Liste Aralıkları
İşlem, List Ranges
bir dosya için geçerli aralıkların listesini döndürür.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz List Ranges
. HTTPS önerilir.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
GET | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist |
HTTP/1.1 |
GET | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist |
HTTP/1.1 |
GET | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime> |
HTTP/1.1 |
GET | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&prevsharesnapshot=<DateTime> |
HTTP/1.1 |
İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:
Yol bileşeni | Description |
---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
İsteğe bağlı. Üst dizinin yolu. |
myfile |
Dosyanın adı. |
Yol adlandırma kısıtlamaları hakkında ayrıntılı bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz.
Parametre | Açıklama |
---|---|
sharesnapshot |
İsteğe bağlı. Sürüm 2017-04-17 ve üzeri.
sharesnapshot parametresi, mevcut olduğunda dosya için sorgu kullanılacak paylaşım anlık görüntüsünü belirten opak DateTime bir değerdir. |
timeout |
İsteğe bağlı.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama. |
prevsharesnapshot |
2020-02-10 ve sonraki sürümlerde isteğe bağlı.
prevsharesnapshot parametresi, mevcut olduğunda önceki anlık görüntüyü belirten opak DateTime bir değerdir.Hem bu parametre hem sharesnapshot de mevcut olduğunda, yanıt yalnızca iki anlık görüntü arasında değiştirilmiş sayfa aralıkları içerir. Yalnızca prevsharesnapshot mevcut olduğunda, yanıt yalnızca bu anlık görüntü ile canlı paylaşım arasında değiştirilmiş sayfa aralıklarını içerir.Değiştirilen sayfalar hem güncelleştirilmiş hem de temizlenmiş sayfaları içerir. |
İstek üst bilgileri
Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.
İstek üst bilgisi | Açıklama |
---|---|
Authorization |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
Range |
İsteğe bağlı. Dahil olmak üzere, aralıkların listelendiği bayt aralığını belirtir. Atlanırsa, dosyanın tüm aralıkları döndürülür. |
x-ms-range |
İsteğe bağlı. Dahil olmak üzere, aralıkların listelendiği bayt aralığını belirtir. Hem hem x-ms-range de Range üst bilgileri belirtilirse, hizmet değerini x-ms-range kullanır. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için aralık üst bilgisini belirtme. |
x-ms-lease-id:<ID> |
İsteğe bağlı. Sürüm 2019-02-02 ve üzeri. Üst bilgi belirtilirse, işlem yalnızca dosyanın kirası şu anda etkinse ve istekte belirtilen kira kimliği dosyanınkiyle eşleşiyorsa gerçekleştirilir. Aksi takdirde işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). |
x-ms-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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. İzleme Azure Dosyalar. |
x-ms-file-request-intent |
Üst bilgi bir OAuth belirteci belirtiyorsa Authorization gereklidir. Kabul edilebilir değer: backup . Bu üst bilgi, üst bilgi kullanılarak Authorization yetkilendirilen Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action kimliğe atanan RBAC ilkesine eklenmişse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
Yanıt
Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve XML biçiminde bir yanıt gövdesi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür. Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki ü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.
Yanıt üst bilgisi | Description |
---|---|
Last-Modified |
Dosyanın son değiştirildiği tarih/saat. Dosyanın meta verilerinin veya özelliklerinin güncelleştirilmiş olması da dahil olmak üzere dosyayı değiştiren tüm işlemler dosyanın son değiştirme zamanını değiştirir. |
ETag |
, ETag tırnak içinde dosyanın sürümünü temsil eden bir değer içerir. |
x-ms-content-length |
Dosyanın bayt cinsinden boyutu. mevcut prevsharesnapshot olduğunda, değeri dosyasındaki dosyanın sharesnapshot boyutunu açıklar (sorgu parametresi varsa sharesnapshot ). Aksi takdirde, canlı dosyanın boyutunu açıklar. |
x-ms-request-id |
Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği çalıştırmak için kullanılan Azure Dosyalar sürümünü gösterir. |
Date veya x-ms-date |
Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur. |
x-ms-client-request-id |
İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi kullanabilirsiniz. Bu üst bilginin değeri, istekte varsa üst bilginin değerine x-ms-client-request-id eşittir. Değer en fazla 1024 görünür ASCII karakterdir.
x-ms-client-request-id Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz. |
Yanıt gövdesi
Yanıt gövdesi, adres aralığını artırarak sıralanmış, çakışmayan geçerli aralıkların listesini içerir. Yanıt gövdesinin biçimi aşağıdaki gibidir.
<?xml version="1.0" encoding="utf-8"?>
<Ranges>
<Range>
<Start>Start Byte</Start>
<End>End Byte</End>
</Range>
<Range>
<Start>Start Byte</Start>
<End>End Byte</End>
</Range>
</Ranges>
Dosyanın aralık kümesinin tamamı temizlenmişse, yanıt gövdesi herhangi bir aralık içermez.
belirtilirse prevsharesnapshot
, yanıt yalnızca hedef anlık görüntü (veya canlı dosya) ile önceki anlık görüntü arasında farklılık gösteren sayfaları içerir. Döndürülen aralıklar güncelleştirilmiş veya temizlenmiş olan her iki aralığı da içerir. Bu yanıtın biçimi aşağıdaki gibidir:
<?xml version="1.0" encoding="utf-8"?>
<Ranges>
<Range>
<Start>Start Byte</Start>
<End>End Byte</Start>
</Range>
<ClearRange>
<Start>Start Byte</Start>
<End>End Byte</Start>
</ClearRange>
<Range>
<Start>Start Byte</Start>
<End>End Byte</Start>
</Range>
</Ranges>
Dosyanın tüm sayfa kümesi temizlenmişse ve prevsharesnapshot
parametresi belirtilmemişse, yanıt gövdesi herhangi bir aralık içermez.
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Her aralığın başlangıç ve bitiş bayt uzaklıkları dahil edilir. Aralığı Koy için Aralık Güncelleştirme İşlemleri ve Aralık Temizleme İşlemleri örneklerine bakın. Bu örnekler, dosyadan 512 hizalanmamış bayt aralığını yazar veya temizlerseniz hangi aralıkların döndürüleceğini gösterir.
Çok fazla sayıda yazma işlemi içeren yüksek oranda parçalanmış bir dosyada, iç List Ranges
sunucu zaman aşımı nedeniyle istek başarısız olabilir. Çok sayıda yazma işlemine sahip bir dosyanın aralıklarını alan uygulamalar, aralıkların bir alt kümesini aynı anda almalıdır.
2020-02-10 sürümünden itibaren bir prevsharesnapshot
parametreyle çağrı List Ranges
yapabilirsiniz. Bu, canlı dosya ile anlık görüntü arasında veya anlık görüntülerdeki dosyanın iki anlık görüntüsü arasında farklılık gösteren aralıkları döndürür. Bu aralık farklarını kullanarak bir dosyanın artımlı anlık görüntüsünü alabilirsiniz. Artımlı anlık görüntüler, kendi yedekleme çözümünüzü uygulamak istiyorsanız dosyaları yedeklemenin uygun maliyetli bir yoludur.
Artımlı anlık görüntü almak için çağrıldığında dosyadaki belirli işlemlerin başarısız olmasına neden olur List Ranges
. Hizmet şunu döndürür:
- 404 (Bulunamadı) anlık görüntülerden birinde bulunmayan (veya belirtilmemişse canlı) bir dosyada ararsanız
sharesnapshot
. - 409 (Çakışma), tarafından
prevsharesnapshot
belirtilen anlık görüntüden sonra üzerine yazma Kopyası'nın hedefi olan bir dosyayı çağırırsanız. - 409 (Çakışma), tarafından belirtilen
prevsharesnapshot
anlık görüntü alındıktan sonra silinmiş ve aynı ad ve konumla yeniden oluşturulmuş bir dosyada çağrı yaparsanız.