Hämta containeregenskaper

Operationen Get Container Properties returnerar all användardefinierad metadata och systemegenskaper för den angivna containern. Den returnerade datan inkluderar inte containerns lista över blobs.

Request

Begäran Get Container Properties 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 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 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 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 or 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 Properties 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 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).

Mer 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.

Svarsrubrik Description
x-ms-meta-name:value Returnerar en sträng som innehåller ett namn/värde-par som är 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. Mer information finns i Representera datum/tid-värden i rubriker.

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-lease-status: <locked ¦ unlocked> Version 2012-02-12 och senare. Lånestatus för containern.
x-ms-lease-state: <available ¦ leased ¦ expired ¦ breaking ¦ broken> Version 2012-02-12 och senare. Containerns hyresstatus.
x-ms-lease-duration: <infinite ¦ fixed > Version 2012-02-12 och senare, endast när containern är leasad. Specificerar om leasingen på en container har oändlig eller fast varaktighet.
x-ms-request-id Identifierar unikt den begäran som gjordes och kan användas för att felsöka förfrågan. Mer information finns i Felsöka API-åtgärder.
x-ms-version Version 2009-09-19 och senare. Indikerar vilken version av Blob-tjänsten som används för att köra förfrågan.

Returnerades också för anonyma förfrågningar utan specificerad version om containern var markerad för allmän åtkomst genom att använda Blob service version 2009-09-19.
Date Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
x-ms-blob-public-access Version 2016-05-31 och senare. Anger om data i containern kan nås offentligt och vilken åtkomstnivå som finns. Möjliga värden är:

container: Indikerar full offentlig läsåtkomst för container- och blobdata. Klienter kan räkna upp blobar i containern via anonym begäran, men de kan inte räkna upp containrar i lagringskontot.

blob: Indikerar offentlig läsåtkomst för blobs. Blobdata inom denna container kan läsas via anonym begäran, men containerdata är inte tillgänglig. Klienter kan inte räkna upp blobar i containern via anonym begäran.

Om denna header inte returneras i svaret är containern privat för kontoägaren.
x-ms-has-immutability-policy Version 2017-11-09 och senare. Anger om containern har en princip för oföränderlighet inställd på den. Värdet är true om en policy är satt, eller false om en policy inte är satt.
x-ms-has-legal-hold Version 2017-11-09 och senare. Anger om containern har ett lagligt undantag. Värdet är true om det har ett eller flera lagliga grepp, och false om det inte har några lagliga grepp.
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-huvudet inte finns i begäran finns det inte i svaret.

Svarsdel

None.

Exempelsvar

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-Name: StorageSample  
Date: Sun, 25 Sep 2016 12:43:08 GMT  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: Sun, 25 Sep 2016 10:42:18 GMT  
x-ms-version: 2016-05-31
x-ms-blob-public-access: blob  
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 Properties 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 Properties å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

None. Se faktureringsinformation för detaljer om hur denna verksamhet påverkar kostnaderna.

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 Properties begäranden baserat på lagringskontotypen:

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

Se även

Drift på containrar

  • Uppdaterades senast