PutLifecycleConfiguration - Amazon Elastic File System
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosExemplosConsulte também

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, Transição para Archive não deve ser definido ou deve ser posterior a Transição para 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 objeto LifecycleConfiguration a um sistema de arquivos criptografado, você precisa das mesmas permissões do AWS Key Management Service 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, Transição para Archive não deve ser definido ou deve ser posterior a Transição para 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 valor especificado de FileSystemId não existir na 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 solicitação de CLI put-lifecycle-configuration

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 um dos SDKs específicos de linguagem AWS, consulte: