Blob Etiketlerini Ayarlama

  • Makale

İş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:

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 parametreleri belirtebilirsiniz:

Parametre Açıklama
versionid 2019-12-12 ve üzeri sürümler için isteğe bağlı. 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

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştı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 isteklerini 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 isteklerini 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 üst bilgi, blobun kendisini değil etiket belgesinin içerik uzunluğunu ifade eder.
Content-Type Gereklidir. Bu üst bilginin 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ı İstek) hata koduyla başarısız olur.

Bu üst bilgi, blobun içeriğiyle değil istek içeriğiyle ilişkilendirilir.
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ı İstek) hata koduyla başarısız olur.

Bu üst bilgi, blobun içeriğiyle değil istek içeriğiyle ilişkilendirilir.

Hem hem de Content-MD5x-ms-content-crc64 üst bilgiler varsa, istek 400 (Hatalı İstek) hata koduyla başarısız olur.
x-ms-lease-id:<ID> Blob etkin bir 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ı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama.

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 üst bilgisi Description
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği yürütmek için kullanılan Blob Depolama sürümü.
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 İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz.

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.

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, bir Microsoft Entra kullanıcı, grup veya hizmet sorumlusunun işlemi çağırması Set Blob Tags için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

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

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. Blobdan tüm etiketleri kaldırmak için boş <TagSet>bir ile istek gönderinSet Blob Tags.

Bu işlem, blobun ETag'ını veya son değiştirilme 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şlemler tarafından hemen görülebilir. Ancak ikincil dizin sonunda tutarlıdır. Blob etiketlerindeki değişiklikler işlemlere Find Blobs by Tags hemen görünmeyebilir.

İstek 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 ü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 Set Blob Tags faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Etiketlerini Ayarlama Premium blok blobu
Standart genel amaçlı v2		 Diğer işlemler
Blob Etiketlerini Ayarlama Standart genel amaçlı v1 Yazma işlemleri

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

Ayrıca bkz.

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