Ange blobtaggar

Artikel
05/15/2024

Å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 för 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äranderubrikerna 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. Det här huvudet refererar till innehållslängden för taggarnas dokument, 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). Det här huvudet är associerat 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). Det här huvudet är associerat 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 statuskoden 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 loggningen 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 inte innehålla fler än 10 taggar. Taggnycklar och värden är skiftlägeskänsliga. Taggnycklarna 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 statuskoden 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 unikt den begäran som gjordes 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 UTC-datum/tid-värde 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 huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. `x-ms-client-request-id` Om rubriken inte finns i begäran visas 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.

Viktigt

Microsoft rekommenderar att du använder Microsoft Entra ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.

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 Microsoft Entra ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp, hanterad identitet eller tjänstens huvudnamn ska anropa Set Blob Tags åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som inkluderar den här åtgärden:

Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
Minsta privilegierade inbyggda roll:Storage Blob Data Owner

Mer information om hur du tilldelar roller med Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten kan komma åt, vilka behörigheter de har till dessa resurser och hur länge SAS är giltigt.

Åtgärden Set Blob Tags stöder tre typer av signaturer för delad åtkomst: SAS för användardelegering, sas för tjänsten och konto-SAS.

Vi rekommenderar att du använder Microsoft Entra autentiseringsuppgifter i stället för lagringskontonyckeln, vilket är enklare att kompromettera. Om din programdesign kräver signaturer för delad åtkomst använder du Microsoft Entra autentiseringsuppgifter för att skapa en SAS för användardelegering när det är möjligt.

När åtkomst med delad nyckel inte tillåts för lagringskontot tillåts inte en SAS-token för tjänsten eller en SAS-kontotoken för en begäran till Blob Storage. Mer information finns i Förstå hur nekande av delad nyckel påverkar SAS-token.

SAS för användardelegering

En SAS för användardelegering skyddas med Microsoft Entra autentiseringsuppgifter och även av de behörigheter som anges för SAS.

Set Blob Tags Att anropa åtgärden med en SAS-token som delegerats till en blobresurs kräver behörigheten Taggar (t) som en del av SAS-token för användardelegering.

Mer information om SAS för användardelegering finns i Skapa en SAS för användardelegering.

Tjänst-SAS

En tjänst-SAS skyddas med lagringskontonyckeln. En tjänst-SAS delegerar åtkomst till en resurs i en enda Azure Storage-tjänst, till exempel bloblagring.

Att anropa åtgärden Set Blob Tags med en SAS-token som delegerats till en blobresurs kräver behörigheten Taggar (t) som en del av tjänstens SAS-token.

Mer information om sas-tjänsten finns i Skapa en tjänst-SAS.

Konto-SAS

Ett SAS-konto skyddas med lagringskontonyckeln. En konto-SAS delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla åtgärder som är tillgängliga via en tjänst eller sas för användardelegering är också tillgängliga via ett konto-SAS.

Följande tabell anger den signerade resurstypen och signerade behörigheter som ska anges när åtkomst delegeras:

Åtgärd	Signerad tjänst	Signerad resurstyp	Signerad behörighet
Ange blobtaggar	Blob (b)	Objekt (o)	Taggar (t)

Mer information om kontots SAS finns i Skapa ett KONTO-SAS.

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 på 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 blobs 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 till exempel tillfaller 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

Dela via