Vytvořit soubor
Operace Create File
vytvoří nový soubor nebo nahradí soubor. Při volání metody Create File
pouze inicializujete soubor. Pokud chcete do souboru přidat obsah, zavolejte Put Range
operaci .
Dostupnost protokolu
Povolený protokol sdílené složky | K dispozici. |
---|---|
SMB | |
NFS |
Žádost
Požadavek můžete vytvořit Create File
následujícím způsobem. Doporučujeme používat protokol HTTPS.
Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními, jak je popsáno v následující tabulce:
Komponenta cesty | Popis |
---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
mydirectorypath |
Nepovinný parametr. Cesta k adresáři, ve kterém se má soubor vytvořit. Pokud cestu k adresáři vynecháte, soubor se vytvoří v rámci zadané sdílené složky. Pokud je adresář zadaný, musí již existovat v rámci sdílené složky, abyste mohli soubor vytvořit. |
myfile |
Název souboru, který chcete vytvořit. |
Informace o omezeních pojmenování 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 se timeout vyjadřuje 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 |
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. |
Content-Length |
Nepovinný parametr. Pokud je k dispozici, musí být nula. |
x-ms-content-length: byte value |
Povinná hodnota. Tato hlavička určuje maximální velikost souboru, a to až 4 tebibajty (TiB). |
Content-Type nebo x-ms-content-type |
Nepovinný parametr. Typ obsahu MIME souboru. Výchozí typ je application/octet-stream . |
Content-Encoding nebo x-ms-content-encoding |
Nepovinný parametr. Určuje, která kódování obsahu byla u souboru použita. Tato hodnota se vrátí klientovi při provedení operace Získat soubor u prostředku souboru a můžete ji použít k dekódování obsahu souboru. |
Content-Language nebo x-ms-content-language |
Nepovinný parametr. Určuje přirozené jazyky používané tímto prostředkem. |
Cache-Control nebo x-ms-cache-control |
Nepovinný parametr. Azure Files tuto hodnotu ukládá, ale nepoužívá ji ani neupravuje. |
x-ms-content-md5 |
Nepovinný parametr. Nastaví hodnotu hash MD5 souboru. |
x-ms-content-disposition |
Nepovinný parametr. Nastaví hlavičku Content-Disposition souboru. |
x-ms-type: file |
Povinná hodnota. Nastavte tuto hlavičku na file . |
x-ms-meta-name:value |
Nepovinný parametr. Páry název-hodnota, které jsou přidružené k souboru jako metadata. Názvy metadat musí splňovat pravidla pojmenování pro identifikátory jazyka C#. Poznámka: Metadata souborů zadaná prostřednictvím Azure Files nejsou přístupná z klienta smb (Server Message Block). |
x-ms-file-permission: { inherit ¦ <SDDL> } |
Ve verzi 2019-02-02 až 2021-04-10 je tato hlavička povinná, pokud x-ms-file-permission-key není zadána. Od verze 2021-06-08 jsou obě hlavičky volitelné. Toto oprávnění je popisovač zabezpečení pro soubor zadaný v jazyce SDDL (Security Descriptor Definition Language). Tuto hlavičku můžete použít, pokud je velikost oprávnění 8 kibibajtů (KiB) nebo menší. V opačném případě můžete použít x-ms-file-permission-key . Pokud zadáte hlavičku, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Můžete předat hodnotu zdědit inherit z nadřazeného adresáře. |
x-ms-file-permission-key: <PermissionKey> |
Ve verzi 2019-02-02 až 2021-04-10 je tato hlavička povinná, pokud x-ms-file-permission není zadána. Od verze 2021-06-08 jsou obě hlavičky volitelné. Pokud není zadána žádná hlavička, použije se pro hlavičku x-ms-file-permission výchozí hodnota inherit .Klíč můžete vytvořit voláním Create Permission rozhraní API. |
x-ms-file-attributes |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 a novější. Tato hlavička obsahuje atributy systému souborů, které mají být nastaveny pro soubor. Další informace najdete v seznamu dostupných atributů. Výchozí hodnota je None . |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 a novější. Vlastnost čas vytvoření souboru utc (Coordinated Universal Time). Hodnota může now být použita k označení času požadavku. Výchozí hodnota je now . |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 a novější. Vlastnost posledního zápisu souboru ve standardu UTC (Coordinated Universal Time). K označení času požadavku můžete použít hodnotu now . Výchozí hodnota je now . |
x-ms-lease-id: <ID> |
Vyžaduje se, pokud má soubor aktivní zapůjčení. K dispozici pro verzi 2019-02-02 a novější. |
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. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Nepovinný parametr. Verze 2021-06-08 a novější. Vlastnost změnit čas koordinovaného univerzálního času (UTC) pro soubor ve formátu ISO 8601. K označení času požadavku můžete použít hodnotu now . Výchozí hodnota je now . |
x-ms-file-request-intent |
Vyžaduje se, pokud Authorization hlavička určuje token OAuth. Přijatelná hodnota je backup . Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action by se měly udělit nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky Authorization . K dispozici pro verzi 2022-11-02 a novější. |
x-ms-allow-trailing-dot: { <Boolean> } |
Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich. |
Text požadavku
Žádné
Ukázkový požadavek
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT
Content-Type: text/plain; charset=UTF-8
x-ms-content-length: 1024
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
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).
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 hlavičky popsané v následující tabulce. 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 | Popis |
---|---|
ETag |
ETag obsahuje hodnotu, která představuje verzi souboru. Hodnota je uzavřena v uvozovkách. |
Last-Modified |
Vrátí datum a čas poslední změny souboru. 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í adresář nebo jeho vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny adresáře. |
x-ms-request-id |
Jednoznačně identifikuje požadavek, který byl proveden, a lze 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á se používá 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-request-server-encrypted: true/false |
Verze 2017-04-17 a novější. Hodnota této hlavičky je nastavena na true , pokud jste úspěšně zašifrovali obsah požadavku pomocí zadaného algoritmu. Pokud šifrování není úspěšné, hodnota je false . |
x-ms-file-permission-key |
Klíč oprávnění k souboru. |
x-ms-file-attributes |
Atributy systému souborů v souboru. Další informace najdete v seznamu dostupných atributů. |
x-ms-file-creation-time |
Hodnota data a času UTC, která představuje vlastnost času vytvoření souboru. |
x-ms-file-last-write-time |
Hodnota data a času UTC, která představuje vlastnost čas posledního zápisu souboru. |
x-ms-file-change-time |
Datum a čas UTC, která představuje vlastnost čas změny souboru. |
x-ms-file-file-id |
ID souboru. |
x-ms-file-parent-id |
ID nadřazeného souboru souboru. |
x-ms-client-request-id |
Používá se k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, není v odpovědi. |
Text odpovědi
Žádné
Ukázková odpověď
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Atributy systému souborů
Atribut | Atribut souboru Win32 | Definice |
---|---|---|
ReadOnly | FILE_ATTRIBUTE_READONLY | Soubor, který je jen pro čtení. Aplikace můžou soubor číst, ale nemůžou do něj zapisovat ani ho odstranit. |
Skrytý | FILE_ATTRIBUTE_HIDDEN | Soubor je skrytý. Není součástí běžného výpisu adresáře. |
Systémový | FILE_ATTRIBUTE_SYSTEM | Soubor, který operační systém používá nebo používá výhradně. |
Žádné | FILE_ATTRIBUTE_NORMAL | Soubor, který nemá nastavené další atributy. Tento atribut je platný pouze při použití samostatně. |
Archiv | FILE_ATTRIBUTE_ARCHIVE | Soubor, který je archivní soubor. Aplikace obvykle používají tento atribut k označení souborů pro zálohování nebo odebrání. |
Dočasné | FILE_ATTRIBUTE_TEMPORARY | Soubor, který se používá pro dočasné úložiště. |
Offline | FILE_ATTRIBUTE_OFFLINE | Data souboru nejsou k dispozici okamžitě. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility se systémem Windows. Azure Files ho nepodporuje s možnostmi offline úložiště. |
NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Soubor nemá indexovat služba indexování obsahu. |
NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Datový proud uživatele, který nemá číst skener integrity dat na pozadí. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility se systémem Windows. |
Poznámky
Pokud chcete vytvořit nový soubor, nejprve ho inicializujte voláním Create File
a určením jeho maximální velikosti, až 4 TiB. Při provádění této operace nezahrnujte obsah do textu požadavku. Po vytvoření souboru zavolejte Put Range
a přidejte do něj obsah nebo ho upravte.
Velikost souboru můžete změnit voláním Set File Properties
příkazu .
Pokud sdílená složka nebo nadřazený adresář neexistuje, operace selže se stavovým kódem 412 (Předběžná podmínka se nezdařila).
Poznámka
Vlastnosti cache-control
souborů , content-type
, content-md5
, content-encoding
a content-language
jsou oddělené od vlastností systému souborů, které jsou k dispozici klientům SMB. Klienti SMB nemohou tyto hodnoty vlastností číst, zapisovat ani upravovat.
Pokud má existující soubor aktivní zapůjčení, musí klient v požadavku zadat platné ID zapůjčení. Pokud klient nezadá ID zapůjčení nebo zadá neplatné ID zapůjčení, vrátí Azure Files stavový kód 412 (Předběžná podmínka selhala). Pokud klient zadá ID zapůjčení, ale soubor nemá aktivní zapůjčení, vrátí Azure Files stavový kód 412 (Předběžná podmínka selhala) i v této instanci. Pokud klient zadá ID zapůjčení souboru, který ještě neexistuje, vrátí Azure Files stavový kód 412 (Předběžná podmínka selhala) pro požadavky, které jsou provedeny proti verzi 2019-02-02-02 a novější.
Pokud operace přepíše existující soubor s aktivním zapůjčením Create File
, zapůjčení se v aktualizovaném souboru zachová až do jeho vydání.
Create File
se nepodporuje u snímku sdílené složky, což je kopie sdílené složky jen pro čtení. Pokus o provedení této operace na snímku sdílené složky selže se stavovým kódem 400 (InvalidQueryParameterValue).