Blob meta verilerini al

  • Makale
  • Okumak için 3 dakika

Get Blob Metadataİşlem, belirtilen blob veya anlık görüntü için Kullanıcı tanımlı tüm meta verileri döndürür.

İstek

Get Blob Metadataİstek aşağıdaki şekilde oluşturulabilir. HTTPS önerilir. Myaccount değerini depolama hesabınızın adıyla değiştirin:

GET veya HEAD yöntemi Istek URI 'SI HTTP sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&versionid=<DateTime>		 HTTP/1.1

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

Öykünülmüş depolama hizmetine karşı bir istek yaparken, öykünücü ana bilgisayar adını ve BLOB hizmeti bağlantı noktasını 127.0.0.1:10000 , ardından öykünülmüş depolama hesabı adı ile belirtin:

GET veya HEAD yöntemi Istek URI 'SI HTTP sürümü
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata HTTP/1.1

daha fazla bilgi için bkz. geliştirme ve test için Azure Depolama Emulator kullanma.

URI parametreleri

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

Parametre Açıklama
snapshot İsteğe bağlı. Anlık görüntü parametresi, varsa, DateTime alınacak blob anlık görüntüsünü belirten donuk bir değerdir. Blob anlık görüntüleri ile çalışma hakkında daha fazla bilgi için bkz. BLOB 'un anlık görüntüsünü oluşturma
versionid İsteğe bağlı, sürüm 2019-12-12 ve üzeri. VersionId parametresi, DateTime varsa, alınacak blob 'un sürümünü belirten donuk bir değerdir.
timeout İsteğe bağlı. timeoutParametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. BLOB hizmeti işlemleri Için zaman aşımlarını ayarlama.

İstek Üst Bilgileri

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

İstek Başlığı Açıklama
Authorization Gereklidir. Yetkilendirme şemasını, hesap adını ve imzayı belirtir. daha fazla bilgi için bkz. istekleri Azure Depolama 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. istekleri Azure Depolama yetkilendirme.
x-ms-version Anonim istekler için isteğe bağlı tüm yetkili istekler için gereklidir. 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 belirtilmişse, Get Blob Metadata işlem yalnızca aşağıdaki koşulların her ikisi karşılanırsa gerçekleştirilir:

-Blobun kirası Şu anda etkin.
-İstekte belirtilen kira KIMLIĞI Blobun ile eşleşiyor.

Bu koşulların her ikisi karşılanmazsa istek başarısız olur ve Get Blob Metadata işlem durum kodu 412 (Önkoşul başarısız) ile başarısız olur.
x-ms-client-request-id İsteğe bağlı. Depolama Analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen bir 1 KiB karakter sınırı ile, istemci tarafından oluşturulan, donuk bir değer sağlar. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı sağlamak için bu üst bilginin kullanılması kesinlikle önerilir. daha fazla bilgi için bkz. Depolama Analizi günlüğe kaydetme ve Azure günlüğe kaydetme: Depolama isteklerini izlemek için günlükleri kullanma.

Bu işlem, yalnızca belirtilen bir koşul karşılanırsa blob 'un meta veri işlemini almak için koşullu üstbilgilerin kullanılmasını da destekler. Daha fazla bilgi için bkz. BLOB hizmeti işlemleri Için koşullu üstbilgiler belirtme.

İstek üstbilgileri (müşteri tarafından belirtilen şifreleme anahtarları)

Sürüm 2019-02-02 ' den başlayarak, müşteri tarafından sağlanmış bir anahtarla şifrelenen bir blobu okuma isteğinde aşağıdaki üstbilgiler belirtilebilir. Bir müşteri tarafından sağlanmış anahtar (ve ilgili üst bilgi kümesi) ile şifreleme isteğe bağlıdır. Bir blob daha önce müşteri tarafından sağlanan anahtarla şifrelendiyse, okuma işlemini başarıyla tamamlamaya yönelik bu üst bilgilerin isteğe bağlı olması 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 üstbilginin 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 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 ayrıca ek standart HTTP üstbilgileri içerebilir. Tüm standart üstbilgiler http/1.1 protokol belirtimineuyar.

Yanıt üst bilgisi Açıklama
x-ms-meta-name:value Kapsayıcı için bir meta veri değeri döndürür.
Last-Modified Blobun son değiştirilme tarihi/saati. Tarih biçimi RFC 1123 ' i izler. Daha fazla bilgi için bkz. üst bilgilerdeki Date-Time değerlerinin temsili.

Blob 'un meta verilerinin veya özelliklerinin güncelleştirilmesi dahil olmak üzere blobu değiştiren herhangi bir işlem, Blobun son değiştirilme saatini değiştirir.
ETag Blob için ETag. İstek sürümü 2011-08-18 veya daha yeniyse, ETag değeri tırnak içinde olur.
x-ms-request-id Bu üst bilgi, yapılan isteği benzersiz bir şekilde tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API Işlemlerinde sorun giderme.
x-ms-version İsteği yürütmek için kullanılan blob hizmeti sürümünü belirtir. Bu üst bilgi, 2009-09-19 ve üzeri sürümler için yapılan istekler için döndürülür.

Bu üst bilgi, kapsayıcı, Blob hizmetinin 2009-09-19 sürümü kullanılarak genel erişim için işaretlenmişse, bir sürüm belirtilmeden anonim istekler için de döndürülür.
Date Hizmetin, yanıtın başlatıldığı saati gösteren bir UTC Tarih/saat değeri.
x-ms-client-request-id Bu üst bilgi, isteklerde ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üstbilginin değeri, x-ms-client-request-id istekte varsa üst bilgi değerine eşittir ve değer en fazla 1024 görünür ASCII karakterdir. x-ms-client-request-idÜst bilgi istekte yoksa, bu üst bilgi yanıtta mevcut olmayacaktır.

Yanıt gövdesi

Yok.

Yetkilendirme

Bu işlem, hesap sahibi veya blobu okuma izni olan bir paylaşılan erişim Imzası kullanan herkes tarafından gerçekleştirilebilir. Kapsayıcının ACL'si anonim erişime izin verecek şekilde ayarlanırsa, herhangi bir istemci bu işlemi çağırabilirsiniz.

Açıklamalar

Yok.

Ayrıca bkz.

Azure Depolama'a istekleri yetkilendirme
Durum ve Hata Kodları
Blob Hizmeti Hata Kodları