Nastavení vlastností sdílené složky
Operace Set Share Properties
nastaví vlastnosti pro zadanou sdílenou složku Azure. 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 FileShare
prostředky sdílení souborů.
Dostupnost protokolu
Povolený protokol sdílených složek | K dispozici. |
---|---|
SMB | |
NFS |
Žádost
Požadavek můžete vytvořit Set Share Properties
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=properties |
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-share-quota |
Nepovinný parametr. Podporováno ve verzi 2015-02-21 a novější. Určuje maximální velikost sdílené složky v gibibajtech (GiB). |
x-ms-access-tier |
Nepovinný parametr. Podporováno ve verzi 2019-12-12 a novější. Určuje úroveň přístupu sdílené složky. Platné hodnoty jsou TransactionOptimized , Hot a Cool . Podrobné informace o vrstvení sdílených složek najdete v tématu Azure Files vrstvách úložiště. |
x-ms-root-squash: <NoRootSquash | RootSquash | AllSquash> |
Nepovinný parametr. Podporováno ve verzi 2020-02-10 a novější. Určuje chování kořenového squashingu ve sdílené složce, když je povolen systém souborů NFS. Pokud není zadaný, výchozí hodnota je NoRootSquash .
|
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=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
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 jako řetězec v uvozovávce. |
x-ms-request-id |
Jedinečně identifikuje požadavek, který byl proveden. Můžete ho také 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á se používá 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 se hlavička x-ms-client-request-id v požadavku nenachází, nebude tato hlavička v odpovědi. |
Text odpovědi
Žádné
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Další informace o nastavení kvóty sdílené složky najdete v tématu Vytvoření sdílené složky.
Pokud nastavíte kvótu sdílené složky tak, aby byla menší než velikost dat ve sdílené složce, operace bude úspěšná. Nebudete ale moct do sdílené složky přidat další data, dokud se množství dat ve sdílené složce nesníží pod kvótu. Objem dat můžete snížit odstraněním nebo komprimací souborů.
Set Share Properties
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).