Hämta blobtaggar

  • Artikel
  • 3 minuter för att läsa

Åtgärden Get Blob Tags returnerar alla användardefinierade taggar för den angivna bloben, versionen eller ögonblicksbilden.

Förfrågan

Begäran Get Blob Tags kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto:

URI för GET-metodbegäran HTTP-version
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-parametrar

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

Parameter Beskrivning
snapshot Valfritt. Parametern snapshot är ett täckande DateTime värde som anger vilken blobögonblicksbild som ska hämtas när den finns. Mer information om hur du arbetar med blobögonblicksbilder finns i Skapa en ögonblicksbild av en blob
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 Description
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, valfritt för anonyma 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.
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 det x-ms-if-tags villkorliga huvudet för att endast hämta blobtaggar om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, svarshuvuden och svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

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 Description
Content-Type application/xml
Content-Length Storleken på det returnerade XML-dokumentet, i byte
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

Formatet på svarstexten ä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>

Svarstexten är ett väl utf-8 XML-dokument som representerar alla taggar som lagras på bloben.

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/read utföra den här åtgärden.

Kommentarer

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

Ordningen på taggar garanteras inte i svaret.

Lagringstjänsten har stark konsekvens mellan en blob och dess taggar, men det sekundära indexet blir konsekvent. Taggar kan vara synliga i ett svar Get Blob Tags till innan de är synliga för Find Blobs by Tags åtgärder.

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