Hämta containermetadata

Operationen Get Container Metadata returnerar all användardefinierad metadata för containern.

Request

Begäran Get Container Metadata kan utformas enligt följande. Vi rekommenderar att du använder HTTPS. Byt ut myaccount mot namnet på ditt lagringskonto:

Method Begäran om URI HTTP-version
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1

Emulerad lagringstjänstbegäran

När du gör en förfrågan mot den emulerade lagringstjänsten, ange emulatorns värdnamn och Azure Blob Storage-porten som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot:

Method Begäran om URI HTTP-version
GET/HEAD http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=metadata HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI parametrar

Följande ytterligare parametrar kan anges på begäran om URI:

Parameter Description
timeout Optional. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

Förfrågningsrubriker

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

Förfrågningshuvudrad Description
Authorization Required. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Required. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-lease-id: <ID> Valfritt, version 2012-02-12 och senare. Om det är specificerat lyckas Get Container Metadata det endast om containerns leasing är aktiv och matchar detta ID. Om det inte finns något aktivt hyresavtal eller om ID:t inte stämmer, returneras felkoden 412 (Precondition Failed).
x-ms-version Obligatoriskt för alla auktoriserade förfrågningar, valfritt för anonyma förfrågningar. 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.
x-ms-client-request-id Optional. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. 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-.

Begär brödtext

None.

Response

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

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 rubriker. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Syntax Description
x-ms-meta-name:value Returnerar en sträng som innehåller ett namn-värde-par kopplat till containern som metadata.
ETag Entitetstaggen för containern. Om begärandeversionen är 2011-08-18 eller senare omges ETag-värdet av citattecken.
Last-Modified Returnerar datum och tid när behållaren senast ändrades. Datumformatet följer RFC 1123. För mer information, se Representation of Date-Time Values i headers.

Alla åtgärder som ändrar containern eller dess egenskaper eller metadata uppdaterar den senaste ändringstiden. Operationer på blobs påverkar inte containerns senaste modifierade tid.
x-ms-request-id Det här huvudet identifierar unikt den begäran som har gjorts och kan användas för att felsöka begäran. För mer information, se Felsökning av API-operationer.
x-ms-version Den tjänstversion som användes för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.

Headern returneras också för anonyma förfrågningar utan en specificerad version om containern markerades för allmän åtkomst genom att använda tjänsteversion 2009-09-19.
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 för x-ms-client-request-id-huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om x-ms-client-request-id headern inte finns i förfrågan, finns inte denna header i svaret.

Svarsdel

None.

Exempelsvar

  
Response Status:  
HTTP/1.1 200 OK  
  
Response headers:  
Transfer-Encoding: chunked  
x-ms-meta-AppName: StorageSample  
Date: Sun, 25 Sep 2011 23:43:08 GMT  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: Sun, 25 Sep 2011 19:42:18 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Authorization

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden Get Container Metadata enligt beskrivningen nedan.

Important

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, huvudnamn för programtjänsten eller en hanterad Azure-identitet. Säkerhetsprincipen 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 hjälp av 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 den Get Container Metadata åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

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

Remarks

Denna operation returnerar endast användardefinierad metadata på containern. För att returnera systemegenskaper också, anropa Get Container Properties.

Billing

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via BLOB Storage REST API eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Get Container Metadata begäranden baserat på lagringskontotypen:

Operation Typ av lagringskonto Faktureringskategori
Hämta containermetadata Premiumblockblob
Standard för allmän användning v2		 Övriga operationer
Hämta containermetadata Standard allmän användning v1 Läsoperationer

Mer information om priser för den angivna faktureringskategorin finns i Prissättning för Azure Blob Storage.

Se även

Drift på containrar

  • Uppdaterades senast