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

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

CreateRestoreTestingPlan

创建还原测试计划。

创建恢复测试计划的两个步骤中的第一步。此请求成功后，使用完成该过程 CreateRestoreTestingSelection。

请求语法

PUT /restore-testing/plans HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "RestoreTestingPlan": { 
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "RestoreTestingPlanName": "string",
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   },
   "Tags": { 
      "string" : "string" 
   }
}

URI 请求参数

该请求不使用任何 URI 参数。

请求体

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

CreatorRequestId

这是唯一字符串，用于标识请求并允许重试失败的请求，同时避免发生两次运行该操作的风险。此参数为可选的。如果使用，则此参数必须包含 1 到 50 个字母数字或“-_.” 字符。

类型：字符串

必需：否

RestoreTestingPlan

还原测试计划必须包含您创建的唯一 RestoreTestingPlanName 字符串，并且必须包含一个 ScheduleExpression cron。您可以选择包括一个 StartWindowHours 整数和一个 CreatorRequestId 字符串。

RestoreTestingPlanName 是唯一字符串，即还原测试计划的名称。创建后无法对其进行更改，并且只能由字母数字字符和下划线组成。

类型：RestoreTestingPlanForCreate 对象

必需：是

Tags

要分配给还原测试计划的标签。

类型：字符串到字符串映射

必需：否

响应语法

HTTP/1.1 201
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string"
}

响应元素

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

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

CreationTime

还原测试计划的创建日期和时间，以 Unix 格式和世界标准时间 (UTC) 格式表示。CreationTime 的值精确到毫秒。例如，值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30.087。

类型：时间戳

RestoreTestingPlanArn

可唯一标识已创建的还原测试计划的 Amazon 资源名称（ARN）。

类型：字符串

RestoreTestingPlanName

唯一字符串，即还原测试计划的名称。

名称一经创建便无法更改。名称只能包含字母数字字符和下划线。最大长度为 50。

类型：字符串

错误

有关所有操作返回的常见错误的信息，请参阅常见错误。

AlreadyExistsException

所需的资源已存在。

HTTP 状态代码：400

ConflictException

Amazon Backup 在完成前一个操作之前，无法执行你请求的操作。请稍后重试。

HTTP 状态代码：400

InvalidParameterValueException

表示参数的值有问题。例如，该值超出了范围。

HTTP 状态代码：400

LimitExceededException

已超过请求中的限制；例如，请求中允许的最大项目数。

HTTP 状态代码：400

MissingParameterValueException

表示缺少必需的参数。

HTTP 状态代码：400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

HTTP 状态代码：500

另请参阅

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