本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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"
}
回應元素
如果動作成功,服務會傳回 201 HTTP 回應。
服務會以 JSON 格式傳回下列資料。
- CreationTime
-
以 Unix 格式和國際標準時間 () 建立還原測試計畫的日期和時間UTC。
CreationTime
的值精確到毫秒。例如,值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型:Timestamp
- RestoreTestingPlanArn
-
Amazon Resource Name (ARN),可唯一識別建立的還原測試計劃。
類型:字串
- RestoreTestingPlanName
-
此不重複字串是還原測試計畫的名稱。
此名稱建立後就不可變更。此名稱僅包含英數字元和底線。長度上限為 50。
類型:字串
錯誤
如需所有動作常見的錯誤資訊,請參閱《常見錯誤》。
- AlreadyExistsException
-
所需資源已存在。
HTTP 狀態碼:400
- ConflictException
-
AWS Backup 在執行完先前的動作之前,無法執行您請求的動作。請稍後再試。
HTTP 狀態碼:400
- InvalidParameterValueException
-
表示參數的值出現問題。例如,值超出範圍。
HTTP 狀態碼:400
- LimitExceededException
-
請求已超過限制;例如,請求中允許的最大項目數量。
HTTP 狀態碼:400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼:400
- ServiceUnavailableException
-
由於伺服器發生臨時故障,請求失敗。
HTTP 狀態碼:500
另請參閱
如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: