Path - Create
Vytvořit soubor | Vytvořit adresář | Přejmenovat soubor | Přejmenovat adresář
Vytvořte nebo přejmenujte soubor nebo adresář. Ve výchozím nastavení se cíl přepíše, a pokud už cíl existuje a má zapůjčení, zapůjčení se přeruší. Mějte na paměti, že přejmenování souboru nebo adresáře na kontejner s vynucenou zásadou šifrování kontejneru není povolené, pokud zdrojový kontejner nemá také vynucenou zásadu šifrování kontejneru, která odpovídá. Tato operace podporuje podmíněné požadavky HTTP. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Service. Pokud už cíl existuje, použijte podmíněný požadavek s chybou If-None-Match: *.
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu služby Azure Storage. |
dns
|
path | True |
string |
Přípona DNS pro koncový bod Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identifikátor systému souborů. Vzor regulárního výrazu: |
path
|
path | True |
string |
Cesta k souboru nebo adresáři. |
continuation
|
query |
string |
Nepovinný parametr. Při přejmenování adresáře je počet cest, které se při každém vyvolání přejmenují, omezený. Pokud počet cest, které se mají přejmenovat, překročí tento limit, vrátí se v této hlavičce odpovědi token pro pokračování. Pokud je v odpovědi vrácen token pokračování, musí být zadán v následném vyvolání operace přejmenování, aby bylo možné pokračovat v přejmenování adresáře. |
|
mode
|
query |
Nepovinný parametr. Platí pouze v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix". |
||
resource
|
query |
Vyžaduje se pouze pro příkazy Create File (Vytvořit soubor) a Create Directory (Vytvořit adresář). Hodnota musí být "file" nebo "directory". |
||
timeout
|
query |
integer int32 |
Hodnota časového limitu volitelné operace v sekundách. Období začíná tím, že služba obdrží požadavek. Pokud hodnota časového limitu uplyne před dokončením operace, operace selže. |
Hlavička požadavku
Media Types: "application/octet-stream"
Name | Vyžadováno | Typ | Description |
---|---|---|---|
Cache-Control |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Cache-Control pro operace "Read File" pro operace "Read File". |
|
Content-Encoding |
string |
Nepovinný parametr. Určuje, která kódování obsahu byla u souboru použita. Tato hodnota se klientovi vrátí při provedení operace "Read File". |
|
Content-Language |
string |
Nepovinný parametr. Určuje přirozený jazyk používaný zamýšlenou cílovou skupinou souboru. |
|
Content-Disposition |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Disposition pro operace "Read File". |
|
x-ms-cache-control |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru. |
|
x-ms-content-type |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Type pro operace "Read File". |
|
x-ms-content-encoding |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Encoding pro operace "Read File". |
|
x-ms-content-language |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Language pro operace "Read File". |
|
x-ms-content-disposition |
string |
Nepovinný parametr. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Disposition pro operace "Read File". |
|
x-ms-rename-source |
string |
Volitelný soubor nebo adresář, který se má přejmenovat. Při použití tokenu SAS musí mít hodnota následující formát: /{filesystem}/{path} nebo /{filesystem}/{path}?sastoken. Pokud je zadána "x-ms-properties", vlastnosti přepíšou existující vlastnosti; v opačném případě se stávající vlastnosti zachovají. Tato hodnota musí být řetězec zakódovaný v procentech adresy URL. Všimněte si, že řetězec může obsahovat pouze znaky ASCII ve znakové sadě ISO-8859-1. |
|
x-ms-lease-id |
string |
Nepovinný parametr. ID zapůjčení pro cestu zadanou v identifikátoru URI. Cesta, která se má přepsat, musí mít aktivní zapůjčení a ID zapůjčení se musí shodovat. Vzor regulárního výrazu: |
|
x-ms-source-lease-id |
string |
Volitelné pro operace přejmenování. ID zapůjčení zdrojové cesty. Zdrojová cesta musí mít aktivní zapůjčení a ID zapůjčení se musí shodovat. Vzor regulárního výrazu: |
|
x-ms-properties |
string |
Nepovinný parametr. Uživatelem definované vlastnosti, které se mají uložit se souborem nebo adresářem, ve formátu seznamu názvů a hodnot oddělených čárkami "n1=v1, n2=v2, ...", kde každá hodnota je řetězec s kódováním base64. Všimněte si, že řetězec může obsahovat pouze znaky ASCII ve znakové sadě ISO-8859-1. |
|
x-ms-permissions |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví přístupová oprávnění POSIX pro vlastníka souboru, skupinu vlastníka souboru a další. Každá třída může mít oprávnění ke čtení (4), zápisu (2) nebo spuštění (1). Podporuje se symbolický (rwxrw-rw-) i 4místný osmičkový zápis (např. 0766). Podporuje se také bit v symbolickém zápisu, který je reprezentován písmenem t nebo T na místě konečného znaku v závislosti na tom, jestli je spouštěcí bit pro kategorii ostatních nastavený nebo nenasazení (např. rwxrw-rw- s bitem sticky je reprezentován jako rwxrw-rwT. Rwxrw-rwx s lepkavým bitem je reprezentován jako rwxrw-rwt), absence t nebo T znamená, že se nenastavil lepkavý bit. Ve 4místném osmičkovém zápisu je reprezentován 1. číslicí (např. 1766 představuje rwxrw-rw- s lepkavým bitem a 0766 představuje rwxrw-rw- bez lepivého bitu). Ve spojení s x-ms-acl je neplatný. |
|
x-ms-umask |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů. Při vytváření souboru nebo adresáře a nadřazená složka nemá výchozí seznam ACL, umask omezí oprávnění k vytvoření souboru nebo adresáře. Výsledné oprávnění je dáno p & ^u, kde p je oprávnění a vy je umask. Pokud je například p 0777 a vy je 0057, výsledné oprávnění je 0720. Výchozí oprávnění je 0777 pro adresář a 0666 pro soubor. Výchozí umask je 0027. Umask musí být zadán v osmičkovém zápisu se 4 číslicemi (např. 0766). |
|
x-ms-owner |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví vlastníka souboru nebo adresáře. |
|
x-ms-group |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví vlastnící skupinu souboru nebo adresáře. |
|
x-ms-acl |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví práva řízení přístupu k souborům a adresářům posix. Každá položka řízení přístupu (ACE) se skládá z oboru, typu, identifikátoru uživatele nebo skupiny a oprávnění ve formátu [obor:][typ]:[id]:[oprávnění]. Obor musí být "výchozí", aby bylo možné označit, že ACE patří do výchozího seznamu ACL pro adresář. jinak je obor implicitní a ACE patří do seznamu ACL pro přístup. Existují čtyři typy ACE: "uživatel" uděluje práva vlastníkovi nebo pojmenovaného uživatele, "skupina" uděluje práva vlastnící skupině nebo pojmenované skupině, maska omezuje práva udělená pojmenovaným uživatelům a členům skupin a "ostatní" uděluje práva všem uživatelům, kteří nejsou nalezeni v žádné jiné položce. Identifikátor uživatele nebo skupiny je vynechán pro položky typu "maska" a "jiný". Identifikátor uživatele nebo skupiny je také vynechán pro vlastníka a vlastnící skupinu. Pole oprávnění je sekvence o 3 znacích, kde prvním znakem je "r", který uděluje přístup pro čtení, druhý znak je "w" pro udělení přístupu pro zápis a třetí znak je "x" pro udělení oprávnění ke spuštění. Pokud přístup není udělen, znak "-" se použije k označení, že oprávnění bylo odepřeno. Například následující seznam ACL uděluje oprávnění ke čtení, zápisu a spouštění vlastníkovi souboru a john.doe@contoso, oprávnění ke čtení vlastnící skupině a všem ostatním nic: user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx. Ve spojení s x-ms-permissions je neplatný. |
|
x-ms-proposed-lease-id |
string |
Nepovinný parametr. Pokud chcete získat zapůjčení během vytváření souboru nebo adresáře, zadejte navrhované ID zapůjčení. Pokud je vytvoření úspěšné, získá se zapůjčení s tímto ID zapůjčení. Vzor regulárního výrazu: |
|
x-ms-expiry-option |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů a podporuje se jenom u souborů. Pokud chcete u souboru při vytváření nastavit dobu vypršení platnosti, zadejte jednu z následujících možností vypršení platnosti. "RelativeToNow" Nastavte vypršení platnosti vzhledem k aktuálnímu času. Uživatel předá počet milisekund, které uplynuly od této chvíle. Absolutní čas ve formátu RFC 1123. "Neverexpire" Nastavte soubor na nikdy nevyprší, čas vypršení platnosti není nutné zadat pomocí této možnosti. |
|
x-ms-expiry-time |
string |
Volitelné a platné pouze v případě, že je pro účet povolený hierarchický obor názvů a podporuje se jenom u souborů. Zadejte dobu vypršení platnosti, kdy má dojít k vypršení platnosti souboru. Udává se jako časový řetězec HTTP RFC 1123 nebo počet milisekund podle možnosti vypršení platnosti. |
|
If-Match |
string |
Nepovinný parametr. Hodnota ETag. Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách. |
|
If-None-Match |
string |
Nepovinný parametr. Hodnota ETag nebo speciální hodnota se zástupným znakem (*). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách. |
|
If-Modified-Since |
string |
Nepovinný parametr. Hodnota data a času Zadáním této hlavičky provedete operaci pouze v případě, že byl prostředek od zadaného data a času změněn. |
|
If-Unmodified-Since |
string |
Nepovinný parametr. Hodnota data a času Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn. |
|
x-ms-source-if-match |
string |
Nepovinný parametr. Hodnota ETag. Tuto hlavičku zadejte, pokud chcete provést operaci přejmenování pouze v případě, že zdrojová značka ETag odpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách. |
|
x-ms-source-if-none-match |
string |
Nepovinný parametr. Hodnota ETag nebo speciální hodnota se zástupným znakem (*). Zadáním této hlavičky provedete operaci přejmenování pouze v případě, že zdrojová značka ETag neodpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách. |
|
x-ms-source-if-modified-since |
string |
Nepovinný parametr. Hodnota data a času Tuto hlavičku zadejte, pokud chcete provést operaci přejmenování pouze v případě, že byl zdroj od zadaného data a času změněn. |
|
x-ms-source-if-unmodified-since |
string |
Nepovinný parametr. Hodnota data a času Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že zdroj nebyl od zadaného data a času změněn. |
|
x-ms-encryption-key |
string |
Nepovinný parametr. Šifrovací klíč AES-256 s kódováním Base64. |
|
x-ms-encryption-key-sha256 |
string |
Nepovinný parametr. Hodnota hash SHA256 šifrovacího klíče v kódování Base64. |
|
x-ms-encryption-algorithm: AES256 |
string |
Nepovinný parametr. Určuje algoritmus, který se má použít pro šifrování. Hodnota této hlavičky musí být AES256. |
|
x-ms-encryption-context |
string |
Nepovinný parametr. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata objektu blob nebo systému souborů. Maximální délka- 1024. Platí jenom v případě, že je pro účet povolený hierarchický obor názvů. |
|
x-ms-client-request-id |
string |
Identifikátor UUID zaznamenaný v analytických protokolech pro řešení potíží a korelaci. Vzor regulárního výrazu: |
|
x-ms-date |
string |
Určuje formát UTC (Coordinated Universal Time). To se vyžaduje při použití autorizace sdíleného klíče. |
|
x-ms-version |
string |
Určuje verzi protokolu REST použitého ke zpracování požadavku. To se vyžaduje při použití autorizace sdíleného klíče. |
Odpovědi
Name | Typ | Description |
---|---|---|
201 Created |
Soubor nebo adresář byl vytvořen. Hlavičky
|
|
Other Status Codes |
Došlo k chybě. Možné stavové řetězce HTTP, kód a řetězce zpráv jsou uvedené níže:
Hlavičky
|
Definice
Name | Description |
---|---|
Data |
|
Error |
Objekt odpovědi na chybu služby. |
Path |
Nepovinný parametr. Platí jenom v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix". |
Path |
Vyžaduje se pouze pro vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory". |
DataLakeStorageError
Name | Typ | Description |
---|---|---|
error |
Objekt odpovědi na chybu služby. |
Error
Objekt odpovědi na chybu služby.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby služby. |
message |
string |
Chybová zpráva služby. |
PathRenameMode
Nepovinný parametr. Platí jenom v případech, kdy je povolený obor názvů. Tento parametr určuje chování operace přejmenování. Hodnota musí být "legacy" nebo "posix" a výchozí hodnota bude "posix".
Name | Typ | Description |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Vyžaduje se pouze pro vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory".
Name | Typ | Description |
---|---|---|
directory |
string |
|
file |
string |