GetDirectoryOrFileProperties - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	GetDirectoryOrFileProperties	L'opération à effectuer. Définissez la valeur sur GetDirectoryOrFileProperties.
FileSystemId	String	Oui	31a8e4****	L'ID du système de fichiers.
Path	String	Oui	/pathway/to/folder	Le chemin absolu du répertoire. Le chemin doit commencer par une barre oblique (/) et exister sur la cible de montage.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Entry	Object		Les détails concernant les fichiers ou les répertoires.
Type	String	File	Le type du résultat de la requête. Valeurs possibles : File Directory
HasInfrequentAccessFile	Boolean	true	Indique si les fichiers contiennent des données archivées sur le support de stockage IA. Ce paramètre n'est renvoyé que si la valeur du paramètre Type est Directory. Valeurs possibles : true : les fichiers contiennent des données archivées sur le support de stockage IA. false : les fichiers ne contiennent pas de données archivées sur le support de stockage IA.
MTime	String	2021-02-11T10:08:08Z	L'heure de la 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é que si la valeur du paramètre Type est File.
ATime	String	2021-02-01T10:08:08Z	La 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é que si la valeur du paramètre Type est File.
Size	Long	1024	La taille des fichiers. Unité : octets. Ce paramètre n'est renvoyé que si la valeur du paramètre Type est File.
CTime	String	2021-02-11T10:08:10Z	L'heure de la dernière 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é que si la valeur du paramètre Type est File.
StorageType	String	InfrequentAccess	Le type de stockage des fichiers. Ce paramètre n'est renvoyé que si la valeur du paramètre Type est File. Valeurs possibles : standard : système de fichiers NAS généraliste InfrequentAccess : support de stockage IA
Name	String	file.txt	Le nom du fichier ou du répertoire.
RetrieveTime	String	2021-02-11T10:08:08Z	L'heure 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é que si la valeur du paramètre Type est File.
Inode	String	40	L'inode du fichier ou du répertoire.
RequestId	String	2D69A58F-345C-4FDE-88E4-BF518948****	L'ID de la requête.

Exemples

Exemple de requête

http(s)://[Endpoint]/?Action=GetDirectoryOrFileProperties
&FileSystemId=31a8e4****
&Path=/pathway/to/folder
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

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

<GetDirectoryOrFilePropertiesResponse>
    <Entry>
        <Type>File</Type>
        <HasInfrequentAccessFile>true</HasInfrequentAccessFile>
        <MTime>2021-02-11T10:08:08Z</MTime>
        <ATime>2021-02-01T10:08:08Z</ATime>
        <Size>1024</Size>
        <CTime>2021-02-11T10:08:10Z</CTime>
        <StorageType>InfrequentAccess</StorageType>
        <Name>file.txt</Name>
        <RetrieveTime>2021-02-11T10:08:08Z</RetrieveTime>
        <Inode>Inode</Inode>
    </Entry>
    <RequestId>2D69A58F-345C-4FDE-88E4-BF518948****</RequestId>
</GetDirectoryOrFilePropertiesResponse>

JSON format

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

{
  "Entry" : {
    "Type" : "File",
    "HasInfrequentAccessFile" : true,
    "MTime" : "2021-02-11T10:08:08Z",
    "ATime" : "2021-02-01T10:08:08Z",
    "Size" : 1024,
    "CTime" : "2021-02-11T10:08:10Z",
    "StorageType" : "InfrequentAccess",
    "Name" : "file.txt",
    "RetrieveTime" : "2021-02-11T10:08:08Z",
    "Inode" : "Inode"
  },
  "RequestId" : "2D69A58F-345C-4FDE-88E4-BF518948****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Le message d'erreur indique que le système de fichiers spécifié n'existe pas.
404	InvalidParameter.PathNotExist	The specified path does not exist.	Le message d'erreur indique que le chemin spécifié n'existe pas.

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