PutLifecycleConfiguration - Amazon Elastic File System
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo 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, 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: