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.

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 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 LifecyclePolicy objet n'ait qu'une seule transition. Le LifecyclePolicies tableau doit donc être structuré avec LifecyclePolicy 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’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 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'PutLifecycleConfigurationAPIaction, Amazon EFS exige que chaque LifecyclePolicy objet ne comporte 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 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 :