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 |
---|---|---|---|---|
account
|
path | True |
string |
De naam van het Azure Storage-account. |
dns
|
path | True |
string |
Het DNS-achtervoegsel voor het Azure Data Lake Storage-eindpunt. |
filesystem
|
path | True |
string |
De bestandssysteem-id. Regex-patroon: |
path
|
path | True |
string |
Het pad naar het bestand of de map. |
action
|
query |
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. |
||
fs
|
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: |
|
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: |
|
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
|
|
Other Status Codes |
Er is een fout opgetreden. De mogelijke HTTP-status, code en berichtreeksen worden hieronder vermeld:
Kopteksten
|
Definities
Name | Description |
---|---|
Data |
|
Error |
Het servicefoutantwoordobject. |
Path |
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 |
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 |