Path - Create

  • Reference
Service:
Storage Services
API Version:
2023-08-03

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}
With optional parameters: 
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
accountName
 path True

string

Název účtu služby Azure Storage.
dnsSuffix
 path True

string

Přípona DNS pro koncový bod Azure Data Lake Storage.
filesystem
 path True

string

Identifikátor systému souborů.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
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

PathRenameMode

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

PathResourceType

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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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í.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Length: integer
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
Other Status Codes

DataLakeStorageError

Došlo k chybě. Možné stavové řetězce HTTP, kód a řetězce zpráv jsou uvedené níže:

  • 400 Chybný požadavek, ContentLengthMustBeZero, Hlavička požadavku Content-Length musí být nulová.
  • 400 Chybný požadavek, InvalidAuthenticationInfo, "Ověřovací informace nejsou uvedeny ve správném formátu. Zkontrolujte hodnotu autorizační hlavičky.
  • 400 Chybný požadavek, InvalidFlushPosition, "Nahraná data nejsou souvislá nebo hodnota parametru dotazu pozice není rovna délce souboru po připojení nahraných dat."
  • 400 Chybný požadavek, InvalidHeaderValue, "Hodnota pro jednu z hlaviček HTTP není ve správném formátu."
  • 400 Chybný požadavek, InvalidHttpVerb, "Zadaný příkaz HTTP je neplatný – server ho nerozpoznal."
  • 400 Chybný požadavek, InvalidInput, "Jeden ze vstupů požadavku není platný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti nemůže být prázdný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti obsahuje neplatné znaky."
  • 400 Chybný požadavek, InvalidQueryParameterValue, "Hodnota jednoho z parametrů dotazu zadaných v identifikátoru URI požadavku je neplatná."
  • 400 Chybný požadavek, InvalidResourceName, "Zadaný název prostředku obsahuje neplatné znaky."
  • 400 Chybný požadavek, InvalidSourceUri, "zdrojový identifikátor URI je neplatný."
  • 400 Chybný požadavek, InvalidUri, "Identifikátor URI požadavku je neplatný."
  • 400 Chybný požadavek, MissingRequiredHeader, "Hlavička HTTP, která je pro tento požadavek povinná, není zadána."
  • 400 Chybný požadavek, MissingRequiredQueryParameter, "Není zadán parametr dotazu, který je pro tento požadavek povinný."
  • 400 Chybný požadavek, MultipleConditionHeadersNotSupported, "Více hlaviček podmínky nejsou podporovány."
  • 400 Chybný požadavek, OutOfRangeInput, "Jeden ze vstupů požadavku je mimo rozsah."
  • 400 Chybný požadavek, OutOfRangeQueryParameterValue, "Jeden z parametrů dotazu zadaných v identifikátoru URI požadavku je mimo povolený rozsah."
  • 400 Bad Request, UnsupportedHeader, "Jedna z hlaviček zadaných v požadavku není podporována."
  • 400 Chybný požadavek, UnsupportedQueryParameter, "Jeden z parametrů dotazu zadaných v identifikátoru URI požadavku není podporován."
  • 400 Chybný požadavek, NepodporovanárestVersion, "Zadaná verze rest je nepodporovaná"
  • 403 Zakázáno, AccountIsDisabled, "Zadaný účet je zakázaný."
  • 403 Zakázáno, AuthorizationFailure, "Tento požadavek nemá oprávnění k provedení této operace."
  • 403 Zakázáno, InsufficientAccountPermissions, "Účet, ke kterým přistupujete, nemá dostatečná oprávnění ke spuštění této operace."
  • 404 Nenalezeno, FilesystemNotFound, "Zadaný systém souborů neexistuje."
  • 404 Nenalezeno, PathNotFound, "Zadaná cesta neexistuje."
  • 404 Nenalezeno, RenameDestinationParentPathNotFound, Nadřazený adresář cílové cesty neexistuje.
  • 404 Nenalezeno, ResourceNotFound, "Zadaný prostředek neexistuje."
  • 404 Nenalezeno, SourcePathNotFound, "Zdrojová cesta pro operaci přejmenování neexistuje."
  • 405 Method Not Allowed, UnsupportedHttpVerb, "The resource doesn't support the specified HTTP verb."
  • 409 Conflict, DestinationPathIsBeingDeleted, "Zadaná cílová cesta je označena k odstranění."
  • 409 Conflict, DirectoryNotEmpty, "Hodnota parametru rekurzivního dotazu musí být true, aby bylo možné odstranit neprázdný adresář."
  • 409 Conflict, FilesystemAlreadyExists, "Zadaný systém souborů již existuje."
  • 409 Konflikt, FilesystemBeingDeleted, "Zadaný systém souborů je odstraněn."
  • 409 – Konflikt, InvalidDestinationPath, "Zadaná cesta nebo prvek cesty existuje a její typ prostředku je pro tuto operaci neplatný." * 409 Konflikt, InvalidFlushOperation, "Prostředek byl vytvořen nebo změněn rozhraním API služby Blob Service a nemůže být zapsán do rozhraní API služby Data Lake Storage."
  • 409 Konflikt, InvalidRenameSourcePath, "Zdrojový adresář nemůže být stejný jako cílový adresář, ani cíl nemůže být podadresář zdrojového adresáře."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Typ zdrojového a cílového prostředku musí být identický."
  • 409 – Konflikt, LeaseAlreadyPresent, "Zapůjčení již existuje."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Zadané ID zapůjčení neodpovídá ID zapůjčení prostředku se zadanou operací zapůjčení."
  • 409 Konflikt, LeaseIsAlreadyBroken, "Zapůjčení již bylo přerušeno a nelze ho znovu zlomit."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "ID zapůjčení bylo spárováno, ale zapůjčení je aktuálně ve stavu přerušení a nelze jej získat, dokud nebude přerušeno."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "ID zapůjčení bylo spárováno, ale zapůjčení je v současné době ve stavu přerušení a nelze ho změnit."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "ID zapůjčení bylo spárováno, ale zapůjčení bylo explicitně přerušeno a nelze ho obnovit."
  • 409 Conflict, LeaseNameMismatch, "Zadaný název zapůjčení neodpovídá existujícímu názvu zapůjčení."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "ID zapůjčení není k dispozici u zadané operace zapůjčení."
  • 409 Konflikt, PathAlreadyExists, "Zadaná cesta již existuje."
  • 409 Konflikt, PathConflict, "Zadaná cesta nebo prvek cesty existuje a její typ prostředku je pro tuto operaci neplatný."
  • 409 Konflikt, SourcePathIsBeingDeleted, "Zadaná zdrojová cesta je označena k odstranění."
  • 409 Konflikt, ResourceTypeMismatch, "Typ prostředku zadaný v požadavku neodpovídá typu prostředku."
  • 412 Předběžná podmínka se nezdařila, ConditionNotMet, Podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna.
  • 412 Předběžná podmínka se nezdařila, LeaseIdMismatch, "Zadané ID zapůjčení neodpovídá ID zapůjčení prostředku."
  • 412 Předběžná podmínka se nezdařila, LeaseIdMissing, "Prostředek je v současné době zapůjčen a v žádosti nebylo zadáno žádné ID zapůjčení."
  • 412 Předběžná podmínka selhala, LeaseNotPresent, "Prostředek v současné době není zapůjčen."
  • 412 Předběžná podmínka se nezdařila, LeaseLost, "Bylo zadáno ID zapůjčení, ale platnost zapůjčení prostředku vypršela."
  • 412 Předpoklad se nezdařil, SourceConditionNotMet, "Zdrojová podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna."
  • 413 Request Entity Too Large, RequestBodyTooLarge, "Text požadavku je příliš velký a překračuje maximální povolený limit."
  • 416 Požadovaný rozsah není uspokojitelný, InvalidRange, "Zadaný rozsah je neplatný pro aktuální velikost prostředku."
  • 500 Vnitřní chyba serveru, InternalError, "Server zjistil vnitřní chybu. Zkuste žádost zopakovat.
  • 500 Vnitřní chyba serveru, OperationTimedOut, "Operaci nelze dokončit v povoleném čase."
  • 503 Service Unavailable, ServerBusy, "Egress is over the account limit" (Výchozí přenos dat je nad limitem účtu).
  • 503 Služba není k dispozici, ServerBusy, "Příchozí přenos dat překročil limit účtu".
  • 503 Service Unavailable, ServerBusy, "Operations per second is over the account limit" (Počet operací za sekundu je nad limitem účtu).
  • 503 Služba není k dispozici, ServerBusy, "Server v současné době nemůže přijímat požadavky. Zkuste prosím žádost zopakovat."

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definice

Name Description
DataLakeStorageError
Error

Objekt odpovědi na chybu 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".
PathResourceType

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

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