Vytvořit sdílenou složku
Operace Create Share
vytvoří novou sdílenou složku Azure Files pod zadaným účtem. I když je toto rozhraní API plně podporované, jedná se o starší verzi rozhraní API pro správu. Doporučujeme místo toho použít sdílené složky – Vytvoření, které poskytuje poskytovatel prostředků Azure Storage (Microsoft.Storage). Další informace o tom, jak programově pracovat s prostředky pomocí poskytovatele prostředků Azure Storage, najdete v tématu Operace se sdílenýmiFileShare
složkami.
Pokud sdílená složka se stejným názvem již existuje, operace se nezdaří. Prostředek sdílené složky obsahuje metadata a vlastnosti této sdílené složky. Neobsahuje seznam souborů obsažených ve sdílené složce.
Dostupnost protokolu
Povolený protokol sdílených složek | K dispozici. |
---|---|
SMB (Server Message Block) | |
Systém souborů NFS (Network File System) |
Žádost
Můžete vytvořit požadavek, Create Share
jak je znázorněno tady. Doporučujeme použít https.
Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty, které jsou 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. Název může obsahovat pouze malá písmena. |
Další informace o omezeních názvů cest najdete v tématu Názvy a odkazy 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 |
Nepovinný parametr. Parametr časového limitu je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace souborové služby. |
Hlavičky požadavku
Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:
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 čas koordinovaného univerzálního času (UTC) požadavku. 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. Pár název-hodnota, který se přidruží ke sdílené složce jako metadata. Názvy metadat musí splňovat pravidla pojmenování identifikátorů jazyka C#. |
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 úrovních sdílených složek najdete v tématu Azure Files úrovně úložiště. |
x-ms-enabled-protocols: <SMB \| NFS> |
Nepovinný parametr. Podporováno ve verzi 2019-07-07 a novější. Určuje povolené protokoly ve sdílené složce. Pokud nejsou zadané, výchozí hodnota je SMB. - SMB : Sdílená složka je přístupná přes SMBv3.0, SMBv2.1 a REST.- NFS : Ke sdílené složce má přístup NFSv4.1. Pro tuto možnost je vyžadován prémiový účet. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Nepovinný parametr. Pouze systém souborů NFS. Podporováno ve verzi 2019-07-07 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. - NoRootSquash : Vypněte root squashing.- RootSquash : Namapujte požadavky z uid/gid 0 na anonymní uid/gid.- AllSquash : Namapujte všechny identifikátory uid a gids na anonymního uživatele. |
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 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 Files. |
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 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 |
---|---|
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 najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví sdílenou složku, její vlastnosti či 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 Azure Files verzi, která byla použita ke spuštění požadavku. |
Date |
Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována. |
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ě x-ms-client-request-id hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se nenachází. |
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
Autorizace
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 pro sdílenou složku můžete při jejím vytváření zadat zahrnutím jedné nebo více hlaviček metadat do požadavku. Formát hlavičky metadat je x-ms-meta-name:value
.
Pokud je sdílená složka se stejným názvem odstraněna při volání Create Share
, 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, které jsou přidružené k souborům a slouží k výpočtu velikosti fakturace pro účet úložiště, se v kvótě nepočítá.
Pokud součet velikostí souborů ve sdílené složce překročí kvótu nastavenou pro sdílenou složku, pokusy o zvětšení velikosti souboru selžou a vytvář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 účtují poplatky za velikost souborů a režijní náklady.