Dela via


Ange katalogmetadata

Den Set Directory Metadata åtgärden anger användardefinierade metadata för den angivna katalogen. Den här åtgärden stöds i version 2015-02-21 och senare för filresurser med SMB-protokollet aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.

Protokolltillgänglighet

Aktiverat filresursprotokoll Tillgänglig
SMB Ja
NFS Ja

Begäran

Den Set Directory Metadata begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.

Metod Begärande-URI HTTP-version
STÄLLA 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 Beskrivning
myaccount Namnet på ditt lagringskonto.
myshare Namnet på filresursen.
myparentdirectorypath Valfri. 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 Valfri. 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äranderubrikerna beskrivs i följande tabeller:

Vanliga begärandehuvuden

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 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. Den här åtgärden stöds i version 2015-02-21 och senare för filresurser med SMB-protokollet aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.

Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-meta-name:value Valfri. 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 metadatahuvuden.

Metadatanamn måste följa namngivningsreglerna för C#-identifierare.
x-ms-client-request-id Valfri. 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 Files-.
x-ms-file-request-intent Krävs om Authorization rubrik 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 RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare.
x-ms-allow-trailing-dot: { <Boolean> } Valfri. 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.

Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard.

Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata.

Endast SMB-begärandehuvuden

Ingen.

Endast NFS-begärandehuvuden

Ingen.

Begärandetext

Ingen.

Svar

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

Vanliga svarshuvuden

Svarsrubrik Beskrivning
ETag Innehåller ett värde som representerar katalogens version. Värdet omges av citattecken.
x-ms-request-id Identifierar unikt den begäran som gjordes 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 UTC-datum/tid-värde 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 är inställt på 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 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.

Endast SMB-svarshuvuden

Ingen.

Endast NFS-svarshuvuden

Ingen.

Svarstext

Ingen.

Tillstånd

Endast kontoägaren kan anropa den här åtgärden.

Anmärkningar

Set Directory Metadata stöds inte i en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue).

Se även

åtgärder för kataloger