Path - Update

Tjänst:

Storage Services

API-version:

2023-08-03

Lägg till data | Rensa data | Ange egenskaper | Ange Access Control
Laddar upp data som ska läggas till i en fil, rensar (skriver) tidigare uppladdade data till en fil, anger egenskaper för en fil eller katalog eller anger åtkomstkontroll för en fil eller katalog. Data kan bara läggas till i en fil. Samtidiga skrivningar till samma fil med flera klienter stöds inte. Den här åtgärden stöder villkorsstyrda HTTP-begäranden. Mer information finns i Ange villkorsstyrda rubriker för Blob Service-åtgärder.

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

Med valfria parametrar:

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}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Namnet på Azure Storage-kontot.
dnsSuffix	path	True	string	DNS-suffixet för Azure Data Lake Storage-slutpunkten.
filesystem	path	True	string	Filsystemidentifieraren. Reguljärt uttrycksmönster: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path	path	True	string	Fil- eller katalogsökvägen.
action	query	True	PathUpdateAction	Åtgärden måste vara "tillägg" för att ladda upp data som ska läggas till i en fil, "tömma" för att tömma tidigare uppladdade data till en fil, "setProperties" för att ange egenskaperna för en fil eller katalog eller "setAccessControl" för att ange ägare, grupp, behörigheter eller åtkomstkontrollistan för en fil eller katalog, eller "setAccessControlRecursive" för att ange åtkomstkontrollistan för en katalog rekursivt. Observera att hierarkisk namnrymd måste vara aktiverat för kontot för att kunna använda åtkomstkontroll. Observera också att Access Control List (ACL) innehåller behörigheter för ägaren, ägande grupp och andra, så att begärandehuvudena x-ms-permissions och x-ms-acl utesluter varandra.
close	query		boolean	Med Azure Storage-händelser kan program ta emot meddelanden när filer ändras. När Azure Storage-händelser är aktiverade aktiveras en filändringshändelse. Den här händelsen har en egenskap som anger om detta är den slutliga ändringen för att skilja skillnaden mellan en mellanliggande tömning till en filström och den sista stängningen av en filström. Parametern close query är endast giltig när åtgärden är "flush" och ändringsmeddelanden aktiveras. Om värdet för close är "true" och tömningsåtgärden har slutförts, genererar tjänsten ett filändringsmeddelande med en egenskap som anger att detta är den slutliga uppdateringen (filströmmen har stängts). Om "false" genereras ett ändringsmeddelande som anger att filen har ändrats. Standardvärdet är False. Den här frågeparametern anges till true av Hadoop ABFS-drivrutinen för att indikera att filströmmen har stängts."
continuation	query		string	Valfritt och giltigt endast för åtgärden "setAccessControlRecursive". Antalet sökvägar som bearbetas med varje anrop är begränsat. Om antalet sökvägar som ska bearbetas överskrider den här gränsen returneras en fortsättningstoken i svarshuvudet x-ms-continuation. När en fortsättningstoken returneras i svaret måste den vara procentkodad och anges i en efterföljande anrop av setAccessControlRecursive-åtgärden.
flush	query		boolean	Endast giltigt för tilläggsanrop. Med den här parametern kan anroparen tömmas under ett tilläggsanrop. Standardvärdet är "false" , om "sant" rensas data med tilläggsanropet. Observera att när du använder flush=true stöds inte följande rubriker – "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Om du vill ange dessa rubriker under tömning använder du action=flush
forceFlag	query		boolean	Valfritt och giltigt endast för åtgärden "setAccessControlRecursive". Om det här är "false" avslutas åtgärden snabbt när användarfel uppstår (4XX). Om "true" kommer API:et att ignorera användarfel och fortsätta med åtgärden på andra underentiteter i katalogen. Detaljerad status för användarfel returneras i svaret för något av scenariona. Fortsättningstoken returneras endast när forceFlag är "true" vid användarfel. Standardvärdet för forceFlag är falskt.
maxRecords	query		integer int32	Valfritt och giltigt endast för åtgärden "setAccessControlRecursive". Den anger det maximala antalet filer eller kataloger som acl-ändringen ska tillämpas på. Om begäran utelämnas eller är större än 2 000 bearbetas upp till 2 000 objekt
mode	query		string	Valfritt. Giltig och obligatorisk för åtgärden "setAccessControlRecursive". Läge "set" anger POSIX-åtkomstkontrollrättigheter för filer och kataloger, "ändra" ändrar en eller flera POSIX-åtkomstkontrollrättigheter som redan finns på filer och kataloger, "ta bort" tar bort en eller flera POSIX-åtkomstkontrollrättigheter som fanns tidigare på filer och kataloger
position	query		integer int64	Med den här parametern kan anroparen ladda upp data parallellt och styra i vilken ordning den läggs till i filen. Det krävs när du laddar upp data som ska läggas till i filen och vid tömning av tidigare uppladdade data till filen. Värdet måste vara den position där data ska läggas till. Uppladdade data rensas inte omedelbart, eller skrivs, till filen. För att rensa måste tidigare uppladdade data vara sammanhängande, positionsparametern måste anges och vara lika med filens längd när alla data har skrivits och det får inte finnas en begärandeentitetstext som ingår i begäran.
retainUncommittedData	query		boolean	Gäller endast för tömningsåtgärder. Om "sant" behålls ogenomförda data när tömningsåtgärden har slutförts. Annars tas de ogenomförda data bort efter tömningsåtgärden. Standardvärdet är False. Data vid förskjutningar som är mindre än den angivna positionen skrivs till filen när tömningen lyckas, men den här valfria parametern tillåter att data efter tömningspositionen bevaras för en framtida tömningsåtgärd.
timeout	query		integer int32	Ett valfritt timeout-värde för åtgärden i sekunder. Perioden börjar när begäran tas emot av tjänsten. Om timeout-värdet förflutit innan åtgärden slutförs misslyckas åtgärden.

Begärandehuvud

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

Name	Obligatorisk	Typ	Description
Content-Length		integer int64	Krävs för "Lägg till data" och "Flush Data". Måste vara 0 för "Flush Data". Måste vara längden på begärandeinnehållet i byte för "Lägg till data".
Content-MD5		string	Valfritt. En MD5-hash för begärandeinnehållet. Det här huvudet är giltigt för åtgärderna "Lägg till" och "Töm". Denna hash används för att verifiera integriteten för begärandeinnehållet under transporten. När det här huvudet anges jämför lagringstjänsten hash-värdet för det innehåll som har anlänt med det här rubrikvärdet. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Observera att denna MD5-hash inte lagras med filen. Det här huvudet är associerat med begärandeinnehållet och inte med det lagrade innehållet i själva filen.
x-ms-lease-id		string	Låne-ID måste anges om det finns ett aktivt lån. Ogiltigt för "setAccessControlRecursive"-åtgärder. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control		string	Valfritt och endast giltigt för åtgärder för att rensa och ange egenskaper. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Cache-Control" för "Läsfil"-åtgärder.
x-ms-content-type		string	Valfritt och endast giltigt för åtgärder för att rensa och ange egenskaper. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Innehållstyp" för "Läs fil"-åtgärder.
x-ms-content-disposition		string	Valfritt och endast giltigt för åtgärder för att rensa och ange egenskaper. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Content-Disposition" för "Read File"-åtgärder.
x-ms-content-encoding		string	Valfritt och endast giltigt för åtgärder för att rensa och ange egenskaper. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Content-Encoding" för "Read File"-åtgärder.
x-ms-content-language		string	Valfritt och endast giltigt för åtgärder för att rensa och ange egenskaper. Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Content-Language" för "Read File"-åtgärder.
x-ms-content-md5		string	Valfritt och endast giltigt för åtgärderna "Töm och ange egenskaper". Tjänsten lagrar det här värdet och inkluderar det i svarshuvudet "Content-Md5" för åtgärderna "Läsa och hämta egenskaper". Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till "Läs och Hämta egenskaper" returnerar inte den här egenskapen om den inte uttryckligen har angetts för filen igen.
x-ms-properties		string	Valfritt. Användardefinierade egenskaper som ska lagras med filen eller katalogen, i formatet för en kommaavgränsad lista med namn och värdepar "n1=v1, n2=v2, ...", där varje värde är en base64-kodad sträng. Observera att strängen bara får innehålla ASCII-tecken i teckenuppsättningen ISO-8859-1. Gäller endast för setProperties-åtgärden. Om filen eller katalogen finns tas alla egenskaper som inte ingår i listan bort. Alla egenskaper tas bort om rubriken utelämnas. Om du vill sammanfoga nya och befintliga egenskaper hämtar du först alla befintliga egenskaper och den aktuella E-taggen och gör sedan en villkorlig begäran med E-taggen och inkluderar värden för alla egenskaper.
x-ms-owner		string	Valfritt och giltigt endast för setAccessControl-åtgärden. Anger filens eller katalogens ägare.
x-ms-group		string	Valfritt och giltigt endast för setAccessControl-åtgärden. Anger den ägande gruppen för filen eller katalogen.
x-ms-permissions		string	Valfritt och endast giltigt om hierarkiskt namnområde är aktiverat för kontot. Anger POSIX-åtkomstbehörigheter för filägaren, filägargruppen och andra. Varje klass kan beviljas läsbehörighet (4), skriva (2) eller köra (1) behörighet. Både symbolisk (rwxrw-rw-) och 4-siffrig oktal notation (t.ex. 0766) stöds. Den klibbiga biten stöds också och i symbolisk notation, representeras den antingen av bokstaven t eller T på den slutliga teckenplatsen beroende på om körningsbiten för den andra kategorin har angetts eller inte (t.ex. rwxrw-rw- med klibbig bit representeras som rwxrw-rwT. En rwxrw-rwx med klibbig bit representeras som rwxrw-rwt), avsaknad av t eller T indikerar att sticky bit inte har angetts. I 4-siffrig oktal notation representerar dess med 1: a siffran (t.ex. 1766 representerar rwxrw-rw- med klibbig bit och 0766 representerar rwxrw-rw- utan klibbig bit). Ogiltigt tillsammans med x-ms-acl.
x-ms-acl		string	Valfritt och giltigt endast för setAccessControl- och setAccessControlRecursive-åtgärder. Krävs för setAccessControlRecursive-åtgärd. Anger behörigheter för POSIX-åtkomstkontroll för filer och kataloger. Värdet är en kommaavgränsad lista över åtkomstkontrollposter som helt ersätter den befintliga åtkomstkontrollistan (ACL) vid setAccessControl och "set"-läget för setAccessControlRecursive. "ändra" läget för setAccessControlRecursive uppdaterar den befintliga ACLS. Varje åtkomstkontrollpost (ACE) består av ett omfång, en typ, en användare eller gruppidentifierare och behörigheter i formatet "[scope:][type]:[id]:[permissions]". Omfånget måste vara "standard" för att ange att ACE tillhör standard-ACL:en för en katalog. annars är omfånget implicit och ACE tillhör åtkomst-ACL:en. Det finns fyra ACE-typer: "användare" beviljar rättigheter till ägaren eller en namngiven användare, "grupp" beviljar rättigheter till ägande gruppen eller en namngiven grupp, "mask" begränsar rättigheter som beviljas till namngivna användare och medlemmar i grupper och "andra" ger rättigheter till alla användare som inte finns i någon av de andra posterna. Användaren eller gruppidentifieraren utelämnas för poster av typen "mask" och "other". Användaren eller gruppidentifieraren utelämnas också för ägare och ägande grupp. Behörighetsfältet är en 3-teckenssekvens där det första tecknet är "r" för att bevilja läsåtkomst, det andra tecknet är "w" för att bevilja skrivåtkomst och det tredje tecknet är "x" för att bevilja körningsbehörighet. Om åtkomst inte beviljas används tecknet "-" för att ange att behörigheten nekas. Följande ACL beviljar till exempel läs-, skriv- och körningsrättigheter till filägaren och john.doe@contoso, läsbehörigheten till den ägande gruppen och ingenting för alla andra: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ogiltigt tillsammans med x-ms-permissions. "remove"-läget för setAccessControlRecursive tar bort befintliga ACL:er och bör inte innehålla behörigheter i åtkomstkontrollistan som anges: "user:john.doe@contoso:, mask:". "set"-läget för setAccessControlRecursive anger ACL:er som ersätter befintliga ACL:er för det angivna omfånget och måste innehålla alla tre – ägande användare, ägande grupp och annan information om åtkomstomfånget anges eller om någon av ägande användare, ägande grupp eller annan anges i standardomfånget. Lägena "set" och "modify" för setAccessControlRecursive måste innehålla behörigheter som en del av åtkomstkontrollistan.
If-Match		string	Valfritt för Töm data, Ange Access Control och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange Access Control rekursiv. Ett ETag-värde. Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet. ETag måste anges inom citattecken.
If-None-Match		string	Valfritt för Töm data, Ange Access Control och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange Access Control rekursiv. Ett ETag-värde eller ett särskilt jokerteckenvärde ("*"). Ange det här huvudet för att utföra åtgärden endast om resursens ETag inte matchar det angivna värdet. ETag måste anges inom citattecken.
If-Modified-Since		string	Valfritt för tömningsdata och ange egenskaper, men ogiltigt för Tilläggsdata och Ange Access Control rekursiv. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan det angivna datumet och tiden.
If-Unmodified-Since		string	Valfritt för tömningsdata och ange egenskaper, men ogiltigt för Tilläggsdata och Ange Access Control rekursiv. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet och tiden.
x-ms-encryption-key		string	Valfritt. Den Base64-kodade AES-256-krypteringsnyckeln.
x-ms-encryption-key-sha256		string	Valfritt. Den Base64-kodade SHA256-hashen för krypteringsnyckeln.
x-ms-encryption-algorithm: AES256		string	Valfritt. Anger vilken algoritm som ska användas för kryptering. Värdet för det här huvudet måste vara AES256.
x-ms-lease-action	True	PathLeaseAction	Från och med version 2020-08-04 i tilläggs- och tömningsåtgärder. Append stöder åtgärden "acquire", "auto-renew" och "acquire-release". Om "förvärvar" kommer det att förvärva lånet. Om "förnyas automatiskt" förnyas lånet. Om "acquire-release" hämtas & slutföra åtgärden & frigöra lånet när åtgärden är klar. "Release"-åtgärden stöds endast i tömningsåtgärden. Om "true" släpps lånet för filen med hjälp av låne-ID-informationen från rubriken x-ms-lease-id.
x-ms-lease-duration		integer int32	Lånetiden krävs för att skaffa ett lån och anger lånets varaktighet i sekunder. Lånetiden måste vara mellan 15 och 60 sekunder eller -1 för oändligt lån.
x-ms-proposed-lease-id		string	Krävs när "x-ms-lease-action" är "acquire" eller "change". Ett lån förvärvas med det här låne-ID:t om åtgärden lyckas. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-client-request-id		string	Ett UUID som registrerats i analysloggarna för felsökning och korrelation. Reguljärt uttrycksmönster: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date		string	Anger Coordinated Universal Time (UTC) för begäran. Detta krävs när du använder auktorisering av delad nyckel.
x-ms-version		string	Anger versionen av REST-protokollet som används för bearbetning av begäran. Detta krävs när du använder auktorisering av delad nyckel.

Begärandetext

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

Name	Typ	Description
requestBody	object	Gäller endast för tilläggsåtgärder. De data som ska laddas upp och läggas till i filen.

Svar

Name	Typ	Description
200 OK	SetAccessControlRecursiveResponse	Data rensades (skrevs) till filen eller så har egenskaperna angetts korrekt. Svarstexten är valfri och är endast giltig för "SetAccessControlRecursive" Sidhuvuden 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		Uppladdade data accepterades. Sidhuvuden Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string x-ms-lease-renewed: boolean
Other Status Codes	DataLakeStorageError	Ett fel inträffade. De möjliga HTTP-status-, kod- och meddelandesträngarna visas nedan: 400 Felaktig begäran, ContentLengthMustBeZero, "Rubriken för innehållslängdsbegäran måste vara noll". 400 Felaktig begäran, InvalidAuthenticationInfo, "Autentiseringsinformation ges inte i rätt format. Kontrollera värdet för auktoriseringsrubriken." 400 Felaktig begäran, InvalidFlushPosition, "Uppladdade data är inte sammanhängande eller värdet för frågeparametern position är inte lika med filens längd efter att de uppladdade data har lagts till." 400 Felaktig begäran, InvalidHeaderValue, "Värdet för en av HTTP-huvudena är inte i rätt format." 400 Felaktig begäran, InvalidHttpVerb, "Det angivna HTTP-verbet är ogiltigt – det känns inte igen av servern." 400 Felaktig begäran, InvalidInput, "En av indata för begäran är inte giltig". 400 Felaktig begäran, InvalidPropertyName, "Ett egenskapsnamn får inte vara tomt". 400 Felaktig begäran, InvalidPropertyName, "Egenskapsnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidQueryParameterValue, "Värdet för en av frågeparametrarna som anges i begärans URI är ogiltigt". 400 Felaktig begäran, InvalidResourceName, "Det angivna resursnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidSourceUri, "Käll-URI:n är ogiltig". 400 Felaktig begäran, InvalidUri, "Begärande-URI:n är ogiltig". 400 Felaktig begäran, MissingRequiredHeader, "Ett HTTP-huvud som är obligatoriskt för den här begäran har inte angetts." 400 Felaktig begäran, MissingRequiredQueryParameter, "En frågeparameter som är obligatorisk för den här begäran har inte angetts.". 400 Felaktig begäran, MultipleConditionHeadersNotSupported, "Flera villkorsrubriker stöds inte.". 400 Felaktig begäran, OutOfRangeInput, "En av indata för begäran är inte inom intervallet." 400 Bad Request, OutOfRangeQueryParameterValue, "En av frågeparametrarna som anges i begärande-URI:n ligger utanför det tillåtna intervallet." 400 Felaktig begäran, UnsupportedHeader, "En av huvudena som anges i begäran stöds inte." 400 Felaktig begäran, UnsupportedQueryParameter, "En av frågeparametrarna som anges i begärans URI stöds inte." 400 Felaktig begäran,RestVersion stöds inte, "Den angivna restversionen stöds inte". 403 Förbjuden, AccountIsDisabled, "Det angivna kontot är inaktiverat". 403 Förbjuden, AuthorizationFailure, "Denna begäran har inte behörighet att utföra den här åtgärden." 403 Förbjudet, InsufficientAccountPermissions, "Kontot som används har inte tillräcklig behörighet för att köra den här åtgärden.". 404 Hittades inte, FilesystemNotFound, "Det angivna filsystemet finns inte.". 404 Hittades inte, PathNotFound, "Den angivna sökvägen finns inte". 404 Hittades inte, RenameDestinationParentPathNotFound, "Målsökvägens överordnade katalog finns inte". 404 Hittades inte, ResourceNotFound, "Den angivna resursen finns inte". 404 Not Found, SourcePathNotFound, "Källsökvägen för en namnbytesåtgärd finns inte." 405 Method Not Allowed, UnsupportedHttpVerb, "Resursen stöder inte det angivna HTTP-verbet." 409 Konflikt, DestinationPathIsBeingDeleted, "Den angivna målsökvägen markeras som borttagen". 409 Konflikt, DirectoryNotEmpty, "Det rekursiva frågeparametervärdet måste vara sant för att ta bort en icke-tom katalog." 409 Conflict, FilesystemAlreadyExists, "Det angivna filsystemet finns redan". 409 Conflict, FilesystemBeingDeleted, "Det angivna filsystemet tas bort". 409 Conflict, InvalidDestinationPath, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." * 409 Conflict, InvalidFlushOperation, "Resursen skapades eller ändrades av Blob Service-API:et och kan inte skrivas till av Data Lake Storage Service-API:et." 409 Conflict, InvalidRenameSourcePath, "Källkatalogen får inte vara samma som målkatalogen och kan inte heller vara en underkatalog till källkatalogen." 409 Konflikt, InvalidSourceOrDestinationResourceType, "Käll- och målresurstypen måste vara identisk." 409 Konflikt, LeaseAlreadyPresent, "Det finns redan ett lån." 409 Konflikt, LeaseIdMismatchWithLeaseOperation, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen med den angivna låneåtgärden." 409 Konflikt, LeaseIsAlreadyBroken, "Lånet har redan brutits och kan inte brytas igen." 409 Konflikt, LeaseIsBreakingAndCannotBeAcquired, "Låne-ID matchade, men lånet är för närvarande i icke-bakåtkompatibelt tillstånd och kan inte förvärvas förrän det bryts." 409 Konflikt, LeaseIsBreakingAndCannotBeChanged, "Låne-ID matchade, men lånet är för närvarande i icke-bakåtkompatibelt tillstånd och kan inte ändras." 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Låne-ID matchade, men lånet har brutits uttryckligen och kan inte förnyas." 409 Konflikt, LeaseNameMismatch, "Det angivna lånenamnet matchade inte det befintliga lånenamnet." 409 Konflikt, LeaseNotPresentWithLeaseOperation, "Låne-ID:t finns inte med den angivna låneåtgärden." 409 Konflikt, PathAlreadyExists, "Den angivna sökvägen finns redan". 409 Konflikt, PathConflict, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." 409 Conflict, SourcePathIsBeingDeleted, "Den angivna källsökvägen har markerats som borttagen". 409 Konflikt, ResourceTypeMismatch, "Resurstypen som anges i begäran matchar inte resurstypen." 412 Förhandsvillkoret misslyckades, ConditionNotMet, "Villkoret som anges med villkorsstyrda HTTP-huvuden är inte uppfyllt." 412 Förhandsvillkoret misslyckades, LeaseIdMismatch, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen." 412 Förhandsvillkoret misslyckades, LeaseIdMissing, "Det finns för närvarande ett lån på resursen och inget låne-ID angavs i begäran." 412 Förhandsvillkoret misslyckades, LeaseNotPresent, "Det finns för närvarande inget lån på resursen." 412 Förhandsvillkoret misslyckades, LeaseLost, "Ett låne-ID angavs, men lånet för resursen har upphört att gälla." 412 Förutsättning misslyckades, SourceConditionNotMet, "Källvillkoret som anges med villkorsstyrda HTTP-huvuden är inte uppfyllt." 413 Begärandeentiteten är för stor, RequestBodyTooLarge, "Begärandetexten är för stor och överskrider den maximala tillåtna gränsen." 416 Det begärda området är inte uppfyllt, InvalidRange, "Det angivna intervallet är ogiltigt för resursens aktuella storlek.". 500 Internt serverfel, InternalError, "Servern påträffade ett internt fel. Försök igen." 500 Internt serverfel, OperationTimedOut, "Det gick inte att slutföra åtgärden inom den tillåtna tiden." 503 Tjänsten är inte tillgänglig, ServerBusy, "Utgående trafik överskrider kontogränsen". 503 Tjänsten är inte tillgänglig, ServerBusy, "Ingress is over the account limit". 503 Tjänsten är inte tillgänglig, ServerBusy, "Åtgärder per sekund överskrider kontogränsen". 503 Tjänsten är inte tillgänglig, ServerBusy, "Servern kan för närvarande inte ta emot begäranden. Försök igen." Sidhuvuden x-ms-request-id: string x-ms-version: string

Definitioner

Name	Description
AclFailedEntryList
DataLakeStorageError
Error	Svarsobjektet för tjänstfel.
PathLeaseAction	Från och med version 2020-08-04 i tilläggs- och tömningsåtgärder. Append stöder åtgärden "acquire", "auto-renew" och "acquire-release". Om "förvärva" det kommer att förvärva lånet. Om "förnyas automatiskt" förnyas lånet. Om "acquire-release" hämtas & slutföra åtgärden & frigöra lånet när åtgärden är klar. Åtgärden "Release" stöds endast i tömningsåtgärden. Om "true" släpps lånet för filen med hjälp av låne-ID-informationen från rubriken x-ms-lease-id.
PathUpdateAction	Åtgärden måste vara "tillägg" för att ladda upp data som ska läggas till i en fil, "flush" för att tömma tidigare uppladdade data till en fil, "setProperties" för att ange egenskaperna för en fil eller katalog eller "setAccessControl" för att ange ägare, grupp, behörigheter eller åtkomstkontrollistan för en fil eller katalog, eller "setAccessControlRecursive" för att ange åtkomstkontrollistan för en katalog rekursivt. Observera att hierarkiskt namnområde måste vara aktiverat för kontot för att kunna använda åtkomstkontroll. Observera också att Access Control List (ACL) innehåller behörigheter för ägaren, ägande gruppen och andra, så x-ms-permissions och x-ms-acl begäran huvuden är ömsesidigt uteslutande.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name	Typ	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Name	Typ	Description
error	Error	Svarsobjektet för tjänstfel.

Error

Svarsobjektet för tjänstfel.

Name	Typ	Description
code	string	Felkoden för tjänsten.
message	string	Tjänstens felmeddelande.

PathLeaseAction

Från och med version 2020-08-04 i tilläggs- och tömningsåtgärder. Append stöder åtgärden "acquire", "auto-renew" och "acquire-release". Om "förvärva" det kommer att förvärva lånet. Om "förnyas automatiskt" förnyas lånet. Om "acquire-release" hämtas & slutföra åtgärden & frigöra lånet när åtgärden är klar. Åtgärden "Release" stöds endast i tömningsåtgärden. Om "true" släpps lånet för filen med hjälp av låne-ID-informationen från rubriken x-ms-lease-id.

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

PathUpdateAction

Åtgärden måste vara "tillägg" för att ladda upp data som ska läggas till i en fil, "flush" för att tömma tidigare uppladdade data till en fil, "setProperties" för att ange egenskaperna för en fil eller katalog eller "setAccessControl" för att ange ägare, grupp, behörigheter eller åtkomstkontrollistan för en fil eller katalog, eller "setAccessControlRecursive" för att ange åtkomstkontrollistan för en katalog rekursivt. Observera att hierarkiskt namnområde måste vara aktiverat för kontot för att kunna använda åtkomstkontroll. Observera också att Access Control List (ACL) innehåller behörigheter för ägaren, ägande gruppen och andra, så x-ms-permissions och x-ms-acl begäran huvuden är ömsesidigt uteslutande.

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