Aracılığıyla paylaş

Liste Aralıkları

  • Makale

List Ranges işlemi, bir dosya için geçerli aralıkların listesini döndürür. Bu işlem, 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 Evet
NFS Evet

İstek

List Ranges isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.

Yöntem İstek URI'si HTTP sürümü
AL https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist HTTP/1.1
AL https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist HTTP/1.1
AL https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime> HTTP/1.1
AL 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 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 ayrıntılı bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz.

Parametre Açıklama
sharesnapshot Opsiyonel. 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 bir DateTime değeridir.
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.
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 bir DateTime değeridir.

Hem bu parametre hem de sharesnapshot mevcut olduğunda, yanıt yalnızca iki anlık görüntü arasında değiştirilmiş sayfa aralıklarını 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

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, 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.
Range Opsiyonel. 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 Opsiyonel. Dahil olmak üzere, aralıkların listelendiği bayt aralığını belirtir.

Hem Range hem de x-ms-range üst bilgileri 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-lease-id:<ID> Opsiyonel. 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).

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. 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-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-file-support-rename: { <Boolean> } Opsiyonel. Sürüm 2024-05-04 ve üzeri sürümlerde desteklenir. Bu üst bilgi yalnızca prevsharesnapshot sorgu parametresi mevcut olduğunda izin verilir. Boole değeri, yeniden adlandırma veya taşıma işlemlerinin bir sonucu olarak dosyanın önceki anlık görüntüdeki konumu İstek URI'sindeki konumdan farklı olduğunda dosya için değiştirilen aralıkların listelenip listelenmeyeceğini belirler. Değer true ise, dosya için geçerli değiştirilmiş aralıklar döndürülür. Değer false ise, işlem 409 (Çakışma) yanıtıyla hataya neden olur. Varsayılan değer false'tur.

Yalnızca SMB istek üst bilgileri

Hiç kimse.

Yalnızca NFS istek üst bilgileri

Hiç kimse.

İstek gövdesi

Hiç kimse.

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 durum kodunu döndürür (Tamam). Durum kodları hakkında 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
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. prevsharesnapshot mevcut olduğunda, değer sharesnapshot dosyasının boyutunu açıklar (sharesnapshot sorgu parametresi varsa). 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 x-ms-client-request-id üst bilgisinin değerine eşittir. Değer en fazla 1024 görünür ASCII karakterdir. İstekte x-ms-client-request-id üst bilgisi yoksa, yanıtta bu üst bilgi bulunmaz.

Yalnızca SMB yanıt üst bilgileri

Hiç kimse.

Yalnızca NFS yanıt üst bilgileri

Hiç kimse.

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.

prevsharesnapshot belirtilirse, 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 sayfa kümesinin tamamı temizlenmişse ve prevsharesnapshot parametresi belirtilmemişse, yanıt gövdesi herhangi bir aralık içermez.

İzin

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Her aralığın başlangıç ve bitiş bayt uzaklıkları dahil edilir. Aralığı Koyiç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ç sunucu zaman aşımı nedeniyle List Ranges isteği 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 başlayarak, prevsharesnapshot parametresiyle List Ranges çağırabilirsiniz. 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.

Bir dosyadaki belirli işlemler, artımlı anlık görüntü almak için çağrıldığında List Ranges başarısız olmasına neden olur. Hizmet şunu döndürür:

  • Anlık görüntülerden birinde (veya sharesnapshot belirtilmezse canlı) mevcut olmayan bir dosyayı çağırırsanız 404 (Bulunamadı).
  • 409 (Çakışma), prevsharesnapshottarafından belirtilen anlık görüntüden sonra üzerine yazmaKopyalama'nın hedefi olan bir dosyayı çağırırsanız.
  • 409 (Çakışma), prevsharesnapshot tarafından belirtilen anlık görüntü alındıktan sonra silinmiş ve aynı ad ve konumla yeniden oluşturulmuş bir dosyayı çağırırsanız.

Ayrıca bkz.

Dosyalarda İşlemleri