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 daLifecyclePolicy
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 aLifecyclePolicies
matriz precisa ser estruturada comLifecyclePolicy
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 objetoLifecycleConfiguration
do sistema de arquivos. UmLifecycleConfiguration
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 aPutLifecycleConfiguration
API ação, a Amazon EFS exige que cadaLifecyclePolicy
objeto tenha apenas uma única transição. Isso significa que, no corpo de uma solicitação, oLifecyclePolicies
deve 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 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: