ListDirectoriesAndFiles - File Storage NAS - Centre de documentation Alibaba Cloud

Obtient la liste des fichiers de classe de stockage IA et des sous-répertoires contenant des fichiers de classe de stockage IA sous un répertoire spécifié dans un système de fichiers NAS à usage général.

Description de l'opération

Seuls les systèmes de fichiers NAS à usage général prennent en charge cette fonctionnalité.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

nas:ListDirectoriesAndFiles

get

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
FileSystemId	string	Oui	L'identifiant du système de fichiers.	31a8e4****
Path	string	Oui	Le chemin absolu du répertoire spécifié. Le chemin doit commencer par une barre oblique (/) et doit être un chemin existant dans la cible de montage.	/pathway/to/folder
NextToken	string	Non	Le jeton de pagination utilisé dans la requête suivante pour obtenir une nouvelle page de résultats. Si les résultats renvoyés sont tronqués, vous pouvez utiliser NextToken pour initier une nouvelle requête afin d'obtenir le contenu après la position de troncature actuelle.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
StorageType	string	Oui	Le type de classe de stockage. InfrequentAccess : classe de stockage IA. Archive : classe de stockage Archive. All : interroge les données de toutes les classes de stockage. Remarque Lorsque StorageType est défini sur All, vous devez définir DirectoryOnly sur true. Valeurs valides : All : Interroge les données de toutes les classes de stockage. Archive : Classe de stockage Archive. InfrequentAccess : Classe de stockage IA.	InfrequentAccess
DirectoryOnly	boolean	Non	Indique si seuls les répertoires doivent être interrogés. Valeurs valides : false (par défaut) : Non. Les répertoires et les fichiers peuvent être interrogés. true : Oui. Seuls les répertoires sont interrogés. Remarque Lorsque StorageType est défini sur All, DirectoryOnly doit être défini sur true et ne peut pas être défini sur false.	false
MaxResults	integer	Non	Le nombre de répertoires ou de fichiers inclus dans chaque résultat de requête. Valeurs valides : 10 à 128. Valeur par défaut : 100.	100

Éléments de réponse

Élément	Type	Description	Exemple
	object
NextToken	string	Le jeton de pagination utilisé dans la requête suivante pour obtenir une nouvelle page de résultats. Si les résultats renvoyés sont tronqués, vous pouvez utiliser NextToken pour initier une nouvelle requête afin d'obtenir le contenu après la position de troncature actuelle.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
RequestId	string	L'identifiant de la requête.	2D69A58F-345C-4FDE-88E4-BF518948****
Entries	array<object>	La collection d'informations sur les répertoires ou les fichiers.
	object	La collection d'informations sur les répertoires ou les fichiers.
Type	string	Le type du résultat renvoyé. Valeurs valides : File : fichier. Directory : répertoire.	File
HasInfrequentAccessFile	boolean	Indique si le répertoire contient des fichiers de classe de stockage IA. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur Directory. Valeurs valides : true : le répertoire contient des fichiers de classe de stockage IA. false : le répertoire ne contient pas de fichiers de classe de stockage IA.	true
Ctime	string	L'heure à laquelle les métadonnées ont été modifiées. L'heure suit la norme ISO 8601 et est renvoyée au format : `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File.	2021-02-11T10:08:10Z
Mtime	string	L'heure à laquelle le fichier a été modifié. L'heure suit la norme ISO 8601 et est renvoyée au format : `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File.	2021-02-11T10:08:08Z
Size	integer	La taille du fichier. Unité : octets. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File.	1024
StorageType	string	Le type de classe de stockage du fichier renvoyé. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File. Valeurs valides : InfrequentAccess : classe de stockage IA. Archive : classe de stockage Archive.	InfrequentAccess
Atime	string	L'heure de la requête. L'heure suit la norme ISO 8601 et est renvoyée au format : `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File.	2021-02-01T10:08:08Z
Name	string	Le nom du fichier ou du répertoire.	file.txt
RetrieveTime	string	L'heure à laquelle la tâche de récupération de données la plus récente a été exécutée. L'heure suit la norme ISO 8601 et est renvoyée au format : `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur File.	2021-02-11T10:08:08Z
Inode	string	L'inode du fichier ou du répertoire.	66
FileId	string	Le FileId du répertoire ou du fichier.	66
Owner	string	L'identifiant du compte portable. Ce paramètre n'a de sens que lorsque ProtocolType est défini sur SMB et que le contrôle d'accès est activé.	37862c****
HasArchiveFile	string	Indique si le répertoire contient des fichiers de classe de stockage Archive. Ce paramètre est renvoyé et n'a de sens que lorsque Type est défini sur Directory. Valeurs valides : true : le répertoire contient des fichiers de classe de stockage Archive. false : le répertoire ne contient pas de fichiers de classe de stockage Archive.	true
OfflineDuration	integer	La durée totale pendant laquelle le fichier a été stocké en tant que fichier d'archive. Unité : secondes.	3600
OfflineUnchangedDuration	integer	La durée totale pendant laquelle le fichier est resté inchangé depuis qu'il a été stocké en tant que fichier d'archive. Unité : secondes.	3600

Exemples

JSON format

{
  "NextToken": "TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=",
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****",
  "Entries": [
    {
      "Type": "File",
      "HasInfrequentAccessFile": true,
      "Ctime": "2021-02-11T10:08:10Z",
      "Mtime": "2021-02-11T10:08:08Z",
      "Size": 1024,
      "StorageType": "InfrequentAccess",
      "Atime": "2021-02-01T10:08:08Z",
      "Name": "file.txt",
      "RetrieveTime": "2021-02-11T10:08:08Z",
      "Inode": "66",
      "FileId": "66",
      "Owner": "37862c****",
      "HasArchiveFile": "true",
      "OfflineDuration": 3600,
      "OfflineUnchangedDuration": 3600
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	OperationDenied.InvalidNextToken	The specified NextToken is invalid.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidParameter.PathNotExist	The specified path does not exist.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.