Sdílet prostřednictvím

Nastavení metadat adresáře

  • Článek

Operace Set Directory Metadata nastaví uživatelsky definovaná metadata pro zadaný adresář. Tato operace se podporuje ve verzi 2015-02-21 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.

Dostupnost protokolu

Povolený protokol sdílené složky K dispozici
SMB Ano
NFS Ano

Prosba

Požadavek Set Directory Metadata je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Metoda Identifikátor URI požadavku Verze HTTP
DÁT https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& comp=metadata HTTP/1.1

Součásti cesty, které se zobrazují v identifikátoru URI požadavku, nahraďte vlastními:

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

Informace o omezeních pojmenování cest najdete v tématu Název a referenční 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 Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace souborové služby.

Hlavičky požadavku

Povinná a volitelná hlavička požadavku jsou popsána v následujících tabulkách:

Běžné hlavičky požadavků

Hlavička požadavku Popis
Authorization Požadovaný. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Tato operace se podporuje ve verzi 2015-02-21 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.

Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-meta-name:value Volitelný. 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. Chcete-li odebrat všechna metadata z adresáře, zavolejte tuto operaci bez záhlaví metadat.

Názvy metadat musí dodržovat pravidla pojmenování pro identifikátory jazyka C# .
x-ms-client-request-id Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem 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í služby Azure Files.
x-ms-file-request-intent Vyžaduje se, pokud hlavička Authorization určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action by měly být uděleny, pokud jsou zahrnuty do zásad RBAC přiřazené k identitě, která je autorizovaná pomocí hlavičky Authorization. K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> } Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli by se měla oříznout koncová tečka v adrese URL požadavku, nebo ne.

Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky.

Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

Hlavičky požadavků jenom smb

Žádný.

Pouze hlavičky požadavků NFS

Žádný.

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 naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje hlavičky v následujících tabulkách. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Běžná hlavička odpovědi

Hlavička odpovědi Popis
ETag Obsahuje hodnotu, která představuje verzi adresáře. Hodnota je uzavřena v uvozovkách.
x-ms-request-id Jednoznač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 k provedení požadavku.
Date nebo x-ms-date Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi.
x-ms-request-server-encrypted: true/false Verze 2017-04-17 a novější Hodnota této hlavičky je nastavená na true, pokud se obsah požadavku úspěšně zašifruje pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na false.
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ě hlavičky x-ms-client-request-id, pokud se nachází v požadavku a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nezobrazí se v odpovědi.

Hlavičky odpovědi pouze smb

Žádný.

Pouze hlavičky odpovědi NFS

Žádný.

Text odpovědi

Žádný.

Oprávnění

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Set Directory Metadata se na snímku sdílené složky nepodporuje, což je kopie sdílené složky jen pro čtení. Pokus o provedení této operace na snímku sdílené složky selže se 400 (InvalidQueryParameterValue).

Viz také

operace v adresářích