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 sdílené složky – aktualizovat operaci poskytovanou poskytovatelem prostředků úložiště (Microsoft.Storage). Další informace o programové interakci s FileShare prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace se sdílenými prostředky.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici |
|---|---|
| SMB |
|
| NFS |
|
Prosba
Požadavek Set Share Properties můžete vytvořit následujícím způsobem. Doporučujeme HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.
| Metoda | Identifikátor URI požadavku | Verze HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Součásti cesty zobrazené v identifikátoru URI požadavku nahraďte vlastními, a to následujícím způsobem:
| Komponenta Path | Popis |
|---|---|
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í a odkazování 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 |
Volitelný. 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 povinné a volitelné 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. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-share-quota |
Volitelný. 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 |
Volitelný. Podporováno ve verzi 2019-12-12 a novějších. Určuje úroveň přístupu sdílené složky. Platné hodnoty jsou TransactionOptimized, Hota Cool. Podrobné informace o vrstvení sdílených složek najdete v tématu úrovně úložiště Azure Files. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Volitelný. Podporováno ve verzi 2020-02-10 a novějších. Určuje chování kořenového squashingu ve sdílené složce, když je povolen systém souborů NFS.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Volitelný. Podporováno ve verzi 2024-08-04 a novějších. Určuje, jestli má být virtuální adresář snímků přístupný v kořenovém adresáři přípojného bodu sdílené složky, pokud je povolen systém souborů NFS. |
x-ms-client-request-id |
Volitelný. Poskytuje klientem vygenerovanou neprůhlenou hodnotu s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech Analýzy ú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í služby 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 se nezdařila). Pokud je tato hlavička zadaná 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 se nezdařila). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Volitelný. Podporováno ve verzi 2024-11-04 a novější. Povolené pouze pro sdílené složky úrovně Premium (sdílené složky v rámci typu účtu úložiště FileStorage). Tuto vlastnost lze použít k povolení nebo zakázání placených shluků. Pokud vlastnost není zadána, sdílená složka si zachová svůj stávající stav povolení pro zvýšení kapacity. |
x-ms-share-paid-bursting-max-iops |
Volitelný. Podporováno ve verzi 2024-11-04 a novější. Povoluje se jenom u sdílených složek úrovně Premium. Celé číslo představující maximální počet placených vstupně-výstupních operací za sekundu (IOPS) povolených pro sdílenou složku. Pokud u sdílené složky ještě není povolené placené rozšíření: Chování je stejné jako záhlaví x-ms-share-paid-bursting-max-iops v části Vytvořit sdílenou složku. Výchozí hodnota, pokud není zadána, je maximální povolený počet vstupně-výstupních operací za sekundu pro sdílenou složku. Pokud je tato hlavička nastavená, musí být x-ms-share-paid-bursting-enabled také nastavena na true.Pokud je u sdílené složky už povolené placené shlukování: x-ms-share-paid-bursting-max-iops je možné použít k aktualizaci maximálního počtu IOPS pro tuto sdílenou složku.
x-ms-share-paid-bursting-enabled v tomto případě není nutné nastavit. Pokud je x-ms-share-paid-bursting-enabled nastavená na hodnotu true, ale x-ms-share-paid-bursting-max-iops není nastavená, maximální počet IOPS pro nárazové nárůsty zůstane beze změny. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Volitelný. Podporováno ve verzi 2024-11-04 a novější. Povoluje se jenom u sdílených složek úrovně Premium. Celé číslo představující maximální počet placených mebibajtů za sekundu (MiB/s) povolených pro sdílenou složku. Pokud u sdílené složky ještě není povolené placené rozšíření: Chování je stejné jako záhlaví x-ms-share-paid-bursting-max-bandwidth-mibps v části Vytvořit sdílenou složku. Výchozí hodnota, pokud není zadána, je maximální povolený MiB/s pro sdílenou složku. Pokud je tato hlavička nastavená, musí být x-ms-share-paid-bursting-enabled také nastavena na true.Pokud je u sdílené složky už povolené placené shlukování: x-ms-share-paid-bursting-max-bandwidth-mibps je možné použít k aktualizaci maximálního placeného nárůstu miB/s pro sdílenou složku.
x-ms-share-paid-bursting-enabled v tomto případě není nutné nastavit. Pokud je x-ms-share-paid-bursting-enabled nastavená na hodnotu true, ale x-ms-share-paid-bursting-max-bandwidth-mibps není nastavená, maximální placená šířka pásma pro nárazové rozšíření zůstane beze změny. |
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 naleznete v tématu Stav a kódy chyb.
Hlavičky odpovědi
Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.
| Hlavička odpovědi | Popis |
|---|---|
Last-Modified |
Vrátí datum a čas poslední změny sdílené složky. Formát data se řídí dokumentem RFC 1123. Další informace naleznete v tématu Reprezentace hodnot data a času v záhlavích. Jakákoli operace, která upravuje 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áku. |
x-ms-request-id |
Jednoznač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 služby Azure Files, která se používá k provedení 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 se rovná hodnotě hlavičky x-ms-client-request-id, pokud se nachází v požadavku a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nebude tato hlavička v odpovědi k dispozici. |
Text odpovědi
Žádný.
Oprávnění
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á. Do sdílené složky ale nebudete moct přidávat další data, dokud nedojde ke snížení množství dat ve sdílené složce pod kvótou. Množství dat můžete snížit odstraněním nebo komprimací souborů.
Set Share Properties snímek sdílené složky nepodporuje. Pokus o provedení této operace na snímku sdílené složky selže se stavovým kódem 400 (InvalidQueryParameterValue).
Pokud pro sdílené složky NFS nastavíte hlavičku x-ms-enable-snapshot-virtual-directory-access, znovu připojte sdílenou složku, abyste mohli sledovat aktualizované chování.