Ange blobtaggar
Åtgärden Set Blob Tags
anger användardefinierade taggar för den angivna bloben som ett eller flera nyckel/värde-par.
Förfrågan
Begäran Set Blob Tags
kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:
URI för PUT-metodbegäran | HTTP-version |
---|---|
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-parametrar
Du kan ange följande ytterligare parametrar på begärande-URI:n:
Parameter | Beskrivning |
---|---|
versionid |
Valfritt för version 2019-12-12 och senare. Parametern versionid är ett täckande DateTime värde som, när den finns, anger vilken version av bloben som ska hämtas. |
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder. |
Begärandehuvuden
De obligatoriska och valfria begärandehuvudena beskrivs i följande tabell:
Begärandehuvud | Beskrivning |
---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
Content-Length |
Krävs. Längden på begärandeinnehållet i byte. Den här rubriken refererar till innehållslängden för dokumentet med taggar, inte själva blobben. |
Content-Type |
Krävs. Värdet för det här huvudet ska vara application/xml; charset=UTF-8. |
Content-MD5 |
Valfritt. En MD5-hash för begärandeinnehållet. Denna hash används för att verifiera integriteten för begärandeinnehållet under transporten. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Den här rubriken är associerad med begärandeinnehållet och inte med själva blobens innehåll. |
x-ms-content-crc64 |
Valfritt. En CRC64-hash för begärandeinnehållet. Denna hash används för att verifiera integriteten för begärandeinnehållet under transporten. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Den här rubriken är associerad med begärandeinnehållet och inte med själva blobens innehåll. Om både Content-MD5 - och x-ms-content-crc64 -huvuden finns misslyckas begäran med felkoden 400 (felaktig begäran). |
x-ms-lease-id:<ID> |
Krävs om bloben har ett aktivt lån. Om du vill utföra den här åtgärden på en blob med ett aktivt lån anger du det giltiga låne-ID:t för det här huvudet. Om ett giltigt låne-ID inte anges i begäran misslyckas åtgärden med statuskod 403 (Förbjuden). |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage. |
Den här åtgärden stöder villkorsrubriken x-ms-if-tags
för att ange blobtaggar endast om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda rubriker för Blob Storage-åtgärder.
Begärandetext
Formatet för begärandetexten är följande:
<?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>
Begärandetexten måste vara ett välformat UTF-8 XML-dokument och innehålla en tagguppsättning som representerar taggarna för bloben.
Tagguppsättningen får innehålla högst 10 taggar. Taggnycklar och värden är skiftlägeskänsliga. Taggnycklar måste vara mellan 1 och 128 tecken och taggvärdena måste vara mellan 0 och 256 tecken. Giltiga taggnyckel- och värdetecken är:
- Gemener och versaler (a-z, A-Z)
- Siffror (0–9)
- Ett blanksteg ( )
- Plus (+), minus (-), punkt (.), snedstreck (/), kolon (:), lika med (=) och understreck (_)
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 204 (inget innehåll).
Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
Svarsrubrik | Description |
---|---|
x-ms-request-id |
Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Blob Storage-versionen som användes för att köra begäran. |
Date |
Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Inga.
Auktorisering
Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Set Blob Tags
nedan.
Azure Storage stöder användning av Microsoft Entra ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.
Mer information om auktorisering med Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.
Behörigheter
Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp eller tjänstens huvudnamn ska kunna anropa Set Blob Tags
åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:
- Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
- Minsta privilegierade inbyggda roll:Storage Blob Data-ägare
Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.
Kommentarer
Åtgärden Set Blob Tags
stöds i REST API-version 2019-12-12 och senare.
För konton med hierarkiskt namnområde aktiverat Set Blob Tags
stöds inte åtgärden eftersom blobtaggar inte stöds för hierarkiska namnområdeskonton.
Åtgärden Set Blob Tags
skriver över alla befintliga taggar i bloben. Om du vill ta bort alla taggar från en blob skickar du en Set Blob Tags
begäran med en tom <TagSet>
.
Den här åtgärden uppdaterar inte ETag- eller senaste ändringstiden för bloben. Det går att ange taggar på en arkiverad blob.
Lagringstjänsten upprätthåller stark konsekvens mellan en blob och dess taggar. Ändringar i blobtaggar visas omedelbart för efterföljande Get Blob Tags
åtgärder på bloben. Det sekundära indexet är dock så småningom konsekvent. Ändringar i en blobbs taggar kanske inte är direkt synliga för Find Blobs by Tags
åtgärder.
Om en begäran innehåller ogiltiga taggar returnerar Blob Storage statuskod 400 (felaktig begäran).
Fakturering
Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Set Blob Tags
begäranden baserat på lagringskontotypen:
Åtgärd | Typ av lagringskonto | Faktureringskategori |
---|---|---|
Ange blobtaggar | Premium-blockblob Standard generell användning v2 |
Andra åtgärder |
Ange blobtaggar | Standard generell användning v1 | Skrivåtgärder |
Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.
Se även
Hantera och hitta Blob Storage-data med blobindextaggar
Auktorisera begäranden till Azure Storage
Status- och felkoder
Felkoder för Blob Storage