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 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](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). 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](#API_PutLifecycleConfiguration_RequestSyntax) ** 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})$` Obrigatório: Sim ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) ** 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. 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](API_LifecyclePolicy.md) Membros da matriz: número máximo de três itens. Obrigatório: 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](#API_PutLifecycleConfiguration_ResponseSyntax) ** 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](API_LifecyclePolicy.md) 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. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 400 ** FileSystemNotFound ** Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de status HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. Código de Status HTTP: 409 ** InternalServerError ** Retornado se ocorreu um erro no lado do servidor. ** ErrorCode ** O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. ** Message ** A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro. 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](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) e [Como gerenciar o armazenamento do sistema de arquivos](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). #### 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: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)