ListDirectoriesAndFiles - - Centre de documentation Alibaba Cloud

Répertorie les fichiers à accès peu fréquent (IA) dans un répertoire spécifié d'un système de fichiers NAS généraliste, ainsi que les sous-répertoires contenant ces fichiers.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListDirectoriesAndFiles	Opération à effectuer. Définissez la valeur sur ListDirectoriesAndFiles.
FileSystemId	String	Oui	31a8e4****	ID du système de fichiers.
Path	String	Oui	/pathway/to/folder	Chemin absolu du répertoire. Le chemin doit commencer par une barre oblique (/) et exister sur la cible de montage.
NextToken	String	Non	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=	Jeton permettant d'initier la requête suivante. Si la réponse est tronquée, utilisez ce jeton pour obtenir les enregistrements restants.
StorageType	String	Oui	InfrequentAccess	Type de stockage des fichiers. Valeur par défaut : InfrequentAccess (IA).
DirectoryOnly	Boolean	Non	false	Indique s'il faut interroger uniquement les répertoires. Valeurs possibles : false (valeur par défaut) : interroge les répertoires et les fichiers. true : interroge uniquement les répertoires.
MaxResults	Long	Non	100	Nombre maximal de répertoires ou de fichiers renvoyés par requête. Valeurs possibles : 10 à 128. Valeur par défaut : 100.

Paramètres de réponse

Paramètre	Type	Exemple	Description
NextToken	String	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=	Jeton permettant d'initier la requête suivante. Si la réponse est tronquée, utilisez ce jeton pour obtenir les enregistrements restants.
RequestId	String	2D69A58F-345C-4FDE-88E4-BF518948****	ID de la requête.
Entries	Array of Entry		Détails concernant les fichiers ou les répertoires.
Type	String	File	Type du résultat de la requête. Valeurs possibles : File Directory
HasInfrequentAccessFile	Boolean	true	Indique si les fichiers contiennent des données déversées sur le support de stockage IA. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur Directory. Valeurs possibles : true : Les fichiers contiennent des données déversées sur le support de stockage IA. false : Les fichiers ne contiennent pas de données déversées sur le support de stockage IA.
Ctime	String	2021-02-11T10:08:10Z	Date de modification des données brutes. L'heure respecte la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File.
Mtime	String	2021-02-11T10:08:08Z	Date de dernière modification du fichier. L'heure respecte la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File.
Size	Long	1024	Taille des fichiers. Unité : octets. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File.
StorageType	String	InfrequentAccess	Type de stockage des fichiers. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File. Valeurs possibles : standard : Système de fichiers NAS généraliste InfrequentAccess : Support de stockage IA
Atime	String	2021-02-01T10:08:08Z	Plage de temps de la requête. L'heure respecte la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File.
Name	String	file.txt	Nom du fichier ou du répertoire.
RetrieveTime	String	2021-02-11T10:08:08Z	Date d'exécution de la dernière tâche de récupération de données. L'heure respecte la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. Ce paramètre n'est renvoyé et valide que si le paramètre Type est défini sur File.
Inode	String	66	Inode du fichier ou du répertoire.
FileId	String	66	ID du répertoire ou du fichier.
Owner	String	37862c****	ID du compte portable. Ce paramètre n'est renvoyé et valide que si le paramètre ProtocolType est défini sur SMB et que le contrôle d'accès basé sur RAM est activé.

Exemples

Exemple de requête

http(s)://[Endpoint]/?Action=ListDirectoriesAndFiles
&FileSystemId=31a8e4****
&Path=/pathway/to/folder
&NextToken=TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=    
&StorageType=InfrequentAccess
&DirectoryOnly=false
&MaxResults=100
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDirectoriesAndFilesResponse>
    <NextToken>TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=</NextToken>
    <RequestId>2D69A58F-345C-4FDE-88E4-BF518948****</RequestId>
    <Entries>
        <Type>File</Type>
        <HasInfrequentAccessFile>true</HasInfrequentAccessFile>
        <Ctime>2021-02-11T10:08:10Z</Ctime>
        <Mtime>2021-02-11T10:08:08Z</Mtime>
        <Size>1024</Size>
        <StorageType>InfrequentAccess</StorageType>
        <Atime>2021-02-01T10:08:08Z</Atime>
        <Name>file.txt</Name>
        <RetrieveTime>2021-02-11T10:08:08Z</RetrieveTime>
        <Inode>66</Inode>
        <FileId>66</FileId>
        <Owner>37862c****</Owner>
    </Entries>
</ListDirectoriesAndFilesResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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****"
  } ]
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	OperationDenied.InvalidNextToken	The specified NextToken is invalid.	Le paramètre NextToken spécifié n'est pas valide.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Le système de fichiers spécifié n'existe pas.
404	InvalidParameter.PathNotExist	The specified path does not exist.	Le chemin spécifié n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.