本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用备份计划名称和备份规则创建备份计划。备份计划是一种文档，其中包含用于计划为资源创建恢复点的任务的信息。 AWS Backup
如果使用已存在的计划调用 CreateBackupPlan，您会收到 AlreadyExistsException 异常。
请求语法
PUT /backup/plans/ 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,
"OptInToArchiveForSupportedResources": boolean
}
}
],
"EnableContinuousBackup": boolean,
"IndexActions": [
{
"ResourceTypes": [ "string" ]
}
],
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointTags": {
"string" : "string"
},
"RuleName": "string",
"ScheduleExpression": "string",
"ScheduleExpressionTimezone": "string",
"StartWindowMinutes": number,
"TargetBackupVaultName": "string"
}
]
},
"BackupPlanTags": {
"string" : "string"
},
"CreatorRequestId": "string"
}URI 请求参数
该请求不使用任何 URI 参数。
请求正文
请求接受采用 JSON 格式的以下数据。
- BackupPlan
-
备份计划的正文。包括
BackupPlanName和一组或多组Rules。类型：BackupPlanInput 对象
必需：是
- BackupPlanTags
-
要分配给备份计划的标签。
类型：字符串到字符串映射
必需：否
- CreatorRequestId
-
标识请求并允许重试失败的请求，而不存在两次运行操作的风险。如果请求中包含与现有备份计划匹配的
CreatorRequestId，则会返回该计划。此参数为可选的。如果使用，则此参数必须包含 1 到 50 个字母数字或“-_.” 字符。
类型：字符串
必需：否
响应语法
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
-
资源类型的设置。此选项仅适用于 Windows 卷影复制服务 (VSS) 备份作业。
类型：AdvancedBackupSetting 对象数组
- BackupPlanArn
-
唯一标识备份计划的 Amazon 资源名称 (ARN)；例如，
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50。类型：字符串
- BackupPlanId
-
备份计划的 ID。
类型：字符串
- CreationDate
-
备份计划的创建日期和时间，采用 Unix 时间格式和协调世界时 (UTC)。
CreationDate的值精确到毫秒。例如，值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30.087。类型：时间戳
- VersionId
-
唯一的、随机生成的、Unicode、UTF-8 编码字符串，长度最大为 1024 个字节。无法对其进行编辑。
类型：字符串
错误
有关所有操作返回的常见错误的信息，请参阅常见错误。
- AlreadyExistsException
-
所需的资源已存在。
HTTP 状态代码：400
- InvalidParameterValueException
-
表示参数的值有问题。例如，该值超出了范围。
HTTP 状态代码：400
- LimitExceededException
-
已超过请求中的限制；例如，请求中允许的最大项目数。
HTTP 状态代码：400
- MissingParameterValueException
-
表示缺少必需的参数。
HTTP 状态代码：400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
HTTP 状态代码：500
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
