Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

PutLifecycleConfiguration

Mode de mise au point
PutLifecycleConfiguration - Amazon Elastic File System

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.

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.

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 n'est disponible que 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 fichiers Amazon EFS 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 PutLifecycleConfigurationmodifie 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’objets LifecyclePolicy 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 objet LifecyclePolicy n’ait qu’une seule transition. Le tableau LifecyclePolicies doit donc être structuré avec des objets LifecyclePolicy 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 demande

PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

Paramètres de demande URI

La demande utilise les paramètres URI 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

Cette demande accepte les données suivantes au format JSON.

LifecyclePolicies

Tableau d’objets LifecyclePolicy qui définissent l’objet LifecycleConfiguration du système de fichiers. Un LifecycleConfiguration 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 n'est disponible que 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 commande put-lifecycle-configuration CLI ou l’action PutLifecycleConfiguration API, Amazon EFS exige que chaque LifecyclePolicy objet n’ait qu’une seule transition. Cela signifie que dans un corps de demande, LifecyclePolicies doit être structuré comme un tableau d’objets LifecyclePolicy, 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 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.

Code d’état HTTP : 400

FileSystemNotFound

Renvoyé si la FileSystemId valeur spécifiée n'existe pas dans celle du Compte AWS demandeur.

Code d’état HTTP : 404

IncorrectFileSystemLifeCycleState

Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».

Code d’état HTTP : 409

InternalServerError

Renvoyé si une erreur s’est produite côté serveur.

Code d’état HTTP : 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 demande à EFS d’effectuer les opérations suivantes :

  • 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 n'est disponible que 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 de stockage EFS 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 demande put-lifecycle-configuration CLI

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 l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :

Rubrique suivante :

TagResource

Rubrique précédente :

PutFileSystemPolicy
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.