CreateRestoreTestingPlan - Amazon Backup
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

CreateRestoreTestingPlan

这是创建还原测试计划的两个步骤中的第一步;此请求成功后,请使用请求 CreateRestoreTestingSelection 完成该步骤。

必须包括参数 RestoreTestingPlan。您可以选择包括 CreatorRequestId 和标签。

请求语法

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

要包括的可选标签。标签是您可用来管理、筛选和搜索资源的键值对。允许使用的字符包括 UTF-8 字母、数字、空格以及以下字符:+ - = . _ : /。

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

必需:否

响应语法

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 的更多信息,请参阅以下内容: