Path - Update

Tjänst:

Storage Services

API-version:

2023-08-03

Lägg till data | Rensa data | Ange egenskaper | Ange åtkomstkontroll
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 minLength: 3 maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$	Filsystemidentifieraren.
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, "rensa" för att rensa 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 åtkomstkontrolllista 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 åtkomstkontrollistan (ACL) innehåller behörigheter för ägaren, ägande gruppen och andra, så att x-ms-permissions- och x-ms-acl-begäranderubrikerna är ömsesidigt uteslutande.
close	query		boolean	Med Azure Storage-händelser kan program ta emot meddelanden när filer ändras. När Azure Storage-händelser aktiveras genereras en filändringshändelse. Den här händelsen har en egenskap som anger om det här är den sista ä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 det här är den slutliga uppdateringen (filströmmen har stängts). Om "false" genereras ett ändringsmeddelande som anger att filen har ändrats. Standardvärdet är falskt. Den här frågeparametern är inställd på 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 (4XX) uppstår. Om "sant" 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 "sant" vid användarfel. Standardvärdet för forceFlag är falskt.
maxRecords	query		integer (int32) minimum: 1	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 krävs 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 de 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 entitetstext för begäran 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 falskt. Data vid förskjutningar som är mindre än den angivna positionen skrivs till filen när tömningen lyckas, men med den här valfria parametern kan data efter tömningspositionen behållas för en framtida tömningsåtgärd.
timeout	query		integer (int32) minimum: 1	Ett valfritt timeout-värde för åtgärden i sekunder. Perioden börjar när begäran tas emot av tjänsten. Om tidsgränsvä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) minimum: 0	Krävs för "Lägg till data" och "Töm 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 har angetts 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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Låne-ID måste anges om det finns ett aktivt lån. Ogiltigt för "setAccessControlRecursive"-åtgärder.
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 innehåller det i svarshuvudet "Cache-Control" för "Läs fil"-å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 innehåller det i svarshuvudet "Content-Disposition" för "Läs fil"-å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 innehåller det i svarshuvudet "Content-Encoding" för "Läs fil"-å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 innehåller det i svarshuvudet "Content-Language" för "Läs fil"-åtgärder.
x-ms-content-md5		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 innehåller 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 ägaren till filen eller katalogen.
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), skrivbehörighet (2) eller köra (1). 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 anges respektive tas bort (t.ex. rwxrw-rw- med fästbit representeras som rwxrw-rwT. En rwxrw-rwx med klibbig bit representeras som rwxrw-rwt), frånvaro av t eller T indikerar att klibbig bit inte har angetts. I 4-siffrig oktal notation representerar dess med en siffra (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ärden. 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äge för setAccessControlRecursive. "ändra" läge 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 den ä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 ägaren och ägande gruppen. Behörighetsfältet är en sekvens på 3 tecken 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 ägande gruppen och ingenting till 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 de befintliga ACL:erna 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 åtkomstkontroll och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange rekursiv åtkomstkontroll. 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 åtkomstkontroll och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange rekursiv åtkomstkontroll. 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öm data och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange rekursiv åtkomstkontroll. 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öm data och Ange egenskaper, men ogiltigt för Tilläggsdata och Ange rekursiv åtkomstkontroll. 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 den 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. Appen har stöd för å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. Å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.
x-ms-lease-duration		integer (int32)	Lånetiden krävs för att förvärva 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 pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Krävs när "x-ms-lease-action" är "acquire" eller "change". Ett lån hämtas med det här låne-ID:t om åtgärden lyckas.
x-ms-client-request-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Ett UUID som registrerats i analysloggarna för felsökning och korrelation.
x-ms-date		string	Anger UTC (Coordinated Universal Time) för begäran. Detta krävs när du använder auktorisering av delad nyckel.
x-ms-version		string	Anger den version 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 (file)	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 har tömts (skrivits) till filen eller så har egenskaperna angetts. 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		De 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 uppstod. 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 auktoriseringshuvud." 400 Felaktig begäran, InvalidFlushPosition, "De uppladdade data är inte sammanhängande eller värdet för frågeparametern position är inte lika med längden på filen 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ärande-URI:n ä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 utom räckhåll." 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 de huvuden som anges i begäran stöds inte." 400 Bad Request, UnsupportedQueryParameter, "En av frågeparametrarna som anges i begärande-URI:n stöds inte." 400 Bad Request, UnsupportedRestVersion, "Den angivna restversionen stöds inte.". 403 Förbjudet, AccountIsDisabled, "Det angivna kontot är inaktiverat". 403 Förbjudet, 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 Hittades inte, SourcePathNotFound, "Källsökvägen för en namnbytesåtgärd finns inte." 405-metoden är inte tillåten, stöds inteHttpVerb, "Resursen stöder inte det angivna HTTP-verbet." 409 Conflict, DestinationPathIsBeingDeleted, "Den angivna målsökvägen har markerats som borttagen". 409 Conflict, 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 och kan inte skrivas till av Data Lake Storage Service API." 409 Conflict, InvalidRenameSourcePath, "Källkatalogen får inte vara samma som målkatalogen och inte heller kan målet vara en underkatalog till källkatalogen." 409 Conflict, InvalidSourceOrDestinationResourceType, "Käll- och målresurstypen måste vara identisk." 409 Konflikt, LeaseAlreadyPresent, "Det finns redan ett lån finns." 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen med den angivna låneåtgärden." 409 Conflict, LeaseIsAlreadyBroken, "Lånet har redan brutits och kan inte brytas igen." 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte förvärvas förrän det har brutits." 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Låne-ID:t matchade, men lånet är för närvarande i icke-bakåtkompatibelt tillstånd och kan inte ändras." 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Låne-ID:t matchade, men lånet har brutits explicit och kan inte förnyas." 409 Konflikt, LeaseNameMismatch, "Det angivna lånenamnet matchade inte det befintliga lånenamnet." 409 Conflict, LeaseNotPresentWithLeaseOperation, "Låne-ID:t finns inte med den angivna låneåtgärden." 409 Conflict, 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 Conflict, ResourceTypeMismatch, "Resurstypen som anges i begäran matchar inte resurstypen." 412 Förutsättningen misslyckades, ConditionNotMet, "Villkoret som anges med http-villkorliga huvuden är inte uppfyllt." 412 Förutsättningen misslyckades, LeaseIdMismatch, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen." 412 Förutsättningen misslyckades, LeaseIdMissing, "Det finns för närvarande ett lån på resursen och inget låne-ID angavs i begäran." 412 Förutsättningen misslyckades, LeaseNotPresent, "Det finns för närvarande inget lån på resursen." 412 Förutsättningen misslyckades, LeaseLost, "Ett låne-ID har angetts, men lånet för resursen har upphört att gälla." 412 Förutsättningen misslyckades, SourceConditionNotMet, "Det källvillkor som anges med http-villkorshuvuden uppfylls inte." 413 Begärandeentiteten är för stor, RequestBodyTooLarge, "Begärandetexten är för stor och överskrider den maximala tillåtna gränsen." 416 Begärt intervall 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, "Åtgärden kunde inte slutföras 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 är över kontogränsen." 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	Tjänstens felsvarsobjekt.
PathLeaseAction	Från och med version 2020-08-04 i tilläggs- och tömningsåtgärder. Appen har stöd för å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. Å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, "rensa" för att rensa 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 åtkomstkontrolllista 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 åtkomstkontrollistan (ACL) innehåller behörigheter för ägaren, ägande gruppen och andra, så att x-ms-permissions- och x-ms-acl-begäranderubrikerna är ömsesidigt uteslutande.
SetAccessControlRecursiveResponse

AclFailedEntryList

Objekt

Name	Typ	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Objekt

Name	Typ	Description
error	Error	Tjänstens felsvarsobjekt.

Error

Objekt

Tjänstens felsvarsobjekt.

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

PathLeaseAction

Uppräkning

Från och med version 2020-08-04 i tilläggs- och tömningsåtgärder. Appen har stöd för å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. Å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.

Värde	Description
acquire
acquire-release
auto-renew
release

PathUpdateAction

Uppräkning

Åtgärden måste vara "tillägg" för att ladda upp data som ska läggas till i en fil, "rensa" för att rensa 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 åtkomstkontrolllista 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 åtkomstkontrollistan (ACL) innehåller behörigheter för ägaren, ägande gruppen och andra, så att x-ms-permissions- och x-ms-acl-begäranderubrikerna är ömsesidigt uteslutande.

Värde	Description
append
flush
setAccessControl
setAccessControlRecursive
setProperties

SetAccessControlRecursiveResponse

Objekt

Name	Typ	Description
directoriesSuccessful	integer (int32)
failedEntries	AclFailedEntryList[]
failureCount	integer (int32)
filesSuccessful	integer (int32)