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.
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
LifecyclePoliciesde objetos daLifecyclePolicyque 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
LifecyclePolicytenha apenas uma única transição. Portanto, a matrizLifecyclePoliciesprecisa ser estruturada com objetosLifecyclePolicyseparados. 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
LifecyclePolicyque definem o objetoLifecycleConfigurationdo sistema de arquivos. Um objetoLifecycleConfigurationinforma 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-configurationda CLI ou a açãoPutLifecycleConfigurationda API, o Amazon EFS exige que cada objetoLifecyclePolicytenha apenas uma única transição. Isso significa que, no corpo de uma solicitação, oLifecyclePoliciesdeve ser estruturado como uma matriz de objetos daLifecyclePolicy, 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.
- 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
FileSystemIdvalor 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 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: