Sayfa Aralıklarını Alma

Sayfa Aralıklarını Al işlemi, sayfa blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür.

İstek

Sayfa Aralıklarını Al isteği aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

Öykünülmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetinde istekte bulunurken öykünücü ana bilgisayar adını ve Azure Blob Depolama bağlantı noktasını 127.0.0.1:10000 olarak ve ardından öykünülmüş depolama hesabı adını belirtin:

Daha fazla bilgi için bkz. Geliştirme ve test için Azure Depolama Öykünücüsü'ni kullanma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında sayfa aralıklarını almak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve 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 daha fazla 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 gövdesi

Yanıt gövdesi, adres sayfası aralığını artırarak sıralanmış, çakışmayan, geçerli sayfa aralıklarının listesini içerir. Yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>  
<PageList>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
</PageList>  

Blobun tüm sayfa kümesi temizlenmişse, yanıt gövdesi herhangi bir sayfa aralığı içermez.

prevsnapshot Parametresi belirtilmişse, yanıt yalnızca hedef anlık görüntü veya blob ile önceki anlık görüntü arasında farklılık gösteren sayfaları içerir. Döndürülen sayfalar güncelleştirilmiş veya temizlenmiş her iki sayfayı da içerir. Bu yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>  
<PageList>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
   <ClearRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </ClearRange>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
</PageList>  
  

Blobun tüm sayfa kümesi temizlenmişse ve prevsnapshot parametresi belirtilmemişse yanıt gövdesinde sayfa aralığı yoktur.

maxresults Parametresi belirtilmişse, yanıt yalnızca etiketinde devamlılık belirteciyle NextMarker belirtilen sayıda aralık içerir. Bekleyen başka aralık yoksa devamlılık belirteci boş olur veya bir sonraki istekte parametre olarak gönderilmesi gereken opak bir marker değer içerir. Bu yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>  
<PageList>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
   <ClearRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </ClearRange>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>
   <NextMarker/>
</PageList>  
  

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Get Page Ranges verebilirsiniz.

Açıklamalar

Her sayfa aralığı için başlangıç ve bitiş bayt uzaklıkları dahil edilir.

Çok fazla sayıda yazma işlemi içeren yüksek oranda parçalanmış bir sayfa blobunda, iç Get Page Ranges sunucu zaman aşımı nedeniyle istek başarısız olabilir. Çok sayıda yazma işlemine sahip bir sayfa blobunun aralıklarını alan uygulamaların bir kerede sayfa aralıklarının bir alt kümesini alması gerekir.

Sürüm 2015-07-08'den itibaren, temel blob ile anlık görüntü arasında veya blobun iki anlık görüntüsü arasında farklılık gösteren sayfaları döndürmek için parametresiyle prevsnapshot çağırabilirsinizGet Page Ranges. Bu sayfa farklarını kullanarak sayfa blobunun artımlı anlık görüntüsünü kaydedebilirsiniz. Artımlı anlık görüntüler, kendi yedekleme çözümünüzü uygulamak istiyorsanız sanal makine disklerini yedeklemenin uygun maliyetli bir yoludur.

parametresiyle çağrılması Get Page Rangesprevsnapshot , tarafından prevsnapshot belirtilen anlık görüntü alındığından beri güncelleştirilmiş veya temizlenmiş sayfaları döndürür. Ardından Sayfa Koy'ı kullanarak döndürülen sayfaları başka bir depolama hesabındaki bir yedekleme sayfası blob'una kopyalayabilirsiniz.

2019-07-07 sürümünden x-ms-previous-snapshot-url itibaren üst bilgisini kullanarak artımlı anlık görüntüler için yönetilen disk hesaplarındaki anlık görüntüleri belirtebilirsiniz. Yönetilen diskler kullanmıyorsanız sorgu parametresini prevsnapshot kullanın.

Artımlı anlık görüntü döndürmek için çağrıldığında blob üzerindeki bazı işlemlerin başarısız olmasına neden olur Get Page Ranges . Get Pages Rangestarafından belirtilen prevsnapshot anlık görüntü alındıktan sonra Put Blob veya Copy Blob isteğinin hedefi olan bir blobda çağrılırsa hata kodu 409 (Çakışma) ile başarısız olur. İşlemin Get Page Ranges hedefi bir anlık görüntüyse, tarafından prevsnapshot belirtilen anlık görüntü eski olduğu ve iki anlık görüntü arasındaki aralıkta veya Put BlobCopy Blob işlem çağrıldığı sürece çağrı başarılı olur.

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob Depolama işlemleri için zaman aşımlarını ayarlama