Ange blobtaggar

Artikel
08/16/2021
4 minuter för att läsa

Å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. HTTPS rekommenderas. 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

Följande ytterligare parametrar kan anges för URI:en för begäran.

Parameter	Beskrivning
`versionid`	Valfritt för versionerna 2019-12-12 och senare. Parametern versionid är ett täckande värde som anger vilken version av bloben som ska hämtas när den `DateTime` finns.
`timeout`	Valfritt. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Service-åtgärder.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Authorize requests to Azure Storage.
`Date` eller `x-ms-date`	Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Authorize requests to 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 Services.
`Content-Length`	Krävs. Längden på begärandeinnehållet i byte. Observera att det här huvudet refererar till innehållslängden för dokumentet taggar, inte själva bloben.
`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. Den här hashen används för att verifiera integriteten för begärandeinnehållet under transporten. Om de två hash-koderna inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Observera att det här huvudet är associerat med begärandeinnehållet och inte med innehållet i själva bloben.
`x-ms-content-crc64`	Valfritt. En CRC64-hash för begärandeinnehållet. Den här hashen används för att verifiera integriteten för begärandeinnehållet under transporten. Om de två hash-koderna inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Observera att det här huvudet är associerat med begärandeinnehållet och inte med innehållet i själva bloben. Om både `Content-MD5` `x-ms-content-crc64` - och -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 har angetts på begäran misslyckas åtgärden med statuskod 403 (förbjudet).
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 KiB som registreras i analysloggarna när loggning av lagringsanalys är aktiverat. Användning av det här huvudet rekommenderas starkt för korrelering av aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i Om Storage Analytics-loggning och Azure Logging: Använda loggar för att spåra Storage-begäranden.

Den här åtgärden stöder x-ms-if-tags villkorsrubriken för att endast ange blobtaggar om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.

Begärandetext

Formatet på 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äl utf-8 XML-dokument som innehåller en tagguppsättning som representerar taggarna för bloben.

Tagguppsättningen kan innehålla högst 10 taggar. Taggnycklar och värden är fallkänsliga. Taggnycklar måste vara mellan 1 och 128 tecken och taggvärden 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 (.), solidus (/), 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).

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande huvuden. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.

Svarshuvud	Beskrivning
`x-ms-request-id`	Det här huvudet identifierar unikt begäran som har gjorts och kan användas för felsökning av begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger vilken version av blobtjänsten som används för att köra begäran.
`Date`	Ett datum-/tidsvärde för UTC som genererats av tjänsten och som anger vid vilken tid svaret initierades.
`x-ms-client-request-id`	Det här huvudet 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 för -huvudet om det finns i begäran och värdet är högst `x-ms-client-request-id` 1 024 synliga ASCII-tecken. Om `x-ms-client-request-id` -huvudet inte finns i begäran finns det här huvudet inte i svaret.

Svarstext

Inga.

Auktorisering

Den här åtgärden kan anropas av kontoägaren och av vem som helst med en signatur för delad åtkomst som har behörighet till blobens taggar t (SAS-behörigheten).

Dessutom kan RBAC-användare med behörighet Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write utföra den här åtgärden.

Kommentarer

Åtgärden Set Blob Tags stöds i REST API version 2019-12-12 och senare.

Åtgärden Set Blob Tags skriver över alla befintliga taggar på bloben. Om du vill ta bort alla taggar från en blob skickar du Set Blob Tags en begäran med en tom <TagSet> .

Den här åtgärden uppdaterar inte blobens ETag-tid eller senaste ändringstid. Det går att ange taggar för en arkiverad blob.

Lagringstjänsten har stark konsekvens mellan en blob och dess taggar. Ändringar av blobtaggar visas omedelbart för efterföljande Get Blob Tags åtgärder på bloben. Det sekundära indexet är dock konsekvent till slut. ändringar av en blobs taggar kanske inte visas omedelbart för Find Blobs by Tags åtgärder.

Om en begäran innehåller ogiltiga taggar returnerar Blob Service statuskod 400 (felaktig begäran).

Se även

Hantera och hitta data på Azure Blob Storage med blobindex
Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service