Blob Etiketlerini Al

  • Makale
  • Okumak için 3 dakika

işlemi Get Blob Tags belirtilen blob, sürüm veya anlık görüntü için tüm kullanıcı tanımlı etiketleri döndürür.

İstek

İstek Get Blob Tags aşağıdaki gibi oluşturulmuş olabilir. HTTPS önerilir. myaccount yerine depolama hesabınız adını yazın:

GET Yöntemi İsteği URI'si HTTP Sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

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

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

URI parametreleri

İstek URI'si üzerinde aşağıdaki ek parametreler belirtilebilir.

Parametre Açıklama
snapshot İsteğe bağlı. Snapshot parametresi, mevcut olduğunda alınarak blob DateTime anlık görüntüsünü belirten opak bir değerdir. Blob anlık görüntüleriyle çalışma hakkında daha fazla bilgi için bkz. Blob'un Anlık Görüntüsünü Oluşturma
versionid 2019-12-12 ve daha yeni sürümler için isteğe bağlıdır. versionid parametresi, mevcut olduğunda, almak için blob sürümünü belirten DateTime opak bir değerdir.
timeout İsteğe bağlı. timeoutparametresi saniyeler içinde ifade edildi. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Zaman Aşımı Ayarlama.

İstek Üst Bilgileri

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

İstek Başlığı Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama.
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.
x-ms-version Anonim istekler için isteğe bağlı olarak tüm yetkili istekler için gereklidir. Bu istek için kullanmak üzere işlem sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama Servicesiçin sürüm.
x-ms-lease-id:<ID> Blob etkin kiraya sahipse gereklidir.

Etkin kiralaması olan bir blobda bu işlemi gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin. İstekte geçerli bir kira kimliği belirtilmezse, işlem 403 (Yasak) durum koduyla 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 1 KiB karakter sınırıyla istemci tarafından oluşturulan ve opak 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 Analiz Günlüğü ve Azure Günlüğü Hakkında: İstekleri Izlemek için Depolama Kullanma.

Bu işlem yalnızca belirtilen x-ms-if-tags bir koşul karşılanırsa blob etiketlerini almak için koşullu üst bilgi destekler. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Koşullu Üst Bilgiler Belirtme.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri ve yanıt gövdesi içerir.

Durum Kodu

Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

Durum kodları hakkında bilgi için bkz. Durum ve Hata Kodları.

Yanıt Üst Bilgileri

Bu işlem için 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 uygun.

Yanıt üst bilgisi Açıklama
Content-Type application/xml
Content-Length Döndürülen XML belgesinin bayt cinsinden boyutu
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 İşlemleri Sorunlarını Giderme.
x-ms-version İsteği yürütmek için kullanılan Blob hizmetinin sürümünü gösterir.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-client-request-id Bu üst bilgi, isteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa üst bilgi değerine eşittir ve değer en fazla x-ms-client-request-id 1024 görünür ASCII karakteridir. üst x-ms-client-request-id bilgisi istekte yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yanıt Gövdesi

Yanıt gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

Yanıt gövdesi, blobda depolanan tüm etiketleri temsil eden iyi UTF-8 XML belgesidir.

Yetkilendirme

Bu işlem hesap sahibi tarafından ve blob etiketlerine (SAS izni) izin verilen Paylaşılan Erişim İmzası olan herkes tarafından t çağrılır.

Ayrıca, izni olan RBAC Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read kullanıcıları bu işlemi gerçekleştirebilirsiniz.

Açıklamalar

bu Get Blob Tags işlem 2019-12-12 ve sonraki bir sürümde REST API için de destek sağlar.

Yanıtta etiketlerin sıralaması garanti edilemez.

Depolama hizmeti blob ile etiketleri arasında güçlü tutarlılık sağlar, ancak ikincil dizin nihai olarak tutarlıdır. Etiketler, işlemlere görünür olmadan Get Blob Tags önce yanıtta görünür Find Blobs by Tags olabilir.

Ayrıca bkz.

Blob Dizini ile Azure Blob Depolama'da verileri bulma ve yönetme
Azure Depolama'a istekleri yetkilendirme
Durum ve Hata Kodları
Blob Hizmeti Hata Kodları