Path - Update

Service:

Storage Services

API-versie:

2023-08-03

Gegevens toevoegen | Gegevens leegmaken | Eigenschappen instellen | Toegangsbeheer instellen
Hiermee worden gegevens geüpload die moeten worden toegevoegd aan een bestand, worden gegevens verwijderd (schrijfbewerkingen) die eerder zijn geüpload naar een bestand, worden eigenschappen ingesteld voor een bestand of map of worden toegangsbeheer ingesteld voor een bestand of map. Gegevens kunnen alleen worden toegevoegd aan een bestand. Gelijktijdige schrijfbewerkingen naar hetzelfde bestand met meerdere clients worden niet ondersteund. Deze bewerking ondersteunt voorwaardelijke HTTP-aanvragen. Zie Voorwaardelijke headers opgeven voor blobservicebewerkingenvoor meer informatie.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
accountName	path	True	string	De naam van het Azure Storage-account.
dnsSuffix	path	True	string	Het DNS-achtervoegsel voor het Azure Data Lake Storage-eindpunt.
filesystem	path	True	string minLength: 3 maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$	De bestandssysteem-id.
path	path	True	string	Het pad naar het bestand of de map.
action	query	True	PathUpdateAction	De actie moet 'toevoegen' zijn om gegevens te uploaden die moeten worden toegevoegd aan een bestand, 'leegmaken' om eerder geüploade gegevens naar een bestand te verwijderen, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst voor een bestand of map in te stellen, of 'setAccessControlRecursive' om de toegangsbeheerlijst voor een map recursief in te stellen. Houd er rekening mee dat hiërarchische naamruimte moet zijn ingeschakeld voor het account om toegangsbeheer te kunnen gebruiken. Houd er ook rekening mee dat de toegangsbeheerlijst (ACL) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, dus de x-ms-permissions en x-ms-acl-aanvraagheaders sluiten elkaar wederzijds uit.
close	query		boolean	Met Azure Storage-gebeurtenissen kunnen toepassingen meldingen ontvangen wanneer bestanden worden gewijzigd. Wanneer Azure Storage-gebeurtenissen zijn ingeschakeld, wordt een gewijzigde gebeurtenis gegenereerd. Deze gebeurtenis heeft een eigenschap die aangeeft of dit de laatste wijziging is om het verschil te onderscheiden tussen een tussenliggende flush naar een bestandsstroom en de laatste sluiting van een bestandsstroom. De queryparameter sluiten is alleen geldig wanneer de actie 'leegmaken' is en wijzigingsmeldingen zijn ingeschakeld. Als de waarde van sluiten 'true' is en de flush-bewerking is voltooid, genereert de service een melding voor bestandswijziging met een eigenschap die aangeeft dat dit de laatste update is (de bestandsstroom is gesloten). Als 'onwaar' een wijzigingsmelding wordt gegenereerd die aangeeft dat het bestand is gewijzigd. De standaardwaarde is onwaar. Deze queryparameter is ingesteld op true door het Hadoop ABFS-stuurprogramma om aan te geven dat de bestandsstroom is gesloten.
continuation	query		string	Optioneel en alleen geldig voor de bewerking setAccessControlRecursive. Het aantal paden dat bij elke aanroep wordt verwerkt, is beperkt. Als het aantal paden dat moet worden verwerkt deze limiet overschrijdt, wordt een vervolgtoken geretourneerd in de antwoordheader x-ms-continuation. Wanneer een vervolgtoken wordt geretourneerd in het antwoord, moet het percentage worden gecodeerd en opgegeven in een volgende aanroep van setAccessControlRecursive-bewerking.
flush	query		boolean	Alleen geldig voor toevoeg-aanroepen. Met deze parameter kan de aanroeper leegmaken tijdens een toevoegaanroep. De standaardwaarde is 'false', als 'true' de gegevens worden leeggemaakt met de toevoeg-aanroep. Houd er rekening mee dat wanneer u flush=true gebruikt, de volgende headers niet worden ondersteund: 'x-ms-cache-control', 'x-ms-content-encoding', 'x-ms-content-type', 'x-ms-content-language', 'x-ms-content-md5', 'x-ms-content-disposition'. Als u deze headers tijdens het leegmaken wilt instellen, gebruikt u action=flush
forceFlag	query		boolean	Optioneel en alleen geldig voor de bewerking setAccessControlRecursive. Als dit 'false' is, wordt de bewerking snel beëindigd bij het tegenkomen van gebruikersfouten (4XX). Als 'waar' negeert de API gebruikersfouten en gaat u verder met de bewerking op andere subentiteiten van de directory. Gedetailleerde status van gebruikersfouten wordt geretourneerd in het antwoord voor beide scenario's. Vervolgtoken wordt alleen geretourneerd wanneer forceFlag 'true' is in het geval van gebruikersfouten. De standaardwaarde voor forceFlag is onwaar.
maxRecords	query		integer (int32) minimum: 1	Optioneel en alleen geldig voor de bewerking setAccessControlRecursive. Hiermee geeft u het maximum aantal bestanden of mappen op waarop de ACL-wijziging wordt toegepast. Als u deze weglaat of groter is dan 2000, verwerkt de aanvraag maximaal 2.000 items
mode	query		string	Facultatief. Geldig en vereist voor de bewerking setAccessControlRecursive. De modus 'set' stelt POSIX-toegangsbeheerrechten in voor bestanden en mappen, 'wijzigen' wijzigt een of meer POSIX-toegangsbeheerrechten die al bestaan op bestanden en mappen, 'verwijderen' verwijdert een of meer POSIX-toegangsbeheerrechten die eerder op bestanden en mappen aanwezig waren
position	query		integer (int64)	Met deze parameter kan de aanroeper gegevens parallel uploaden en de volgorde bepalen waarin deze wordt toegevoegd aan het bestand. Het is vereist bij het uploaden van gegevens die moeten worden toegevoegd aan het bestand en bij het leegmaken van eerder geüploade gegevens naar het bestand. De waarde moet de positie zijn waar de gegevens moeten worden toegevoegd. Geüploade gegevens worden niet onmiddellijk leeggemaakt of naar het bestand geschreven. Als u wilt leegmaken, moeten de eerder geüploade gegevens aaneengesloten zijn, moet de positieparameter worden opgegeven en gelijk zijn aan de lengte van het bestand nadat alle gegevens zijn geschreven en mag er geen hoofdtekst van de aanvraag zijn opgenomen in de aanvraag.
retainUncommittedData	query		boolean	Alleen geldig voor spoelbewerkingen. Indien 'waar', worden niet-verzonden gegevens bewaard nadat de leeggemaakte bewerking is voltooid; anders worden de niet-verzonden gegevens verwijderd na de leeggemaakte bewerking. De standaardwaarde is onwaar. Gegevens bij verschuivingen die kleiner zijn dan de opgegeven positie, worden naar het bestand geschreven wanneer het leegmaken is geslaagd, maar met deze optionele parameter kunnen gegevens na het leegmaken behouden blijven voor een toekomstige flush-bewerking.
timeout	query		integer (int32) minimum: 1	Een optionele time-outwaarde voor bewerkingen in seconden. De periode begint wanneer de aanvraag door de service wordt ontvangen. Als de time-outwaarde is verstreken voordat de bewerking is voltooid, mislukt de bewerking.

Aanvraagkoptekst

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

Name	Vereist	Type	Description
Content-Length		integer (int64) minimum: 0	Vereist voor 'Gegevens toevoegen' en 'Gegevens leegmaken'. Moet 0 zijn voor 'Gegevens leegmaken'. Moet de lengte zijn van de aanvraaginhoud in bytes voor 'Gegevens toevoegen'.
Content-MD5		string	Facultatief. Een MD5-hash van de aanvraaginhoud. Deze header is geldig voor bewerkingen 'Toevoegen' en 'Leegmaken'. Deze hash wordt gebruikt om de integriteit van de aanvraaginhoud tijdens het transport te controleren. Wanneer deze header is opgegeven, vergelijkt de opslagservice de hash van de inhoud die is aangekomen met deze headerwaarde. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Ongeldige aanvraag). Houd er rekening mee dat deze MD5-hash niet is opgeslagen met het bestand. Deze header is gekoppeld aan de aanvraaginhoud en niet aan de opgeslagen inhoud van het bestand zelf.
x-ms-lease-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	De lease-id moet worden opgegeven als er een actieve lease is. Ongeldig voor 'setAccessControlRecursive'-bewerkingen.
x-ms-cache-control		string	Optioneel en alleen geldig voor bewerkingen voor leegmaken en eigenschappen instellen. De service slaat deze waarde op en bevat deze in de antwoordheader 'Cache-Control' voor 'Bestand lezen'-bewerkingen.
x-ms-content-type		string	Optioneel en alleen geldig voor bewerkingen voor leegmaken en eigenschappen instellen. De service slaat deze waarde op en bevat deze in de antwoordheader 'Inhoudstype' voor 'Bestand lezen'-bewerkingen.
x-ms-content-disposition		string	Optioneel en alleen geldig voor bewerkingen voor leegmaken en eigenschappen instellen. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Disposition' voor 'Bestand lezen'-bewerkingen.
x-ms-content-encoding		string	Optioneel en alleen geldig voor bewerkingen voor leegmaken en eigenschappen instellen. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Encoding' voor 'Bestand lezen'-bewerkingen.
x-ms-content-language		string	Optioneel en alleen geldig voor bewerkingen voor leegmaken en eigenschappen instellen. De service slaat deze waarde op en bevat deze in de antwoordheader 'Content-Language' voor 'Bestand lezen'-bewerkingen.
x-ms-content-md5		string	Optioneel en alleen geldig voor bewerkingen 'Eigenschappen leegmaken en instellen'. De service slaat deze waarde op en bevat deze in de antwoordheader Content-Md5 voor bewerkingen Lezen en Eigenschappen ophalen. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap gewist voor het bestand. Volgende aanroepen naar 'Eigenschappen lezen en ophalen' retourneren deze eigenschap niet, tenzij deze expliciet voor dat bestand is ingesteld.
x-ms-properties		string	Facultatief. Door de gebruiker gedefinieerde eigenschappen die moeten worden opgeslagen met het bestand of de map, in de indeling van een door komma's gescheiden lijst met naam- en waardeparen "n1=v1, n2=v2, ...", waarbij elke waarde een met base64 gecodeerde tekenreeks is. Houd er rekening mee dat de tekenreeks alleen ASCII-tekens mag bevatten in de ISO-8859-1-tekenset. Alleen geldig voor de bewerking setProperties. Als het bestand of de map bestaat, worden alle eigenschappen die niet in de lijst zijn opgenomen, verwijderd. Alle eigenschappen worden verwijderd als de koptekst wordt weggelaten. Als u nieuwe en bestaande eigenschappen wilt samenvoegen, moet u eerst alle bestaande eigenschappen en de huidige E-Tag ophalen en vervolgens een voorwaardelijke aanvraag indienen met de E-tag en waarden voor alle eigenschappen opnemen.
x-ms-owner		string	Optioneel en alleen geldig voor de setAccessControl-bewerking. Hiermee stelt u de eigenaar van het bestand of de map in.
x-ms-group		string	Optioneel en alleen geldig voor de setAccessControl-bewerking. Hiermee stelt u de groep die eigenaar is van het bestand of de map in.
x-ms-permissions		string	Optioneel en alleen geldig als hiërarchische naamruimte is ingeschakeld voor het account. Hiermee stelt u POSIX-toegangsmachtigingen in voor de bestandseigenaar, de groep die eigenaar is van het bestand en andere. Elke klasse kan een machtiging lezen (4), schrijven (2) of uitvoeren (1) krijgen. Zowel symbolische (rwxrw-rw-) als een octale notatie van 4 cijfers (bijvoorbeeld 0766) worden ondersteund. De plak-bit wordt ook ondersteund en in symbolische notatie, die wordt vertegenwoordigd door de letter t of T in de laatste tekenplaats, afhankelijk van of de uitvoeringsbit voor de andere categorie is ingesteld of uitgezet (bijvoorbeeld rwxrw-rw- met plakbit wordt weergegeven als rwxrw-rwT. Een rwxrw-rwx met plakbit wordt weergegeven als rwxrw-rwt), afwezigheid van t of T geeft aan dat plakbit niet is ingesteld. In een octale notatie van 4 cijfers wordt deze vertegenwoordigd door het 1e cijfer (bijvoorbeeld 1766 vertegenwoordigt rwxrw-rw- met plakbit en 0766 staat voor rwxrw-rw- zonder plakbit). Ongeldig in combinatie met x-ms-acl.
x-ms-acl		string	Optioneel en alleen geldig voor de setAccessControl en setAccessControlRecursive-bewerkingen. Vereist voor setAccessControlRecursive-bewerking. Hiermee stelt u POSIX-toegangsbeheerrechten in voor bestanden en mappen. De waarde is een door komma's gescheiden lijst met vermeldingen voor toegangsbeheer die de bestaande toegangsbeheerlijst (ACL) volledig vervangt in het geval van setAccessControl en de 'set'-modus van setAccessControlRecursive. De modus 'modify' van setAccessControlRecursive werkt de bestaande ACLS bij. Elke toegangsbeheervermelding (ACE) bestaat uit een bereik, een type, een gebruikers- of groeps-id en machtigingen in de indeling [scope:][type]:[id]:[machtigingen]". Het bereik moet 'standaard' zijn om aan te geven dat de ACE deel uitmaakt van de standaard-ACL voor een map; anders is het bereik impliciet en behoort de ACE tot de toegangs-ACL. Er zijn vier ACE-typen: "gebruiker" verleent rechten aan de eigenaar of een benoemde gebruiker, "groep" verleent rechten aan de groep die eigenaar is of een benoemde groep, "masker" beperkt rechten die zijn verleend aan benoemde gebruikers en de leden van groepen, en "andere" verleent rechten aan alle gebruikers die niet in een van de andere vermeldingen zijn gevonden. De gebruikers- of groeps-id wordt weggelaten voor vermeldingen van het type 'masker' en 'overige'. De gebruikers- of groeps-id wordt ook weggelaten voor de eigenaar en eigenaar van de groep. Het machtigingsveld is een reeks van drie tekens waarbij het eerste teken 'r' is om leestoegang te verlenen, het tweede teken w is om schrijftoegang te verlenen en het derde teken 'x' is om uitvoermachtigingen te verlenen. Als er geen toegang wordt verleend, wordt het teken '-' gebruikt om aan te geven dat de machtiging wordt geweigerd. De volgende ACL verleent bijvoorbeeld lees-, schrijf- en uitvoerrechten aan de bestandseigenaar en john.doe@contoso, het leesrecht voor de groep die eigenaar is en niets aan iedereen: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ongeldig in combinatie met x-ms-machtigingen. De modus 'remove' van setAccessControlRecursive verwijdert de bestaande ACL's en mag geen machtigingen bevatten in de opgegeven toegangsbeheerlijst: "user:john.doe@contoso:, mask:". 'set'-modus van setAccessControlRecursive stelt de ACL's in die de bestaande ACL's van het opgegeven bereik vervangen en moeten alle drie de eigenaar zijn van de gebruiker, de groep die eigenaar is en andere informatie bevatten als het toegangsbereik wordt ingesteld of als een van de eigenaar van de gebruiker, de eigenaar van de groep of een andere wordt ingesteld in het standaardbereik. De modi 'set' en 'modify' van setAccessControlRecursive moeten machtigingen bevatten als onderdeel van de toegangsbeheerlijst.
If-Match		string	Optioneel voor leegmaken van gegevens, toegangsbeheer instellen en eigenschappen instellen, maar ongeldig voor toevoeggegevens en toegangsbeheer instellen recursief. Een ETag-waarde. Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven.
If-None-Match		string	Optioneel voor leegmaken van gegevens, toegangsbeheer instellen en eigenschappen instellen, maar ongeldig voor toevoeggegevens en toegangsbeheer instellen recursief. Een ETag-waarde of de speciale jokertekenwaarde ('*'). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. De ETag moet tussen aanhalingstekens worden opgegeven.
If-Modified-Since		string	Optioneel voor leegmaken van gegevens en eigenschappen instellen, maar ongeldig voor toevoeggegevens en recursief toegangsbeheer instellen. Een datum- en tijdwaarde. Geef deze header op om de bewerking alleen uit te voeren als de resource is gewijzigd sinds de opgegeven datum en tijd.
If-Unmodified-Since		string	Optioneel voor leegmaken van gegevens en eigenschappen instellen, maar ongeldig voor toevoeggegevens en recursief toegangsbeheer instellen. Een datum- en tijdwaarde. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum en tijd.
x-ms-encryption-key		string	Facultatief. De met Base64 gecodeerde AES-256-versleutelingssleutel.
x-ms-encryption-key-sha256		string	Facultatief. De met Base64 gecodeerde SHA256-hash van de versleutelingssleutel.
x-ms-encryption-algorithm: AES256		string	Facultatief. Hiermee geeft u het algoritme op dat moet worden gebruikt voor versleuteling. De waarde van deze header moet AES256 zijn.
x-ms-lease-action	True	PathLeaseAction	Vanaf versie 2020-08-04 in toevoeg- en spoelbewerkingen. Toevoegen ondersteunt de actie 'acquire', 'auto-renew' en 'acquire-release'. Als 'acquire' wordt de lease verkregen. Als automatisch verlengen wordt de lease verlengd. Als 'acquire-release' wordt verkregen, wordt & de bewerking voltooid & de lease vrij te geven zodra de bewerking is voltooid. De actie 'Release' wordt alleen ondersteund in de bewerking Leegmaken. Als 'waar' wordt gebruikt, wordt de lease voor het bestand vrijgegeven met behulp van de lease-id-informatie van de header x-ms-lease-id.
x-ms-lease-duration		integer (int32)	De leaseduur is vereist voor het verkrijgen van een lease en geeft de duur van de lease in seconden aan. De leaseduur moet tussen 15 en 60 seconden of -1 zijn voor een oneindige lease.
x-ms-proposed-lease-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Vereist wanneer 'x-ms-lease-action' 'acquire' of 'change' is. Er wordt een lease verkregen met deze lease-id als de bewerking is geslaagd.
x-ms-client-request-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Een UUID die is vastgelegd in de analyselogboeken voor probleemoplossing en correlatie.
x-ms-date		string	Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Dit is vereist bij het gebruik van autorisatie van gedeelde sleutels.
x-ms-version		string	Hiermee geeft u de versie op van het REST-protocol dat wordt gebruikt voor het verwerken van de aanvraag. Dit is vereist bij het gebruik van autorisatie van gedeelde sleutels.

Aanvraagbody

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

Name	Type	Description
requestBody	object (file)	Alleen geldig voor toevoegbewerkingen. De gegevens die moeten worden geüpload en toegevoegd aan het bestand.

Antwoorden

Name	Type	Description
200 OK	SetAccessControlRecursiveResponse	De gegevens zijn leeggemaakt (geschreven) naar het bestand of de eigenschappen zijn ingesteld. Antwoordtekst is optioneel en is alleen geldig voor SetAccessControlRecursive Kopteksten 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 geüploade gegevens zijn geaccepteerd. Kopteksten Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string x-ms-lease-renewed: boolean
Other Status Codes	DataLakeStorageError	Er is een fout opgetreden. Hieronder ziet u de mogelijke HTTP-status, code en berichttekenreeksen: 400 Ongeldige aanvraag, ContentLengthMustBeZero, "De aanvraagheader content-length moet nul zijn." 400 Ongeldige aanvraag, InvalidAuthenticationInfo, "Verificatiegegevens worden niet gegeven in de juiste indeling. Controleer de waarde van de autorisatieheader. 400 Ongeldige aanvraag, InvalidFlushPosition, "De geüploade gegevens zijn niet aaneengesloten of de waarde van de positiequeryparameter is niet gelijk aan de lengte van het bestand nadat de geüploade gegevens zijn toegevoegd." 400 Ongeldige aanvraag, InvalidHeaderValue, 'De waarde voor een van de HTTP-headers heeft niet de juiste indeling.' 400 Ongeldige aanvraag, InvalidHttpVerb, 'Het opgegeven HTTP-werkwoord is ongeldig- het wordt niet herkend door de server'. 400 Ongeldige aanvraag, InvalidInput, "Een van de aanvraaginvoer is ongeldig." 400 Ongeldige aanvraag, InvalidPropertyName, 'Een eigenschapsnaam mag niet leeg zijn'. 400 Ongeldige aanvraag, InvalidPropertyName, 'De naam van de eigenschap bevat ongeldige tekens'. 400 Ongeldige aanvraag, InvalidQueryParameterValue, 'Waarde voor een van de queryparameters die zijn opgegeven in de aanvraag-URI is ongeldig'. 400 Ongeldige aanvraag, InvalidResourceName, 'De opgegeven resourcenaam bevat ongeldige tekens'. 400 Ongeldige aanvraag, InvalidSourceUri, 'De bron-URI is ongeldig'. 400 Ongeldige aanvraag, InvalidUri, 'De aanvraag-URI is ongeldig'. 400 Ongeldige aanvraag, MissingRequiredHeader, "Een HTTP-header die verplicht is voor deze aanvraag is niet opgegeven." 400 Ongeldige aanvraag, MissingRequiredQueryParameter, 'Een queryparameter die verplicht is voor deze aanvraag is niet opgegeven'. 400 Ongeldige aanvraag, MultipleConditionHeadersNotSupported, 'Headers met meerdere voorwaarden worden niet ondersteund'. 400 Ongeldige aanvraag, OutOfRangeInput, 'Een van de aanvraaginvoer valt buiten het bereik.' 400 Ongeldige aanvraag, OutOfRangeQueryParameterValue, "Een van de queryparameters die zijn opgegeven in de aanvraag-URI valt buiten het toegestane bereik." 400 Ongeldige aanvraag, Niet-ondersteundeHeader, "Een van de headers die zijn opgegeven in de aanvraag wordt niet ondersteund." 400 Ongeldige aanvraag, Niet-ondersteundeQueryParameter, "Een van de queryparameters die zijn opgegeven in de aanvraag-URI wordt niet ondersteund." 400 Ongeldige aanvraag, Niet-ondersteundeRestVersion, 'De opgegeven REST-versie wordt niet ondersteund'. 403 Verboden, AccountIsDisabled, "Het opgegeven account is uitgeschakeld." 403 Verboden, AuthorizationFailure, "Deze aanvraag is niet gemachtigd om deze bewerking uit te voeren." 403 Verboden, InsufficientAccountPermissions, "Het account dat wordt geopend, beschikt niet over voldoende machtigingen om deze bewerking uit te voeren." 404 Niet gevonden, FilesystemNotFound, "Het opgegeven bestandssysteem bestaat niet." 404 Niet gevonden, PathNotFound, "Het opgegeven pad bestaat niet." 404 Niet gevonden, RenameDestinationParentPathNotFound, "De bovenliggende map van het doelpad bestaat niet." 404 Niet gevonden, ResourceNotFound, "De opgegeven resource bestaat niet." 404 Niet gevonden, SourcePathNotFound, "Het bronpad voor een naamswijzigingsbewerking bestaat niet." Methode 405 Niet toegestaan, UnsupportedHttpVerb, 'De resource biedt geen ondersteuning voor het opgegeven HTTP-werkwoord'. 409 Conflict, DestinationPathIsBeingDeleted, "Het opgegeven doelpad is gemarkeerd om te worden verwijderd." 409 Conflict, DirectoryNotEmpty, "The recursive query parameter value must be true to delete a non-empty directory." 409 Conflict, FilesystemAlreadyExists, "Het opgegeven bestandssysteem bestaat al." 409 Conflict, FilesystemBeingDeleted, "Het opgegeven bestandssysteem wordt verwijderd." 409 Conflict, InvalidDestinationPath, "Het opgegeven pad of een element van het pad, bestaat en het resourcetype is ongeldig voor deze bewerking." * 409 Conflict, InvalidFlushOperation, "De resource is gemaakt of gewijzigd door de Blob Service-API en kan niet worden geschreven door de Data Lake Storage-service-API." 409 Conflict, InvalidRenameSourcePath, "De bronmap mag niet hetzelfde zijn als de doelmap, en kan de bestemming ook geen submap van de bronmap zijn." 409 Conflict, InvalidSourceOrDestinationResourceType, 'Het bron- en doelresourcetype moet identiek zijn'. 409 Conflict, LeaseAlreadyPresent, "Er is al een lease aanwezig." 409 Conflict, LeaseIdMismatchWithLeaseOperation, "De opgegeven lease-id komt niet overeen met de lease-id voor de resource met de opgegeven leasebewerking." 409 Conflict, LeaseIsAlreadyBroken, "De lease is al verbroken en kan niet opnieuw worden verbroken." 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "The lease ID matched, but the lease is currently in breaking state and cannot be acquired until it is broken." 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "De lease-id komt overeen, maar de lease heeft momenteel de status Breken en kan niet worden gewijzigd." 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "De lease-id komt overeen, maar de lease is expliciet verbroken en kan niet worden vernieuwd." 409 Conflict, LeaseNameMismatch, "De opgegeven leasenaam komt niet overeen met de bestaande leasenaam." 409 Conflict, LeaseNotPresentWithLeaseOperation, 'De lease-id is niet aanwezig met de opgegeven leasebewerking'. 409 Conflict, PathAlreadyExists, "Het opgegeven pad bestaat al." 409 Conflict, PathConflict, "The specified path, or an element of an element of the path, exists and its resource type is invalid for this operation." 409 Conflict, SourcePathIsBeingDeleted, 'Het opgegeven bronpad is gemarkeerd om te worden verwijderd'. 409 Conflict, ResourceTypeMismatch, "Het resourcetype dat is opgegeven in de aanvraag komt niet overeen met het type van de resource." 412 Voorwaarde is mislukt, ConditionNotMet, "De voorwaarde die is opgegeven met behulp van HTTP-voorwaardelijke header(s) is niet voldaan." 412 Voorwaarde mislukt, LeaseIdMismatch, "De opgegeven lease-id komt niet overeen met de lease-id voor de resource." 412 Voorwaarde is mislukt, LeaseIdMissing, 'Er is momenteel een lease voor de resource en er is geen lease-id opgegeven in de aanvraag'. 412 Voorwaarde is mislukt, LeaseNotPresent, 'Er is momenteel geen lease voor de resource.' 412 Voorwaarde is mislukt, LeaseLost, 'Er is een lease-id opgegeven, maar de lease voor de resource is verlopen'. 412 Condition Failed, SourceConditionNotMet, "The source condition specified using HTTP conditional header(s) is not voldoen." 413 Aanvraagentiteit te groot, RequestBodyTooLarge, "De aanvraagbody is te groot en overschrijdt de maximaal toegestane limiet." 416 Aangevraagd bereik niet satisfiable, InvalidRange, "Het opgegeven bereik is ongeldig voor de huidige grootte van de resource." 500 Interne serverfout, InternalError, "Er is een interne fout opgetreden op de server. Probeer de aanvraag opnieuw. 500 Interne serverfout, OperationTimedOut, "De bewerking kan niet worden voltooid binnen de toegestane tijd." 503 Service Niet beschikbaar, ServerBusy, "Uitgaand verkeer overschrijdt de accountlimiet." 503-service niet beschikbaar, ServerBusy, 'Inkomend verkeer overschrijdt de accountlimiet'. 503 Service Niet beschikbaar, ServerBusy, 'Bewerkingen per seconde overschrijdt de accountlimiet'. 503-service niet beschikbaar, ServerBusy, "De server kan momenteel geen aanvragen ontvangen. Probeer uw aanvraag opnieuw. Kopteksten x-ms-request-id: string x-ms-version: string

Definities

Name	Description
AclFailedEntryList
DataLakeStorageError
Error	Het antwoordobject voor de servicefout.
PathLeaseAction	Vanaf versie 2020-08-04 in toevoeg- en spoelbewerkingen. Toevoegen ondersteunt de actie 'acquire', 'auto-renew' en 'acquire-release'. Als 'acquire' wordt de lease verkregen. Als automatisch verlengen wordt de lease verlengd. Als 'acquire-release' wordt verkregen, wordt & de bewerking voltooid & de lease vrij te geven zodra de bewerking is voltooid. De actie 'Release' wordt alleen ondersteund in de bewerking Leegmaken. Als 'waar' wordt gebruikt, wordt de lease voor het bestand vrijgegeven met behulp van de lease-id-informatie van de header x-ms-lease-id.
PathUpdateAction	De actie moet 'toevoegen' zijn om gegevens te uploaden die moeten worden toegevoegd aan een bestand, 'leegmaken' om eerder geüploade gegevens naar een bestand te verwijderen, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst voor een bestand of map in te stellen, of 'setAccessControlRecursive' om de toegangsbeheerlijst voor een map recursief in te stellen. Houd er rekening mee dat hiërarchische naamruimte moet zijn ingeschakeld voor het account om toegangsbeheer te kunnen gebruiken. Houd er ook rekening mee dat de toegangsbeheerlijst (ACL) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, dus de x-ms-permissions en x-ms-acl-aanvraagheaders sluiten elkaar wederzijds uit.
SetAccessControlRecursiveResponse

AclFailedEntryList

Object

Name	Type	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Object

Name	Type	Description
error	Error	Het antwoordobject voor de servicefout.

Error

Object

Het antwoordobject voor de servicefout.

Name	Type	Description
code	string	De servicefoutcode.
message	string	Het servicefoutbericht.

PathLeaseAction

Inventarisatie

Vanaf versie 2020-08-04 in toevoeg- en spoelbewerkingen. Toevoegen ondersteunt de actie 'acquire', 'auto-renew' en 'acquire-release'. Als 'acquire' wordt de lease verkregen. Als automatisch verlengen wordt de lease verlengd. Als 'acquire-release' wordt verkregen, wordt & de bewerking voltooid & de lease vrij te geven zodra de bewerking is voltooid. De actie 'Release' wordt alleen ondersteund in de bewerking Leegmaken. Als 'waar' wordt gebruikt, wordt de lease voor het bestand vrijgegeven met behulp van de lease-id-informatie van de header x-ms-lease-id.

Waarde	Description
acquire
acquire-release
auto-renew
release

PathUpdateAction

Inventarisatie

De actie moet 'toevoegen' zijn om gegevens te uploaden die moeten worden toegevoegd aan een bestand, 'leegmaken' om eerder geüploade gegevens naar een bestand te verwijderen, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst voor een bestand of map in te stellen, of 'setAccessControlRecursive' om de toegangsbeheerlijst voor een map recursief in te stellen. Houd er rekening mee dat hiërarchische naamruimte moet zijn ingeschakeld voor het account om toegangsbeheer te kunnen gebruiken. Houd er ook rekening mee dat de toegangsbeheerlijst (ACL) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, dus de x-ms-permissions en x-ms-acl-aanvraagheaders sluiten elkaar wederzijds uit.

Waarde	Description
append
flush
setAccessControl
setAccessControlRecursive
setProperties

SetAccessControlRecursiveResponse

Object

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