UpdateRecoveryPointLifecycle - Amazon Backup
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

UpdateRecoveryPointLifecycle

设置恢复点的转换生命周期。

生命周期定义了受保护的资源何时过渡到冷存储以及何时过期。 Amazon Backup 根据您定义的生命周期自动过渡和过期备份。

转换到冷存储的备份必须在冷存储中存储至少 90 天。因此，“保留期”设置必须比“转换为冷态前经过的天数”设置多 90 天。在备份转换为冷态后，无法更改“转换为冷态前经过的天数”设置。

可以过渡到冷存储的资源类型在 “按资源划分的功能可用性” 表的 “到冷存储的生命周期” 部分中列出。 Amazon Backup 对于其他资源类型，将忽略此表达式。

此操作不支持连续备份。

请求语法

POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json

{
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   }
}

URI 请求参数

请求使用以下 URI 参数。

backupVaultName

用于存储备份的逻辑容器的名称。备份保管库的名称在创建它们的账户和创建它们的 Amazon 区域中是唯一的。名称包含小写字母、数字和连字符。

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

必需：是

recoveryPointArn

唯一标识恢复点的 Amazon 资源名称 (ARN)；例如，arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。

必需：是

请求体

请求接受采用 JSON 格式的以下数据。

Lifecycle

生命周期定义了受保护的资源何时过渡到冷存储以及何时过期。 Amazon 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"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

BackupVaultArn

唯一标识备份保管库的 ARN；例如，arn:aws:backup:us-east-1:123456789012:vault:aBackupVault。

类型：字符串

CalculatedLifecycle

包含 DeleteAt 和 MoveToColdStorageAt 时间戳的 CalculatedLifecycle 对象。

类型：CalculatedLifecycle 对象

Lifecycle

生命周期定义了受保护的资源何时过渡到冷存储以及何时过期。 Amazon Backup 根据您定义的生命周期自动过渡和过期备份。

转换到冷存储的备份必须在冷存储中存储至少 90 天。因此，“保留期”设置必须比“转换为冷态前经过的天数”设置多 90 天。在备份转换为冷态后，无法更改“转换为冷态前经过的天数”设置。

可以过渡到冷存储的资源类型在 “按资源划分的功能可用性” 表的 “到冷存储的生命周期” 部分中列出。 Amazon Backup 对于其他资源类型，将忽略此表达式。

类型：Lifecycle 对象

RecoveryPointArn

唯一标识恢复点的 Amazon 资源名称 (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

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：