Path - List
Répertorier les chemins d’accès et leurs propriétés dans le système de fichiers donné.
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}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte stockage Azure. |
dns
|
path | True |
string |
Suffixe DNS pour le point de terminaison Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identificateur du système de fichiers. La valeur doit commencer et se terminer par une lettre ou un nombre et doit contenir uniquement des lettres, des chiffres et le caractère de tiret (-). Les tirets consécutifs ne sont pas autorisés. Toutes les lettres doivent être minuscules. La valeur doit comporter entre 3 et 63 caractères. |
recursive
|
query | True |
boolean |
Si la valeur est « true », tous les chemins sont répertoriés ; sinon, seuls les chemins à la racine du système de fichiers sont répertoriés. Si « répertoire » est spécifié, la liste inclut uniquement les chemins d’accès qui partagent la même racine. |
resource
|
query | True |
La valeur doit être « filesystem » pour toutes les opérations de système de fichiers. |
|
continuation
|
query |
string |
Le nombre de chemins retournés avec chaque appel est limité. Si le nombre de chemins à renvoyer dépasse cette limite, un jeton de continuation est retourné dans l’en-tête de réponse x-ms-continuation. Lorsqu’un jeton de continuation est retourné dans la réponse, il doit être spécifié dans un appel ultérieur de l’opération de liste pour continuer à répertorier les chemins d’accès. Notez que le jeton de continuation retourné dans l’en-tête de réponse x-ms-continuation doit être codé d’URL avant d’être utilisé dans un appel ultérieur. |
|
directory
|
query |
string |
Filtre les résultats des chemins d’accès dans le répertoire spécifié. Une erreur se produit si le répertoire n’existe pas. |
|
max
|
query |
integer (int32) minimum: 1 |
Valeur facultative qui spécifie le nombre maximal d’éléments à retourner. Si elle est omise ou supérieure à 5 000, la réponse inclut jusqu’à 5 000 éléments. |
|
timeout
|
query |
integer (int32) minimum: 1 |
Valeur de délai d’expiration d’opération facultative en secondes. La période commence lorsque la demande est reçue par le service. Si la valeur de délai d’expiration s’écoule avant la fin de l’opération, l’opération échoue. |
|
upn
|
query |
boolean |
Optionnel. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte. Si la valeur est « true », les valeurs d’identité utilisateur retournées dans les champs propriétaire et groupe de chaque entrée de liste sont transformées des ID d’objet Azure Active Directory en noms d’utilisateur principaux. Si la valeur est « false », les valeurs sont retournées en tant qu’ID d’objet Azure Active Directory. La valeur par défaut est false. Notez que les ID d’objet de groupe et d’application ne sont pas traduits, car ils n’ont pas de noms conviviaux uniques. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Un UUID enregistré dans les journaux d’activité d’analytique pour la résolution des problèmes et la corrélation. |
|
x-ms-date |
string |
Spécifie le temps universel coordonné (UTC) de la requête. Cela est nécessaire lors de l’utilisation de l’autorisation de clé partagée. |
|
x-ms-version |
string |
Spécifie la version du protocole REST utilisée pour le traitement de la requête. Cela est nécessaire lors de l’utilisation de l’autorisation de clé partagée. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
D’accord En-têtes
|
|
Other Status Codes |
Une erreur s’est produite. L’état HTTP, le code et les chaînes de message possibles sont répertoriés ci-dessous :
En-têtes
|
Définitions
Nom | Description |
---|---|
Data |
|
Error |
Objet de réponse d’erreur de service. |
Filesystem |
La valeur doit être « filesystem » pour toutes les opérations de système de fichiers. |
Path | |
Path |
DataLakeStorageError
Nom | Type | Description |
---|---|---|
error |
Objet de réponse d’erreur de service. |
Error
Objet de réponse d’erreur de service.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur du service. |
message |
string |
Message d’erreur du service. |
FilesystemResourceType
La valeur doit être « filesystem » pour toutes les opérations de système de fichiers.
Valeur | Description |
---|---|
filesystem |
Path
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
contentLength |
integer (int64) |
||
etag |
string |
||
group |
string |
||
isDirectory |
boolean |
False | |
lastModified |
string |
||
name |
string |
||
owner |
string |
||
permissions |
string |
||
x-ms-encryption-context |
string |
Si la valeur de la propriété de contexte de chiffrement est définie, elle retourne la valeur définie. Valide uniquement lorsque l’espace de noms hiérarchique est activé pour le compte. |
|
x-ms-encryption-key-sha256 |
string |
Le serveur renvoie la sha256 de la clé de chiffrement fournie par le client pour valider la clé utilisée dans l’opération. |
|
x-ms-encryption-scope |
string |
Si la demande a utilisé une étendue de chiffrement, le client peut s’assurer que le contenu de la requête est correctement chiffré à l’aide de l’étendue de chiffrement. |
|
x-ms-server-encrypted: true/false |
boolean |
La valeur de cet en-tête est définie sur true si le contenu de la requête est correctement chiffré à l’aide de l’algorithme spécifié. |
PathList
Nom | Type | Description |
---|---|---|
paths |
Path[] |