Blob etiketlerini ayarla

  • Makale
  • Okumak için 4 dakika

Set Blob Tagsİşlem, belirtilen blob için Kullanıcı tanımlı etiketleri bir veya daha fazla anahtar-değer çifti olarak ayarlar.

İstek

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

PUT yöntemi Istek 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&versionid=<DateTime>		 HTTP/1.1

URI Parametreleri

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

Parametre Açıklama
versionid 2019-12-12 ve üzeri sürümler için isteğe bağlı. 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 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.
Content-Length Gereklidir. İstek içeriğinin bayt cinsinden uzunluğu. Bu üstbilginin blob 'un kendisi değil, Etiketler belgesinin içerik uzunluğuna başvurduğunu unutmayın.
Content-Type Gereklidir. Bu üstbilginin değeri Application/XML olmalıdır; charset = UTF-8.
Content-MD5 İsteğe bağlı. İstek içeriğinin MD5 karması. Bu karma, aktarım sırasında istek içeriğinin bütünlüğünü doğrulamak için kullanılır. İki Karma eşleşmezse, işlem 400 (Hatalı Istek) hata koduyla başarısız olur.

Bu üstbilginin blob 'un içeriğiyle değil, istek içeriğiyle ilişkilendirildiğini unutmayın.
x-ms-content-crc64 İsteğe bağlı. İstek içeriğinin CRC64 karması. Bu karma, aktarım sırasında istek içeriğinin bütünlüğünü doğrulamak için kullanılır. İki Karma eşleşmezse, işlem 400 (Hatalı Istek) hata koduyla başarısız olur.

Bu üstbilginin blob 'un içeriğiyle değil, istek içeriğiyle ilişkilendirildiğini unutmayın.

Hem hem Content-MD5 de x-ms-content-crc64 üst bilgiler varsa, istek 400 (hatalı istek) hata koduyla başarısız olur.
x-ms-lease-id:<ID> Blobun etkin bir kirası varsa gereklidir.

Bu işlemi etkin bir kiralamaya sahip bir blob üzerinde gerçekleştirmek için, bu üst bilgi için geçerli kira KIMLIĞINI belirtin. İstekte geçerli bir kira KIMLIĞI belirtilmemişse, 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 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, x-ms-if-tags yalnızca belirtilen bir koşul karşılanırsa blob etiketlerini ayarlamak için koşullu üstbilgiyi destekler. Daha fazla bilgi için bkz. BLOB hizmeti işlemleri Için koşullu üstbilgiler belirtme.

İstek Gövdesi

İstek 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>

İstek gövdesi, blob etiketlerini temsil eden bir etiket kümesi içeren iyi biçimlendirilmiş bir UTF-8 XML belgesi olmalıdır.

Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları ve değerleri büyük/küçük harfe duyarlıdır. Etiket anahtarları 1 ile 128 karakter arasında olmalıdır ve etiket değerleri 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır:

  • Küçük ve büyük harfler (a-z, A-Z)
  • Basamaklar (0-9)
  • Boşluk ()
  • Artı (+), eksi (-), nokta (.), eğik çizgi (/), iki nokta (:), eşittir (=) ve alt çizgi (_)

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, 204 (Içerik yok) 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-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.
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 tarafından ve BLOB 'un etiketleri (SAS izni) iznine sahip bir paylaşılan erişim Imzası olan herkese göre çağrılabilir t .

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

Açıklamalar

Set Blob Tagsİşlem REST API sürüm 2019-12-12 ve üzeri sürümlerde desteklenir.

Set Blob Tagsİşlem, blob üzerindeki tüm mevcut etiketlerin üzerine yazar. Bir Blobun tüm etiketleri kaldırmak için, boş bir Set Blob Tags istek gönderin <TagSet> .

Bu işlem, Blobun ETag veya son değiştirilme saatini güncelleştirmez. Arşivlenmiş bir blob 'da Etiketler ayarlamak mümkündür.

Depolama hizmeti bir blob ile etiketleri arasında güçlü tutarlılık sağlar. Blob etiketlerine yapılan değişiklikler, blob üzerinde sonraki Get Blob Tags işlemler tarafından hemen görülebilir. Ancak ikincil dizin nihai olarak tutarlıdır; blob etiketlerine yapılan değişiklikler işlemler tarafından hemen Find Blobs by Tags görülemeyebilir.

İstek geçersiz etiketler sağlarsa Blob hizmeti 400 (Hatalı İstek) durum kodunu döndürür.

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ı