BLOB özelliklerini Al

Makale
03/16/2023

İşlem, Get Blob Properties blob için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Blobun içeriğini döndürmez.

İstek

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

HEAD 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.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:

HEAD yöntemi istek URI'si	HTTP sürümü
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	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 parametreleri belirtebilirsiniz:

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ü oluşturma.
`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. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-lease-id: <ID>`	İsteğe bağlı. Bu üst bilgi belirtilirse, `Get Blob Properties` 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 koşullardan biri karşılanmazsa istek başarısız olur ve `Get Blob Properties` işlem 412 (Önkoşul Başarısız Oldu) durum koduyla başarısız olur.
`x-ms-upn`	İsteğe bağlı. Sürüm 2020-06-12 ve üzeri. Hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir. içinde `x-ms-owner` döndürülen kullanıcı kimliği değerleri true ise, bunlar Microsoft Entra nesne kimliklerinden kullanıcı asıl adlarına dönüştürülür. Değerler 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 blob özelliklerini ve meta verileri döndürmek 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şleminin başarıyla tamamlanabilmesi için bu üst bilgileri isteğe 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 ve bir dizi yanıt üst bilgisi 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 tabloda yer alan ü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 üst bilgisi	Description
`Last-Modified`	Blob'un en son değiştirildiği tarih/saat. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin. 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. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin.
`x-ms-meta-name:value`	Bu blobla ilişkili kullanıcı tanımlı meta verilerine karşılık gelen ad-değer çiftleri kümesi.
`x-ms-tag-count`	Sürüm 2019-12-12 ve üzeri. Blobun herhangi bir etiketi varsa, blobda depolanan etiket sayısını döndürür. Blobda etiket yoksa bu üst bilgi döndürülemez.
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	Blob tü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şlemde hedef olmadıysa veya , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`sonuçlanan `Copy Blob` bir 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 `pending`olduğunda `x-ms-copy-statusfailed` görünür. Önemli veya önemli olmayan kopyalama işlemi hatasının nedenini açıklar. Bu blob hiçbir zaman bir `Copy Blob` işlemdeki hedef olmadıysa veya bu blob , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`sonlandı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, denenen `Copy Blob` son işlemin dize tanımlayıcısı. Bu blob hiçbir zaman bir `Copy Blob` işlemdeki hedef olmadıysa veya bu blob , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`sonlandı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 bayta kadar `Content-Length` gösterebilir. Bu blob hiçbir zaman bir `Copy Blob` işlemdeki hedef olmadıysa veya bu blob , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`sonlandı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 blob'un hedef blob olduğu son deneme `Copy Blob` işleminde kullanılan kaynak blobu belirten en fazla 2 KiB uzunluğunda bir URL. Bu blob hiçbir zaman bir `Copy Blob` işlemdeki hedef olmadıysa veya bu blob , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`sonlandırılan `Copy Blob` bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.
`x-ms-copy-status: <pending \\| success \\| aborted \\| failed>`	Sürüm 2012-02-12 ve üzeri. Şu değerlerle x-ms-copy-id tarafından 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 ilerlemesini engellenip engellenmediğini ancak hataya neden olup olmadığını denetleyin `x-ms-copy-status-description` . - `aborted`: Kopyalama, tarafından `Abort Copy Blob`sonlandı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şlemdeki hedef olmadıysa veya bu blob , `Put Blob`veya `Put Block List`kullanan `Set Blob Properties`tamamlanmış `Copy Blob` bir işlemden sonra değiştirildiyse bu üst bilgi görünmez.
`x-ms-incremental-copy: true`	Sürüm 2016-05-31 ve üzeri. Blob artımlı bir kopyalama blobuysa dahil edilir.
`x-ms-copy-destination-snapshot:<datetime>`	Sürüm 2016-05-31 ve üzeri. Blob, artımlı kopyalama blobu veya artımlı kopyalama anlık görüntüsü ise (başarılıysa `x-ms-copy-status` ) dahildir. Bu blob için son başarılı artımlı kopyalama anlık görüntüsünün anlık görüntü zamanı.
`x-ms-lease-duration: <infinite \\| fixed>`	Bir blob kiralandığında, kiralamanın sonsuz mu yoksa sabit süreli mi olduğunu belirtir. Sürüm 2012-02-12 ve üzerini kullanan istekler için dahildir.
`x-ms-lease-state: <available \\| leased \\| expired \\| breaking \\| broken>`	Blobun kira durumu. Sürüm 2012-02-12 ve üzerini kullanan istekler için dahildir.
`x-ms-lease-status:<locked\\| unlocked>`	Blobun kira durumu.
`Content-Length`	Blobun bayt cinsinden boyutu. Sayfa blobu için bu üst bilgi, blob ile depolanan üst bilginin değerini `x-ms-blob-content-length` döndürür.
`Content-Type`	Blob için belirtilen içerik türü. Hiçbir içerik türü belirtilmezse, varsayılan içerik türü olur `application/octet-stream`.
`Etag`	ETag, iş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`	`Content-MD5` Blob için üst bilgi ayarlandıysa, istemcinin ileti içerik 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 değerini ayarlar.
`Content-Encoding`	`Content-Encoding` İstek üst bilgisi daha önce blob için ayarlandıysa, bu üst bilgide bu değer döndürülür.
`Content-Language`	`Content-Language` İstek üst bilgisi daha önce blob için ayarlandıysa, bu üst bilgide bu değer döndürülür.
`Content-Disposition`	`Content-Disposition` İstek üst bilgisi daha önce blob için ayarlandıysa, bu değer 2013-08-15 ve sonraki sürümlere yönelik istekler için bu üst bilgide döndürülü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 de kullanılabilir. Örneğin, üst bilgi olarak `attachment`ayarlandıysa, kullanıcı aracısının yanıtı görüntülememesi gerektiğini, bunun yerine farklı kaydet iletişim kutusunu göstermesi gerektiğini gösterir.
`Cache-Control`	`Cache-Control` İstek üst bilgisi daha önce blob için ayarlandıysa, bu üst bilgide bu değer döndürülür.
`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. Blok blobları için bu üst bilgi döndürülmüyor.
`x-ms-request-id`	Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz . API İşlemleri Sorunlarını Giderme.
`x-ms-version`	İsteği yürütmek için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür. 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.
`Date`	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
`Accept-Ranges: bytes`	Hizmetin kısmi blob içeriği isteklerini desteklediğini gösterir. Sürüm 2013-08-15 ve üzeri kullanılarak yapılan isteklere dahildir.
`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`	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 blob/uygulama meta verilerinin yalnızca bir bölümü şifrelenirse).
`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-access-tier`	Sürüm 2017-04-17 ve üzeri. Blob Depolama veya genel amaçlı v2 hesabındaki bir Premium Depolama hesabı veya blok blobu katmanındaki sayfa blobu katmanı. İzin verilen premium sayfa blob katmanlarının listesi için bkz. Vm'ler için yüksek performanslı Premium Depolama ve yönetilen diskler. Blob depolama veya genel amaçlı v2 hesabı için geçerli değerler , `Cool`, `Cold`ve `Archive`değerleridir`Hot`. Not:`Cold` katman, sürüm 2021-12-02 ve üzeri için desteklenir. Standart blob hesabı blok blob düzeyi katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv 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ı blobda açıkça ayarlı değilse, katman içerik uzunluğuna göre çıkarılır ve bu üst bilgi değeriyle `true`döndürülür. Blob Depolama veya genel amaçlı v2 hesabındaki blok blobları için, blobda erişim katmanı ayarlanmadıysa depolama hesabı özelliklerinden katmanı çıkarabilirsiniz. Bu üst bilgi yalnızca blok blobu katmanı çıkarsanırsa ayarlanır.
`x-ms-archive-status`	Sürüm 2017-04-17 ve üzeri. Blob depolama veya genel amaçlı v2 hesabı için geçerli değerler , `rehydrate-pending-to-cool`ve `rehydrate-pending-to-cold`değerleridir`rehydrate-pending-to-hot`. Blob yeniden dolduruluyorsa ve eksikse, bu üst bilgi döndürülür; bu da yeniden doldurmanın beklemede olduğunu gösterir ve hedef katmanı görüntüler. Standart blob hesabı blok blob düzeyinde katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv 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 blobundaki bir katman ayarlanmışsa döndürülür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin. Standart blob hesabı blok blob düzeyinde katmanlama hakkında daha fazla bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.
`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 varsa üst bilginin değerine `x-ms-client-request-id` eşittir ve değer en fazla 1.024 görünür ASCII karakterdir. İstekte `x-ms-client-request-id` üst bilgi yoksa, yanıtta bu üst bilgi yoktur.
`x-ms-rehydrate-priority`	Sürüm 2019-12-12 ve üzeri. Bir nesne yeniden doldurma bekleme durumundaysa, bu üst bilgi yeniden doldurma önceliğiyle döndürülür. Geçerli değerler şunlardır: `High`/`Standard`. Standart blob hesabı blok blob düzeyi katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.
`x-ms-or-{policy-id}_{rule-id}`	Sürüm 2019-12-12 ve üzeri, yalnızca blok blobları için döndürülür. `policy-id` depolama hesabındaki bir nesne çoğaltma ilkesinin tanımlayıcısını temsil eden bir GUID değeridir. `rule-id` , blob kapsayıcısı üzerindeki bir ilke kuralının tanımlayıcısını temsil eden bir GUID değeridir. Hesap -etkinse`ObjectReplication`, bu üst bilginin değeri blobun belirtilen ilke ve kural tanımlayıcılarıyla çoğaltma durumunu (veya `failed`) temsil eder`complete`.
`x-ms-or-policy-id`	Sürüm 2019-12-12 ve üzeri, yalnızca blok blobları için döndürülür. Hesap -etkinse `ObjectReplication`, bu üst bilginin değeri çoğaltmayı yöneten ilkeyi temsil eder.
`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 Depolama 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ğer doğru olacaktır. 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 'bekletme tarihine kadar' tarihini 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 ayarlandıysa, değişmezlik ilkesi modu döndürülür. Değerler şeklindedir `unlocked`/`locked`. `unlocked` , kullanıcının saklama tarihine kadar olan saklama süresini 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 bir saklama içeriyorsa ve değeri true ise bu üst bilginin değeri true olarak ayarlanır. Aksi takdirde, blob yasal bir ayrı tutma ve değeri false içeriyorsa değer false olarak ayarlanır.
`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 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 öğeler için ayarlanan izinleri döndürür. Her bir izin [r,w,x,-]{3} biçimindedir.
`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 `filedirectory`olabilir.
`x-ms-expiry-time`	Sürüm 2020-02-10 ve üzeri. Yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için. Blobda ayarlanan süre sonu süresini döndürür. Yalnızca süre sonu ayarlanmış dosyalar için döndürülür.

Yanıt gövdesi

Yok.

Örnek yanıt

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties verebilirsiniz.

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 veya hizmet sorumlusunun işlemi çağırması Get Blob Properties için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC eylemi:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
En az ayrıcalıklı yerleşik rol:Depolama Blob Veri Okuyucusu

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

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahipsiniz. İstemcinin hangi kaynağa erişebileceğini, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

İşlem Get Blob Properties üç tür paylaşılan erişim imzasını destekler: kullanıcı temsilcisi SAS, hizmet SAS'ı ve hesap SAS'ı.

En iyi güvenlik uygulaması olarak depolama hesabı anahtarı yerine daha kolay ele geçirilebilen Microsoft Entra kimlik bilgilerini kullanmanızı öneririz. Uygulama tasarımınız paylaşılan erişim imzaları gerektiriyorsa, mümkün olduğunda kullanıcı temsilcisi SAS'sini oluşturmak için Microsoft Entra kimlik bilgilerini kullanın.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hizmet SAS belirteci veya hesap SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtara izin vermemeyenin SAS belirteçlerini nasıl etkilediğini anlama.

Kullanıcı temsilcisi SAS

Kullanıcı temsilcisi SAS'sinin güvenliği Microsoft Entra kimlik bilgileriyle ve SAS için belirtilen izinlerle sağlanır.

Get Blob Properties Kapsayıcıya veya blob kaynağına devredilen bir SAS belirteci kullanarak işlemi çağırmak için kullanıcı temsilcisi SAS belirtecinin bir parçası olarak Okuma (r) izni gerekir.

Kullanıcı temsilcisi SAS'i hakkında daha fazla bilgi edinmek için bkz. Kullanıcı temsilcisi SAS'ı oluşturma.

Hizmet SAS'i

Hizmet SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hizmet SAS'ı blob depolama gibi tek bir Azure Depolama hizmetindeki bir kaynağa erişim yetkisi verir.

Get Blob Properties Kapsayıcıya veya blob kaynağına devredilen bir SAS belirteci kullanarak işlemi çağırmak için hizmet SAS belirtecinin bir parçası olarak Okuma (r) izni gerekir.

Hizmet SAS'i hakkında daha fazla bilgi edinmek için bkz. Hizmet SAS'ı oluşturma.

Hesap SAS'i

Bir hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS ise bir veya daha fazla depolama hizmetindeki kaynaklara erişim atar. Bir hizmet veya kullanıcı temsilcisi SAS aracılığıyla kullanılabilen tüm işlemler, hesap SAS'sı aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişim için temsilci seçme sırasında belirtilmesi gereken imzalı kaynak türü ve imzalı izinler gösterilir:

İşlem	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
BLOB özelliklerini Al	Blob (b)	Nesne (o)	Okuma (r)

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'ı oluşturma.

Açıklamalar

Bir Copy Blob işlemin tamamlanıp tamamlanmadığını belirlemek için, önce üst bilgi değerinin x-ms-copy-id ö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, Put Page, ve Put Block işlemleri dışında Leasebir blob üzerindeki tüm yazma işlemlerinin blobdan tüm x-ms-copy-* özellikleri kaldırdığını unutmayın. Bu özellikler, 2012-02-12'den önceki sürümleri kullanan işlemler tarafından Copy Blob da kopyalanmaz.

x-ms-copy-status-description hata hakkında Copy Blob daha fazla bilgi içerir. Değerler x-ms-copy-status-description 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. Daha fazla bilgi için bkz. Ortak 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

Aşağıdaki hata açıklamaları, sürüm değişikliği olmasa bile uyarı vermeden değişebilir, bu nedenle metin 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 ErrorCode> öğesinde <döndürür`ResourceNotFound`. Yanıtta hiçbir <ErrorCode> öğesi görünmediyse, HTTP durumunun standart dize gösterimi ( gibi `NotFound`) görünür.
Geçen tüm kopyalama işlemlerini sınırlayan zaman aşımı süresi. (Şu anda zaman aşımı süresi iki 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 en düşük başarı deneme 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 Properties faturalama kategorisi gösterilmektedir:

İşlem	Depolama hesabı türü	Faturalama kategorisi
BLOB özelliklerini Al	Premium blok blobu Standart genel amaçlı v2	Diğer işlemler
BLOB özelliklerini Al	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ı