Url'den Aralık Koy
Put Range From URL işlemi, içeriğin URL'den okunduğu bir dosyanın parçası olarak işlenecek yeni bir aralık oluşturur. Bu işlem, SMB protokolü etkinleştirilmiş Dosya Paylaşımları için 2019-02-02 ve sonraki sürümlerde ve NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Mevcut |
|---|---|
| SMB |
|
| NFS |
|
İstek
Put Range From URL isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
| KOYMAK | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
HTTP/1.1 |
İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:
| Yol bileşeni | Açıklama |
|---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
Opsiyonel. Üst dizinin yolu. |
myfile |
Dosyanın adı. |
Yol adlandırma kısıtlamaları hakkında bilgi için bkz. Ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.
URI parametreleri
| Parametre | Açıklama |
|---|---|
timeout |
Opsiyonel.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama. |
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tablolarda açıklanmıştır:
Ortak istek üst bilgileri
| İstek üst bilgisi | Açıklama |
|---|---|
Authorization |
Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama istekleri yetkilendirme. |
Date veya x-ms-date |
Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem, SMB protokolü etkinleştirilmiş Dosya Paylaşımları için 2019-02-02 ve sonraki sürümlerde ve NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-copy-source:name |
Gerekli. Kaynak dosyanın URL'sini belirtir. Değer, bir dosyayı belirten en fazla 2 KiB uzunluğunda bir URL olabilir. Değer, istek URI'sinde göründüğü gibi URL ile kodlanmış olmalıdır. Kaynak dosyanın ortak olması veya paylaşılan erişim imzası aracılığıyla yetkilendirilmiş olması gerekir. Kaynak dosya ortaksa, işlemi gerçekleştirmek için yetkilendirme gerekmez. Kaynak nesne URL'lerine bazı örnekler aşağıda verilmiştir:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Opsiyonel. Kopyalama kaynağı için yetkilendirme düzenini ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme. Microsoft Entra için yalnızca şema taşıyıcı desteklenir. Bu üst bilgi 2020-10-02 ve sonraki sürümlerde desteklenir. |
x-ms-write: { update } |
Gerekli. Yalnızca updatebelirtmelisiniz.
clearile çağrılırsa istek başarısız olur.
update değeri, istek gövdesi tarafından belirtilen baytları belirtilen aralıklara yazar. |
Range veya x-ms-range |
Gerekli.
Range veya x-ms-range gereklidir.Yazılacak bayt aralığını belirtir. Aralığın hem başlangıcı hem de sonu belirtilmelidir. Bu üst bilgi, HTTP/1.1 protokol belirtimi tarafından tanımlanır. Güncelleştirme işlemi için aralığın boyutu 4 MiB'a kadar olabilir. Azure Dosyalar, Range ve x-ms-range üst bilgileri için yalnızca tek bir bayt aralığı kabul eder ve bayt aralığı şu biçimde belirtilmelidir: bytes=startByte-endByte.Hem Range hem de x-ms-range belirtilirse, hizmet x-ms-rangedeğerini kullanır. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için aralık üst bilgisini belirtme. |
x-ms-source-range |
Gerekli. Kaynaktan okunacak bayt aralığını belirtir. Aralığın hem başlangıcı hem de sonu belirtilmelidir. Azure Dosyalar, Range ve x-ms-range üst bilgileri için yalnızca tek bir bayt aralığı kabul eder ve bayt aralığı şu biçimde belirtilmelidir: bytes=startByte-endByte.Kaynak aralığın boyutu 4 MiB'a kadar olabilir. Kaynak aralığı boyutu 4 MiB'yi aşarsa Azure Dosyalar durum kodu 413'ü döndürür (İstek Varlığı Çok Büyük). Kaynak aralık boyutu aralık (hedef aralık) boyutuyla eşleşmiyorsa, hizmet durum kodu 400 (Hatalı İstek) döndürür. |
Content-Length |
Gerekli. İstek gövdesinde iletilen bayt sayısını belirtir. Bu üst bilginin değeri 0olarak ayarlanmalıdır. Uzunluk 0olmadığında işlem 400 (Hatalı İstek) durum koduyla başarısız olur. |
x-ms-client-request-id |
Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. azure dosyaları izleme. |
x-ms-source-content-crc64 |
Opsiyonel. URI'den belirtilen aralığın CRC64 karması. Bu karma, verilerin URI'den taşınması sırasında aralığın bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, Azure Dosyalar kopyalama kaynağından gelen içeriğin karması ile bu üst bilgi değerini karşılaştırır. Not: Bu CRC64 karması dosyayla birlikte depolanmaz. İki karma eşleşmezse, işlem 400 (Hatalı İstek) hata koduyla başarısız olur. |
x-ms-source-if-match-crc64 |
Opsiyonel. CRC64 sağlama toplamı değeri. yalnızca kaynaktan okunan aralığın sağlama toplamı sağlanan sağlama toplamıyla eşleşiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. Belirtilen koşul karşılanmazsa, Azure Dosyalar durum kodu 412'yi döndürür (Önkoşul Başarısız oldu). |
x-ms-source-if-none-match-crc64 |
Opsiyonel. CRC64 sağlama toplamı değeri. yalnızca kaynaktan okunan aralığın sağlama toplamı sağlanan sağlama toplamından farklıysa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. Belirtilen koşul karşılanmazsa, Azure Dosyalar durum kodu 412'yi döndürür (Önkoşul Başarısız oldu). |
x-ms-lease-id: <ID> |
Dosyanın etkin bir kirası varsa gereklidir. 2019-02-02 ve sonraki sürümlerde kullanılabilir. Dosya, dosya kiralamalarını desteklemeyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır. |
x-ms-client-request-id |
Opsiyonel. Azure Depolama Analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen, 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı kurarken bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. blob depolamayı izleme . |
x-ms-file-last-write-time: { now ¦ preserve } |
Opsiyonel. Sürüm 2021-06-08 ve üzeri. Aşağıdaki seçeneklerden birini belirtebilirsiniz:
|
x-ms-file-request-intent |
Authorization üst bilgisi bir OAuth belirteci belirtiyorsa gereklidir. Kabul edilebilir değer backup. Bu üst bilgi, Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, Authorization üst bilgisi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine eklenmişse verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde bulunan sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Hedef, varsayılan olarak sondaki noktayı destekleyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, kaynak URL'de bulunan sondaki noktanın kırpılıp kırpılmaması gerektiğini belirtir. Bu üst bilgi yalnızca kopyalama kaynağı bir Azure Dosya Paylaşımı'nda bulunuyorsa belirtilmelidir. Bu üst bilgi, başka bir kopyalama kaynağı türü için desteklenmez. Kopyalama kaynağı varsayılan olarak sondaki noktayı destekleyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma. |
Yalnızca SMB istek üst bilgileri
Hiç kimse.
Yalnızca NFS istek üst bilgileri
Hiç kimse.
İstek gövdesi
İstek gövdesi yok.
Örnek istek
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
Yanıt
Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.
Durum kodu
Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür. Durum kodları hakkında daha fazla bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki tablolardaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Ortak yanıt üst bilgileri
| Yanıt üst bilgisi | Açıklama |
|---|---|
ETag |
İşlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır. |
Last-Modified |
Dosyanın son değiştirildiği tarih ve saat. Tarih biçimi RFC 1123'e uyar. Daha fazla bilgi için bkz. üst bilgilerde Tarih/Saat Değerlerinin gösterimi. Dosyanın meta verilerine veya özelliklerine yönelik güncelleştirmeler de dahil olmak üzere dosyadaki herhangi bir yazma işlemi, dosyanın son değiştirme zamanını değiştirir. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve isteği gidermek için kullanabilirsiniz. Daha fazla bilgi için bkz. API işlem sorunlarını giderme. |
x-ms-version |
İsteği yürütmek için kullanılan FileREST API sürümünü gösterir. |
Date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
x-ms-content-crc64 |
İstemcinin ileti içerik bütünlüğünü denetleyebilmesi için döndürüldü. Bu üst bilginin değeri Azure Dosyalar tarafından hesaplanır. İstek üst bilgilerinde belirtilen değerle aynı olmayabilir. |
x-ms-client-request-id |
İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz. |
x-ms-file-last-write-time |
Sürüm 2021-06-08 ve üzeri. Dosyanın iso 8601 biçimindeki son yazma zamanı (örneğin, 2017-05-10T17:52:33.9551861Z). |
Yalnızca SMB yanıt üst bilgileri
Hiç kimse.
Yalnızca NFS yanıt üst bilgileri
Hiç kimse.
Yanıt gövdesi
Hiç kimse.
Örnek yanıt
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
İzin
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Put Range From URL işlemi bir dosyaya bir veri aralığı yazar ve Put Range işlemine benzer bir davranıştır. Kaynak dosyanın verilerini, meta verilerini ve diğer özelliklerini okumak için belirtilen kaynakta Get File işlemini kullanır. 2020-10-02 ve sonraki sürümlerde, kopyalama işleminin kaynağı için Microsoft Entra yetkilendirmesi desteklenir.
Put Range From URL işlemi, yalnızca belirtilen aralık dosyaya yazıldıysa 201 (Oluşturuldu) başarısını döndürür.
Ayrıca bkz.
Dosyalarda İşlemleri