Vytvořit sdílenou složku
Operace Create Share vytvoří novou sdílenou složku Azure Files v rámci zadaného účtu. I když je toto rozhraní API plně podporované, jedná se o starší rozhraní API pro správu. Doporučujeme místo toho použít sdílené složky – vytvořit, který poskytuje poskytovatel prostředků Azure Storage (Microsoft.Storage). Další informace o programové interakci s prostředky FileShare pomocí poskytovatele prostředků Azure Storage najdete v tématu Operace se sdílenými složkami.
Pokud sdílená složka se stejným názvem již existuje, operace selže. Prostředek sdílené složky obsahuje metadata a vlastnosti pro danou sdílenou složku. Neobsahuje seznam souborů obsažených ve sdílené složce.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici |
|---|---|
| Server Message Block (SMB) |
|
| Systém souborů NFS (Network File System) |
|
Prosba
Můžete vytvořit požadavek Create Share, jak je znázorněno zde. Doporučujeme používat PROTOKOL HTTPS.
| Metoda | Identifikátor URI požadavku | Verze HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
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. Název může obsahovat jenom malá písmena. |
Další 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
Pro identifikátor URI požadavku můžete zadat následující další parametry:
| Parametr | Popis |
|---|---|
timeout |
Volitelný. Parametr časového limitu 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í tabulce:
| 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 čas koordinovaného univerzálního času (UTC) požadavku. 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-meta-name:value |
Volitelný. Pár název-hodnota, který se přidruží ke sdílené složce jako metadata. Názvy metadat musí dodržovat pravidla pojmenování pro identifikátory jazyka C# . |
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 vrstvách sdílené složky najdete v tématu vrstvách úložiště Azure Files. |
x-ms-enabled-protocols: <SMB \| NFS> |
Volitelný. Podporováno ve verzi 2019-07-07 a novějších. Určuje povolené protokoly ve sdílené složce. Pokud nejsou zadané, výchozí hodnota je SMB. - SMB: Ke sdílené složce má přístup SMBv3.0, SMBv2.1 a REST.- NFS: Ke sdílené složce má přístup NFSv4.1. Pro tuto možnost se vyžaduje prémiový účet. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Volitelný. Pouze systém souborů NFS. Podporováno ve verzi 2019-07-07 a novějších. 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. - NoRootSquash: Vypněte root squashing.- RootSquash: Mapujte žádosti z uid/gid 0 na anonymní uid/gid.- AllSquash: Namapujte všechny identifikátory uid a gidy na anonymního uživatele. |
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. Pokud není zadáno, výchozí hodnota je true. |
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-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). Tato vlastnost umožňuje placené shlukování. Pokud vlastnost není zadána, výchozí hodnota je false. |
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. 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. |
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. 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. |
Text požadavku
Žádný.
Ukázkový požadavek
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
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 201 (vytvořeno).
Další informace 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 |
|---|---|
ETag |
Obsahuje hodnotu, která představuje verzi sdílené složky uzavřenou v uvozovkách. |
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á upraví sdílenou složku nebo její vlastnosti nebo metadata, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny sdílené složky. |
x-ms-request-id |
Jednoznačně identifikuje požadavek a 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 služby Azure Files, která se použila k provedení požadavku. |
Date |
Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi. |
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, není v odpovědi k dispozici. |
Text odpovědi
Žádný.
Ukázková odpověď
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Oprávnění
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Sdílené složky se vytvoří okamžitě v rámci účtu úložiště. Není možné vnořit jednu sdílenou složku do jiné.
Metadata sdílené složky můžete zadat tak, že do požadavku zahrnete jednu nebo více hlaviček metadat. Formát hlavičky metadat je x-ms-meta-name:value.
Pokud se při volání Create Shareodstraní sdílená složka se stejným názvem, server vrátí stavový kód 409 (Konflikt) a další informace o chybě značí, že se sdílená složka odstraňuje.
Kvótu velikosti sdílené složky můžete použít k omezení velikosti souborů uložených ve sdílené složce. Kvóta neomezuje velikost snímků. Režijní náklady přidružené k souborům a používané k výpočtu velikosti fakturace účtu úložiště se neúčtují v kvótě.
Když součet velikostí souborů ve sdílené složce překročí kvótu nastavenou ve sdílené složce, pokusy o zvětšení velikosti souboru selžou a vytvoření nových neprázdných souborů (přes REST) selže. Stále budete moct vytvářet prázdné soubory.
Změna nebo nastavení kvóty nemá žádný vliv na fakturaci. Stále se vám účtuje velikost souborů a režijní náklady.