Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
DescribeLifecycleConfiguration
Renvoie l'LifecycleConfigurationobjet actuel pour le système de fichiers EFS spécifié. La gestion du cycle de vie utilise l’objet LifecycleConfiguration pour identifier le moment où il convient de déplacer des fichiers entre les classes de stockage. Pour un système de fichiers sans objet LifecycleConfiguration, l’appel renvoie un tableau vide dans la réponse.
Cette opération exige des autorisations pour l’opération elasticfilesystem:DescribeLifecycleConfiguration.
Syntaxe de la demande
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- FileSystemId
-
L’ID du système de fichiers dont vous souhaitez récupérer l’objet
LifecycleConfiguration(String).Contraintes de longueur : Longueur maximum de 128.
Modèle :
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$Obligatoire : oui
Corps de la demande
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- LifecyclePolicies
-
Un ensemble de politiques de gestion du cycle de vie. EFS prend en charge au maximum une politique par système de fichiers.
Type : tableau d’objets LifecyclePolicy
Membres du tableau : nombre maximum de 3 éléments.
Erreurs
- BadRequest
-
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 400
- FileSystemNotFound
-
Renvoyé si la
FileSystemIdvaleur spécifiée n'existe pas dans celle du Compte AWS demandeur.- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 404
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
- ErrorCode
-
Le code d'erreur est une chaîne qui identifie de façon univoque une condition d'erreur. Il doit être lu et compris par des programmes qui détectent et gèrent des erreurs par type.
- Message
-
Le message d'erreur contient une description générique de la condition d'erreur en anglais. Il s'adresse à un public d'individus. Des programmes basiques affichent le message directement pour l'utilisateur final s'ils trouvent une condition d'erreur qu'ils ne savent, ni souhaitent gérer. Des programmes sophistiqués avec une gestion d'erreur plus complète et une stratégie d'internationalisation personnalisée risquent plus d'ignorer le message d'erreur.
Code d’état HTTP : 500
Exemples
Récupérer la configuration du cycle de vie d’un système de fichiers
La requête suivante récupère l’objet LifecycleConfiguration pour le système de fichiers spécifié.
Exemple de demande
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
Exemple de réponse
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
