Blob'u edinin

İşlem, Get Blob sistemden bir blob'u okur veya indirir; meta verileri ve özellikleri dahil. Ayrıca bir anlık fotoğrafı okumak için arayabilirsiniz Get Blob .

İstek

Get Blob isteğini aşağıdaki gibi oluşturabilirsiniz. HTTPS kullanmanızı öneririz. Hesabımı depolama hesabınızın adıyla değiştirin:

GET yöntem talebi URI 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ünmüş depolama hizmeti URI'si

Emülasyon edilen depolama hizmetine karşı bir talep yaparken, emülatör ana adını ve Azure Blob Depolama portunu , ardından emüllenmiş depolama hesabı adını belirtin 127.0.0.1:10000:

GET yöntem talebi URI 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

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

Parametre Description
snapshot Optional. Snapshot parametresi, mevcut olduğunda alınacak blob snapshot'u belirleyen opak DateTime bir değerdir. Blob snapshot'larla çalışma hakkında daha fazla bilgi için bkz. Create a snapshot of a blob.
versionid İsteğe bağlı, sürüm 2019-12-12 ve üzeri. Parametre, versionid mevcut olduğunda alınacak blob versiyonunu belirleyen opak DateTime bir değerdir.
timeout Optional. Parametre timeout saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama işlemleri için zaman aşımını ayarlayın.

İstek başlıkları

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

İstek başlığı Description
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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 depolamaistekleri yetkilendirme .
x-ms-version Tüm yetkili talepler için gereklidir. Anonim talepler için isteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Eğer bu başlık anonim bir istek için çıkarılırsa, hizmet isteği 2009-09-19 sürümüyle çalıştırır. Daha fazla bilgi için bkz . Azure Depolama hizmetleri için sürüm oluşturma.
Range Optional. Blobun baytlarını sadece belirtilen aralıkta döndür.
x-ms-range Optional. Blobun baytlarını sadece belirtilen aralıkta döndür. Eğer her ikisi Range de belirtilirse x-ms-range , hizmet 'nin değerini x-ms-rangekullanır. Hiçbir aralık belirtilmediyse, tüm blob içeriği geri döner. Daha fazla bilgi için, Blob Depolama işlemleri için aralık başlığını belirt bkz.
x-ms-lease-id: <ID> Optional. Bu başlık belirtilmişse, işlem yalnızca aşağıdaki her iki koşul da sağlandığında gerçekleştirilir:

- Blob'un kira sözleşmesi şu anda geçerlidir.
- İstekte belirtilen kira kimliği, blobun kira kimliğiyle eşleşiyor.

Bu başlık belirtilirse ama bu koşullardan biri karşılanmazsa, istek başarısız olur ve Get Blob işlem durum kodu 412 (Ön Koşul Başarısız Oldu) ile başarısız olur.
x-ms-range-get-content-md5: true Optional. Bu başlık başlıkla birlikte ayarlandığında true ve belirtildiğinde Range , hizmet aralığın 4 mebibayttan (MiB) küçük veya daha az olması koşuluyla aralığın MD5 hash'ini döndürür.

Başlık belirtilmişse Range , hizmet durum kodu 400 (Kötü İstek) döndürür.

Başlık aralık 4 MiB'yi aştığında ayarlanmışsa true , hizmet durum kodu 400 (Kötü İstek) döner.
x-ms-range-get-content-crc64: true Optional. Bu başlık başlıkla birlikte ayarlandığında true ve belirtildiğinde Range , hizmet aralığın CRC64 hash'ini döner; tabii ki aralık 4 MiB'den az veya eşit olduğunda.

Başlık belirtilmişse Range , hizmet durum kodu 400 (Kötü İstek) döndürür.

Başlık aralık 4 MiB'yi aştığında ayarlanmışsa true , hizmet durum kodu 400 (Kötü İstek) döner.

Hem x-ms-range-get-content-md5 başlık hem x-ms-range-get-content-crc64 de başlık varsa, istek 400 (Kötü İstek) ile başarısız olur.

Bu başlık, 2019-02-02 ve sonraki sürümlerde desteklenmektedir.
Origin Optional. İsteğin hangi kaynaktan verildiğini belirtir. Bu başlığın varlığı, yanıtta çapraz kaynak paylaşımı (CORS) başlıklarına yol açar.
x-ms-upn Optional. 2023-11-03 ve sonraki sürümler. Hiyerarşik isim alanı etkin olan hesaplar için geçerli. Eğer doğruysa, , x-ms-ownerx-ms-group ve yanıt başlıklarında x-ms-acldöndürülen kullanıcı kimliği değerleri Microsoft Entra nesne ID'lerinden Kullanıcı Başlıca Adlarına dönüştürülür. Değer yanlışsa, Microsoft Entra nesne ID'leri olarak dönerler. Varsayılan değer false. Grup ve uygulama nesne kimliklerinin çevrilmediğini unutmayın, çünkü benzersiz dost isimleri yoktur.
x-ms-client-request-id Optional. Depolama analitik kaydı etkinleştirildiğinde analiz kayıtlarına kaydedilen 1 kibibayt (KiB) karakter sınırı olan istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı aktiviteleri sunucu tarafından alınan taleplerle ilişkilendirmek için bu başlığı kullanmanızı şiddetle tavsiye ederiz. Daha fazla bilgi için Azure Depolama Analizi loging hakkında bölümüne bakınız.
x-ms-structured-body Optional. 2025-01-05 ve sonrası sürümler. Belirtilirse, hizmet blob içeriğini yapılandırılmış gövde formatında kodlanmış olarak döndürecektir. Bu başlığın değeri, mesaj şeması versiyonu ve özelliklerini içerir.

Şu anda desteklenen XSM/1.0; properties=crc64tek değer , yanıtın kodlanmış mesajda crc64 kontrol toplamı segmentlerini kullanacağını gösterir. Değer bu değerle eşleşmezse, işlem hata kodu 400 (Kötü İstek) ile başarısız olur.

Bu işlem ayrıca, belirli bir koşul sağlandığında blob'u okumak için koşullu başlıkların kullanılmasını destekler. Daha fazla bilgi için, Blob Depolama işlemleri için koşullu başlıklar belirt bkz.

İstek başlıkları (müşteri tarafından sağlanan şifreleme anahtarları)

2019-02-02 sürümü itibarıyla, müşteri tarafından sağlanan bir anahtarla şifrelenmiş bir blob okuma talebinde aşağıdaki başlıkları belirtebilirsiniz. Müşteri tarafından sağlanan anahtarla (ve ilgili başlık setiyle şifreleme) isteğe bağlıdır. Bir blob daha önce müşteri tarafından sağlanan bir anahtarla şifrelenmişse, okuma işlemini başarıyla tamamlamak için bu başlıkları isteğe eklemelisiniz.

İstek başlığı Description
x-ms-encryption-key Gerekli. Base64 kodlu AES-256 şifreleme anahtarı.
x-ms-encryption-key-sha256 Optional. Base64 kodlu SHA256 şifreleme anahtarının hash'i.
x-ms-encryption-algorithm: AES256 Gerekli. Şifreleme için kullanılacak algoritmayı belirler. Bu başlığın değeri olmalıdır AES256.

İstek içeriği

Yok.

Yanıt

Yanıt, bir HTTP durum kodu, bir dizi yanıt başlığı 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 durum kodu 200 (OK) döndürür.

Belirli bir aralığı başarılı bir şekilde okumak için yapılan işlem, durum kodu 206'yı (Kısmi İçerik) döndürür.

Durum kodları hakkında daha fazla bilgi için bkz. Durum ve hata kodları.

Yanıt başlıkları

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 başlıklar HTTP/1.1 protokol belirtimine uygundur.

Sözdizimi Description
Last-Modified Blobun en son değiştirildiği tarih/saat. Tarih biçimi RFC 1123'e uygundur.

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 2017-11-09 ve sonrası sürümler. Blob'un oluşma tarihi/saati. Tarih biçimi RFC 1123'e uygundur.
x-ms-meta-name:value Bu topa kullanıcı tanımlı meta veri olarak ilişkilendirilen bir isim-değer çiftleri kümesi.
x-ms-tag-count 2019-12-12 ve sonrası sürümler. Eğer blob'un herhangi bir etiketi varsa, bu başlık blob'ta saklanan etiket sayısını döndürür. Blob'da etiket yoksa başlık geri dönmez.
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 İstemci blobun alt kümesini talep ettiğinde geri dönen bayt aralığını istek başlığını ayarlayarak Range gösterir.
ETag Operasyonları koşullu olarak gerçekleştirebileceğiniz bir değer içerir. Daha fazla bilgi için, Blob Depolama işlemleri için koşullu başlıklar belirt bkz. İstek sürümü 2011-08-18 veya üzeriyse, ETag değeri tırnak işaretleri içine alınır.
Content-MD5 Blobun MD5 hash'ı varsa ve bu Get Blob işlem tam blob'u okumaksa, bu yanıt başlığı geri döner, böylece istemci mesaj içeriği bütünlüğünü kontrol edebilir.

2012-02-12 ve sonraki sürümlerde, Put Blob istek MD5 başlığı içermese Put Blob bile blok blobun MD5 hash değerini ayarlar.

Eğer talep belirli bir aralığı okunacaksa ve bu x-ms-range-get-content-md5 aralık , olarak ayarlanmışsa true, talep aralığı için MD5 hash'i döner; tabii ki aralık boyutu 4 MiB'den az veya eşit ise.

Bu koşul kümelerinden hiçbiri ise true, başlık için bir değer döndürülmez Content-MD5 .

Başlık x-ms-range-get-content-md5 olmadan Range belirtilirse, hizmet durum kodu 400 (Kötü İstek) döner.

Eğer x-ms-range-get-content-md5 aralık 4 MiB'yi aştığında ayarlanırsa true , hizmet durum kodu 400 (Kötü İstek) döner.
x-ms-content-crc64 Eğer talep belirli bir aralığı okunacaksa ve bu x-ms-range-get-content-crc64 aralık , olarak ayarlanmışsa true, talep aralığı için CRC64 hash'i döner; tabii ki aralık boyutu 4 MiB'den az veya eşit olsun.

Başlık x-ms-range-get-content-crc64 olmadan Range belirtilirse, hizmet durum kodu 400 (Kötü İstek) döner.

Eğer x-ms-range-get-content-crc64 aralık 4 MiB'yi aştığında ayarlanırsa true , hizmet durum kodu 400 (Kötü İstek) döner.
Content-Encoding İstek başlığı için belirtilen Content-Encoding değeri döndürür.
Content-Language İstek başlığı için belirtilen Content-Language değeri döndürür.
Cache-Control Eğer başlık daha önce blob için belirtilmişse geri gönderilir.
Content-Disposition 2013-08-15 ve sonraki sürümlere yönelik talepler için geri gönderildi. Bu başlık, başlık için x-ms-blob-content-disposition belirtilen değeri döndürür.

Yanıt başlığı alanı Content-Disposition , yanıt yükünün nasıl işleneceğine dair ek bilgi verir ve ek meta veriler eklemek için kullanılabilir. Örneğin, başlık ayarlıysa attachment, kullanıcı ajanının cevabı göstermemesi gerektiğini gösterir. Bunun yerine, belirtilen blob adı dışında bir dosya adıyla Kaydet Gibi bir diyalog gösterir.
x-ms-blob-sequence-number Sayfa blobu için geçerli sıra numarası.

Bu başlık blok bloblar veya ekler bloblar için geri dönmez.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Blob'un tipini geri döndürüyor.
x-ms-copy-completion-time: <datetime> 2012-02-12 ve sonrası sürümler. Bu lekenin hedef nokta olduğu son Copy Blob operasyonun sona erme zamanı. Bu değer tamamlanan, durdurulan veya başarısız kopyalama girişiminin zamanını belirtebilir. Bu başlık, bir kopya beklemekteyse, bu blob bir Copy Blob işlemde hiç hedef olmamışsa veya bu blob, , veya , Copy BlobSet Blob PropertiesPut Blobkullanılan sona Put Block List ermiş bir işlemden sonra değiştirilmişse, görünmez.
x-ms-copy-status-description: <error string> 2012-02-12 ve sonrası sürümler. Sadece ise x-ms-copy-statusfailed veya pendinggöründüğünde görünür. Son önemli veya önemli olmayan kopyalama işlemi hatasının nedenini açıklar. Bu başlık, bu blob hiçbir zaman bir Copy Blob işlemin hedefi olmamışsa veya , , veya Copy Blob'yi kullanan bir işlemden Set Blob PropertiesPut BlobPut Block Listsonra değiştirilmişse, bu başlık görünmez.
x-ms-copy-id: <id> 2012-02-12 ve sonrası sürümler. Bu blobun hedef blob olduğu son deneme Copy Blob işlemi için bir dizi tanımlayıcısı. Bu başlık, bu blob hiçbir zaman bir Copy Blob işlemin hedefi olmamışsa veya , , veya Copy Blob'yi kullanan bir işlemden Set Blob PropertiesPut BlobPut Block Listsonra değiştirilmişse, bu başlık görünmez.
x-ms-copy-progress: <bytes copied/bytes total> 2012-02-12 ve sonrası sürümler. Kopyalanan bayt sayısını ve son deneme Copy Blob işleminde kaynak içindeki toplam baytları içerir; bu blob hedef blob olarak görülür. 0'dan bayta Content-Length kadar kopyalanmış gösterebilir. Bu başlık, bu blob hiçbir zaman bir Copy Blob işlemin hedefi olmamışsa veya , , veya Copy Blob'yi kullanan bir işlemden Set Blob PropertiesPut BlobPut Block Listsonra değiştirilmişse, bu başlık görünmez.
x-ms-copy-source: url 2012-02-12 ve sonrası sürümler. Son deneme Copy Blob işlemi sırasında kullanılan kaynak blob veya dosyayı belirten, bu blobun hedef blob olduğu yerde, 2 KiB'ye kadar uzunluğunda bir URL. Bu başlık, bu blob hiçbir zaman bir Copy Blob işlemin hedefi olmamışsa veya , , veya Copy Blob'yi kullanan bir işlemden Set Blob PropertiesPut BlobPut Block Listsonra değiştirilmişse, bu başlık görünmez.

Bu başlıkta dönen URL, kaynak blob'un kopyalama işleminde kullanılan tüm istek parametrelerini içerir. URL bir Paylaşılan Erişim İmzası (SAS) belirteci içeriyorsa, imza (sig parametre) dahil edilmez.
x-ms-copy-status: <pending | success | aborted | failed> 2012-02-12 ve sonrası sürümler. x-ms-copy-id ile tanımlanan kopyalama işleminin durumu, aşağıdaki değerlerle:

- success: Kopya başarıyla tamamlandı.
- pending: Kopya devam ediyor. Aralıklı, ölümcül olmayan hataların kopya ilerlemesini yavaşlatıp yavaşlatmadığını ama başarısızlığa neden olup olmadığını kontrol x-ms-copy-status-description edin.
- aborted: Kopya ile sona erdi Abort Copy Blob.
- failed: Kopya başarısız oldu. Arıza detayları için x-ms-copy-status-description sayfasına bakınız.

Bu başlık, eğer bu blob hiçbir zaman bir Copy Blob operasyonun hedefi olmamışsa veya tamamlanmış Copy Blob bir işlemden sonra değiştirilmişseSet Blob PropertiesPut Blob, , veya Put Block List.
x-ms-lease-duration: <infinite | fixed> 2012-02-12 ve sonrası sürümler. Bir blob kiralandığında, kiralamanın sonsuz mu yoksa sabit bir süre mi olduğunu belirtir.
x-ms-lease-state: <available | leased | expired | breaking | broken> 2012-02-12 ve sonrası sürümler. Blobun kira durumu.
x-ms-lease-status:<locked | unlocked> Blobun geçerli kira durumu.
x-ms-request-id Yapılan talebi benzersiz şekilde tanımlar ve isteği sorun gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlem sorunlarını giderme.
x-ms-version Talebi çalıştırmak için kullanılan Blob Depolama sürümünü gösterir. 2009-09-19 ve sonrasında yapılan istekler için dahil edilmiştir.

Bu başlık, konteyner Blob Depolama sürüm 2009-09-19 kullanılarak halka açık erişim için işaretlenmişse, belirli bir sürüm olmadan anonim istekler için de döner.
Accept-Ranges: bytes Hizmetin kısmi blob içeriğine yönelik istekleri desteklediğini gösterir. 2011-08-18 ve sonrasında yapılan istekler için ve SDK sürüm 1.6 ve sonrasında 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 başlık Origin içeriyorsa ve CORS eşleşme kuralı ile etkinleştirilmişse geri gönderilir. Bu başlık, eşleşme durumunda orijin isteği başlığının değerini döndürür.
Access-Control-Expose-Headers İstek başlık Origin içeriyorsa ve CORS eşleşme kuralı ile etkinleştirilmişse geri gönderilir. İstemci veya isteği veren kişiye sunulacak yanıt başlıklarının listesini döndürür.
Vary CORS kuralları belirlendiğinde başlık değeriyle Origin döner. Detaylar için Azure Depolama hizmetleri için CORS desteğine bakınız.
Access-Control-Allow-Credentials İstek başlık Origin içeriyorsa ve tüm orijinlere izin vermeyen bir eşleşme kuralı ile CORS etkinleştirilmişse geri gönderilir. Bu başlık olarak trueayarlanacak.
x-ms-blob-committed-block-count Blobda bulunan işlenen blokların sayısı. Bu üst bilgi yalnızca ekleme blobları için döndürülür.
x-ms-server-encrypted: true/false 2015-12-11 ve sonraki sürümler. Bu başlığın true değeri, blob veri ve uygulama meta verileri belirtilen algoritma kullanılarak tamamen şifrelenmişse ayarlanır. Aksi takdirde, değer şu şekilde ayarlanır false (blob şifrelenmemişse veya blobun veya uygulama meta verilerinin sadece bazı bölümleri şifrelenmişse).
x-ms-encryption-key-sha256 2019-02-02 ve sonrası sürümler. Bu başlık, blob müşteri tarafından sağlanan bir anahtarla şifrelenmişse geri döner.
x-ms-encryption-context 2021-08-06 ve sonrası sürümler. Ş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 2019-02-02 ve sonrası sürümler. Bu başlık, blob şifreleme kapsamıyla şifrelenmişse geri döner.
x-ms-access-tier Sürüm 2017-04-17 ve üzeri. Premium Depolama hesabındaki sayfa blobu katmanı veya Blob Depolama veya genel amaçlı v2 hesabındaki blok blobu katmanı. İzin verilen premium sayfa blob katmanlarının listesi için bkz. Yüksek performanslı Premium Depolama ve VM'ler için yönetilen diskler. Blob depolama veya genel amaçlı v2 hesabı için geçerli değerler Hot, Cool, Cold ve Smart.
Not:Cold katmanı sürüm 2021-12-02 ve üzeri için desteklenir. Smart Tier, 2026-02-06 ve sonrasında olan sürümler için desteklenmekte olup, şu anda halka açık önizleme aşamasındadır.
Standart blob hesabı blob seviye katmanlama hakkında detaylı bilgi için bkz. Blob depolama katmanları.
x-ms-access-tier-inferred: true Sürüm 2017-04-17 ve üzeri. Yalnızca Premium Depolama hesabındaki sayfa blobları için. Erişim katmanı blob üzerinde açıkça ayarlanmamışsa, katman içerik uzunluğuna göre çıkarılır ve bu üst bilgi .true Blob Depolama veya genel amaçlı v2 hesabındaki blok blobları için, blobun erişim katmanı ayarlanmamışsa, depolama hesabı özelliklerinden katmanı çıkarabilirsiniz. Bu üst bilgi yalnızca blok blobu katmanı çıkarsanırsa ayarlanır.
x-ms-smart-access-tier Bu başlık yalnızca 2026-02-06 sürümüyle ve sonrasında seviyedeki Smart lekelere karşı yapılan talepler için geri gönderilir. Geçerli değerler: Hot, Cool ve Cold. Standart blob hesabı blob seviye katmanlama hakkında detaylı bilgi için bkz. Blob depolama katmanları.
x-ms-access-tier-change-time Sürüm 2017-04-17 ve üzeri. Nesnede katmanın en son ne zaman değiştirildiğini gösterir. Bu üst bilgi yalnızca blok blobu üzerinde bir katman ayarlanmışsa döndürülür. Tarih biçimi RFC 1123'e uygundur. Daha fazla bilgi için bkz. üst bilgilerde tarih/saat değerlerini temsil edin. Standart blob hesabı blob seviyesinde katmanlama hakkında daha fazla bilgi için Blob depolama katmanları sayfasına bakınız.
x-ms-blob-content-md5 2016-05-31 ve sonraki sürümler. Eğer blobun MD5 hash'i varsa ve istek bir aralık başlığı (Aralık veya x-ms-aralık) içeriyorsa, bu yanıt başlığı tüm blobun MD5 değerinin değeriyle döner. Bu değer, Content-MD5 başlığında geri dönen değere eşit olabilir veya eşit olmayabilir; MD5 başlığı istenen aralıktan hesaplanır.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun 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 x-ms-client-request-id üst bilgisinin değerine eşittir. Eğer x-ms-client-request-id başlık istekte yoksa, bu başlık yanıtta da yoktur.
x-ms-last-access-time 2020-02-10 ve sonrası sürüm. Depolama hesabının son erişim süresi takip politikasına göre blobun verilerine en son ne zaman erişildiğini gösterir. Depolama hesabında son erişim süresi takip politikası yoksa veya politika devre dışı bırakılıyorsa başlık iade edilmez. Depolama hesabının son erişim süresi takip politikasını ayarlama hakkında bilgi için Blob Service API'ye bakınız.
x-ms-blob-sealed 2019-12-12 ve sonrası sürümler. Sadece ekle toplar için geri döndüm. Eğer ekleyici blob mühürlenmişse, değer .true Daha fazla bilgi için Bakın Ekle Mühür
x-ms-immutability-policy-until-date 2020-06-12 ve sonrası sürümler. Blob'da belirlenen tarihe kadar olan tutma süresini belirtir. Bu, blobun değiştirilmekten veya silinmekten korunabileceği tarihtir. Blob'a bir değişmezlik politikası ayarlanmışsa geri gönderilir. Bu başlığın değeri RFC1123 formatındadır.
x-ms-immutability-policy-mode: unlocked/locked 2020-06-12 ve sonrası sürümler. Blob'a bir değişmezlik politikası ayarlanmışsa iade edilir. Değerler ve unlockedşeklindedirlocked. unlocked kullanıcının tarihe kadar saklama süresini artırarak veya azaltarak politikayı değiştirebileceğini gösterir. locked bu eylemlerin yasak olduğunu gösterir.
x-ms-legal-hold: true/false 2020-06-12 ve sonrası sürümler. Bu başlık blob üzerinde yasal bir tutma yoksa geri dönmez. Bu başlığın değeri, blob yasal bir tutma içeriyorsa ve değeri ise trueolarak ayarlanırtrue. Aksi takdirde, false eğer blob yasal bir tutma içeriyorsa ve değeri ise falsedeğer olarak ayarlanır.
x-ms-owner 2020-06-12 ve sonrası sürümleri, yalnızca hiyerarşik isim alanı etkinleştirilmiş hesaplar için. Dosyanın veya dizinin sahibi-kullanıcısını döndürür.
x-ms-group 2020-06-12 ve sonrası sürümleri, yalnızca hiyerarşik isim alanı etkinleştirilmiş hesaplar için. Dosyanın veya dizinin sahibi grubunu döndürür.
x-ms-permissions 2020-06-12 ve sonrası sürümleri, yalnızca hiyerarşik isim alanı etkinleştirilmiş hesaplar için. Dosya veya dizinde kullanıcı, grup ve diğer için belirlenen izinleri döndürür. Her bireysel izin formatındadır [r,w,x,-]{3} .
x-ms-acl 2023-11-03 ve sonraki sürümler. Sadece hiyerarşik isim alanı etkin olan hesaplar için. Dosya veya dizinde kullanıcı, grup ve diğer kişiler için ayarlanmış erişim ve varsayılan erişim kontrol listesinin birleşik listesini döndürür. Her erişim kontrol girişi (ACE), bir kapsam, bir tür, bir kullanıcı veya grup tanımlayıcısı ve formatındaki [scope]:[type]:[id]:[permissions]izinlerden oluşur. Kapsam, default ACE'nin bir dizinin varsayılan ACL'sine ait olduğunu gösterir; aksi takdirde kapsam örtüktür ve ACE erişim ACL'sine aittir. Her bireysel izin formatındadır [r,w,x,-]{3} .
x-ms-resource-type 2020-10-02 ve sonrası sürümler, yalnızca hiyerarşik isim alanı etkin olan hesaplar için. Yol için kaynak tipini döndürür, bu tür veya filedirectoryya da olabilir.

Yanıt başlıkları (yapılandırılmış gövde)

2025-01-05 sürümünden itibaren, istek geçerli x-ms-structured-body bir başlık gönderirse aşağıdaki başlıklar geri gönderilecektir.

Yanıt üst bilgisi Description
Content-Length Kodlanan yanıtın uzunluğu olur (sadece geri dönen blob içeriğinin uzunluğu değil).
x-ms-structured-body Bu başlığın değeri, talebe gönderilen değere eşittir ve şu anda bu değer olarak olmalıdır XSM/1.0; properties=crc64.
x-ms-structured-content-length Bu başlığın değeri, geri dönen blob içeriğinin uzunluğudur ve mesaj kodlaması nedeniyle her zaman başlık Content-Length değerinden daha küçük olur.

Yanıtın içeriği

Yanıt bedeni, 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>

Authorization

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. aşağıda açıklandığı gibi Get Blob işlemini yetkileyebilirsiniz.

Ö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 bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra Id tarafından doğrulanır. Daha sonra belirteç, 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 .

Permissions

Aşağıda bir Microsoft Entra kullanıcısı, grubu, yönetilen kimliği veya hizmet sorumlusunun Get Blob işlemini çağırması 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.

Açıklamalar

Bir sayfa blobu için, henüz içeriği olmayan veya temizlenmiş bir sayfa aralığı üzerinde yapılan Get Blob bir işlem, o baytlar için sıfır döner.

Aralık belirtilmemiş bir sayfa blobunda çağrı Get Blob yaparsanız, servis başlık için belirtilen değere x-ms-blob-content-length kadar sayfa aralığını döndürür. İçerik eksikliği olan sayfalar için servis, bu baytlar için sıfır döndürür.

Bir ekleme blobu için Get Blob işlem başlığı x-ms-blob-committed-block-count döndürür. Bu başlık, blob'taki belirlenmiş blok sayısını gösterir. Blok x-ms-blob-committed-block-count blobları veya sayfa blobları için başlık geri dönmez.

Bir Get Blob operasyonun tamamlanması için MiB başına iki dakika izin verilir. Operasyon ortalama başına MiB başına iki dakikadan uzun sürüyorsa, işlem zaman döner.

Başlık x-ms-version , özel bir konteynere ait bir blob'u almak için gereklidir. Eğer blob, tam veya kısmi halka açık erişim için mevcut bir konteynere aitse, herhangi bir istemci onu bir sürüm belirtmeden okuyabilir; Hizmet sürümü, kamuya açık bir konteynere ait bir blob'u almak için gerekli değildir. Daha fazla bilgi için, Konteynerlere ve bloblara erişimi kısıtla.

Arşivlenmiş bir blok blobunda yapılan Get Blob bir işlem başarısız olur.

Kopyalama işlemleri

Bir Copy Blob işlemin tamamlanıp tamamlanmadığını belirlemek için, hedef blobun başlık değerinin x-ms-copy-id orijinal çağrı Copy Blobtarafından sağlanan kopyalama kimliğiyle eşleşip eşleşmediğinden emin olun. Eşleşme, başka bir uygulamanın kopyayı durdurup yeni Copy Blob bir işlem başlatmamasını sağlar. Sonra, başlığı kontrol edin x-ms-copy-status: success . Ancak, bir blob'daki tüm yazma işlemlerinin , LeasePut Page, ve Put Block işlemlerin blob'tan tüm x-ms-copy-* özellikleri kaldırdığını unutmayın. Bu özellikler, 2012-02-12 öncesinde Blob Depolama sürümlerini kullanan işlemler tarafından da kopyalanmaz Copy Blob .

Uyarı

Başlıkta x-ms-copy-source döndürülen URL, kaynak blob'un kopyalama işleminde kullanılan istek parametrelerini içerir. Kaynak bloba erişmek için Paylaşılan Erişim İmzası (SAS) belirtecesi kullanıldıysa, hedef blob'da çağrıldığında SAS belirteçeği başlıkta x-ms-copy-source görünürGet Blob, ancak imza (sigsorgu parametresi) kaldırılır.

x-ms-copy-status: failed Yanıtta göründüğünde, x-ms-copy-status-description başarısızlıkla Copy Blob ilgili daha fazla bilgi içerir.

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

Bileşen Description
HTTP durum kodu Arızayı belirten standart 3 haneli tam sayı.
Hata kodu Hatayı tanımlayan anahtar kelime, Azure <tarafından ErrorCode> öğesinde sağlanır. Eğer ErrorCode< öğesi >görünmezse, HTTP spesifikasyonundaki 3 haneli HTTP durum koduyla ilişkilendirilen standart hata metni içeren bir anahtar kelime kullanılır. Common REST API hata kodlarına bakınız.
Bilgi Başarısızlığın ayrıntılı bir açıklaması, tırnak içinde eklenmiştir.

x-ms-copy-status Yaygın arıza 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 yüzden metininizle tam olarak eşleşmeyebilir.

Scenario x-ms-copy-status değeri x-ms-copy-status-description değeri
Kopyalama işlemi başarıyla tamamlandı. başarı empty
Kullanıcı kopyalama işlemi tamamlanmadan önce iptal etti. Iptal empty
Kopyalama işlemi sırasında kaynak blob'tan okuma sırasında bir hata yaşandı, ancak işlem tekrar denenecek. bekleniyor 502 BadGateway "Kaynak okunurken yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Başarısızlık zamanı: <zaman>"
Bir kopyalama işleminin hedef blob'una yazıldığında bir hata yaşandı, ancak işlem tekrar denenecek. bekleniyor 500 InternalServerError "Yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Başarısızlık zamanı: <zaman>"
Kopyalama işleminin kaynak blobundan okunurken kurtarılamaz bir hata oluştu. başarısız 404 ResourceNotFound "Kaynağı okunurken kopya hatalandı."

Not: Servis bu temel hatayı bildirdiğinde, eleman içinde ResourceNotFound geri dönerErrorCode. Yanıtta herhangi ErrorCode bir eleman görünmediyse, HTTP durumunun standart bir dizi temsili (örneğin NotFound, gibi) görünür.
Tüm kopyalama işlemlerini sınırlayan zaman aşımı süresi doldu. (Şu anda ara verme süresi 2 hafta.) başarısız 500 OperationCancelled "Kopya izin verilen en uzun süreyi aştı."
Kopyalama işlemi kaynaktan okunurken çok sık başarısız oluyordu ve denemeler ile başarılar oranını minimum düzeyde 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 Blobun verilerine erişim zamanı depolama hesabının son erişim süresi takip politikasına göre takip eder. Bir blobun meta verisine erişmek, son erişim süresini değiştirmez.

Billing

Fiyatlandırma istekleri, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından Blob Depolama API'lerini kullanan istemcilerden kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk ettirir. İşlem türü, hesabın nasıl ücretlendirileceğini 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:

Operation Depolama hesabı türü Faturalama kategorisi
Blob'u edinin Premium blok blob
Standart Genel Amaçlı Versiyon 2
Standart genel amaçlı v1		 Okuma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz.

Ayrıca bakınız

Azure Depolama isteklerini yetkilendirme
Durum ve hata kodları
blob depolama hata kodları
Blob Depolama işlemleri için zaman aşımları ayarlanır

  • Last updated on