Ange containermetadata

Operationen Set Container Metadata sätter ett eller flera användardefinierade namn-värde-par för den angivna containern.

Request

Begäran Set 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
PUT 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 Blob-serviceporten som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot:

Method Begäran om URI HTTP-version
PUT 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

Du kan ange följande ytterligare parametrar i begärande-URI:n:

Parameter Description
timeout Optional. Parametern timeout uttrycks i sekunder. För mer information, se Sätt time-outs för Blob-tjänstoperationer.

Förfrågningsrubriker

De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:

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-version Krävs för alla auktoriserade 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-tjänsterna.
x-ms-lease-id: <ID> Valfritt, version 2012-02-12 och senare. Om det är specificerat lyckas Set 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 412 (Precondition Failed Failure).
x-ms-meta-name:value Optional. Ett namn/värde-par som ska associeras med containern som metadata.

Varje anrop till denna operation ersätter all befintlig metadata som är kopplad till containern. För att ta bort all metadata från containern, anropa denna operation utan metadatahuvuden.

Obs: Från och med version 2009-09-19 måste metadatanamn följa namngivningsreglerna för C#-identifierare.
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-.

Denna operation stöder också användningen av villkorliga headers för att sätta containermetadata endast om ett specificerat villkor är uppfyllt. För mer information, se Specificera villkorliga headers för Blob-tjänsteoperationer.

Begär brödtext

None.

Exempelbegäran

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT  
x-ms-meta-Category: Images  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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
ETag ETag för containern. Om begäran-versionen är 2011-08-18 och senare, är ETag-värdet instängt inom citationstecken.
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 operationer som modifierar containern eller dess egenskaper eller metadata uppdaterar den senaste modifierade tiden, inklusive att sätta containerns behörigheter. Operationer på blobs påverkar inte containerns sista modifierade tid.
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 Indikerar vilken Blob-tjänstversion som användes för att köra förfrågan. Det här huvudet returneras för begäranden som gjordes mot version 2009-09-19 och senare.
Date Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
Access-Control-Allow-Origin Returneras om förfrågan innehåller en Origin header och cross-origin resource sharing (CORS) aktiveras med en matchningsregel. Det här huvudet returnerar värdet för rubriken för ursprungsbegäran om det finns en matchning.
Access-Control-Expose-Headers Returneras om förfrågan innehåller en Origin header och CORS aktiveras med en matchningsregel. Returnerar listan över svarshuvuden som ska exponeras till klienten eller utgivaren av begäran.
Access-Control-Allow-Credentials Returneras om förfrågan innehåller en Origin header och CORS aktiveras med en matchningsregel som inte tillåter alla ursprung. Det här huvudet är inställt på true.
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 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 den x-ms-client-request-id rubriken inte finns i begäran visas den inte i svaret.

Svarsdel

None.

Authorization

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden Set 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 Set 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

Att anropa Set Container Metadata operationen skriver över all befintlig metadata som är kopplad till containern. Det går inte att ändra ett enskilt namn/värde-par.

Du kan också ställa in metadata för en container när den skapas.

Anrop Set Container Metadata uppdaterar ETag och Last-Modified-Time egenskaper för containern. Om begäran gjordes med version 2011-08-18 är den uppdaterade ETag innesluten inom citationstecken.

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

Operation Typ av lagringskonto Faktureringskategori
Ange containermetadata Premiumblockblob
Standard för allmän användning v2		 Övriga operationer
Ange containermetadata Standard allmän användning v1 Skrivåtgärder

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

Se även

Status och felkoder
Felkoder för Blob Service
Sätt in och hämta egenskaper och metadata för Blob Storage-resurser

  • Uppdaterades senast