Aracılığıyla paylaş

Blob Alma

  • Makale

İşlem, Get Blob meta verileri ve özellikleri dahil olmak üzere sistemden bir blob okur veya indirir. Anlık görüntüyü okumak için de çağrısı Get Blob yapabilirsiniz.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Get Blob . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

GET yöntemi istek URI'si HTTP sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

 HTTP/1.0

HTTP/1.1

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

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

GET yöntemi istek URI'si HTTP sürümü
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

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:

Parametre Açıklama
snapshot İsteğe bağlı. snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak DateTime bir değerdir. Blob anlık görüntüleriyle çalışma hakkında daha fazla bilgi için bkz. Blobun anlık görüntüsünü İçerik Oluşturucu.
versionid İsteğe bağlı, sürüm 2019-12-12 ve üzeri. versionid parametresi, mevcut olduğunda alınacak blobun sürümünü belirten opak DateTime bir değerdir.
timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için zaman aşımlarını ayarlama.

İ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'ya istekleri 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'ya istekleri yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Anonim istekler için isteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Anonim bir istek için bu üst bilgi atlanırsa, hizmet isteği 2009-09-19 sürümüyle yürütür. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
Range İsteğe bağlı. Blobun baytlarını yalnızca belirtilen aralıkta döndürür.
x-ms-range İsteğe bağlı. Blobun baytlarını yalnızca belirtilen aralıkta döndürür. hem hem de Rangex-ms-range belirtilirse, hizmet değerini x-ms-rangekullanır. Hiçbir aralık belirtilmezse blob içeriğinin tamamı döndürülür. Daha fazla bilgi için bkz. Blob Depolama işlemleri için aralık üst bilgisini belirtme.
x-ms-lease-id: <ID> İsteğe bağlı. Bu üst bilgi belirtilirse, işlem yalnızca aşağıdaki koşulların her ikisi de karşılandığında gerçekleştirilir:

- Blob'un kirası şu anda etkin.
- İstekte belirtilen kira kimliği, blobun kira kimliğiyle eşleşir.

Bu üst bilgi belirtilirse ancak bu koşullardan biri karşılanmazsa istek başarısız olur ve Get Blob işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız Oldu).
x-ms-range-get-content-md5: true İsteğe bağlı. Bu üst bilgi olarak ayarlandığında true ve üst bilgiyle Range birlikte belirtildiğinde, aralık boyutu 4 mebibayttan (MiB) küçük veya buna eşit olduğu sürece hizmet, aralık için MD5 karması döndürür.

Üst bilgi üst bilgi olmadan Range belirtilirse, hizmet 400 (Hatalı İstek) durum kodunu döndürür.

Üst bilgi, aralık 4 MiB'yi aştığında olarak ayarlanırsa true , hizmet 400 (Hatalı İstek) durum kodunu döndürür.
x-ms-range-get-content-crc64: true İsteğe bağlı. Bu üst bilgi olarak ayarlandığında true ve üst bilgiyle Range birlikte belirtildiğinde, aralık boyutu 4 MiB'den küçük veya buna eşit olduğu sürece hizmet, aralık için CRC64 karması döndürür.

Üst bilgi üst bilgi olmadan Range belirtilirse, hizmet 400 (Hatalı İstek) durum kodunu döndürür.

Üst bilgi, aralık 4 MiB'yi aştığında olarak ayarlanırsa true , hizmet 400 (Hatalı İstek) durum kodunu döndürür.

Hem hem x-ms-range-get-content-crc64 de x-ms-range-get-content-md5 üst bilgileri varsa, istek 400 (Hatalı İstek) ile başarısız olur.

Bu üst bilgi 2019-02-02 ve sonraki sürümlerde desteklenir.
Origin İsteğe bağlı. İsteğin verildiği kaynağı belirtir. Bu üst bilginin varlığı, yanıtta çıkış noktaları arası kaynak paylaşımı (CORS) üst bilgileriyle sonuçlanır.
x-ms-upn İsteğe bağlı. Sürüm 2023-11-03 ve üzeri. Hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir. True ise, içinde x-ms-group döndürülen x-ms-ownerkullanıcı kimliği değerleri ve x-ms-acl yanıt üst bilgileri Microsoft Entra nesne kimliklerinden Kullanıcı Asıl Adları'na dönüştürülür. Değer false ise, Microsoft Entra nesne kimlikleri olarak döndürülür. Varsayılan değer false şeklindedir. Grup ve uygulama nesnesi kimliklerinin benzersiz kolay adları olmadığından çevrilmediğini unutmayın.
x-ms-client-request-id İsteğe bağlı. Depolama analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen, 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı kurarken bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. Azure Depolama Analizi günlüğü hakkında.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blobu okumak 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 üst bilgileri (müşteri tarafından sağlanan şifreleme anahtarları)

2019-02-02 sürümünden itibaren, istekte müşteri tarafından sağlanan bir anahtarla şifrelenmiş bir blobu okumak için aşağıdaki üst bilgileri belirtebilirsiniz. Müşteri tarafından sağlanan anahtarla (ve ilgili üst bilgi kümesiyle) şifreleme isteğe bağlıdır. Blob daha önce müşteri tarafından sağlanan bir anahtarla şifrelendiyse, okuma işlemini başarıyla tamamlamak için isteğe bu üst bilgileri eklemeniz gerekir.

İstek üst bilgisi Açıklama
x-ms-encryption-key Gereklidir. Base64 kodlamalı AES-256 şifreleme anahtarı.
x-ms-encryption-key-sha256 İsteğe bağlı. Şifreleme anahtarının Base64 kodlamalı SHA256 karması.
x-ms-encryption-algorithm: AES256 Gereklidir. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri olmalıdır AES256.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve blobun içeriğini içeren yanıt gövdesini içerir.

Durum kodu

Tam blobu okumak için başarılı bir işlem 200 durum kodunu döndürür (Tamam).

Belirtilen aralığı okuma işlemi başarılı bir şekilde 206 (Kısmi İçerik) 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.

Syntax Description
Last-Modified Blob'un en son değiştirildiği tarih/saat. Tarih biçimi RFC 1123'e göredir.

Blobun meta verilerinin veya özelliklerinin güncelleştirilmiş olması da dahil olmak üzere blobu değiştiren tüm işlemler, blobun son değiştirme zamanını değiştirir.
x-ms-creation-time Sürüm 2017-11-09 ve üzeri. Blob oluşturulduğu tarih/saat. Tarih biçimi RFC 1123'e göredir.
x-ms-meta-name:value Kullanıcı tanımlı meta veriler olarak bu blobla ilişkilendirilmiş bir dizi ad-değer çifti.
x-ms-tag-count Sürüm 2019-12-12 ve üzeri. Blobun herhangi bir etiketi varsa, bu üst bilgi blobda depolanan etiket sayısını döndürür. Blobda etiket yoksa üst bilgi döndürülemez.
Content-Length Yanıt gövdesinde bulunan bayt sayısı.
Content-Type Blob için belirtilen içerik türü. Varsayılan içerik türü şeklindedir application/octet-stream.
Content-Range İstemcinin istek üst bilgisini ayarlayarak Range blobun bir alt kümesini istemesi durumunda döndürülen bayt aralığını gösterir.
ETag İşlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme. İstek sürümü 2011-08-18 veya üzeriyse, ETag değeri tırnak içine alınır.
Content-MD5 Blobda MD5 karması varsa ve bu Get Blob işlem blob'un tamamını okumaksa, istemcinin ileti içeriği bütünlüğünü denetleyebilmesi için bu yanıt üst bilgisi döndürülür.

Sürüm 2012-02-12 ve sonraki sürümlerde, Put Blob istek bir MD5 üst bilgisi içermese bile blok blobunun Put Blob MD5 karma değerini ayarlar.

İstek belirli bir aralığı okumak içinse ve x-ms-range-get-content-md5 değeri olarak ayarlandıysa true, aralık boyutu 4 MiB'den küçük veya buna eşit olduğu sürece, istek aralık için bir MD5 karması döndürür.

Bu koşul kümelerinden hiçbiri değilse true, üst bilgi için Content-MD5 hiçbir değer döndürülür.

Üst bilgi olmadan Range belirtilirsex-ms-range-get-content-md5, hizmet 400 (Hatalı İstek) durum kodunu döndürür.

Aralık 4 MiB'yi aştığında olarak ayarlanırsa x-ms-range-get-content-md5true , hizmet 400 (Hatalı İstek) durum kodunu döndürür.
x-ms-content-crc64 İstek belirli bir aralığı okuyacaksa ve x-ms-range-get-content-crc64 değeri olarak ayarlandıysa true, aralık boyutu 4 MiB'den küçük veya buna eşit olduğu sürece, istek aralık için bir CRC64 karması döndürür.

Üst bilgi olmadan Range belirtilirsex-ms-range-get-content-crc64, hizmet 400 (Hatalı İstek) durum kodunu döndürür.

Aralık 4 MiB'yi aştığında olarak ayarlanırsa x-ms-range-get-content-crc64true , hizmet 400 (Hatalı İstek) durum kodunu döndürür.
Content-Encoding İstek üst bilgisi için Content-Encoding belirtilen değeri döndürür.
Content-Language İstek üst bilgisi için Content-Language belirtilen değeri döndürür.
Cache-Control Üst bilgi daha önce blob için belirtilmişse döndürülür.
Content-Disposition Sürüm 2013-08-15 ve sonraki sürümlere yönelik istekler için döndürüldü. Bu üst bilgi, üst bilgi için x-ms-blob-content-disposition belirtilen değeri döndürür.

Yanıt Content-Disposition üst bilgisi alanı, yanıt yükünün nasıl işlendiği hakkında ek bilgiler sağlar ve ek meta veriler eklemek için kullanılabilir. Örneğin, üst bilgi olarak attachmentayarlanırsa, kullanıcı aracısının yanıtı görüntülememesi gerektiğini gösterir. Bunun yerine, belirtilen blob adından farklı bir dosya adına sahip farklı kaydet iletişim kutusunu gösterir.
x-ms-blob-sequence-number Sayfa blobu için geçerli sıra numarası.

Blok blobları veya ekleme blobları için bu üst bilgi döndürülmüyor.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Blob'un türünü döndürür.
x-ms-copy-completion-time: <datetime> Sürüm 2012-02-12 ve üzeri. Bu blobun hedef blob olduğu son deneme Copy Blob işleminin sonuç zamanı. Bu değer tamamlanan, durdurulan veya başarısız kopyalama girişiminin zamanını belirtebilir. Bu üst bilgi, bir kopya bekliyorsa, bu blob hiçbir zaman bir Copy Blob işlemdeki hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiesbir sonlandırılan Copy Blob işlemden sonra değiştirilmişse görünmez.
x-ms-copy-status-description: <error string> Sürüm 2012-02-12 ve üzeri. Yalnızca veya pendingolduğunda x-ms-copy-statusfailed görünür. Son önemli veya önemli olmayan kopyalama işlemi hatasının nedenini açıklar. Bu blob bir işlemde Copy Blob hiç hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiessonlandırılan Copy Blob bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.
x-ms-copy-id: <id> Sürüm 2012-02-12 ve üzeri. Bu blob'un hedef blob olduğu son denenen Copy Blob işlemin dize tanımlayıcısı. Bu blob bir işlemde Copy Blob hiç hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiessonlandırılan Copy Blob bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.
x-ms-copy-progress: <bytes copied/bytes total> Sürüm 2012-02-12 ve üzeri. Kopyalanan bayt sayısını ve bu blobun hedef blob olduğu son deneme Copy Blob işleminde kaynaktaki toplam bayt sayısını içerir. 0'dan kopyalanan bayt'a kadar Content-Length görüntüleyebilir. Bu blob bir işlemde Copy Blob hiç hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiessonlandırılan Copy Blob bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.
x-ms-copy-source: url Sürüm 2012-02-12 ve üzeri. Bu blobun hedef blob olduğu son denenen Copy Blob işlemde kullanılan kaynak blobu veya dosyayı belirten en fazla 2 KiB uzunluğunda bir URL. Bu blob bir işlemde Copy Blob hiç hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiessonlandırılan Copy Blob bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.

Bu üst bilgide döndürülen URL, kaynak bloba erişmek için kullanılan paylaşılan erişim imzası (SAS) belirteci dahil olmak üzere kaynak blobdaki kopyalama işleminde kullanılan tüm istek parametrelerini içerir.
x-ms-copy-status: <pending | success | aborted | failed> Sürüm 2012-02-12 ve üzeri. Şu değerlerle x-ms-copy-id ile tanımlanan kopyalama işleminin durumu:

- success: Kopyalama başarıyla tamamlandı.
- pending: Kopyalama işlemi devam ediyor. Aralıklı, önemli olmayan hataların kopyalama işleminin yavaş ilerleyip ilerlemediğini ancak hataya neden olup olmadığını denetleyin x-ms-copy-status-description .
- aborted: Kopyalama, tarafından Abort Copy Blobsonlandırıldı.
- failed: Kopyalama başarısız oldu. Hata ayrıntıları için bkz. x-ms-copy-status-description.

Bu blob hiçbir zaman bir Copy Blob işlemde hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanan Set Blob Propertiestamamlanmış Copy Blob bir işlemden sonra değiştirildiyse bu üst bilgi görüntülenmez.
x-ms-lease-duration: <infinite | fixed> Sürüm 2012-02-12 ve üzeri. Bir blob kiralandığında, kiralamanın sonsuz mu yoksa sabit süreli mi olduğunu belirtir.
x-ms-lease-state: <available | leased | expired | breaking | broken> Sürüm 2012-02-12 ve üzeri. Blobun kira durumu.
x-ms-lease-status:<locked | unlocked> Blobun geçerli kira durumu.
x-ms-request-id 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 yürütmek için kullanılan Blob Depolama sürümünü gösterir. Sürüm 2009-09-19 ve üzeri kullanılarak yapılan istekler için dahil edildi.

Kapsayıcı Blob Depolama sürüm 2009-09-19 kullanılarak genel erişim için işaretlendiyse, bu üst bilgi belirtilen sürüm olmadan anonim istekler için de döndürülür.
Accept-Ranges: bytes Hizmetin kısmi blob içeriği isteklerini desteklediğini gösterir. Sürüm 2011-08-18 ve üzeri kullanılarak yapılan istekler ile SDK sürüm 1.6 ve sonraki sürümlerdeki yerel depolama hizmeti için dahil edilmiştir.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Access-Control-Allow-Origin İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. Bu üst bilgi, eşleşme olması durumunda kaynak istek üst bilgisinin değerini döndürür.
Access-Control-Expose-Headers İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. İsteğin istemcisine veya verene sunulacak yanıt üst bilgilerinin listesini döndürür.
Vary CORS kuralları belirtildiğinde Origin üst bilgi değeriyle döndürülür. Ayrıntılar için bkz. Azure Depolama hizmetleri için CORS desteği .
Access-Control-Allow-Credentials İstek bir Origin üst bilgi içeriyorsa ve CORS tüm çıkış noktalarına izin vermeyecek bir eşleştirme kuralıyla etkinleştirildiyse döndürülür. Bu üst bilgi olarak trueayarlanır.
x-ms-blob-committed-block-count Blobda bulunan kaydedilmiş blokların sayısı. Bu üst bilgi yalnızca ekleme blobları için döndürülür.
x-ms-server-encrypted: true/false Sürüm 2015-12-11 ve üzeri. Blob verileri ve uygulama meta verileri belirtilen algoritma kullanılarak tamamen şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Aksi takdirde, değer olarak ayarlanır false (blob şifrelenmemişse veya blobun veya uygulama meta verilerinin yalnızca bir bölümü şifrelenmişse).
x-ms-encryption-key-sha256 Sürüm 2019-02-02 ve üzeri. Blob müşteri tarafından sağlanan bir anahtarla şifrelenirse bu üst bilgi döndürülür.
x-ms-encryption-context Sürüm 2021-08-06 ve üzeri. Şifreleme bağlamı özellik değeri ayarlanırsa, ayarlanan değeri döndürür. Yalnızca hesap için Hiyerarşik Ad Alanı etkinleştirildiğinde geçerlidir.
x-ms-encryption-scope Sürüm 2019-02-02 ve üzeri. Blob bir şifreleme kapsamıyla şifrelenirse bu üst bilgi döndürülür.
x-ms-blob-content-md5 Sürüm 2016-05-31 ve üzeri. Blobun MD5 karması varsa ve istek bir aralık üst bilgisi (Aralık veya x-ms-range) içeriyorsa, bu yanıt üst bilgisi tüm blobun MD5 değerinin değeriyle döndürülür. Bu değer, content-MD5 üst bilgisinde döndürülen değere eşit olabilir veya olmayabilir; ikinci değer istenen aralıktan hesaplanır.
x-ms-client-request-id İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi yoktur.
x-ms-last-access-time Sürüm 2020-02-10 ve üzeri. Depolama hesabının son erişim zamanı izleme ilkesine göre blob verilerine en son ne zaman erişildiğini gösterir. Depolama hesabının son erişim zamanı izleme ilkesi yoksa veya ilke devre dışı bırakıldıysa üst bilgi döndürülemez. Depolama hesabının son erişim zamanı izleme ilkesini ayarlama hakkında bilgi için bkz. Blob Hizmeti API'si.
x-ms-blob-sealed Sürüm 2019-12-12 ve üzeri. Yalnızca ekleme blobları için döndürülür. Ekleme blobu mühürlenmişse değeri olacaktır true. Daha fazla bilgi için bkz . Ekleme Blob Mühürü
x-ms-immutability-policy-until-date Sürüm 2020-06-12 ve üzeri. Blobda ayarlanan tarihe kadar bekletmeyi belirtir. Bu, blob'un değiştirilmeye veya silinmeye karşı korunabileceği tarihtir. Yalnızca blob üzerinde bir değişmezlik ilkesi ayarlandıysa döndürülür. Bu üst bilginin değeri RFC1123 biçimdedir.
x-ms-immutability-policy-mode: unlocked/locked Sürüm 2020-06-12 ve üzeri. Blobda bir değişmezlik ilkesi ayarlanırsa döndürülür. Değerler ve lockedşeklindedirunlocked. unlocked , kullanıcının saklama süresini tarihe kadar artırarak veya azaltarak ilkeyi değiştirebileceğini gösterir. locked bu eylemlerin yasaklandığını gösterir.
x-ms-legal-hold: true/false Sürüm 2020-06-12 ve üzeri. Blobda yasal bir saklama yoksa bu üst bilgi döndürülemez. Blob yasal ayrı tutma içeriyorsa ve değeri ise truebu üst bilginin değeri olarak ayarlanırtrue. Aksi takdirde, blob yasal bir saklama içeriyorsa ve değeri ise falsedeğeri olarak ayarlanırfalse.
x-ms-owner Sürüm 2020-06-12 ve üzeri, yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Dosya veya dizinin sahip kullanıcısını döndürür.
x-ms-group Sürüm 2020-06-12 ve üzeri, yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Dosya veya dizinin sahip olan grubunu döndürür.
x-ms-permissions Sürüm 2020-06-12 ve üzeri, yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Dosya veya dizindeki kullanıcı, grup ve diğer kullanıcılar için ayarlanan izinleri döndürür. Her bir izin biçimindedir [r,w,x,-]{3} .
x-ms-acl Sürüm 2023-11-03 ve üzeri. Yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Dosya veya dizindeki kullanıcı, grup ve diğer kullanıcılar için ayarlanan birleştirilmiş erişim ve varsayılan erişim denetim listesini döndürür. Her erişim denetimi girdisi (ACE), bir kapsam, tür, kullanıcı veya grup tanımlayıcısı ve biçimindeki [scope]:[type]:[id]:[permissions]izinlerden oluşur. Kapsam, default ACE'nin bir dizin için varsayılan ACL'ye ait olduğunu gösterir; aksi takdirde kapsam örtük olur ve ACE erişim ACL'sine aittir. Her bir izin biçimindedir [r,w,x,-]{3} .
x-ms-resource-type Sürüm 2020-10-02 ve üzeri, yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Yolun kaynak türünü döndürür ve bu tür veya filedirectoryolabilir.

Yanıt gövdesi

Yanıt gövdesi blobun içeriğini içerir.

Örnek yanıt

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

Yetkilendirme

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

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Get Blob için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

Sayfa blobu için, henüz içeriği olmayan veya temizlenen bir sayfa aralığı üzerindeki işlem, Get Blob bu baytlar için sıfır döndürür.

Aralık belirtilmemiş bir sayfa blobunu çağırırsanız Get Blob , hizmet üst bilgi için x-ms-blob-content-length belirtilen değere kadar olan sayfa aralığını döndürür. İçerik içermeyen tüm sayfalar için hizmet, bu baytlar için sıfırlar döndürür.

Ekleme blobu için Get Blob işlem üst bilgisini döndürür x-ms-blob-committed-block-count . Bu üst bilgi, blobdaki işlenen blok sayısını gösterir. Blok x-ms-blob-committed-block-count blobları veya sayfa blobları için üst bilgi döndürülmüyor.

Bir Get Blob işlemin MiB başına iki dakika tamamlanmasına izin verilir. İşlem, MiB başına ortalama iki dakikadan uzun sürüyorsa işlem zaman aşımına uyacaktır.

Üst x-ms-version bilgi, özel bir kapsayıcıya ait bir blobu almak için gereklidir. Blob tam veya kısmi genel erişim için kullanılabilen bir kapsayıcıya aitse, herhangi bir istemci sürümü belirtmeden bu kapsayıcıyı okuyabilir; genel kapsayıcıya ait bir blobu almak için hizmet sürümü gerekli değildir. Daha fazla bilgi için bkz. Kapsayıcılara ve blob'lara erişimi kısıtlama.

Get Blob Arşivlenmiş blok blobu üzerindeki bir işlem başarısız olur.

Kopyalama işlemleri

Bir Copy Blob işlemin tamamlanıp tamamlanmadığını belirlemek için, önce hedef blobun x-ms-copy-id üst bilgi değerinin özgün çağrısı Copy Blobtarafından sağlanan kopya kimliğiyle eşleştiğinden emin olun. Eşleşme, başka bir uygulamanın kopyalamayı durdurmamasını ve yeni Copy Blob bir işlem başlatmamasını sağlar. Ardından üst bilgiyi denetleyin x-ms-copy-status: success . Ancak, bir blob üzerindeki , Put Pageve Put Block işlemleri dışındaki Leasetüm yazma işlemlerinin blobdan tüm x-ms-copy-* özellikleri kaldırdığını unutmayın. Bu özellikler, 2012-02-12'den önceki Blob Depolama sürümlerini kullanan işlemler tarafından Copy Blob da kopyalanmaz.

Uyarı

Üst bilgide x-ms-copy-source döndürülen URL, kaynak blobdaki kopyalama işleminde kullanılan tüm istek parametrelerini içerir. Kaynak bloba erişmek için SAS belirteci kullanırsanız, hedef blobda çağrıldığında Get Blob bu SAS belirteci üst bilgide x-ms-copy-source görünür.

x-ms-copy-status: failed Yanıtta göründüğünde, x-ms-copy-status-description hata hakkında Copy Blob daha fazla bilgi içerir.

Her x-ms-copy-status-description değerin üç alanı aşağıdaki tabloda açıklanmıştır:

Bileşen Açıklama
HTTP durum kodu Hatayı belirten standart bir 3 basamaklı tamsayı.
Hata kodu ErrorCode> öğesinde <Azure tarafından sağlanan hatayı açıklayan bir anahtar sözcük. ErrorCode> öğesi görüntülenmezse<, HTTP belirtimindeki 3 basamaklı HTTP durum koduyla ilişkili standart hata metni içeren bir anahtar sözcük kullanılır. Bkz. Yaygın REST API hata kodları.
Bilgi Hatanın tırnak içine alınmış ayrıntılı açıklaması.

x-ms-copy-status Yaygın hata senaryolarının ve x-ms-copy-status-description değerleri aşağıdaki tabloda açıklanmıştır:

Önemli

Bu tablodaki hata açıklamaları, sürüm değişikliği olmasa bile uyarı vermeden değişebilir, bu nedenle metninizle tam olarak eşleşmeyebilir.

Senaryo x-ms-copy-status değeri x-ms-copy-status-description değeri
Kopyalama işlemi başarıyla tamamlandı. başarılı empty
Kullanıcı kopyalama işlemini tamamlanmadan önce iptal etti. Iptal empty
Kopyalama işlemi sırasında kaynak blobdan okunurken bir hata oluştu, ancak işlem yeniden denenecek. bekleniyor 502 BadGateway "Kaynak okunurken yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Hata zamanı: <saat>"
Kopyalama işleminin hedef blob'unu yazarken bir hata oluştu, ancak işlem yeniden denenecek. bekleniyor 500 InternalServerError "Yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Hata zamanı: <saat>"
Kopyalama işleminin kaynak blobundan okunurken kurtarılamaz bir hata oluştu. başarısız 404 ResourceNotFound "Kaynak okunurken kopyalama başarısız oldu."

Not: Hizmet bu temel hatayı bildirdiğinde öğesinde ErrorCode döndürürResourceNotFound. Yanıtta hiçbir ErrorCode öğe görünmediyse, HTTP durumunun standart dize gösterimi ( gibi NotFound) görüntülenir.
Geçen tüm kopyalama işlemlerini sınırlayan zaman aşımı süresi. (Şu anda zaman aşımı süresi 2 haftadır.) başarısız 500 OperationCancelled "Kopya izin verilen en uzun süreyi aştı."
Kaynaktan okurken kopyalama işlemi çok sık başarısız oldu ve başarıya yönelik girişimlerin en düşük oranını karşılamadı. (Bu zaman aşımı, başarısız olmadan önce çok kötü bir kaynağın iki hafta içinde yeniden denenmesini önler). başarısız 500 OperationCancelled "Kaynak okunurken kopya başarısız oldu."

x-ms-last-access-time depolama hesabının son erişim zamanı izleme ilkesine göre blob verilerine erişildiği zamanı izler. Blob'un meta verilerine erişmek son erişim zamanını değiştirmez.

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 Blob faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Alma Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Okuma işlemleri

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

Ayrıca bkz.

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