CreateRestoreTestingPlan - AWS Backup

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

CreateRestoreTestingPlan

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

復元テストプランを作成する 2 つのステップの最初のステップ。このリクエストが成功したら、 を使用して手順を完了します 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

リクエストを識別するための一意の文字列で、失敗したリクエストを再試行する際に、オペレーションを 2 回実行するリスクを回避することができます。このパラメータはオプションです。使用する場合、このパラメータには 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 を表します。

型: タイムスタンプ

RestoreTestingPlanArn

作成された復元テストプランを一意に識別する Amazon リソースネーム (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、以下を参照してください。