Path - Get Properties
Eigenschaften abrufen | Status abrufen | Zugriffssteuerungsliste abrufen | Zugriff überprüfen
Mit "Properties" werden alle system- und benutzerdefinierten Eigenschaften für einen Pfad zurückgegeben. Der Status gibt alle vom System definierten Eigenschaften für einen Pfad zurück. Abrufen der Zugriffssteuerungsliste gibt die Zugriffssteuerungsliste für einen Pfad zurück. Dieser Vorgang unterstützt bedingte HTTP-Anforderungen. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Blob-Dienstvorgänge.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Azure Storage-Kontos. |
dns
|
path | True |
string |
Das DNS-Suffix für den Azure Data Lake Storage-Endpunkt. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Der Dateisystembezeichner. |
path
|
path | True |
string |
Die Datei oder der Verzeichnispfad. |
action
|
query |
Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben. |
||
fs
|
query |
string |
Nur für die Zugriffsüberprüfungsaktion erforderlich. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Dateisystemvorgang lese-/schreib-/execute in Zeichenfolgenform, übereinstimmende regex-Muster '[rwx-]{3}' |
|
timeout
|
query |
integer (int32) minimum: 1 |
Ein optionaler Vorgangstimeoutwert in Sekunden. Der Zeitraum beginnt, wenn die Anforderung vom Dienst empfangen wird. Wenn der Timeoutwert vor Abschluss des Vorgangs verstrichen ist, schlägt der Vorgang fehl. |
|
upn
|
query |
boolean |
Wahlfrei. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Wenn "true", werden die in den Headern "x-ms-owner", "x-ms-group" und "x-ms-acl" zurückgegebenen Benutzeridentitätswerte von Azure Active Directory-Objekt-IDs in Benutzerprinzipalnamen transformiert. Wenn "false", werden die Werte als Azure Active Directory-Objekt-IDs zurückgegeben. Der Standardwert ist "false". Beachten Sie, dass Gruppen- und Anwendungsobjekt-IDs nicht übersetzt werden, da sie keine eindeutigen Anzeigenamen enthalten. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Wahlfrei. Wenn dieser Header angegeben ist, wird der Vorgang nur ausgeführt, wenn beide der folgenden Bedingungen erfüllt sind: i) die Lease des Pfads ist derzeit aktiv und ii) die in der Anforderung angegebene Lease-ID mit der des Pfads übereinstimmt. |
|
If-Match |
string |
Wahlfrei. Ein ETag-Wert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-None-Match |
string |
Wahlfrei. Ein ETag-Wert oder der spezielle Wildcardwert ("*") Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-Modified-Since |
string |
Wahlfrei. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit geändert wurde. |
|
If-Unmodified-Since |
string |
Wahlfrei. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit nicht geändert wurde. |
|
x-ms-encryption-key |
string |
Wahlfrei. Der base64-codierte AES-256-Verschlüsselungsschlüssel. |
|
x-ms-encryption-key-sha256 |
string |
Wahlfrei. Der base64-codierte SHA256-Hash des Verschlüsselungsschlüssels. |
|
x-ms-encryption-algorithm: AES256 |
string |
Wahlfrei. Gibt den Algorithmus an, der für die Verschlüsselung verwendet werden soll. Der Wert dieses Headers muss AES256 sein. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Eine in den Analyseprotokollen aufgezeichnete UUID zur Problembehandlung und Korrelation. |
|
x-ms-date |
string |
Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Dies ist erforderlich, wenn Sie die Gemeinsame Schlüsselautorisierung verwenden. |
|
x-ms-version |
string |
Gibt die Version des REST-Protokolls an, das für die Verarbeitung der Anforderung verwendet wird. Dies ist erforderlich, wenn Sie die Gemeinsame Schlüsselautorisierung verwenden. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Gibt alle Eigenschaften für die Datei oder das Verzeichnis zurück. Header
|
|
Other Status Codes |
Ein Fehler ist aufgetreten. Die möglichen HTTP-Status-, Code- und Nachrichtenzeichenfolgen sind unten aufgeführt:
Header
|
Definitionen
Name | Beschreibung |
---|---|
Data |
|
Error |
Das Dienstfehlerantwortobjekt. |
Path |
Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben. |
DataLakeStorageError
Name | Typ | Beschreibung |
---|---|---|
error |
Das Dienstfehlerantwortobjekt. |
Error
Das Dienstfehlerantwortobjekt.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Dienstfehlercode. |
message |
string |
Die Dienstfehlermeldung. |
PathGetPropertiesAction
Wahlfrei. Wenn der Wert "getStatus" ist, werden nur die vom System definierten Eigenschaften für den Pfad zurückgegeben. Wenn der Wert "getAccessControl" lautet, wird die Zugriffssteuerungsliste in den Antwortheadern zurückgegeben (hierarchischer Namespace muss für das Konto aktiviert sein), andernfalls werden die Eigenschaften zurückgegeben.
Wert | Beschreibung |
---|---|
checkAccess | |
getAccessControl | |
getStatus |