Blob Etiketlerini Ayarlama

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

İstek

İstek Set Blob Tags aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blob etiketlerini ayarlamak için koşullu üst bilgiyi destekler x-ms-if-tags . Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri 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 iyi biçimlendirilmiş bir UTF-8 XML belgesi olmalı ve blobun etiketlerini temsil eden bir etiket kümesi içermelidir.

Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları ve değerler büyük/küçük harfe duyarlıdır. Etiket anahtarları 1 ile 128 karakter arasında olmalı 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 üst üste (:), eşittir (=) ve alt çizgi (_)

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.

Durum kodu

Başarılı bir işlem 204 (İçerik Yok) 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 ü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 gövdesi

Yok.

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 Set Blob Tags verebilirsiniz.

Açıklamalar

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

Hiyerarşik ad alanı etkinleştirilmiş hesaplarda blob Set Blob Tags etiketleri hiyerarşik ad alanı hesapları için desteklenmediğinden işlem desteklenmez.

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

Bu işlem blobun ETag veya son değiştirme zamanını güncelleştirmez. Arşivlenmiş bir blobda etiket ayarlamak mümkündür.

Depolama hizmeti, blob ile etiketleri arasında güçlü tutarlılık sağlar. Blob etiketlerinde yapılan değişiklikler blob üzerindeki sonraki Get Blob Tags işlemlere hemen görünür. Ancak ikincil dizin sonunda tutarlı olur. Blob etiketlerindeki değişiklikler işlemlere Find Blobs by Tags hemen görünmeyebilir.

bir istek geçersiz etiketler sağlıyorsa Blob Depolama, 400 (Hatalı İstek) durum kodunu döndürür.

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 nasıl ücretlendirildiğinden etkilenir. Ö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 Set Blob Tags faturalama kategorisi gösterilmektedir:

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Blob dizini etiketleriyle Blob Depolama verilerini yönetme ve bulma
Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob Depolama hata kodları