Delen via


Path - Update

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

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
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

De bestandssysteem-id.

Regex-patroon: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

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 om aan een bestand te worden toegevoegd, 'leegmaken' om eerder geüploade gegevens naar een bestand leeg te maken, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst in te stellen voor een bestand of map, 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 Access Control List (ACL) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, zodat de aanvraagheaders x-ms-permissions en x-ms-acl elkaar uitsluiten.

close
query

boolean

Met Azure Storage-gebeurtenissen kunnen toepassingen meldingen ontvangen wanneer bestanden worden gewijzigd. Wanneer Azure Storage-gebeurtenissen zijn ingeschakeld, wordt er een gebeurtenis gegenereerd die het bestand heeft gewijzigd. 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 het laatste sluiten 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 bewerking voor het leegmaken 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' wordt weergegeven, wordt er een wijzigingsmelding gegenereerd die aangeeft dat het bestand is gewijzigd. De standaardwaarde is false. 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 dit 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 worden leeggemaakt tijdens een toevoegaanroep. De standaardwaarde is 'onwaar'. Als 'waar' worden de gegevens 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 wilt instellen tijdens het leegmaken, gebruikt u action=flush

forceFlag
query

boolean

Optioneel en alleen geldig voor de bewerking setAccessControlRecursive. Als dit 'onwaar' is, wordt de bewerking snel beëindigd bij het optreden van gebruikersfouten (4XX). Als 'waar' is, negeert de API gebruikersfouten en gaat de bewerking op andere subentiteiten van de map verder. De 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 false.

maxRecords
query

integer

int32

Optioneel en alleen geldig voor de bewerking setAccessControlRecursive. Hiermee wordt het maximum aantal bestanden of mappen opgegeven waarop de ACL-wijziging wordt toegepast. Als u dit weglaat of groter is dan 2.000, verwerkt de aanvraag maximaal 2000 items

mode
query

string

Optioneel. 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 aanwezig waren op bestanden en mappen

position
query

integer

int64

Met deze parameter kan de aanroeper gegevens parallel uploaden en de volgorde bepalen waarin deze aan het bestand worden toegevoegd. Dit is vereist bij het uploaden van gegevens die aan het bestand moeten worden toegevoegd 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 naar het bestand verwijderd of weggeschreven. Als u wilt wissen, 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 moet er geen aanvraagentiteitstekst zijn opgenomen in de aanvraag.

retainUncommittedData
query

boolean

Alleen geldig voor spoelbewerkingen. Als 'waar' is, blijven niet-verzonden gegevens behouden nadat de flush-bewerking is voltooid; anders worden de niet-verzonden gegevens verwijderd na de leegmaakbewerking. De standaardwaarde is false. Gegevens met offsets 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 de leegmaakpositie worden bewaard voor een toekomstige leegmaakbewerking.

timeout
query

integer

int32

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

Vereist voor 'Gegevens toevoegen' en 'Gegevens leegmaken'. Moet 0 zijn voor 'Gegevens leegmaken'. Dit moet de lengte zijn van de aanvraaginhoud in bytes voor 'Gegevens toevoegen'.

Content-MD5

string

Optioneel. Een MD5-hash van de aanvraaginhoud. Deze header is geldig voor de 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 wordt 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

De lease-id moet worden opgegeven als er een actieve lease is. Ongeldig voor 'setAccessControlRecursive'-bewerkingen.

Regex-patroon: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-cache-control

string

Optioneel en alleen geldig voor bewerkingen voor het leegmaken en instellen van eigenschappen. De service slaat deze waarde op en neemt deze op in de antwoordheader 'Cache-Control' voor 'Bestand lezen'-bewerkingen.

x-ms-content-type

string

Optioneel en alleen geldig voor bewerkingen voor het leegmaken en instellen van eigenschappen. De service slaat deze waarde op en neemt deze op in de antwoordheader 'Inhoudstype' voor bewerkingen 'Bestand lezen'.

x-ms-content-disposition

string

Optioneel en alleen geldig voor bewerkingen voor het leegmaken en instellen van eigenschappen. De service slaat deze waarde op en neemt deze op in de antwoordheader 'Content-Disposition' voor 'Bestand lezen'-bewerkingen.

x-ms-content-encoding

string

Optioneel en alleen geldig voor bewerkingen voor het leegmaken en instellen van eigenschappen. De service slaat deze waarde op en neemt deze op in de antwoordheader Content-Encoding voor bewerkingen voor Bestand lezen.

x-ms-content-language

string

Optioneel en alleen geldig voor bewerkingen voor het leegmaken en instellen van eigenschappen. De service slaat deze waarde op en neemt deze op 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 neemt deze op in de antwoordheader Content-Md5 voor de bewerkingen Lezen en Eigenschappen ophalen. Als deze eigenschap niet is opgegeven in de aanvraag, wordt de eigenschap voor het bestand gewist. Volgende aanroepen naar 'Eigenschappen lezen en ophalen' retourneren deze eigenschap niet, tenzij deze expliciet opnieuw is ingesteld op dat bestand.

x-ms-properties

string

Optioneel. 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 in de ISO-8859-1-tekenset mag bevatten. 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 header wordt weggelaten. Als u nieuwe en bestaande eigenschappen wilt samenvoegen, haalt u eerst alle bestaande eigenschappen en de huidige E-tag op, maakt u vervolgens een voorwaardelijke aanvraag met de E-tag en neemt u waarden op voor alle eigenschappen.

x-ms-owner

string

Optioneel en alleen geldig voor de bewerking setAccessControl. Hiermee stelt u de eigenaar van het bestand of de map in.

x-ms-group

string

Optioneel en alleen geldig voor de bewerking setAccessControl. Hiermee stelt u de groep die eigenaar is van het bestand of de map.

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 anderen. Aan elke klasse kan de machtiging lezen (4), schrijven (2) of uitvoeren (1) worden verleend. Zowel symbolische (rwxrw-rw-) als 4-cijferige octale notatie (bijvoorbeeld 0766) worden ondersteund. De sticky bit wordt ook ondersteund en wordt in symbolische notatie vertegenwoordigd door de letter t of T op de laatste tekenplaats, afhankelijk van of de uitvoeringsbit voor de andere categorie respectievelijk 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 de sticky bit niet is ingesteld. In de 4-cijferige octale notatie wordt de notatie weergegeven 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 bewerkingen setAccessControl en setAccessControlRecursive. Vereist voor de bewerking setAccessControlRecursive. Hiermee stelt u POSIX-toegangsbeheerrechten in voor bestanden en mappen. De waarde is een door komma's gescheiden lijst met vermeldingen van toegangsbeheer die de bestaande toegangsbeheerlijst (ACL) volledig vervangt in het geval van setAccessControl en de 'set'-modus van setAccessControlRecursive. De "modify"-modus 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 [bereik:][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 worden verleend aan benoemde gebruikers en de leden van groepen, en 'overige' verleent rechten aan alle gebruikers die niet in een van de andere vermeldingen worden gevonden. De gebruikers- of groeps-id wordt weggelaten voor vermeldingen van het type 'masker' en 'overig'. De gebruikers- of groeps-id wordt ook weggelaten voor de eigenaar en de groep die eigenaar is. 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 uitvoeringsmachtigingen te verlenen. Als er geen toegang wordt verleend, wordt het teken '-' gebruikt om aan te geven dat de machtiging is geweigerd. De volgende ACL verleent bijvoorbeeld lees-, schrijf- en uitvoeringsrechten aan de bestandseigenaar en john.doe@contoso, het leesrecht aan de groep die eigenaar is en niets aan alle anderen: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Ongeldig in combinatie met x-ms-permissions. De 'remove'-modus van setAccessControlRecursive verwijdert de bestaande ACL's en mag geen machtigingen bevatten in de opgegeven toegangsbeheerlijst: 'user:john.doe@contoso:, mask:'. De 'set'-modus van setAccessControlRecursive stelt de ACL's in die de bestaande ACL's van het opgegeven bereik vervangen en moeten alle drie bevatten: de gebruiker die eigenaar is, de groep die eigenaar is en andere informatie als het toegangsbereik wordt ingesteld of als een van de eigenaar van een gebruiker, groep die eigenaar is of een andere groep is ingesteld in het standaardbereik. De 'set'- en 'modify'-modi van setAccessControlRecursive moeten machtigingen bevatten als onderdeel van de toegangsbeheerlijst.

If-Match

string

Optioneel voor Gegevens leegmaken, Access Control instellen en Eigenschappen instellen, maar ongeldig voor Gegevens toevoegen en Instellen Access Control 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 Gegevens leegmaken, Access Control instellen en Eigenschappen instellen, maar ongeldig voor Gegevens toevoegen en Instellen Access Control 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 gegevens wissen en Eigenschappen instellen, maar ongeldig voor gegevens toevoegen en instellen Access Control recursief. 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 gegevens wissen en Eigenschappen instellen, maar ongeldig voor gegevens toevoegen en instellen Access Control recursief. 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

Optioneel. De met Base64 gecodeerde AES-256-versleutelingssleutel.

x-ms-encryption-key-sha256

string

Optioneel. De Base64-gecodeerde SHA256-hash van de versleutelingssleutel.

x-ms-encryption-algorithm: AES256

string

Optioneel. Hiermee geeft u het algoritme te gebruiken 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 het wordt 'overgenomen', verkrijgt het de lease. Als de lease automatisch wordt verlengd, wordt de lease verlengd. Als 'acquire-release' wordt verkregen & de bewerking wordt voltooid & de lease wordt vrijgegeven zodra de bewerking is voltooid. De actie 'Vrijgeven' wordt alleen ondersteund bij het leegmaken. Als 'waar' is, wordt de lease voor het bestand vrijgegeven met behulp van de lease-id-informatie uit de x-ms-lease-id-header.

x-ms-lease-duration

integer

int32

De leaseduur is vereist om een lease te verkrijgen en geeft de duur van de lease op in seconden. De leaseduur moet tussen 15 en 60 seconden of -1 voor oneindige lease zijn.

x-ms-proposed-lease-id

string

Vereist wanneer 'x-ms-lease-action' 'verkrijgen' of 'wijzigen' is. Er wordt een lease verkregen met deze lease-id als de bewerking is geslaagd.

Regex-patroon: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-client-request-id

string

Een UUID die is vastgelegd in de analyselogboeken voor probleemoplossing en correlatie.

Regex-patroon: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date

string

Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Dit is vereist bij het gebruik van autorisatie van gedeelde sleutels.

x-ms-version

string

Hiermee geeft u de versie van het REST-protocol op 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

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. De mogelijke HTTP-status, code en berichtreeksen worden hieronder vermeld:

  • 400 Ongeldige aanvraag, ContentLengthMustBeZero, "De aanvraagheader met lengte van inhoud moet nul zijn."
  • 400 Ongeldige aanvraag, InvalidAuthenticationInfo, "Verificatiegegevens worden niet in de juiste indeling gegeven. Controleer de waarde van 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 na het toevoegen van de geüploade gegevens."
  • 400 Ongeldige aanvraag, InvalidHeaderValue, 'De waarde voor een van de HTTP-headers heeft niet de juiste indeling.'
  • 400 Ongeldige aanvraag, OngeldigHttpVerb, '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, 'De naam van een eigenschap 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, 'Er is geen HTTP-header opgegeven die verplicht is voor deze aanvraag.'
  • 400 Ongeldige aanvraag, MissingRequiredQueryParameter, 'Er is geen queryparameter opgegeven die verplicht is voor deze aanvraag.'
  • 400 Ongeldige aanvraag, MultipleConditionHeadersNotSupported, 'Meerdere voorwaardeheaders worden niet ondersteund'.
  • 400 Ongeldige aanvraag, OutOfRangeInput, "Een van de aanvraaginvoeren 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 in de aanvraag zijn opgegeven, 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, UnsupportedRestVersion, 'De opgegeven REST-versie wordt niet ondersteund.'
  • 403 Verboden, AccountIsDisabled, 'Het opgegeven account is uitgeschakeld'.
  • 403 Forbidden, AuthorizationFailure, 'Deze aanvraag is niet gemachtigd om deze bewerking uit te voeren'.
  • 403 Forbidden, InsufficientAccountPermissions, "Het account dat wordt geopend, heeft onvoldoende machtigingen om deze bewerking uit te voeren."
  • 404 Niet gevonden, BestandssysteemNotFound, '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 naamwijzigingsbewerking bestaat niet'.
  • 405 Methode Niet toegestaan, Niet ondersteundHttpVerb, '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, 'De waarde van de recursieve queryparameter moet waar zijn om een niet-lege map te verwijderen'.
  • 409 Conflict, BestandssysteemAlreadyExists: '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, noch kan het doel een submap van de bronmap zijn.'
  • 409 Conflict, InvalidSourceOrDestinationResourceType, 'Het bron- en doelresourcetype moeten 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, 'De lease-id komt overeen, maar de lease heeft momenteel de status 'breken' en kan pas worden verkregen als deze is verbroken.'
  • 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 bij de opgegeven leasebewerking.'
  • 409 Conflict, PathAlreadyExists, 'Het opgegeven pad bestaat al'.
  • 409 Conflict, PathConflict, "Het opgegeven pad of een element van het pad bestaat en het resourcetype is ongeldig voor deze bewerking."
  • 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, "Aan de voorwaarde die is opgegeven met behulp van voorwaardelijke HTTP-header(s) wordt niet voldaan."
  • 412 Voorwaarde is 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 Voorwaarde is mislukt, SourceConditionNotMet, 'Er wordt niet voldaan aan de bronvoorwaarde die is opgegeven met behulp van voorwaardelijke HTTP-header(s).
  • 413 Aanvraagentiteit is te groot, RequestBodyTooLarge, "De aanvraagbody is te groot en overschrijdt de maximaal toegestane limiet."
  • 416 Aangevraagd bereik niet bevredigend, 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 heeft de accountlimiet overschreden'.
  • 503 Service niet beschikbaar, ServerBusy, 'Inkomend verkeer heeft de accountlimiet overschreden'.
  • 503 Service niet beschikbaar, ServerBusy, 'Bewerkingen per seconde is boven 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 servicefouten.

PathLeaseAction

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

PathUpdateAction

De actie moet 'toevoegen' zijn om gegevens te uploaden om aan een bestand te worden toegevoegd, 'flush' om eerder geüploade gegevens naar een bestand te wissen, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst in te stellen voor een bestand of map, 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 ACL (Access Control List) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, zodat de aanvraagheaders x-ms-permissions en x-ms-acl elkaar uitsluiten.

SetAccessControlRecursiveResponse

AclFailedEntryList

Name Type Description
errorMessage

string

name

string

type

string

DataLakeStorageError

Name Type Description
error

Error

Het antwoordobject voor servicefouten.

Error

Het antwoordobject voor servicefouten.

Name Type Description
code

string

De foutcode van de service.

message

string

Het servicefoutbericht.

PathLeaseAction

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

Name Type Description
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

De actie moet 'toevoegen' zijn om gegevens te uploaden om aan een bestand te worden toegevoegd, 'flush' om eerder geüploade gegevens naar een bestand te wissen, 'setProperties' om de eigenschappen van een bestand of map in te stellen, of 'setAccessControl' om de eigenaar, groep, machtigingen of toegangsbeheerlijst in te stellen voor een bestand of map, 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 ACL (Access Control List) machtigingen bevat voor de eigenaar, de groep die eigenaar is en andere, zodat de aanvraagheaders x-ms-permissions en x-ms-acl elkaar uitsluiten.

Name Type Description
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

Name Type Description
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer