Megosztás a következőn keresztül:

Blobcímkék beállítása

  • Cikk

A Set Blob Tags művelet egy vagy több kulcs-érték párként állítja be a megadott blob felhasználó által definiált címkéit.

Kérés

A Set Blob Tags kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

PUT metóduskérés URI-ja HTTP-verzió
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-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg:

Paraméter Leírás
versionid Nem kötelező a 2019-12-12-es és újabb verziókhoz. A versionid paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a lekérni kívánt blob verzióját.
timeout Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez.

Kérésfejlécek

A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:

Kérelem fejléce Leírás
Authorization Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
Date vagy x-ms-date Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
x-ms-version Minden engedélyezett kéréshez szükséges. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
Content-Length Kötelező. A kérelem tartalmának hossza bájtban. Ez a fejléc a címkedokumentum tartalomhosszára vonatkozik, nem magáról a blobról.
Content-Type Kötelező. Ennek a fejlécnek az értéke application/xml; charset=UTF-8.
Content-MD5 Választható. A kérelem tartalmának MD5-kivonata. Ez a kivonat a kérelem tartalmának integritásának ellenőrzésére szolgál az átvitel során. Ha a két kivonat nem egyezik, a művelet a 400-es hibakóddal (hibás kérelem) meghiúsul.

Ez a fejléc a kérelem tartalmához van társítva, nem magához a blobhoz.
x-ms-content-crc64 Választható. A kérelem tartalmának CRC64-kivonata. Ez a kivonat a kérelem tartalmának integritásának ellenőrzésére szolgál az átvitel során. Ha a két kivonat nem egyezik, a művelet a 400-es hibakóddal (hibás kérelem) meghiúsul.

Ez a fejléc a kérelem tartalmához van társítva, nem magához a blobhoz.

Ha a kérés és x-ms-content-crc64 a fejléc is Content-MD5 jelen van, a kérés 400-os hibakóddal (hibás kérés) meghiúsul.
x-ms-lease-id:<ID> Akkor szükséges, ha a blob rendelkezik aktív bérlettal.

Ha ezt a műveletet aktív bérlettel rendelkező blobon szeretné végrehajtani, adja meg a fejléc érvényes bérletazonosítóját. Ha nincs megadva érvényes bérletazonosító a kérelemben, a művelet a 403-at (Tiltott) állapotkóddal meghiúsul.
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Azure Blob Storage figyelése.

Ez a művelet támogatja a x-ms-if-tags feltételes fejlécet a blobcímkék beállításához, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.

A kérés törzse

A kérelem törzsének formátuma a következő:

<?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>

A kérelem törzsének jól formázott UTF-8 XML-dokumentumnak kell lennie, és tartalmaznia kell egy címkekészletet, amely a blob címkéinek felel meg.

A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkekulcsok és -értékek megkülönböztetik a kis- és nagybetűket. A címkekulcsok legfeljebb 128 karakterből állhatnak, a címkeértékek pedig 0 és 256 karakter közöttiek lehetnek. Az érvényes címkekulcs- és értékkarakterek a következők:

  • Kis- és nagybetűk (a-z, A-Z)
  • Számjegyek (0-9)
  • Szóköz ( )
  • Plusz (+), mínusz (-), pont (.), perjel (/), kettőspont (:), egyenlő (=) és aláhúzásjel (_)

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Állapotkód

A sikeres művelet a 204-et (nincs tartalom) állapotkódot adja vissza.

További információ az állapotkódokról: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc Description
x-ms-request-id Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A kérés végrehajtásához használt Blob Storage-verzió.
Date A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
x-ms-client-request-id A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor az nem jelenik meg a válaszban.

Választörzs

Nincsenek.

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Set Blob Tags alábbiak szerint engedélyezheti.

Fontos

A Microsoft a Microsoft Entra ID felügyelt identitásokkal való használatát javasolja az Azure Storage felé irányuló kérések engedélyezéséhez. Microsoft Entra ID a megosztott kulcsos hitelesítéshez képest kiemelkedő biztonságot és könnyű használatot biztosít.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívja a műveletet, valamint a legkevésbé emelt jogosultságú beépített Azure RBAC-szerepkört, amely tartalmazza ezt a Set Blob Tags műveletet:

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Megjegyzések

A Set Blob Tags műveletet a REST API 2019-12-12-es és újabb verziói támogatják.

A hierarchikus névtérrel rendelkező fiókok esetében a Set Blob Tags művelet nem támogatott, mivel a blobcímkék nem támogatottak a hierarchikus névtérfiókok esetében.

A Set Blob Tags művelet felülírja a blob összes meglévő címkéit. Ha az összes címkét el szeretné távolítani egy blobból, küldjön egy Set Blob Tags üres kérést <TagSet>.

Ez a művelet nem frissíti a blob ETag vagy utolsó módosításának időpontját. Az archivált blobok címkéi beállíthatók.

A tárolási szolgáltatás erős konzisztenciát biztosít a blobok és címkéi között. A blobcímkék módosításai azonnal láthatók a blob későbbi Get Blob Tags műveleteiben. A másodlagos index azonban végül konzisztens. Előfordulhat, hogy a blob címkéinek módosításai nem láthatók azonnal a műveletek számára Find Blobs by Tags .

Ha egy kérelem érvénytelen címkéket ad meg, a Blob Storage a 400 -os állapotkódot adja vissza (hibás kérés).

Számlázás

A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Set Blob Tags mutatja be:

Művelet Tárfiók típusa Számlázási kategória
Blobcímkék beállítása Prémium szintű blokkblob
Standard általános célú v2		 Egyéb műveletek
Blobcímkék beállítása Standard általános célú v1 Írási műveletek

A megadott számlázási kategória díjszabásáról a Azure Blob Storage Díjszabás című témakörben talál további információt.

Lásd még

Blob Storage-adatok kezelése és keresése blobindexcímkék használatával
Kérések engedélyezése az Azure Storage-nak
Állapot- és hibakódok
Blob Storage-hibakódok