Nastavení metadat sdílené složky
Operace Set Share Metadata nastaví jeden nebo více uživatelsky definovaných dvojic název/hodnota pro zadanou sdílenou složku. I když je tato operace plně podporovaná, jedná se o starší operaci správy. Doporučujeme místo toho použít operaci Sdílené složky – Aktualizace , kterou poskytuje poskytovatel prostředků úložiště (Microsoft.Storage). Další informace o programové interakci s prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace s FileShareprostředky sdílení souborů.
Dostupnost protokolu
| Povolený protokol sdílených složek | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
Požadavek vytvoříte Set Share Metadata následujícím způsobem. Doporučujeme HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.
| Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty 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. |
Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.
Parametry identifikátoru URI
V identifikátoru URI požadavku můžete zadat následující další parametry:
| Parametr | Popis |
|---|---|
timeout |
Nepovinný parametr. Vyjádřeno v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files. |
Hlavičky požadavku
Následující tabulka popisuje požadované a volitelné hlavičky požadavků:
| Hlavička požadavku | Popis |
|---|---|
Authorization |
Povinná hodnota. Určuje schéma autorizace, 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. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-meta-name:value |
Nepovinný parametr. Poskytuje dvojici název/hodnota, která obsahuje metadata pro sdílenou složku. Každé volání této operace nahradí všechna existující metadata připojená ke sdílené složce. Pokud chcete ze sdílené složky odebrat všechna metadata, zavolejte tuto operaci bez záhlaví 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 Analýza úložiště 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 Blob Storage. |
x-ms-lease-id:<ID> |
Vyžaduje se, pokud má cílová sdílená složka aktivní zapůjčení. K dispozici pro verzi 2020-02-10 a novější. Pokud požadavek neobsahuje ID zapůjčení nebo není platný, operace selže se stavovým kódem 412 (Předběžná podmínka selhala). Pokud je tato hlavička zadána a cílová sdílená složka aktuálně nemá aktivní zapůjčení, operace selže se stavovým kódem 412 (Předběžná podmínka selhala). |
Text požadavku
Žádné
Ukázkový požadavek
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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ěď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.
| Hlavička odpovědi | Description |
|---|---|
Last-Modified |
Vrátí datum a čas poslední změny sdílené složky. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví sdílenou složku nebo její vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny sdílené složky. |
ETag |
Obsahuje hodnotu, která představuje verzi sdílené složky v uvozovkách. |
x-ms-request-id |
Jedinečně identifikuje požadavek, který byl proveden. Můžete 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 Azure Files, která byla použita ke spuštění požadavku. |
Date nebo x-ms-date |
Hodnota data a času UTC, která označuje čas, kdy služba odeslala odpověď. |
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 je rovna hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude tato hlavička v odpovědi. |
Text odpovědi
Žádné
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Volání Set Share Metadata přepíše všechna existující metadata přidružená ke sdílené složce. Není možné upravit individuální dvojici název/hodnota.
Metadata pro sdílenou složku můžete také nastavit v okamžiku, kdy je vytvořena, v rámci operace Vytvořit sdílenou složku.
Volání Set Share Metadata aktualizuje ETag vlastnosti a Last-Modified-Time sdílené složky.
Set Share Metadata se nepodporuje pro snímek sdílené složky. Pokus o provedení této operace se snímkem sdílené složky selže se stavovým kódem 400 (InvalidQueryParameterValue). Metadata pro snímek sdílené složky můžete nastavit v okamžiku jeho vytvoření v rámci Snapshot Share operace.