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á.
UpdateRecoveryPointLifecycle
Define o ciclo de vida de transição de um ponto de recuperação.
O ciclo de vida define quando um recurso protegido é transferido para o armazenamento refrigerado e quando ele expira. AWS Backup faz a transição e expira os backups automaticamente de acordo com o ciclo de vida definido por você.
Os tipos de recursos que podem fazer a transição para o armazenamento refrigerado estão listados na tabela Disponibilidade de recursos por recursos. AWS Backup ignora essa expressão para outros tipos de recursos.
Os backups transferidos para o armazenamento refrigerado devem ser armazenados em armazenamento refrigerado por no mínimo 90 dias. Portanto, a configuração de “retenção” deve ser noventa dias a mais do que a configuração de “número de dias para a transição para o armazenamento frio”. A configuração de “número de dias para transferência ao armazenamento a frio” não pode ser alterada depois que um backup é transferido para o armazenamento a frio.
Importante
Se seu ciclo de vida atualmente usa os parâmetros DeleteAfterDays e MoveToColdStorageAfterDays, inclua esses parâmetros e seus valores ao chamar essa operação. Não incluí-los pode resultar na atualização do seu plano com valores nulos.
Essa operação não é compatível com backups contínuos.
Sintaxe da Solicitação
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number,
"DeleteAfterEvent": "string",
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
}
}Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- backupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da AWS em que são criados.
Padrão:
^[a-zA-Z0-9\-\_]{2,50}$Exigido: Sim
- recoveryPointArn
-
Um Nome do recurso da Amazon (ARN) que identifica de forma exclusiva um ponto de recuperação. Por exemplo,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Obrigatório: sim
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- Lifecycle
-
O ciclo de vida define quando um recurso protegido é transferido para o armazenamento refrigerado e quando ele expira. AWS Backup faz a transição e expira os backups automaticamente de acordo com o ciclo de vida definido por você.
Os backups transferidos para o armazenamento refrigerado devem ser armazenados em armazenamento refrigerado por no mínimo 90 dias. Portanto, a configuração de “retenção” deve ser noventa dias a mais do que a configuração de “número de dias para a transição para o armazenamento frio”. A configuração de “número de dias para transferência ao armazenamento a frio” não pode ser alterada depois que um backup é transferido para o armazenamento a frio.
Tipo: objeto Lifecycle
Obrigatório: não
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"CalculatedLifecycle": {
"DeleteAt": number,
"MoveToColdStorageAt": number
},
"Lifecycle": {
"DeleteAfterDays": number,
"DeleteAfterEvent": "string",
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "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.
- BackupVaultArn
-
Um ARN que identifica de forma exclusiva um cofre de backup, por exemplo,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.Tipo: string
- CalculatedLifecycle
-
Um objeto
CalculatedLifecycleque contém os timestampsMoveToColdStorageAteDeleteAt.Tipo: objeto CalculatedLifecycle
- Lifecycle
-
O ciclo de vida define quando um recurso protegido é transferido para o armazenamento refrigerado e quando ele expira. AWS Backup faz a transição e expira os backups automaticamente de acordo com o ciclo de vida definido por você.
Os backups transferidos para o armazenamento refrigerado devem ser armazenados em armazenamento refrigerado por no mínimo 90 dias. Portanto, a configuração de “retenção” deve ser noventa dias a mais do que a configuração de “número de dias para a transição para o armazenamento frio”. A configuração de “número de dias para transferência ao armazenamento a frio” não pode ser alterada depois que um backup é transferido para o armazenamento a frio.
Os tipos de recursos que podem fazer a transição para o armazenamento refrigerado estão listados na tabela Disponibilidade de recursos por recursos. AWS Backup ignora essa expressão para outros tipos de recursos.
Tipo: objeto Lifecycle
- RecoveryPointArn
-
Um Nome do recurso da Amazon (ARN) que identifica de forma exclusiva um ponto de recuperação, por exemplo,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Tipo: string
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- InvalidParameterValueException
-
Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.
- Context
- Type
Código de status HTTP: 400
- InvalidRequestException
-
Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.
- Context
- Type
Código de status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
- Context
- Type
Código de status HTTP: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
- Context
- Type
Código de status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
- Context
- Type
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
