Nastavení metadat adresáře

Článek
03/29/2023

Operace Set Directory Metadata nastaví uživatelem definovaná metadata pro zadaný adresář. Tato operace je dostupná ve verzi 2015-02-21 a novější.

Dostupnost protokolu

Povolený protokol sdílených složek	K dispozici.
SMB
NFS

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	`https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& comp=metadata`	HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty, které jsou uvedené v identifikátoru URI požadavku, vlastními:

Komponenta Cesta	Description
`myaccount`	Název vašeho účtu úložiště.
`myshare`	Název sdílené složky.
`myparentdirectorypath`	Nepovinný parametr. Cesta k nadřazené adresáři.
`mydirectory`	Název adresáře.

Informace o omezeních pojmenování cest najdete v tématu Názvy a odkazy na sdílené složky, adresáře, soubory a metadata.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry:

Parametr	Popis
`timeout`	Nepovinný parametr. Parametr `timeout` je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace souborové služby.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje autorizační schéma, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date` nebo `x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Tato operace je k dispozici pouze ve verzi 2015-02-21 a novější. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-meta-name:value`	Nepovinný parametr. Nastaví dvojici název-hodnota pro adresář. Každé volání této operace nahradí všechna existující metadata připojená k adresáři. Pokud chcete z adresáře odebrat všechna metadata, zavolejte tuto operaci bez hlaviček metadat. Názvy metadat musí splňovat pravidla pojmenování identifikátorů jazyka C#.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files.
`x-ms-file-request-intent`	Vyžaduje se, pokud `Authorization` hlavička určuje token OAuth. Přijatelná hodnota je `backup`. Tato hlavička určuje, že `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` by se měly udělit nebo `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky `Authorization` . K dispozici pro verzi 2022-11-02 a novější.
`x-ms-allow-trailing-dot: { <Boolean> }`	Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď obsahuje také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`ETag`	Obsahuje hodnotu, která představuje verzi adresáře. Hodnota je uzavřena v uvozovkách.
`x-ms-request-id`	Jedinečně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Označuje verzi souborové služby, která se použila ke spuštění požadavku.
`Date` nebo `x-ms-date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`x-ms-request-server-encrypted: true/false`	Verze 2017-04-17 a novější. Hodnota této hlavičky je nastavena na `true` , pokud je obsah požadavku úspěšně zašifrován pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na `false`hodnotu .
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička `x-ms-client-request-id` v požadavku není, nebude v odpovědi.

Text odpovědi