Vytvořit soubor

Operace Create File vytvoří nový soubor nebo nahradí soubor. Tato operace je podporována ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Při volání Create File, inicializujete pouze soubor. Pokud chcete do souboru přidat obsah, zavoláte operaci Put Range. Od verze 2026-02-06 můžete také vytvářet soubor s obsahem až do 4MiB pomocí Create File operace.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici
protokol SMB
NFS

Prosba

Požadavek Create File je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Metoda	Identifikátor URI požadavku	Verze HTTP
VLOŽIT	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile`	HTTP/1.1

Nahraďte součásti cesty zobrazené v identifikátoru URI požadavku vlastními, jak je popsáno v následující tabulce:

Komponenta Path	Popis
`myaccount`	Název vašeho účtu úložiště.
`myshare`	Název sdílené složky.
`mydirectorypath`	Volitelný. Cesta k adresáři, do kterého se má soubor vytvořit. Pokud je cesta k adresáři vynechána, soubor se vytvoří v zadané sdílené složce. Pokud je zadaný adresář, musí již existovat ve sdílené složce, 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ázev a odkazové 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 `timeout` 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ích tabulkách:

Běžné 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 č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. Tato operace je podporována ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`Content-Length`	Určuje počet bajtů přenášených v textu požadavku. Verze 2019-02-02 až 2025-11-05: Volitelné. Pokud je k dispozici, musí být nula. Verze 2026-02-06 nebo novší: Povinná, pokud je obsah zahrnut v těle žádosti. Pokud žádný obsah není přítomen a hlavička je zahrnuta, musí být její hodnota nulová. Pokud je velikost souboru zadaného v `x-ms-content-length` hlavičce menší než `Content-Length`, operace selže s chybovým kódem 400.
`x-ms-content-length: byte value`	Požadovaný. Tato hlavička určuje maximální velikost souboru až 4 tebibajtů (TiB).
`Content-MD5`	Volitelný. Podporováno ve verzi 2026-02-06 nebo novější. Hodnota hash MD5 obsahu. Tato hodnota hash se používá k ověření integrity dat během přenosu. Když je zadán hlavička Content-MD5, Azure Files porovná hash dorazeného obsahu s hodnotou hlavičky, která byla odeslána. Pokud se dvě hodnoty hash neshoduje, operace selže s kódem chyby 400 (Chybný požadavek).
`Content-Type` nebo `x-ms-content-type`	Volitelný. Typ obsahu MIME souboru. Výchozí typ je `application/octet-stream`.
`Content-Encoding` nebo `x-ms-content-encoding`	Volitelný. Určuje, které kódování obsahu se na soubor použilo. Tato hodnota se vrátí klientovi, když se u prostředku souboru provede operace Get File a můžete ji použít k dekódování obsahu souboru.
`Content-Language` nebo `x-ms-content-language`	Volitelný. Určuje přirozené jazyky, které tento prostředek používá.
`Cache-Control` nebo `x-ms-cache-control`	Volitelný. Azure Files ukládá tuto hodnotu, ale nepoužívá ji ani neupravuje.
`x-ms-content-md5`	Volitelný. Nastaví hodnotu hash MD5 souboru.
`x-ms-content-disposition`	Volitelný. Nastaví hlavičku `Content-Disposition` souboru.
`x-ms-type: file`	Požadovaný. Nastavte toto záhlaví na `file`.
`x-ms-meta-name:value`	Volitelný. Dvojice name-value, které jsou přidružené k souboru jako metadata. Názvy metadat musí dodržovat pravidla pojmenování pro identifikátory jazyka C# . Poznámka: Metadata souborů zadaná prostřednictvím služby Azure Files nejsou přístupná z klienta SMB (Server Message Block).
`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 času vytvoření koordinovaného univerzálního času (UTC) souboru. Hodnotu `now` lze použít 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 v koordinovaném univerzálním čase (UTC) Hodnotu `now` můžete použít k označení času požadavku. 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ší. Tato hlavička se ignoruje, pokud se soubor nachází ve sdílené složce s povoleným protokolem NFS, který nepodporuje zapůjčení souborů.
`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-file-request-intent`	Vyžaduje se, pokud hlavička `Authorization` určuje token OAuth. Přijatelná hodnota je `backup`. Tato hlavička určuje, že se mají udělit `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` nebo `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action`, pokud jsou zahrnuty do zásad RBAC přiřazené k identitě, která je autorizovaná pomocí hlavičky `Authorization`. K dispozici pro verzi 2022-11-02 a novější.
`x-ms-allow-trailing-dot: { <Boolean> }`	Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli by se měla oříznout koncová tečka v adrese URL požadavku, nebo ne. Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.
`x-ms-structured-body`	Je vyžadováno, pokud je formát zprávy v těle požadavku strukturovaný. Hodnota této hlavičky obsahuje verzi a vlastnosti schématu zpráv. V současnosti je podporovanou `XSM/1.0; properties=crc64`pouze hodnotou , což znamená, že požadavek používá kontrolní součet crc64 segmentů v zakódované zprávě. Pokud hodnota neodpovídá, operace selže s chybovým kódem 400 (Špatný požadavek). Požadavek také selže, pokud obsah uvedený v požadavku neodpovídá zadanému kontrolnímu součtu pro daný segment. Dostupné pro verzi 2026-06-06 a vyšší. Podporováno pouze pro požadavky s délkou obsahu větší než nula.
`x-ms-structured-content-length`	Je vyžadováno, pokud je formát zprávy těla požadavku strukturovaný, tj. `x-ms-structured-body` je specifikován s požadavkem. Hodnota této hlavičky je délka obsahu souboru a vždy bude menší než `Content-Length` hodnota hlavičky kvůli kódování zpráv. Pokud hodnota hlavičky neodpovídá délce obsahu bloku uvedeného v požadavku, operace selže s chybovým kódem 400 (Špatný požadavek). Dostupné pro verzi 2026-06-06 a vyšší.

Hlavičky požadavků jenom smb

Hlavička požadavku	Popis
`x-ms-file-change-time: { now ¦ <DateTime> }`	Volitelný. Verze 2021-06-08 a novější Vlastnost času koordinovaného univerzálního času (UTC) pro soubor změní ve formátu ISO 8601. Hodnotu `now` můžete použít k označení času požadavku. Výchozí hodnota je `now`.
`x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> }`	Ve verzi 2019-02-02 až 2021-04-10 se tato hlavička vyžaduje, pokud není zadána `x-ms-file-permission-key`. Od verze 2021-06-08 jsou obě hlavičky volitelné. Toto oprávnění je popisovač zabezpečení pro soubor zadaný v SDDL (Security Descriptor Definition Language) nebo (verze 2024-11-04 nebo novější) ve formátu binární popisovač zabezpečení. Můžete určit, který formát se má použít se záhlavím `x-ms-file-permission-format`. 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 záhlaví, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Můžete předat hodnotu `inherit`, která dědí z nadřazeného adresáře.
`x-ms-file-permission-format: { sddl ¦ binary }`	Volitelný. Verze 2024-11-04 nebo novější Určuje, zda hodnota předaná v `x-ms-file-permission` je v SDDL nebo v binárním formátu. Pokud je `x-ms-file-permission` nastavená na `inherit`, nemělo by být toto záhlaví nastaveno. Pokud je `x-ms-file-permission` nastavena na jinou hodnotu než `inherit`a pokud tato hlavička není nastavená, použije se výchozí hodnota `sddl`.
`x-ms-file-permission-key: <PermissionKey>`	Ve verzi 2019-02-02 až 2021-04-10 se tato hlavička vyžaduje, pokud není zadána `x-ms-file-permission`. Od verze 2021-06-08 jsou obě hlavičky volitelné. Pokud není zadána žádná hlavička, použije se výchozí hodnota `inherit` pro hlavičku `x-ms-file-permission`. Klíč můžete vytvořit voláním rozhraní API `Create Permission`.
`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é se mají v souboru nastavit. Další informace naleznete v seznamu dostupných atributů. Výchozí hodnota je `None`.
`x-ms-file-property-semantics: { New ¦ Restore }`	Volitelný. Podporováno ve verzi 2026-02-06 nebo novější. Výchozí hodnota je `New`. `New` / `Restore` Sémantika upravuje, jak aplikovat hlavičku `x-ms-file-permission` na soubor. Když je hlavička nastavena `x-ms-file-permission` na `inherit`, tato sémantika nemá vliv na oprávnění souboru. Když je konkrétní oprávnění určeno pomocí `x-ms-file-permission` hlavičky, `New` sémantika používá výchozí pravidla pro tvorbu souborů Win32 a může aplikovat mírně odlišná oprávnění, která byla stanovena na základě oprávnění rodičovského adresáře, zatímco `Restore` sémantika používá výchozí aktualizační sémantiku a přiřadí oprávnění souboru přesně podle specifikace. `New` sémantika také přidává atribut Archive do souboru, i když není uveden v `x-ms-file-attributes` hlavičce.

Pouze hlavičky požadavků NFS

Hlavička požadavku	Popis
`x-ms-mode`	Volitelný. Verze 2025-05-05 a novější. Bity režimu, které se mají nastavit v souboru. Režim je reprezentován ve 12bitovém osmičkovém formátu nebo symbolickém formátu rwx. Výchozí hodnota je 0644. Viz oprávnění k souborům POSIX (režim).
`x-ms-owner`	Volitelný. Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka souboru, který se má v souboru nastavit. Výchozí hodnota je 0 (kořen).
`x-ms-group`	Volitelný. Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru, který se má v souboru nastavit. Výchozí hodnota je 0 (kořenová skupina).
`x-ms-file-file-type`	Volitelný. Verze 2025-05-05 a novější. Typ souboru. Pokud je k dispozici, musí být normální.

Text požadavku

Žádné pokud Content-Length je nula. Je vyžadováno, pokud Content-Length je hlavička nastavena na nenulu. Toto je podporováno ve verzi 2026-02-06 nebo novější. Počet bajtů specifikovaných v těle požadavku a hlavičce Content-Length musí odpovídat, aby bylo možné vytvořit soubor s daty. Maximální počet bajtů, které lze v těle požadavku zadát, je 4MiB.

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=

Ukázkový požadavek s `Content-Length` hlavičkou

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2026-02-06
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024
Content-Length: 512
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 naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje hlavičky v následujících tabulkách. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Běžná hlavička odpovědi

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 naleznete v tématu Reprezentace hodnot data a času v záhlavích. Jakákoli 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 verzi služby Azure Files, která se používá k provedení požadavku.
`Date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi.
`x-ms-request-server-encrypted: true/false`	Verze 2017-04-17 a novější Hodnota této hlavičky je nastavená na `true`, pokud jste obsah požadavku úspěšně zašifrovali pomocí zadaného algoritmu. Pokud šifrování není úspěšné, hodnota je `false`.
`x-ms-file-creation-time`	Hodnota data a času UTC, která představuje vlastnost čas vytvoření souboru.
`x-ms-file-last-write-time`	Hodnota data a času UTC, která představuje vlastnost posledního času zápisu souboru.
`x-ms-file-change-time`	Hodnota data a času UTC, která představuje vlastnost změnit čas souboru.
`x-ms-file-file-id`	ID souboru.
`x-ms-file-parent-id`	ID nadřazeného souboru souboru.
`Content-MD5`	Verze 2026-02-06 a novší. Tato hlavička se vrátí, aby klient mohl zkontrolovat integritu obsahu zprávy. Hodnota této hlavičky se vypočítá službou File.
`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ě 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.

Hlavičky odpovědi pouze smb

Hlavička odpovědi	Popis
`x-ms-file-permission-key`	Verze 2019-02-02 a novější. Klíč oprávnění souboru.
`x-ms-file-attributes`	Verze 2019-02-02 a novější. Atributy systému souborů souboru. Další informace najdete v seznamu dostupných atributů.

Pouze hlavičky odpovědi NFS

Hlavička odpovědi	Popis
`x-ms-mode`	Verze 2025-05-05 a novější. Režim souboru. Viz oprávnění k souborům POSIX (režim).
`x-ms-owner`	Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka souboru.
`x-ms-group`	Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru.
`x-ms-file-file-type`	Verze 2025-05-05 a novější. Typ souboru, možná hodnota je: "Regular".

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

Oprávnění

Tuto operaci může volat pouze vlastník účtu.

Atributy systému souborů

Atribut	Atribut souboru Win32	Definice
Jen pro čtení	FILE_ATTRIBUTE_READONLY	Soubor, který je jen pro čtení. Aplikace můžou soubor číst, ale nemůžou do něj zapisovat ani je odstraňovat.
Schovaný	FILE_ATTRIBUTE_HIDDEN	Soubor je skrytý. Není součástí běžného seznamu adresářů.
Systém	FILE_ATTRIBUTE_SYSTEM	Soubor, ze kterého operační systém používá část 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ě.
Archivovat	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 s Windows. Služba Azure Files ji nepodporuje s možnostmi offline úložiště.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	Soubor není indexován službou indexování obsahu.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	Datový proud uživatelů, který není číst skenerem integrity dat na pozadí. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility s Windows.

Oprávnění k souborům POSIX (režim)

Oprávnění k souborům POSIX je možné zadat číselně v osmičkovém formátu 12bitového formátu nebo v symbolickém formátu rwx. Příklady:

"0644" nebo "rw-r--r--": Uživatel (vlastník souboru) má oprávnění ke čtení a zápisu. Skupina má oprávnění ke čtení. Ostatní mají oprávnění ke čtení.
0755 nebo rwxr-xr-x: Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. Skupina má oprávnění ke čtení a spuštění. Ostatní mají oprávnění ke čtení a spouštění.

Číselný osmičkový formát

Tři osmičková čísla nejnižšího pořadí představují oprávnění pro vlastníka/uživatele, skupinu a další a označují se pomocí osmičkového čísla (0–7), která se vytvoří pomocí bitové kombinace 4 (čtení), 2 (zápis), 1 (Spustit). Osmičkové číslo nejvyššího pořadí (0–7) se používá k označení kombinace oprávnění 4 (SetUID), 2 (SetGID), 1 (StickyBit).

Formát	Povolení
0700	Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění.
0400	Uživatel má oprávnění ke čtení.
0200	Uživatel má oprávnění k zápisu.
0100	Uživatel má oprávnění ke spuštění.
0070	Skupina má oprávnění ke čtení, zápisu a spuštění.
0040	Skupina má oprávnění ke čtení.
0020	Skupina má oprávnění k zápisu.
0010	Skupina má oprávnění ke spuštění.
0007	Ostatní mají oprávnění ke čtení, zápisu a spouštění.
0004	Ostatní mají oprávnění ke čtení.
0002	Ostatní mají oprávnění k zápisu.
0001	Ostatní mají oprávnění ke spuštění.
4000	Nastavte efektivní ID uživatele v souboru.
2000	Nastavte pro soubor efektivní ID skupiny.
1000	Nastavit na označení, že soubor lze odstranit nebo přejmenovat pouze vlastníkem souboru, vlastníkem adresáře nebo uživatelem root.

Symbolický formát rwx

Oprávnění pro vlastníka/uživatele, skupinu a další uživatele jsou označená pomocí kombinace znaků r (Read), w (Write) a x (Execute).

Formát	Povolení
rwx------	Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění.
r--------	Uživatel má oprávnění ke čtení.
-w-------	Uživatel má oprávnění k zápisu.
--x------	Uživatel má oprávnění ke spuštění.
---rwx---	Skupina má oprávnění ke čtení, zápisu a spuštění.
---r-----	Skupina má oprávnění ke čtení.
----w----	Skupina má oprávnění k zápisu.
-----x---	Skupina má oprávnění ke spuštění.
------rwx	Ostatní mají oprávnění ke čtení, zápisu a spouštění.
------r--	Ostatní mají oprávnění ke čtení.
-------w-	Ostatní mají oprávnění k zápisu.
--------x	Ostatní mají oprávnění ke spuštění.

Poznámky

Pokud chcete vytvořit nový soubor, nejprve ho inicializujete voláním Create File a zadáním 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 přidat do souboru obsah nebo ho upravit.

Od verze 2026-02-06 a později můžete vytvořit soubor s daty až do 4MiB tím, že zadáte obsah do těla požadavku. Poté, co soubor s daty vytvoříte, zavolejte Put Range k přidání dalších dat nebo jeho úpravu. Maximální velikost vytvořeného souboru je až 4 TiB.

Velikost souboru můžete změnit voláním Set File Properties.

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 souboru cache-control, content-type, content-md5, content-encodinga 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.

Chcete-li vytvořit soubor, pokud má existující soubor aktivní zapůjčení, musí klient zadat platné ID zapůjčení v požadavku. Pokud klient buď nezadá ID zapůjčení, nebo určuje neplatné ID zapůjčení, vrátí služba Azure Files stavový kód 412 (předběžná podmínka se nezdařila). Pokud klient určuje ID zapůjčení, ale soubor nemá aktivní zapůjčení, vrátí služba Azure Files v této instanci stavový kód 412 (předběžná podmínka se nezdařila). Pokud klient u souboru, který ještě neexistuje, určuje ID zapůjčení, vrátí služba Azure Files stavový kód 412 (Předběžná podmínka se nezdařila) pro požadavky, které jsou provedeny ve verzi 2019-02-02 a novější.

Pokud existující soubor s aktivním zapůjčením přepíše operace Create File, zapůjčení se v aktualizovaném souboru zachová, dokud ho nevyvolá.

Create File se na snímku sdílené složky nepodporuje, 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).

Viz také

Operace se soubory

Last updated on 2026-03-27