GetDirectoryOrFileProperties - File Storage NAS - Centre de documentation Alibaba Cloud

Vérifie si un répertoire spécifié contient des fichiers de classe de stockage Accès peu fréquent (IA) ou Archive, ou vérifie si un fichier spécifié est de classe de stockage Accès peu fréquent ou Archive.

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:GetDirectoryOrFileProperties

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

Éléments de réponse

Élément	Type	Description	Exemple
	object
Entry	object	Les informations sur le répertoire ou le fichier.
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é uniquement lorsque Type est 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
MTime	string	L'heure de modification du fichier. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. Ce paramètre est renvoyé uniquement lorsque Type est File.	2021-02-11T10:08:08Z
ATime	string	L'heure à laquelle le fichier a été interrogé. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. Ce paramètre est renvoyé uniquement lorsque Type est File.	2021-02-01T10:08:08Z
Size	integer	La taille du fichier. Unité : octets. Ce paramètre est renvoyé uniquement lorsque Type est File.	1024
CTime	string	L'heure de modification des métadonnées. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. Ce paramètre est renvoyé uniquement lorsque Type est File.	2021-02-11T10:08:10Z
StorageType	string	Le type de stockage du fichier renvoyé. Ce paramètre est renvoyé uniquement lorsque Type est File. Valeurs valides : Standard : stockage NAS à usage général. InfrequentAccess : classe de stockage IA.	InfrequentAccess
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 au format yyyy-MM-ddTHH:mm:ssZ. Ce paramètre est renvoyé uniquement lorsque Type est File.	2021-02-11T10:08:08Z
Inode	string	L'inode du fichier ou du répertoire.	40
HasArchiveFile	boolean	Indique si le répertoire contient des fichiers de classe de stockage Archive. Ce paramètre est renvoyé uniquement lorsque Type est 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.	false
OfflineDuration	integer	La durée totale pendant laquelle le fichier a été stocké en tant que fichier Archive. Unité : secondes.	3600
OfflineUnchangedDuration	integer	La durée totale pendant laquelle le fichier est resté inchangé depuis son stockage en tant que fichier Archive. Unité : secondes.	3600
RequestId	string	L'identifiant de la requête.	2D69A58F-345C-4FDE-88E4-BF518948****

Exemples

JSON format

{
  "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": "40",
    "HasArchiveFile": false,
    "OfflineDuration": 3600,
    "OfflineUnchangedDuration": 3600
  },
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

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

Notes de version

Consultez Notes de version pour la liste complète.