翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CreateRestoreTestingPlan
<a name="API_CreateRestoreTestingPlan"></a>

復元テストプランを作成します。

復元テストプランを作成する 2 つのステップのうちの最初のステップ。このリクエストが成功したら、CreateRestoreTestingSelection を使用して手順を完了します。

## リクエストの構文
<a name="API_CreateRestoreTestingPlan_RequestSyntax"></a>

```
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 リクエストパラメータ
<a name="API_CreateRestoreTestingPlan_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_CreateRestoreTestingPlan_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [CreatorRequestId](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-CreatorRequestId"></a>
リクエストを識別するための一意の文字列で、失敗したリクエストを再試行する際に、オペレーションを 2 回実行するリスクを回避することができます。このパラメータはオプションです。使用する場合、このパラメータには 1～50 文字の英数字または「-\$1」を含める必要があります 。  
タイプ: 文字列  
必須: いいえ

 ** [RestoreTestingPlan](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-RestoreTestingPlan"></a>
復元テストプランには、作成した一意の `RestoreTestingPlanName` 文字列と `ScheduleExpression` cron を含める必要があります。オプションで `StartWindowHours` 整数と `CreatorRequestId` 文字列を含めることができます。  
`RestoreTestingPlanName` は復元テストプランの名前を表す一意の文字列です。これは作成後に変更できず、英数字とアンダースコアのみで構成されている必要があります。  
型: [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md) オブジェクト  
必須: はい

 ** [Tags](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-Tags"></a>
復元テストプランに割り当てるタグ。  
タイプ: 文字列間のマッピング  
必須: いいえ

## レスポンスの構文
<a name="API_CreateRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

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

## レスポンス要素
<a name="API_CreateRestoreTestingPlan_ResponseElements"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

 ** [CreationTime](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-CreationTime"></a>
復元テストプランが作成された日時を Unix 形式、および協定世界時 (UTC) で表しています。`CreationTime` の値は、ミリ秒単位の精度です。例えば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前 12:11:30.087 を表します。  
型: タイムスタンプ

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
作成された復元テストプランを一意に識別する Amazon リソースネーム (ARN) です。  
タイプ: 文字列

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
この一意の文字列は復元テストプランの名前です。  
作成後にこの名前を変更することはできません。名前には英数字とアンダースコアのみを使用できます。最大長は 50 文字です。  
タイプ: 文字列

## エラー
<a name="API_CreateRestoreTestingPlan_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AlreadyExistsException **   
必要なリソースは既に存在します。    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ConflictException **   
 AWS Backup は、前のアクションの実行が完了するまで、リクエストしたアクションを実行できません。後でもう一度お試しください。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** InvalidParameterValueException **   
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** LimitExceededException **   
たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** MissingParameterValueException **   
必須パラメータがないことを示します。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ServiceUnavailableException **   
サーバーの一時的障害のため、リクエストは失敗しました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 500

## その他の参照資料
<a name="API_CreateRestoreTestingPlan_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreTestingPlan)