Delen via


Path - Get Properties

Eigenschappen ophalen | Status ophalen | Lijst met Access Control ophalen | Toegang controleren
Eigenschappen ophalen retourneert alle door het systeem en de gebruiker gedefinieerde eigenschappen voor een pad. Status ophalen retourneert alle door het systeem gedefinieerde eigenschappen voor een pad. Get Access Control List retourneert de toegangsbeheerlijst voor een pad. Deze bewerking ondersteunt voorwaardelijke HTTP-aanvragen. Zie Voorwaardelijke headers opgeven voor blobservicebewerkingen voor meer informatie.

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

PathGetPropertiesAction

Optioneel. Als de waarde 'getStatus' is, worden alleen de door het systeem gedefinieerde eigenschappen voor het pad geretourneerd. Als de waarde 'getAccessControl' is, wordt de toegangsbeheerlijst geretourneerd in de antwoordheaders (hiërarchische naamruimte moet zijn ingeschakeld voor het account), anders worden de eigenschappen geretourneerd.

fsAction
query

string

Alleen vereist voor het controleren van de toegangsactie. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account. Bestandssysteembewerking lezen/schrijven/uitvoeren in tekenreeksvorm, overeenkomend met regex-patroon [rwx-]{3}'

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.

upn
query

boolean

Optioneel. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account. Indien 'waar', worden de waarden van de gebruikersidentiteit die worden geretourneerd in de antwoordheaders x-ms-owner, x-ms-group en x-ms-acl getransformeerd van Azure Active Directory-object-id's naar User Principal Names. Als 'onwaar' is, worden de waarden geretourneerd als Azure Active Directory-object-id's. De standaardwaarde is false. Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald omdat ze geen unieke beschrijvende namen hebben.

Aanvraagkoptekst

Name Vereist Type Description
x-ms-lease-id

string

Optioneel. Als deze header is opgegeven, wordt de bewerking alleen uitgevoerd als aan beide van de volgende voorwaarden wordt voldaan: i) de lease van het pad is momenteel actief en ii) de lease-id die in de aanvraag is opgegeven, komt overeen met die van het pad.

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

If-Match

string

Optioneel. 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. 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. 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. 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-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.

Antwoorden

Name Type Description
200 OK

Retourneert alle eigenschappen voor het bestand of de map.

Kopteksten

  • 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
  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-resource-type: string
  • x-ms-properties: string
  • x-ms-owner: string
  • x-ms-group: string
  • x-ms-permissions: string
  • x-ms-acl: string
  • x-ms-lease-duration: string
  • x-ms-lease-state: string
  • x-ms-lease-status: string
  • x-ms-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-context: string
  • x-ms-encryption-scope: string
  • x-ms-creation-time: string
  • x-ms-expiry-time: string
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
DataLakeStorageError
Error

Het servicefoutantwoordobject.

PathGetPropertiesAction

Optioneel. Als de waarde 'getStatus' is, worden alleen de door het systeem gedefinieerde eigenschappen voor het pad geretourneerd. Als de waarde 'getAccessControl' is, wordt de toegangsbeheerlijst geretourneerd in de antwoordheaders (hiërarchische naamruimte moet zijn ingeschakeld voor het account), anders worden de eigenschappen geretourneerd.

DataLakeStorageError

Name Type Description
error

Error

Het servicefoutantwoordobject.

Error

Het servicefoutantwoordobject.

Name Type Description
code

string

De servicefoutcode.

message

string

Het servicefoutbericht.

PathGetPropertiesAction

Optioneel. Als de waarde 'getStatus' is, worden alleen de door het systeem gedefinieerde eigenschappen voor het pad geretourneerd. Als de waarde 'getAccessControl' is, wordt de toegangsbeheerlijst geretourneerd in de antwoordheaders (hiërarchische naamruimte moet zijn ingeschakeld voor het account), anders worden de eigenschappen geretourneerd.

Name Type Description
checkAccess

string

getAccessControl

string

getStatus

string