Path - Get Properties
Abrufen von Eigenschaften | Status abrufen | Abrufen Access Control Liste | Überprüfen des Zugriffs
Get Properties gibt alle system- und benutzerdefinierten Eigenschaften für einen Pfad zurück. Get Status gibt alle systemdefinierte Eigenschaften für einen Pfad zurück. Get Access Control List gibt die Zugriffssteuerungsliste für einen Pfad zurück. Dieser Vorgang unterstützt bedingte HTTP-Anforderungen. Weitere Informationen finden Sie unter Specifying Conditional Headers for Blob Service Operations (Angeben von bedingten Headern für Vorgänge des Blob-Diensts).
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 |
Der Dateisystembezeichner. RegEx-Muster: |
path
|
path | True |
string |
Der Datei- oder Verzeichnispfad. |
action
|
query |
Optional. Wenn der Wert "getStatus" lautet, werden nur die systemdefinierten 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 werden), andernfalls werden die Eigenschaften zurückgegeben. |
||
fs
|
query |
string |
Nur für die Aktion "Zugriffsüberprüfung" erforderlich. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Dateisystemvorgang lesen/schreiben/ausführen in Zeichenfolgenform, übereinstimmend mit dem RegEx-Muster "[rwx-]{3}" |
|
timeout
|
query |
integer int32 |
Ein optionaler Vorgangstimeoutwert in Sekunden. Der Zeitraum beginnt, wenn die Anforderung vom Dienst empfangen wird. Wenn der Timeoutwert verstrichen ist, bevor der Vorgang abgeschlossen ist, schlägt der Vorgang fehl. |
|
upn
|
query |
boolean |
Optional. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. Bei "true" werden die in den Antwortheadern x-ms-owner, x-ms-group und x-ms-acl zurückgegebenen Benutzeridentitätswerte von Azure Active Directory-Objekt-IDs in Benutzerprinzipalnamen transformiert. Bei "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 haben. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-lease-id |
string |
Optional. 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 entspricht der des Pfads. RegEx-Muster: |
|
If-Match |
string |
Optional. Ein ETag-Wert. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-None-Match |
string |
Optional. Ein ETag-Wert oder der spezielle Wildcardwert ("*") Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-Modified-Since |
string |
Optional. 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 |
Optional. 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 |
Optional. Der Base64-codierte AES-256-Verschlüsselungsschlüssel. |
|
x-ms-encryption-key-sha256 |
string |
Optional. Der Base64-codierte SHA256-Hash des Verschlüsselungsschlüssels. |
|
x-ms-encryption-algorithm: AES256 |
string |
Optional. 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 |
Eine in den Analyseprotokollen für die Problembehandlung und Korrelation aufgezeichnete UUID. RegEx-Muster: |
|
x-ms-date |
string |
Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Dies ist erforderlich, wenn die Autorisierung mit gemeinsam genutzten Schlüsseln verwendet wird. |
|
x-ms-version |
string |
Gibt die Version des REST-Protokolls an, das für die Verarbeitung der Anforderung verwendet wird. Dies ist erforderlich, wenn die Autorisierung mit gemeinsam genutzten Schlüsseln verwendet wird. |
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 |
Optional. Wenn der Wert "getStatus" lautet, werden nur die systemdefinierten 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 werden), 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
Optional. Wenn der Wert "getStatus" lautet, werden nur die systemdefinierten 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 werden), andernfalls werden die Eigenschaften zurückgegeben.
Name | Typ | Beschreibung |
---|---|---|
checkAccess |
string |
|
getAccessControl |
string |
|
getStatus |
string |