Blob-tags op halen

De Get Blob Tags bewerking retourneert alle door de gebruiker gedefinieerde tags voor de opgegeven blob, versie of momentopname.

Aanvraag

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

AANVRAAG-URI GET-methode HTTP-versie
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&snapshot=<DateTime>

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
snapshot Optioneel. De momentopnameparameter is een ondoorzichtige waarde die, indien aanwezig, de blob-momentopname opgeeft die DateTime moet worden opgehaald. Zie Een momentopname van een blob maken voor meer informatie over het werken met blob-momentopnamen
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 Description
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, optioneel voor anonieme 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.
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 voorwaardelijke header om blobtags alleen op te halen x-ms-if-tags als aan een opgegeven voorwaarde wordt voldaan. Zie Specifying Conditional Headers for Blob Service Operations (Voorwaardelijke headers opgeven voor blobservicebewerkingen) voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode, antwoordheaders en antwoordtekst.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

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 Description
Content-Type application/xml
Content-Length De grootte van het geretourneerde XML-document, in bytes
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

De indeling van de antwoord-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 antwoord-body is een goed gevormd UTF-8 XML-document dat alle tags vertegenwoordigt die zijn opgeslagen in de blob.

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/read machtiging deze bewerking uitvoeren.

Opmerkingen

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

De volgorde van tags wordt niet gegarandeerd in het antwoord.

De opslagservice behoudt een sterke consistentie tussen een blob en de tags, maar de secundaire index is uiteindelijk consistent. Tags zijn mogelijk zichtbaar in een reactie op Get Blob Tags voordat ze zichtbaar zijn voor Find Blobs by Tags bewerkingen.

Zie ook

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