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-rangekullanı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 prevsharesnapshotbelirtilen 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.

Ayrıca bkz.

Dosyalar üzerindeki işlemler