Path - List
Listet Pfade und deren Eigenschaften im angegebenen Dateisystem auf.
GET https://{accountName}.{dnsSuffix}/{filesystem}?recursive={recursive}&resource=filesystem
GET https://{accountName}.{dnsSuffix}/{filesystem}?directory={directory}&recursive={recursive}&continuation={continuation}&maxResults={maxResults}&upn={upn}&resource=filesystem&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. Der Wert muss mit einem Buchstaben oder einer Zahl beginnen und enden und darf nur Buchstaben, Zahlen und das Bindestrichzeichen (-) enthalten. Aufeinander folgende Bindestriche sind nicht zulässig. Alle Buchstaben müssen Kleinbuchstaben sein. Der Wert muss zwischen 3 und 63 Zeichen lang sein. Regex pattern: |
recursive
|
query | True |
boolean |
Bei "true" werden alle Pfade aufgelistet. Andernfalls werden nur Pfade im Stammverzeichnis des Dateisystems aufgeführt. Wenn "verzeichnis" angegeben ist, enthält die Liste nur Pfade, die denselben Stamm verwenden. |
resource
|
query | True |
Der Wert muss für alle Dateisystemvorgänge "dateisystem" sein. |
|
continuation
|
query |
string |
Die Anzahl der bei jedem Aufruf zurückgegebenen Pfade ist begrenzt. Wenn die Anzahl der zurückzugebenden Pfade diesen Grenzwert überschreitet, wird im Antwortheader x-ms-continuation ein Fortsetzungstoken zurückgegeben. Wenn in der Antwort ein Fortsetzungstoken zurückgegeben wird, muss es in einem nachfolgenden Aufruf des Listenvorgangs angegeben werden, um die Auflistung der Pfade fortzusetzen. |
|
directory
|
query |
string |
Filtert Ergebnisse nach Pfaden innerhalb des angegebenen Verzeichnisses. Wenn das Verzeichnis nicht vorhanden ist, tritt ein Fehler auf. |
|
max
|
query |
integer int32 |
Ein optionaler Wert, der die maximale Anzahl von Elementen angibt, die zurückgegeben werden sollen. Wenn ausgelassen oder größer als 5.000, enthält die Antwort bis zu 5.000 Elemente. |
|
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. Gültig nur, wenn hierarchischer Namespace für das Konto aktiviert ist. Bei "true" werden die in den Besitzer- und Gruppenfeldern jedes Listeneintrags 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 aufweisen. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-client-request-id |
string |
Eine in den Analyseprotokollen für die Problembehandlung und Korrelation aufgezeichnete UUID. Regex pattern: |
|
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 |
OK, Headers
|
|
Other Status Codes |
Ein Fehler ist aufgetreten. Die möglichen HTTP-status, Code und Nachrichtenzeichenfolgen sind unten aufgeführt:
Headers
|
Definitionen
Name | Beschreibung |
---|---|
Data |
|
Error |
Das Dienstfehlerantwortobjekt. |
Filesystem |
Der Wert muss für alle Dateisystemvorgänge "dateisystem" sein. |
Path | |
Path |
DataLakeStorageError
Name | Typ | Beschreibung |
---|---|---|
error |
Das Dienstfehlerantwortobjekt. |
Error
Das Dienstfehlerantwortobjekt.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Dienstfehlercode. |
message |
string |
Die Dienstfehlermeldung. |
FilesystemResourceType
Der Wert muss für alle Dateisystemvorgänge "dateisystem" sein.
Name | Typ | Beschreibung |
---|---|---|
filesystem |
string |
Path
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
contentLength |
integer |
||
eTag |
string |
||
group |
string |
||
isDirectory |
boolean |
False | |
lastModified |
string |
||
name |
string |
||
owner |
string |
||
permissions |
string |
||
x-ms-encryption-context |
string |
Wenn der Wert der Verschlüsselungskontexteigenschaft festgelegt ist, wird der festgelegte Wert zurückgegeben. Nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist. |
|
x-ms-encryption-key-sha256 |
string |
Der Server gibt den SHA256 des vom Kunden bereitgestellten Verschlüsselungsschlüssels zurück, um den im Vorgang verwendeten Schlüssel zu überprüfen. |
|
x-ms-encryption-scope |
string |
Wenn die Anforderung einen Verschlüsselungsbereich verwendet hat, kann der Client sicherstellen, dass der Inhalt der Anforderung mithilfe des Verschlüsselungsbereichs erfolgreich verschlüsselt wurde. |
|
x-ms-server-encrypted: true/false |
boolean |
Der Wert dieses Headers wird auf true festgelegt, wenn der Inhalt der Anforderung mit dem angegebenen Algorithmus erfolgreich verschlüsselt wurde. |
PathList
Name | Typ | Beschreibung |
---|---|---|
paths |
Path[] |