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 cíl již existuje a má zapůjčení, zapůjčení se přeruší. Upozorňujeme, že přejmenování souboru nebo adresáře do kontejneru s vynucenými zásadami šifrování kontejneru není povoleno, pokud zdrojový kontejner nemá také vynucené zásady šifrování kontejneru, které odpovídají. 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 cíl již 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 služby 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 |
Volitelný. Při přejmenování adresáře je omezený počet cest, které se přejmenují při každém vyvolání. Pokud počet cest, které se mají přejmenovat, tento limit překročí, vrátí se v této hlavičce odpovědi token pro pokračování. Pokud se v odpovědi vrátí token pro 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 |
Volitelný. Platné 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 vytvoření souboru a vytvoření adresáře. Hodnota musí být "file" nebo "directory". |
||
timeout
|
query |
integer int32 |
Volitelná hodnota časového limitu operace v sekundách. Období začíná, když služba obdrží požadavek. Pokud hodnota časového limitu uplynula 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 |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru pro operace Čtení souboru. |
|
Content-Encoding |
string |
Volitelný. Určuje, které kódování obsahu se na soubor použilo. Tato hodnota se vrátí klientovi při provedení operace Čtení souboru. |
|
Content-Language |
string |
Volitelný. Určuje přirozený jazyk používaný zamýšlenou cílovou skupinou pro soubor. |
|
Content-Disposition |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Disposition pro operace Čtení souboru. |
|
x-ms-cache-control |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru. |
|
x-ms-content-type |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Type pro operace Čtení souboru. |
|
x-ms-content-encoding |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Encoding pro operace Čtení souboru. |
|
x-ms-content-language |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Language pro operace Čtení souboru. |
|
x-ms-content-disposition |
string |
Volitelný. Služba uloží tuto hodnotu a zahrne ji do hlavičky odpovědi Content-Disposition pro operace Čtení souboru. |
|
x-ms-rename-source |
string |
Volitelný soubor nebo adresář, který se má přejmenovat. Hodnota musí mít následující formát: /{filesystem}/{path} nebo /{filesystem}/{path}?sastoken při použití tokenu SAS. Pokud je zadán parametr 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 kó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 |
Volitelný. 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 |
Volitelný. Uživatelem definované vlastnosti, které se mají uložit se souborem nebo adresářem, ve formátu čárkami oddělený seznam párů názvů a hodnot "n1=v1, n2=v2, ...", kde každá hodnota je řetězec kódovaný jako base64. Všimněte si, že řetězec může obsahovat pouze znaky ASCII ve znakové sadě ISO-8859-1. |
|
x-ms-permissions |
string |
Nepovinný 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řídě může být uděleno oprávnění ke čtení (4), zápisu (2) nebo provedení (1). Podporují se symbolické (rwxrw-rw-) i 4ciferné osmičkové notace (např. 0766). Bit sticky je také podporován a v symbolickém zápisu je reprezentován písmenem t nebo T v konečném znaku v závislosti na tom, jestli je spouštěcí bit pro ostatní kategorie nastavený nebo nenastavený (např. rwxrw-rw- with sticky bit je reprezentován jako rwxrw-rwT. Rwxrw-rwx s rychlým bitem je reprezentován jako rwxrw-rwt), absence t nebo T indikuje, že bit sticky není nastavený. Ve 4ciferném osmičkovém zápisu představuje 1. číslice (např. 1766 představuje rwxrw-rw- s sticky bitem a 0766 představuje rwxrw-rw- bez lepivé bity). Neplatné ve spojení s x-ms-acl. |
|
x-ms-umask |
string |
Nepovinný 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 omezuje oprávnění k vytvoření souboru nebo adresáře. Výsledné oprávnění udělí p & ^u, kde p je oprávnění a vy jste 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 4 číslic (např. 0766). |
|
x-ms-owner |
string |
Nepovinný 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 |
Nepovinný 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 |
Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů. Nastaví práva řízení přístupu POSIX u souborů a adresářů. 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 [scope:][type]:[id]:[permissions]". Obor musí být "výchozí", aby označí, že ACE patří do výchozího seznamu ACL pro adresář; jinak je obor implicitní a ACE patří do přístupového seznamu ACL. 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ří se nenašli v žádné z ostatních položek. 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 3znaková sekvence, kde první znak je r pro udělení přístupu pro čtení, druhý znak je w pro udělení přístupu k zápisu 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í je odepřeno. Například následující seznam ACL uděluje oprávnění ke čtení, zápisu a provádění oprávnění pro vlastníka souboru a john.doe@contoso, oprávnění ke čtení vlastnící skupině a nic ostatním: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Neplatné ve spojení s x-ms-permissions. |
|
x-ms-proposed-lease-id |
string |
Volitelný. Pokud chcete při vytváření souboru nebo adresáře získat zapůjčení, zadejte navrhované ID zapůjčení. Zapůjčení se získá s tímto ID zapůjčení, pokud bude vytvoření úspěšné. Vzor regulárního výrazu: |
|
x-ms-expiry-option |
string |
Nepovinný a platný pouze v případě, že je pro účet povolený hierarchický obor názvů a podporuje se jenom u souborů. Pokud chcete nastavit dobu vypršení platnosti souboru při vytváření, zadejte jednu z následujících možností vypršení platnosti. "RelativeToNow" Nastavte vypršení platnosti vzhledem k aktuálnímu času. Od této chvíle uživatel předá počet milisekund. Absolutní čas ve formátu RFC 1123 "Neverexpire" Nastavte soubor tak, aby nikdy nevypršela platnost, není nutné zadávat s touto možností. |
|
x-ms-expiry-time |
string |
Nepovinný 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 souboru. Hodnota RFC 1123 HTTP Time String nebo počet milisekund podle možnosti vypršení platnosti. |
|
If-Match |
string |
Volitelný. Hodnota ETag. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku odpovídají zadané hodnotě. ETag musí být zadán v uvozovkách. |
|
If-None-Match |
string |
Volitelný. Hodnota značky ETag nebo speciální zástupný znak (*). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. ETag musí být zadán v uvozovkách. |
|
If-Modified-Since |
string |
Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek změněn od zadaného data a času. |
|
If-Unmodified-Since |
string |
Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že se prostředek od zadaného data a času nezměnil. |
|
x-ms-source-if-match |
string |
Volitelný. Hodnota ETag. Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že značky ETag zdroje odpovídají zadané hodnotě. ETag musí být zadán v uvozovkách. |
|
x-ms-source-if-none-match |
string |
Volitelný. Hodnota značky ETag nebo speciální zástupný znak (*). Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že značky ETag zdroje neodpovídají zadané hodnotě. ETag musí být zadán v uvozovkách. |
|
x-ms-source-if-modified-since |
string |
Volitelný. Hodnota data a času. Tuto hlavičku zadejte, aby se operace přejmenování prováděla pouze v případě, že byl zdroj změněn od zadaného data a času. |
|
x-ms-source-if-unmodified-since |
string |
Volitelný. Hodnota data a času. Tuto hlavičku zadejte, pokud chcete provést operaci přejmenování pouze v případě, že zdroj nebyl změněn od zadaného data a času. |
|
x-ms-encryption-key |
string |
Volitelný. Šifrovací klíč AES-256 s kódováním Base64. |
|
x-ms-encryption-key-sha256 |
string |
Volitelný. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče. |
|
x-ms-encryption-algorithm: AES256 |
string |
Volitelný. 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 |
Volitelný. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata systému objektů blob nebo systému souborů. Maximální délka- 1024. Platné pouze v případě, že je pro účet povolený hierarchický obor názvů. |
|
x-ms-client-transaction-id |
string |
Volitelný. Výchozí hodnota je Prázdná. Pokud je hodnota nastavená, nastaví se metadata objektu blob při vytvoření nebo přejmenování souboru. Pokud vyprší časový limit požadavku pro klienta, můžete tuto hodnotu načíst pomocí volání Get Properties a ověřit, jestli vypršel časový limit požadavku na konci služby nebo ne. Maximální délka- 36. Platné pouze 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 standard UTC (Coordinated Universal Time) pro požadavek. To se vyžaduje při použití autorizace sdíleného klíče. |
|
x-ms-version |
string |
Určuje verzi protokolu REST, který se používá 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é řetězce stavu, kódu a zprávy HTTP jsou uvedené níže:
Hlavičky
|
Definice
Name | Description |
---|---|
Data |
|
Error |
Objekt odpovědi na chybu služby. |
Path |
Volitelný. Platné 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". |
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
Volitelný. Platné 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".
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 |