本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateBackupPlan
使用 JSON 格式的输入文档更新由backupPlanId
其标识的现有备份计划。新版本由 a 唯一标识VersionId
。
请求语法
POST /backup/plans/backupPlanId
HTTP/1.1
Content-type: application/json
{
"BackupPlan": {
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string
" : "string
"
},
"ResourceType": "string
"
}
],
"BackupPlanName": "string
",
"Rules": [
{
"CompletionWindowMinutes": number
,
"CopyActions": [
{
"DestinationBackupVaultArn": "string
",
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
}
}
],
"EnableContinuousBackup": boolean
,
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
},
"RecoveryPointTags": {
"string
" : "string
"
},
"RuleName": "string
",
"ScheduleExpression": "string
",
"StartWindowMinutes": number
,
"TargetBackupVaultName": "string
"
}
]
}
}
URI 请求参数
请求使用以下 URI 参数。
- backupPlanId
-
唯一标识备份计划。
必需:是
请求正文
请求接受采用 JSON 格式的以下数据。
- BackupPlan
-
指定备份计划的正文。包括
BackupPlanName
一套或多套Rules
.类型:BackupPlanInput 对象
必需:是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlanArn": "string",
"BackupPlanId": "string",
"CreationDate": number,
"VersionId": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- AdvancedBackupSettings
-
包含每种
BackupOptions
资源类型的列表。类型:AdvancedBackupSetting 对象数组
- BackupPlanArn
-
唯一标识备份计划的 Amazon 资源名称(ARN);例如,
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50
。类型:字符串
- BackupPlanId
-
唯一标识备份计划。
类型:字符串
- CreationDate
-
备份计划的创建日期和时间,采用 Unix 格式和世界协调时 (UTC)。的值精
CreationDate
确到毫秒。例如,值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30 .087。类型:Timestamp
- VersionId
-
唯一的、随机生成的、Unicode、UTF-8 编码字符串,长度最大为 1024 个字节。无法编辑版本 ID。
类型:字符串
错误
有关所有操作常见错误的信息,请参阅常见错误。
- InvalidParameterValueException
-
表示参数的值有问题。例如,该值超出范围。
HTTP 状态代码:400
- MissingParameterValueException
-
表示缺少必填参数。
HTTP 状态代码:400
- ResourceNotFoundException
-
操作所需的资源不存在。
HTTP 状态代码:400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
HTTP 状态代码:500
另请参阅
有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: