UpdateRecoveryPointLifecycle - AWS Backup

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateRecoveryPointLifecycle

設定復原點的轉移生命週期。

生命週期會定義受保護資源何時轉換為冷儲存,以及何時到期。會根據您定義的生命週期自動 AWS Backup 轉換和過期備份。

可轉換為冷儲存體的資源類型會依資源資料表列在功能可用性中。請 AWS Backup 忽略其他資源類型的此表達式。

轉移至冷儲存的備份必須在冷儲存中存放至少 90 天之久。因此,「保留」設定必須比「轉移至冷儲存前所需天數」設定大上 90 天。「轉移至冷儲存前所需天數」設定在已有備份轉移至冷儲存後就無法再加以變更。

重要

如果您的生命週期目前使用 參數 DeleteAfterDaysMoveToColdStorageAfterDays,請在呼叫此操作時包含這些參數及其值。未包含這些值可能會導致您的計劃更新為 null 值。

此操作不支援連續備份。

請求語法

POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1 Content-type: application/json { "Lifecycle": { "DeleteAfterDays": number, "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean } }

URI 請求參數

請求使用以下URI參數。

backupVaultName

存放備份的邏輯容器的名稱。備份文件庫依名稱識別,這些名稱對建立文件庫的帳戶和 AWS 區域來說是唯一的。

模式:^[a-zA-Z0-9\-\_]{2,50}$

必要:是

recoveryPointArn

可唯一識別復原點的 Amazon Resource Name (ARN);例如 arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

必要:是

請求主體

請求接受下列JSON格式的資料。

Lifecycle

生命週期會定義受保護資源何時轉換為冷儲存,以及何時到期。會根據您定義的生命週期自動 AWS Backup 轉換和過期備份。

轉移至冷儲存的備份必須在冷儲存中存放至少 90 天之久。因此,「保留」設定必須比「轉移至冷儲存前所需天數」設定大上 90 天。「轉移至冷儲存前所需天數」設定在已有備份轉移至冷儲存後就無法再加以變更。

類型:Lifecycle 物件

必要:否

回應語法

HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "CalculatedLifecycle": { "DeleteAt": number, "MoveToColdStorageAt": number }, "Lifecycle": { "DeleteAfterDays": number, "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointArn": "string" }

回應元素

如果動作成功,服務會傳回 200 HTTP 個回應。

服務會以 JSON 格式傳回下列資料。

BackupVaultArn

ARN 唯一識別備份保存庫的 ;例如 arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault

類型:字串

CalculatedLifecycle

包含 DeleteAtMoveToColdStorageAt 時間戳記的 CalculatedLifecycle 物件。

類型:CalculatedLifecycle 物件

Lifecycle

生命週期會定義受保護資源何時轉換為冷儲存,以及何時到期。會根據您定義的生命週期自動 AWS Backup 轉換和過期備份。

轉移至冷儲存的備份必須在冷儲存中存放至少 90 天之久。因此,「保留」設定必須比「轉移至冷儲存前所需天數」設定大上 90 天。「轉移至冷儲存前所需天數」設定在已有備份轉移至冷儲存後就無法再加以變更。

可轉換為冷儲存體的資源類型會依資源資料表列在功能可用性中。請 AWS Backup 忽略其他資源類型的此表達式。

類型:Lifecycle 物件

RecoveryPointArn

可唯一識別復原點的 Amazon Resource Name (ARN);例如 arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

類型:字串

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidParameterValueException

表示參數的值出現問題。例如,值超出範圍。

HTTP 狀態碼:400

InvalidRequestException

表示請求的輸入出現問題。例如,參數的類型錯誤。

HTTP 狀態碼:400

MissingParameterValueException

表示缺少必要的參數。

HTTP 狀態碼:400

ResourceNotFoundException

動作所需的資源不存在。

HTTP 狀態碼:400

ServiceUnavailableException

由於伺服器發生臨時故障,請求失敗。

HTTP 狀態碼:500

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: