PutLifecycleConfiguration - Amazon Elastic File System

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

PutLifecycleConfiguration

Use essa ação para gerenciar o armazenamento do seu sistema de arquivos. Um LifecycleConfiguration consiste em um ou mais objetos LifecyclePolicy que definem o seguinte:

  • TransitionToIA: quando mover arquivos no sistema de arquivos do armazenamento principal (classe de armazenamento Standard) para o armazenamento Infrequent Access (IA).

  • TransitionToArchive: quando mover arquivos no sistema de arquivos de sua classe de armazenamento atual (IA ou armazenamento Standard) para o armazenamento Archive.

    Os sistemas de arquivos não podem fazer a transição para o armazenamento Archive antes da transição para o armazenamento IA. Portanto, não TransitionToArchive deve ser definido ou deve ser posterior ao TransitionTo IA.

    nota

    A classe de armazenamento Archive está disponível somente para sistemas de arquivos que usam o modo de taxa de transferência elástica e o modo de desempenho de uso geral.

  • TransitionToPrimaryStorageClass: se os arquivos do sistema de arquivos devem ser movidos de volta para o armazenamento primário (classe de armazenamento Standard) após serem acessados no IA ou no armazenamento Archive.

Para obter mais informações, consulte Como gerenciar o armazenamento de sistema de arquivos.

Cada sistema de EFS arquivos da Amazon oferece suporte a uma configuração de ciclo de vida, que se aplica a todos os arquivos no sistema de arquivos. Se já existir um objeto LifecycleConfiguration para o sistema de arquivos especificado, uma chamada PutLifecycleConfiguration modifica a configuração existente. Uma chamada PutLifecycleConfiguration com uma matriz LifecyclePolicies vazia no corpo da solicitação exclui qualquer LifecycleConfiguration existente. Na solicitação, especifique o seguinte:

  • A ID do sistema de arquivos para o qual você está ativando, desativando ou modificando o gerenciamento do ciclo de vida.

  • Uma matriz LifecyclePolicies de objetos da LifecyclePolicy que define quando mover arquivos para o armazenamento IA, para o armazenamento Archive e de volta para o armazenamento primário.

    nota

    A Amazon EFS exige que cada LifecyclePolicy objeto tenha apenas uma única transição, então a LifecyclePolicies matriz precisa ser estruturada com LifecyclePolicy objetos separados. Consulte os exemplos de solicitações na seção a seguir para obter mais informações.

Essa operação exige permissões para a operação elasticfilesystem:PutLifecycleConfiguration.

Para aplicar um LifecycleConfiguration objeto a um sistema de arquivos criptografado, você precisa das mesmas AWS Key Management Service permissões de quando criou o sistema de arquivos criptografado.

Sintaxe da Solicitação

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

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

FileSystemId

O ID do sistema de arquivos para o qual você está criando o objeto LifecycleConfiguration (String).

Restrições de Tamanho: Tamanho máximo de 128.

Padrão: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os seguintes dados no JSON formato.

LifecyclePolicies

Uma matriz de objetos LifecyclePolicy que definem o objeto LifecycleConfiguration do sistema de arquivos. Um LifecycleConfiguration objeto informa o gerenciamento do ciclo de vida sobre o seguinte:

  • TransitionToIA: quando mover arquivos no sistema de arquivos do armazenamento principal (classe de armazenamento Standard) para o armazenamento Infrequent Access (IA).

  • TransitionToArchive: quando mover arquivos no sistema de arquivos de sua classe de armazenamento atual (IA ou armazenamento Standard) para o armazenamento Archive.

    Os sistemas de arquivos não podem fazer a transição para o armazenamento Archive antes da transição para o armazenamento IA. Portanto, não TransitionToArchive deve ser definido ou deve ser posterior ao TransitionTo IA.

    nota

    A classe de armazenamento Archive está disponível somente para sistemas de arquivos que usam o modo de taxa de transferência elástica e o modo de desempenho de uso geral.

  • TransitionToPrimaryStorageClass: se os arquivos do sistema de arquivos devem ser movidos de volta para o armazenamento primário (classe de armazenamento Standard) após serem acessados no IA ou no armazenamento Archive.

nota

Ao usar o put-lifecycle-configuration CLI comando ou a PutLifecycleConfiguration API ação, a Amazon EFS exige que cada LifecyclePolicy objeto tenha apenas uma única transição. Isso significa que, no corpo de uma solicitação, o LifecyclePolicies deve ser estruturado como uma matriz de objetos da LifecyclePolicy, um objeto para cada transição. Consulte os exemplos de solicitações na seção a seguir para obter mais informações.

Tipo: matriz de objetos LifecyclePolicy

Membros da matriz: número máximo de três itens.

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

Os dados a seguir são retornados em JSON formato pelo serviço.

LifecyclePolicies

Uma matriz de políticas de gerenciamento do ciclo de vida. EFSsuporta no máximo uma política por sistema de arquivos.

Tipo: matriz de objetos LifecyclePolicy

Membros da matriz: número máximo de três itens.

Erros

BadRequest

Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.

HTTPCódigo de status: 400

FileSystemNotFound

Retornado se o FileSystemId valor especificado não existir no valor do Conta da AWS solicitante.

HTTPCódigo de status: 404

IncorrectFileSystemLifeCycleState

Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”.

HTTPCódigo de status: 409

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

HTTPCódigo de status: 500

Exemplos

Criar uma configuração de ciclo de vida

O exemplo a seguir cria um objeto LifecyclePolicy usando a ação PutLifecycleConfiguration. Este exemplo cria uma política de ciclo de vida que instrui EFS a fazer o seguinte:

  • Mova todos os arquivos no sistema de arquivos que não foram acessados no armazenamento Standard nos últimos 30 dias para o armazenamento IA.

  • Mova todos os arquivos no sistema de arquivos que não foram acessados no armazenamento Standard nos últimos 90 dias para o armazenamento Archive.

  • Mova os arquivos de volta para o armazenamento Standard depois que eles forem acessados no armazenamento IA ou Archive. A classe de armazenamento Archive está disponível somente para sistemas de arquivos que usam o modo de taxa de transferência elástica e o modo de desempenho de uso geral.

Para obter mais informações, consulte classes EFS de armazenamento e Gerenciamento do armazenamento do sistema de arquivos.

Exemplo de solicitação

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" } ] }

Resposta da amostra

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" } ] }

Exemplo de put-lifecycle-configuration CLI solicitação

Este exemplo ilustra um uso do. PutLifecycleConfiguration

Exemplo de solicitação

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

Resposta da amostra

{ "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] }

Desativar o gerenciamento de ciclo de vida

O exemplo a seguir desativa o gerenciamento do ciclo de vida do sistema de arquivos especificado.

Exemplo de solicitação

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": [ ] }

Resposta da amostra

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] }

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: