Blok Listesini Al

İşlem, Get Block List bir blok blobunun parçası olarak karşıya yüklenen blokların listesini alır.

Blob için tutulan iki blok listesi vardır:

• Kaydedilmiş Blok Listesi: Blok Listesini Koy kullanılarak belirtilen bloba başarıyla kaydedilmiş blokların listesi.

• Kaydedilmemiş Blok Listesi: Blok Koy kullanılarak blob için karşıya yüklenen ancak henüz işlenmemiş blokların listesi. Bu bloklar Bir blob ile ilişkili olarak Azure'da depolanır, ancak henüz blobun bir parçasını oluşturmaz.

Kaydedilmiş blok listesini, kaydedilmemiş blok listesini veya her iki listeyi de döndürmek için öğesini çağırabilirsiniz Get Block List . Anlık görüntü için işlenen blok listesini almak için de bu işlemi çağırabilirsiniz.

İstek

İstek Get Block List 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 isteği

Öykünülmüş depolama hizmetinde istekte bulunulduğunda öykünücü konak adını ve Blob hizmeti bağlantı noktasını olarak 127.0.0.1:10000belirtin ve ardından öykünülen depolama hesabı adını belirtin:

Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

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

İ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 işlemi yürütmek 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.

Örnek istek

Aşağıdaki örnek istek URI'si, MOV1.avi adlı bir blob için yürütülen blok listesini döndürür:

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=committed HTTP/1.1

Aşağıdaki örnek istek URI'sinde hem kaydedilmiş hem de kaydedilmemiş blok listesi döndürülür:

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=all HTTP/1.1

Aşağıdaki örnek istek URI'sinde anlık görüntü için kaydedilmiş blok listesi döndürülür. Anlık görüntü yalnızca kaydedilmiş bloklardan oluşur, bu nedenle onunla ilişkilendirilmiş kaydedilmemiş bloklar yoktur.

GET http://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist&snapshot=2009-09-30T20%3a11%3a15.2735974Z

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve blok listesini içeren 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.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blok listesini 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.

Yanıt gövdesi

Yalnızca işlenen blokları döndüren bir isteğin yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>base64-encoded-block-id</Name>
      <Size>size-in-bytes</Size>
    </Block>
  <CommittedBlocks>
</BlockList>

Hem işlenen hem de kaydedilmemiş blokları döndüren bir isteğin yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
     <Block>
        <Name>base64-encoded-block-id</Name>
        <Size>size-in-bytes</Size>
     </Block>
  </CommittedBlocks>
  <UncommittedBlocks>
    <Block>
      <Name>base64-encoded-block-id</Name>
      <Size>size-in-bytes</Size>
    </Block>
  </UncommittedBlocks>
 </BlockList>

Örnek yanıt

Aşağıdaki örnekte parametresi olarak committedayarlanmıştır, blocklisttype bu nedenle yanıtta yalnızca blob'un işlenen blokları döndürülür.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Sun, 25 Sep 2011 00:33:19 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>4194304</Size>
    </Block>
  </CommittedBlocks>
</BlockList>

Bu örnekte blocklisttype parametresi olarak ayarlanmıştır allve yanıtta hem blob'un işlenen hem de kaydedilmemiş blokları döndürülür.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Sun, 25 Sep 2011 00:35:56 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>4194304</Size>
    </Block>
  </CommittedBlocks>
  <UncommittedBlocks>
    <Block>
      <Name>BlockId003</Name>
      <Size>4194304</Size>
    </Block>
    <Block>
      <Name>BlockId004</Name>
      <Size>1024000</Size>
    </Block>
  </UncommittedBlocks>
</BlockList>

Bu sonraki örnekte blocklisttype parametresi olarak allayarlanmıştır, ancak blob henüz işlenmediğinden CommittedBlocks öğe boş olur.

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23
Date: Wed, 14 Sep 2011 00:40:22 GMT

<?xml version="1.0" encoding="utf-8"?>
<BlockList>
  <CommittedBlocks />
  <UncommittedBlocks>
    <Block>
      <Name>BlockId001</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId002</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId003</Name>
      <Size>1024</Size>
    </Block>
    <Block>
      <Name>BlockId004</Name>
      <Size>1024</Size>
    </Block>
  </UncommittedBlocks>
</BlockList>

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 Block List verebilirsiniz.

Açıklamalar

Bir blok bloba kaydedilmiş blokların listesini, henüz işlenmemiş blokların listesini veya her iki listeyi döndürmek için çağrısı Get Block List . blocklisttype Döndürülecek blok listesini belirtmek için parametresini kullanın. İşlenmiş blokların listesi, Blok Listesini Koy işlemi tarafından işlendikleri sırayla döndürülür.

Çağrıların başarısız olduğu veya Put Block List başarısız olduğu durumlarda blobda eksik olan blokları belirlemek için Put Block kaydedilmemiş blok listesini kullanabilirsiniz. Kaydedilmemiş blokların listesi alfabetik sırada döndürülür. Bir blok kimliği birden çok kez karşıya yüklendiyse, listede yalnızca en son karşıya yüklenen blok görüntülenir.

Get Block List , kaydedilmemiş blokların listesini okurken eşzamanlılığı desteklemez. Diğer okuma işlemlerinden daha düşük maksimum istek oranına sahip olan veya blocklisttype=all bu değere Get Block Listblocklisttype=uncommitted yapılan çağrılar. Okuma işlemleri için hedef aktarım hızı hakkında ayrıntılı bilgi için bkz. Azure Depolama ölçeklenebilirlik ve performans hedefleri.

2019-12-12 sürümünden itibaren blok blobu 4000 mebibayta (MiB) kadar blok içerebilir. Blok boyutunu temsil etmek için imzalı 32 bit tamsayı kullanan uygulamaları korumak için, 2019-12-12'den önceki bir REST sürümüne sahip 100 MiB'den büyük bir blok içeren blok blobunda çağrılması Get Block List durum kodu 409(Çakışma) ile sonuçlanmıştır.

Get Block List yalnızca blok blobları için geçerlidir. Sayfa blobunda çağrılması Get Block List durum kodu 400 (Hatalı İstek) ile sonuçlanmıştır.

Get Block List arşivlenmiş bir blok blobu başarısız olur.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Get Block List faturalama kategorisi gösterilmektedir:

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Azure Depolama Durumu ve hata kodlarınayönelik istekleri yetkilendirmeBlob Depolama hata kodlarıBlob Depolama işlemleri için zaman aşımlarını ayarlama