Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

PutLifecycleConfiguration

Modo de foco
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á.

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á.

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 de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico 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 arquivos do Amazon EFS é compatível com 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:

  • O ID do sistema de arquivos para o qual você está habilitando, desabilitando 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

    O Amazon EFS exige que cada objeto LifecyclePolicy tenha apenas uma única transição. Portanto, a matriz LifecyclePolicies precisa ser estruturada com objetos LifecyclePolicy 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" } ] }

Parâmetros da Solicitação de URI

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

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 dados a seguir no formato JSON.

LifecyclePolicies

Uma matriz de objetos LifecyclePolicy que definem o objeto LifecycleConfiguration do sistema de arquivos. Um objeto LifecycleConfiguration 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 de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico 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 comando put-lifecycle-configuration da CLI ou a ação PutLifecycleConfiguration da API, o Amazon EFS exige que cada objeto LifecyclePolicy 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 200.

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

LifecyclePolicies

Uma matriz de políticas de gerenciamento do ciclo de vida. O EFS é compatível com 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.

Código de status HTTP: 400

FileSystemNotFound

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

Código de status HTTP: 404

IncorrectFileSystemLifeCycleState

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

Código de Status HTTP: 409

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

Código de status HTTP: 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 o 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 de arquivos está disponível somente para sistemas de arquivos que usam o modo de throughput elástico e o modo de desempenho de uso geral.

Para obter mais informações, consulte Classes de armazenamento do EFS e Como gerenciar o 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 solicitação de CLI

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 essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.