Path - Update

Služba:

Storage Services

Verze rozhraní API:

2023-08-03

Připojit data | Vyprázdnění dat | Nastavit vlastnosti | Nastavit Access Control
Nahraje data, která se mají připojit k souboru, vyprázdní (zapíše) dříve nahraná data do souboru, nastaví vlastnosti souboru nebo adresáře nebo nastaví řízení přístupu k souboru nebo adresáři. Data lze připojit pouze k souboru. Souběžné zápisy do stejného souboru pomocí více klientů se nepodporují. 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.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}

S volitelnými parametry:

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&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ů. Vzor regulárního výrazu: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path	path	True	string	Cesta k souboru nebo adresáři.
action	query	True	PathUpdateAction	Akce musí být "připojit" k nahrání dat, která se mají připojit k souboru, "vyprázdnit" pro vyprázdnění dříve nahraná data do souboru, "setProperties" pro nastavení vlastností souboru nebo adresáře, nebo "setAccessControl" pro nastavení vlastníka, skupiny, oprávnění nebo seznamu řízení přístupu pro soubor nebo adresář, nebo "setAccessControlRecursive" pro nastavení seznamu řízení přístupu pro adresář rekurzivně. Mějte na paměti, že hierarchický obor názvů musí být pro účet povolený, aby bylo možné používat řízení přístupu. Všimněte si také, že seznam Access Control (ACL) obsahuje oprávnění pro vlastníka, vlastnící skupinu a další uživatele, takže hlavičky požadavků x-ms-permissions a x-ms-ACL se vzájemně vylučují.
close	query		boolean	Události služby Azure Storage umožňují aplikacím přijímat oznámení, když se změní soubory. Když jsou povolené události služby Azure Storage, vyvolá se událost změny souboru. Tato událost má vlastnost označující, zda se jedná o konečnou změnu k rozlišení rozdílu mezi průběžným vyprázdněním datového proudu souboru a konečným uzavřením datového proudu souboru. Parametr close query je platný, pouze pokud je akce "vyprázdnění" a jsou povolená oznámení o změnách. Pokud je hodnota close "true" a operace vyprázdnění se úspěšně dokončí, služba vyvolá oznámení o změně souboru s vlastností, která označuje, že se jedná o konečnou aktualizaci (datový proud souboru byl uzavřen). Pokud "false" je vyvolána oznámení o změně souboru. Výchozí hodnotou je hodnota false. Tento parametr dotazu je nastaven na hodnotu true ovladačem Hadoop ABFS, který označuje, že datový proud souboru byl uzavřen."
continuation	query		string	Volitelné a platné pouze pro operaci setAccessControlRecursive. Počet cest zpracovaných při každém vyvolání je omezený. Pokud počet zpracovávaných cest překročí tento limit, vrátí se v hlavičce odpovědi x-ms-continuation pokračovací token. Když se v odpovědi vrátí token pokračování, musí být zakódovaný v procentech a zadaný v následném vyvolání operace setAccessControlRecursive.
flush	query		boolean	Platí pouze pro připojení volání. Tento parametr umožňuje volajícímu vyprázdnit během přidávacího volání. Výchozí hodnota je "false" , pokud "true", data se vyprázdní s voláním připojení. Všimněte si, že při použití flush=true se nepodporují následující hlavičky: "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Pokud chcete nastavit tato záhlaví během vyprázdnění, použijte action=flush.
forceFlag	query		boolean	Volitelné a platné pouze pro operaci setAccessControlRecursive. Pokud se jedná o "false", operace se rychle ukončí při výskytu chyb uživatele (4XX). Pokud je hodnota true, rozhraní API bude ignorovat chyby uživatele a pokračovat v operaci s jinými dílčími entitami adresáře. Podrobný stav uživatelských chyb se vrátí v odpovědi pro oba scénáře. Token pokračování se vrátí pouze v případě, že má forceFlag hodnotu true v případě chyb uživatele. Výchozí hodnota forceFlag je false.
maxRecords	query		integer int32	Volitelné a platné pouze pro operaci setAccessControlRecursive. Určuje maximální počet souborů nebo adresářů, u kterých se změna seznamu ACL použije. Pokud je vynecháno nebo větší než 2 000, žádost zpracuje až 2 000 položek.
mode	query		string	Nepovinný parametr. Platné a povinné pro operaci setAccessControlRecursive. Režim "set" nastaví práva řízení přístupu POSIX k souborům a adresářům, "modify" upraví jedno nebo více přístupových práv POSIX, která existují u souborů a adresářů, "remove" odebere jedno nebo více přístupových práv POSIX, která byla k souborům a adresářům k dispozici dříve.
position	query		integer int64	Tento parametr umožňuje volajícímu nahrávat data paralelně a řídit pořadí jejich připojení k souboru. Při nahrávání dat se vyžaduje připojení k souboru a při vyprázdnění dříve nahraných dat do souboru. Hodnota musí být pozice, kam se mají data připojit. Nahraná data nejsou okamžitě vyprázdněna ani zapsána do souboru. Chcete-li vyprázdnit, musí být dříve nahraná data souvislá, musí být zadán parametr position a musí se rovnat délce souboru po zápisu všech dat a nesmí být součástí požadavku entita.
retainUncommittedData	query		boolean	Platí pouze pro operace vyprázdnění. Pokud "true", jsou nepotvrzená data zachována po dokončení operace vyprázdnění; v opačném případě se nepotvrzená data po operaci vyprázdnění odstraní. Výchozí hodnotou je hodnota false. Data v posunu menší než zadaná pozice se zapíšou do souboru při úspěšném vyprázdnění, ale tento volitelný parametr umožňuje zachovat data po pozici vyprázdnění pro budoucí operaci vyprázdnění.
timeout	query		integer int32	Volitelná hodnota časového limitu operace v sekundách. Období začíná tím, že služba obdrží požadavek. Pokud hodnota časového limitu uplynou před dokončením operace, operace selže.

Hlavička požadavku

Media Types: "application/octet-stream", "text/plain"

Name	Vyžadováno	Typ	Description
Content-Length		integer int64	Vyžaduje se pro připojení dat a vyprázdnění dat. Pro vyprázdnění dat musí být 0. Musí být délka obsahu požadavku v bajtech pro "Připojit data".
Content-MD5		string	Nepovinný parametr. Hodnota hash MD5 obsahu požadavku. Tato hlavička je platná pro operace "Připojení" a "Vyprázdnění". Tato hodnota hash se používá k ověření integrity obsahu požadavku během přenosu. Když je tato hlavička zadána, služba úložiště porovná hodnotu hash obsahu, který byl doručen, s touto hodnotou hlavičky. Pokud se tyto dvě hodnoty hash neshodují, operace selže s kódem chyby 400 (Chybný požadavek). Všimněte si, že tato hodnota hash MD5 není uložena se souborem. Tato hlavička je přidružená k obsahu požadavku, nikoli k uloženému obsahu samotného souboru.
x-ms-lease-id		string	Id zapůjčení musí být zadáno, pokud existuje aktivní zapůjčení. Neplatné pro operace setAccessControlRecursive Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Cache-Control pro operace Čtení souboru.
x-ms-content-type		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Type pro operace "Read File".
x-ms-content-disposition		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Disposition pro operace "Read File".
x-ms-content-encoding		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Encoding pro operace "Read File".
x-ms-content-language		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Language pro operace "Read File".
x-ms-content-md5		string	Volitelné a platné pouze pro operace vyprázdnění a nastavení vlastností. Služba tuto hodnotu uloží a zahrne ji do hlavičky odpovědi Content-Md5 pro operace Číst a Získat vlastnosti. Pokud tato vlastnost není v požadavku zadána, bude vlastnost pro soubor vymazána. Následná volání Vlastnosti čtení a získání nevrátí tuto vlastnost, pokud není znovu explicitně nastavena pro daný soubor.
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. Platí pouze pro operaci setProperties. Pokud soubor nebo adresář existuje, odeberou se všechny vlastnosti, které nejsou zahrnuty v seznamu. Pokud je záhlaví vynecháno, odeberou se všechny vlastnosti. Pokud chcete sloučit nové a existující vlastnosti, nejprve získejte všechny existující vlastnosti a aktuální e-značku, pak vytvořte podmíněný požadavek se značkou E a zahrňte hodnoty pro všechny vlastnosti.
x-ms-owner		string	Volitelné a platné pouze pro operaci setAccessControl. Nastaví vlastníka souboru nebo adresáře.
x-ms-group		string	Volitelné a platné pouze pro operaci setAccessControl. Nastaví vlastnící skupinu souboru nebo adresáře.
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-acl		string	Volitelné a platné pouze pro operace setAccessControl a setAccessControlRecursive. Požadováno pro operaci setAccessControlRecursive. Nastaví práva řízení přístupu k souborům a adresářům posix. Hodnota je čárkami oddělený seznam položek řízení přístupu, který plně nahrazuje existující seznam řízení přístupu (ACL) v případě setAccessControl a režim setAccessControlRecursive. Režim úprav setAccessControlRecursive aktualizuje již existující seznam ACLS. 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ý. Režim odebrání setAccessControlRecursive odebere existující seznamy ACL a neměl by obsahovat oprávnění v zadaném seznamu řízení přístupu: "user:john.doe@contoso:, mask:". Režim setAccessControlRecursive nastaví seznamy ACL nahrazující existující seznamy ACL zadaného oboru a musí obsahovat všechny tři informace – vlastnící uživatel, vlastnící skupinu a další informace, pokud se nastavuje obor přístupu nebo pokud se ve výchozím oboru nastavuje některý z vlastněných uživatelů, vlastnících skupin nebo jiných. Režimy set a modify setAccessControlRecursive musí obsahovat oprávnění jako součást seznamu řízení přístupu.
If-Match		string	Volitelné pro vyprázdnění dat, nastavit Access Control a nastavit vlastnosti, ale neplatné pro připojit data a nastavit Access Control rekurzivní. 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	Volitelné pro vyprázdnění dat, nastavit Access Control a nastavit vlastnosti, ale neplatné pro připojit data a nastavit Access Control rekurzivní. 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	Volitelné pro vyprázdnění dat a vlastnosti sady, ale neplatné pro připojení dat a nastavení Access Control rekurzivní. 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	Volitelné pro vyprázdnění dat a vlastnosti sady, ale neplatné pro připojení dat a nastavení Access Control rekurzivní. 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-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-lease-action	True	PathLeaseAction	Počínaje verzí 2020-08-04 v operacích připojení a vyprázdnění. Funkce Append podporuje akce "acquire", "auto-renew" a "acquire-release". Pokud "získá", získá zapůjčení. Pokud se automaticky prodlouží, prodlouží se zapůjčení. Pokud "acquire-release" získá & dokončení operace & uvolnění zapůjčení po dokončení operace. Akce Uvolnění je podporována pouze v operaci vyprázdnění. Pokud je true, uvolní zapůjčení souboru pomocí informací o ID zapůjčení z hlavičky x-ms-lease-id.
x-ms-lease-duration		integer int32	K získání zapůjčení se vyžaduje doba zapůjčení a určuje dobu zapůjčení v sekundách. Doba zapůjčení musí být 15 až 60 sekund nebo -1 pro nekonečné zapůjčení.
x-ms-proposed-lease-id		string	Vyžaduje se, pokud je "x-ms-lease-action" "získání" nebo "změna". Pokud je operace úspěšná, získá se zapůjčení s tímto ID zapůjčení. Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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: ^[{(]?[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.

Text požadavku

Media Types: "application/octet-stream", "text/plain"

Name	Typ	Description
requestBody	object	Platí pouze pro operace připojení. Data, která se mají nahrát a připojit k souboru.

Odpovědi

Name	Typ	Description
200 OK	SetAccessControlRecursiveResponse	Data byla vyprázdněna (zapsána) do souboru nebo byly vlastnosti úspěšně nastaveny. Text odpovědi je volitelný a platí pouze pro SetAccessControlRecursive. Hlavičky Date: string ETag: string Last-Modified: string Accept-Ranges: string Cache-Control: string Content-Disposition: string Content-Encoding: string Content-Language: string Content-Length: integer Content-Range: string Content-Type: string Content-MD5: string x-ms-properties: string x-ms-continuation: string x-ms-request-id: string x-ms-version: string x-ms-request-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-scope: string x-ms-lease-renewed: boolean
202 Accepted		Nahraná data byla přijata. Hlavičky Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string x-ms-lease-renewed: boolean
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." Hlavičky x-ms-request-id: string x-ms-version: string

Definice

Name	Description
AclFailedEntryList
DataLakeStorageError
Error	Objekt odpovědi na chybu služby.
PathLeaseAction	Počínaje verzí 2020-08-04 v operacích připojení a vyprázdnění. Funkce Append podporuje akce "acquire", "auto-renew" a "acquire-release". Pokud "získá", získá zapůjčení. Pokud se automaticky prodlouží, prodlouží se zapůjčení. Pokud "acquire-release" získá & dokončení operace & uvolnění zapůjčení po dokončení operace. Akce Uvolnění je podporována pouze v operaci vyprázdnění. Pokud je true, uvolní zapůjčení souboru pomocí informací o ID zapůjčení z hlavičky x-ms-lease-id.
PathUpdateAction	Akce musí být "připojit" k nahrání dat, která se mají připojit k souboru, "vyprázdnit" pro vyprázdnění dříve nahraná data do souboru, "setProperties" pro nastavení vlastností souboru nebo adresáře, nebo "setAccessControl" pro nastavení vlastníka, skupiny, oprávnění nebo seznamu řízení přístupu pro soubor nebo adresář, nebo "setAccessControlRecursive" pro nastavení seznamu řízení přístupu pro adresář rekurzivně. Mějte na paměti, že hierarchický obor názvů musí být pro účet povolený, aby bylo možné používat řízení přístupu. Všimněte si také, že seznam Access Control (ACL) obsahuje oprávnění pro vlastníka, vlastnící skupinu a další uživatele, takže hlavičky požadavků x-ms-permissions a x-ms-ACL se vzájemně vylučují.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name	Typ	Description
errorMessage	string
name	string
type	string

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.

PathLeaseAction

Počínaje verzí 2020-08-04 v operacích připojení a vyprázdnění. Funkce Append podporuje akce "acquire", "auto-renew" a "acquire-release". Pokud "získá", získá zapůjčení. Pokud se automaticky prodlouží, prodlouží se zapůjčení. Pokud "acquire-release" získá & dokončení operace & uvolnění zapůjčení po dokončení operace. Akce Uvolnění je podporována pouze v operaci vyprázdnění. Pokud je true, uvolní zapůjčení souboru pomocí informací o ID zapůjčení z hlavičky x-ms-lease-id.

Name	Typ	Description
acquire	string
acquire-release	string
auto-renew	string
release	string

PathUpdateAction

Akce musí být "připojit" k nahrání dat, která se mají připojit k souboru, "vyprázdnit" pro vyprázdnění dříve nahraná data do souboru, "setProperties" pro nastavení vlastností souboru nebo adresáře, nebo "setAccessControl" pro nastavení vlastníka, skupiny, oprávnění nebo seznamu řízení přístupu pro soubor nebo adresář, nebo "setAccessControlRecursive" pro nastavení seznamu řízení přístupu pro adresář rekurzivně. Mějte na paměti, že hierarchický obor názvů musí být pro účet povolený, aby bylo možné používat řízení přístupu. Všimněte si také, že seznam Access Control (ACL) obsahuje oprávnění pro vlastníka, vlastnící skupinu a další uživatele, takže hlavičky požadavků x-ms-permissions a x-ms-ACL se vzájemně vylučují.

Name	Typ	Description
append	string
flush	string
setAccessControl	string
setAccessControlRecursive	string
setProperties	string

SetAccessControlRecursiveResponse

Name	Typ	Description
directoriesSuccessful	integer
failedEntries	AclFailedEntryList[]
failureCount	integer
filesSuccessful	integer