Ange katalogmetadata

Artikel
03/29/2023

Åtgärden Set Directory Metadata anger användardefinierade metadata för den angivna katalogen. Den här åtgärden är tillgänglig i version 2015-02-21 och senare.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	`https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& comp=metadata`	HTTP/1.1

Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:

Sökvägskomponent	Description
`myaccount`	Namnet på ditt lagringskonto.
`myshare`	Namnet på filresursen.
`myparentdirectorypath`	Valfritt. Sökvägen till den överordnade katalogen.
`mydirectory`	Namnet på katalogen.

Information om namngivningsbegränsningar för sökvägar finns i Namn och referensresurser, kataloger, filer och metadata.

URI-parametrar

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

Parameter	Beskrivning
`timeout`	Valfritt. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder.

Begärandehuvuden

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

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
`Date` eller `x-ms-date`	Krävs. Anger Coordinated Universal Time (UTC) 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. Den här åtgärden är endast tillgänglig i version 2015-02-21 och senare. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`x-ms-meta-name:value`	Valfritt. Anger ett namn/värde-par för katalogen. Varje anrop till den här åtgärden ersätter alla befintliga metadata som är kopplade till katalogen. Om du vill ta bort alla metadata från katalogen anropar du den här åtgärden utan metadatarubriker. Metadatanamn måste följa namngivningsreglerna för C#-identifierare.
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. 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 Files.
`x-ms-file-request-intent`	Krävs om `Authorization` huvudet anger en OAuth-token. Acceptabelt värde är `backup`. Det här huvudet anger att `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` eller `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` ska beviljas om de ingår i DEN RBAC-princip som tilldelats den identitet som har behörighet med hjälp av `Authorization` huvudet. Tillgänglig för version 2022-11-02 och senare.
`x-ms-allow-trailing-dot: { <Boolean> }`	Valfritt. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Mer information finns i Namnge och referera till resurser, kataloger, filer och metadata.

Begärandetext

Inga.

Svarsåtgärder

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.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret innehåller även ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarsrubrik	Description
`ETag`	Innehåller ett värde som representerar katalogens version. Värdet omges av citattecken.
`x-ms-request-id`	Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger den filtjänstversion som användes för att köra begäran.
`Date` eller `x-ms-date`	Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades.
`x-ms-request-server-encrypted: true/false`	Version 2017-04-17 och senare. Värdet för det här huvudet anges till `true` om innehållet i begäran har krypterats med den angivna algoritmen. Annars är värdet inställt på `false`.
`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 `x-ms-client-request-id` för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken `x-ms-client-request-id` inte finns i begäran finns den inte i svaret.

Själva svaret