Blob-tags instellen

  • Artikel
  • 5 minuten om te lezen

De bewerking stelt door de gebruiker gedefinieerde tags voor de opgegeven blob in als een of meer Set Blob Tags sleutel-waardeparen.

Aanvraag

De Set Blob Tags aanvraag kan als volgt worden samengesteld. HTTPS wordt aanbevolen. Vervang myaccount door de naam van uw opslagaccount:

AANVRAAG-URI put-methode HTTP-versie
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-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de aanvraag-URI.

Parameter Beschrijving
versionid Optioneel voor versies 2019-12-12 en hoger. De parameter versionid is een ondoorzichtige waarde die, indien aanwezig, de versie opgeeft van de DateTime blob die moet worden opgehaald.
timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Setting Timeouts for Blob Service Operations (Time-outs instellen voor blobservicebewerkingen) voor meer informatie.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking moet worden gebruikt voor deze aanvraag. Zie Versioning for the Azure Storage Services (Versie Azure Storage services) voor meer informatie.
Content-Length Vereist. De lengte van de aanvraaginhoud in bytes. Houd er rekening mee dat deze header verwijst naar de inhoudslengte van het tagsdocument, niet van de blob zelf.
Content-Type Vereist. De waarde van deze header moet application/xml zijn; charset=UTF-8.
Content-MD5 Optioneel. Een MD5-hash van de aanvraaginhoud. Deze hash wordt gebruikt om de integriteit van de aanvraaginhoud tijdens het transport te controleren. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Bad Request).

Houd er rekening mee dat deze header is gekoppeld aan de aanvraaginhoud en niet aan de inhoud van de blob zelf.
x-ms-content-crc64 Optioneel. Een CRC64-hash van de inhoud van de aanvraag. Deze hash wordt gebruikt om de integriteit van de aanvraaginhoud tijdens het transport te controleren. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Bad Request).

Houd er rekening mee dat deze header is gekoppeld aan de aanvraaginhoud en niet aan de inhoud van de blob zelf.

Als beide Content-MD5 x-ms-content-crc64 headers en aanwezig zijn, mislukt de aanvraag met foutcode 400 (Slechte aanvraag).
x-ms-lease-id:<ID> Vereist als de blob een actieve lease heeft.

Als u deze bewerking wilt uitvoeren op een blob met een actieve lease, geeft u de geldige lease-id voor deze header op. Als er geen geldige lease-id is opgegeven in de aanvraag, mislukt de bewerking met statuscode 403 (verboden).
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Logboeken gebruiken om logboeken bij Storage volgen) voor meer informatie.

Deze bewerking ondersteunt de x-ms-if-tags voorwaardelijke header om blobtags alleen in te stellen als aan een opgegeven voorwaarde wordt voldaan. Zie Specifying Conditional Headers for Blob Service Operations (Voorwaardelijke headers opgeven voor blobservicebewerkingen) voor meer informatie.

Aanvraagbody

De indeling van de aanvraag body is als volgt:

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

De aanvraag body moet een goed gevormd UTF-8 XML-document zijn, met een tagset die de tags voor de blob vertegenwoordigt.

De tagset kan uit meer dan 10 tags bestaan. Tagsleutels en -waarden zijn casegevoelig. Tagsleutels moeten tussen 1 en 128 tekens lang zijn en tagwaarden moeten tussen 0 en 256 tekens lang zijn. Geldige tagsleutel- en waardetekens zijn onder andere:

  • Kleine letters en hoofdletters (a-z, A-Z)
  • Cijfers (0-9)
  • Een spatie ( )
  • Plus (+), min (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=) en onderstrepingsteken (_)

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 204 (geen inhoud).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Beschrijving
x-ms-request-id Deze header identificeert op unieke manier de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Troubleshooting API Operations (Problemen met API-bewerkingen oplossen) voor meer informatie.
x-ms-version Hiermee wordt de versie van de Blob service gebruikt om de aanvraag uit te voeren.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die de tijd aangeeft waarop het antwoord is gestart.
x-ms-client-request-id Deze header kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit ten beste x-ms-client-request-id 1024 zichtbare ASCII-tekens bestaat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Antwoord body

Geen.

Autorisatie

Deze bewerking kan worden aangeroepen door de accounteigenaar en door iedereen met een Shared Access Signature die machtigingen heeft voor de tags van de blob (de t SAS-machtiging).

Bovendien kunnen RBAC-gebruikers met de Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write machtiging deze bewerking uitvoeren.

Opmerkingen

De Set Blob Tags bewerking wordt ondersteund in REST API versie 2019-12-12 en hoger.

Met Set Blob Tags de bewerking worden alle bestaande tags in de blob overschreven. Als u alle tags uit een blob wilt verwijderen, verzendt u een Set Blob Tags aanvraag met een lege <TagSet> .

Met deze bewerking wordt de ETag of de tijd van de laatste wijziging van de blob niet bijgewerkt. Het is mogelijk om tags in te stellen op een gearchiveerde blob.

De opslagservice behoudt een sterke consistentie tussen een blob en de tags. Wijzigingen in blobtags zijn onmiddellijk zichtbaar voor volgende Get Blob Tags bewerkingen in de blob. De secundaire index is echter uiteindelijk consistent; wijzigingen in de tags van een blob zijn mogelijk niet onmiddellijk zichtbaar voor Find Blobs by Tags bewerkingen.

Als een aanvraag ongeldige tags bevat, retourneert Blob service statuscode 400 (Ongeldige aanvraag).

Zie ook

Gegevens in Azure Blob Storage beheren en zoeken met blobindex
Aanvragen voor Azure Storage
Status- en foutcodes
Foutcodes voor blob-services