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.
PutLifecycleConfiguration
Utilisez cette action pour gérer le stockage de votre système de fichiers. Le LifecycleConfiguration
se compose d’un ou de plusieurs objets LifecyclePolicy
qui définissent les éléments suivants :
-
TransitionToIA
— Quand déplacer des fichiers dans le système de fichiers depuis le stockage principal (classe de stockage standard) vers le stockage à accès peu fréquent (IA). -
TransitionToArchive
— Quand déplacer les fichiers du système de fichiers depuis leur classe de stockage actuelle (stockage IA ou standard) vers le stockage d’archives.Les systèmes de fichiers ne peuvent pas passer au stockage d’archives avant de passer au stockage IA. Par conséquent, TransitionToArchive il ne doit pas être défini ou doit être postérieur à TransitionTo IA.
Note
La classe de stockage Archive est disponible uniquement pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose.
-
TransitionToPrimaryStorageClass
— S’il faut replacer les fichiers du système de fichiers vers le stockage principal (classe de stockage standard) après leur accès dans le stockage IA ou dans le stockage des archives.
Pour plus d’informations, consultez Gestion du stockage du système de fichiers.
Chaque système de EFS fichiers Amazon prend en charge une configuration de cycle de vie, qui s'applique à tous les fichiers du système de fichiers. Si un LifecycleConfiguration
objet existe déjà pour le système de fichiers spécifié, un appel PutLifecycleConfiguration
modifie la configuration existante. Un appel PutLifecycleConfiguration
avec un tableau LifecyclePolicies
vide dans le corps de la requête supprime tout tableau existant LifecycleConfiguration
. Dans la demande, précisez ce qui suit :
-
ID du système de fichiers pour lequel vous activez, désactivez ou modifiez la gestion du cycle de vie.
-
Un tableau
LifecyclePolicies
d’objetsLifecyclePolicy
qui définit le moment où les fichiers doivent être déplacés vers le stockage IA, vers le stockage d’archives et vers le stockage principal.Note
Amazon EFS exige que chaque
LifecyclePolicy
objet n'ait qu'une seule transition. LeLifecyclePolicies
tableau doit donc être structuré avecLifecyclePolicy
des objets distincts. Pour plus d’informations, veuillez consulter les exemples de demandes dans la section suivante.
Cette opération exige des autorisations pour l’opération elasticfilesystem:PutLifecycleConfiguration
.
Pour appliquer un LifecycleConfiguration
objet à un système de fichiers chiffré, vous devez disposer des mêmes AWS Key Management Service autorisations que lorsque vous avez créé le système de fichiers chiffré.
Syntaxe de la requête
PUT /2015-02-01/file-systems/FileSystemId
/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string
",
"TransitionToIA": "string
",
"TransitionToPrimaryStorageClass": "string
"
}
]
}
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- FileSystemId
-
ID du système de fichiers pour lequel créer l’objet
LifecycleConfiguration
(chaîne).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 accepte les données suivantes au JSON format suivant.
- LifecyclePolicies
-
Tableau d’objets
LifecyclePolicy
qui définissent l’objetLifecycleConfiguration
du système de fichiers. UnLifecycleConfiguration
objet fournit à la gestion du cycle de vie les informations suivantes :-
TransitionToIA
— Quand déplacer des fichiers dans le système de fichiers depuis le stockage principal (classe de stockage standard) vers le stockage à accès peu fréquent (IA). -
TransitionToArchive
— Quand déplacer les fichiers du système de fichiers depuis leur classe de stockage actuelle (stockage IA ou standard) vers le stockage d’archives.Les systèmes de fichiers ne peuvent pas passer au stockage d’archives avant de passer au stockage IA. Par conséquent, TransitionToArchive il ne doit pas être défini ou doit être postérieur à TransitionTo IA.
Note
La classe de stockage Archive est disponible uniquement pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose.
-
TransitionToPrimaryStorageClass
— S’il faut replacer les fichiers du système de fichiers vers le stockage principal (classe de stockage standard) après leur accès dans le stockage IA ou dans le stockage des archives.
Note
Lorsque vous utilisez la
put-lifecycle-configuration
CLI commande ou l'PutLifecycleConfiguration
APIaction, Amazon EFS exige que chaqueLifecyclePolicy
objet ne comporte qu'une seule transition. Cela signifie que dans un corps de demande,LifecyclePolicies
doit être structuré comme un tableau d’objetsLifecyclePolicy
, un objet pour chaque transition de stockage. Pour plus d’informations, veuillez consulter les exemples de demandes dans la section suivante.Type : tableau d’objets LifecyclePolicy
Membres du tableau : nombre maximum de 3 éléments.
Obligatoire : oui
-
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 sous JSON forme formatée par le service.
- LifecyclePolicies
-
Un ensemble de politiques de gestion du cycle de vie. EFSprend en charge un maximum d'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.
HTTPCode de statut : 400
- FileSystemNotFound
-
Renvoyé si la
FileSystemId
valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.HTTPCode de statut : 404
- IncorrectFileSystemLifeCycleState
-
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».
HTTPCode de statut : 409
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
HTTPCode de statut : 500
Exemples
Créer une configuration de cycle de vie
L’exemple suivant crée un objet LifecyclePolicy
à l’aide de l’action PutLifecycleConfiguration
. Cet exemple crée une politique de cycle de vie qui indique EFS de procéder comme suit :
-
Déplacez tous les fichiers du système de fichiers auxquels vous n’avez pas accédé dans le stockage Standard au cours des 30 derniers jours vers le stockage IA.
-
Déplacez tous les fichiers du système de fichiers auxquels vous n’avez pas accédé dans le stockage standard au cours des 90 derniers jours vers le stockage d’archives.
-
S’il faut replacer les fichiers vers le stockage principal (standard) après leur accès dans le stockage IA ou dans le stockage d’archives. La classe de stockage Archive est disponible uniquement pour les systèmes de fichiers qui utilisent le mode débit élastique et le mode de performance General Purpose.
Pour plus d'informations, consultez les sections Classes EFS de stockage et Gestion du stockage des systèmes de fichiers.
Exemple de demande
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
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_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
Exemple de put-lifecycle-configuration CLI demande
Cet exemple illustre une utilisation de PutLifecycleConfiguration.
Exemple de demande
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
Exemple de réponse
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
Désactiver la gestion du cycle de vie ()
L’exemple suivant désactive la gestion du cycle de vie pour le système de fichiers spécifié.
Exemple de demande
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
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": [ ]
}
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :