CreateBackupSelection - AWS Backup
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラーその他の参照資料

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

CreateBackupSelection

バックアップ計画に割り当てる一連のリソースを指定する JSON ドキュメントを作成します。例については、「プログラムによるリソースの割り当て」を参照してください。

リクエストの構文

PUT /backup/plans/backupPlanId/selections/ HTTP/1.1
Content-type: application/json

{
   "BackupSelection": { 
      "Conditions": { 
         "StringEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ]
      },
      "IamRoleArn": "string",
      "ListOfTags": [ 
         { 
            "ConditionKey": "string",
            "ConditionType": "string",
            "ConditionValue": "string"
         }
      ],
      "NotResources": [ "string" ],
      "Resources": [ "string" ],
      "SelectionName": "string"
   },
   "CreatorRequestId": "string"
}

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

backupPlanId

バックアッププランの ID。

必須: はい

リクエストボディ

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

BackupSelection

バックアッププランに一連のリソースを割り当てるリクエストの本文。

型: BackupSelection オブジェクト

必須: はい

CreatorRequestId

オペレーションを 2 回実行するリスクなしに、失敗したリクエストを再試行できるリクエストを識別する一意の文字列。このパラメータはオプションです。

使用する場合、このパラメータには 1～50 文字の英数字または「-_」を含める必要があります 。

タイプ: 文字列

必須: いいえ

レスポンスの構文

HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanId": "string",
   "CreationDate": number,
   "SelectionId": "string"
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

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

BackupPlanId

バックアッププランの ID。

型: 文字列

CreationDate

Unix 形式および協定世界時 (UTC)でバックアップ選択が作成された日時。CreationDateの値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。

型: タイムスタンプ

SelectionId

バックアップ計画に一連のリソースを割り当てるためのリクエストを一意に識別します。

型: 文字列

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AlreadyExistsException

必要なリソースは既に存在します。

HTTP ステータスコード：400

InvalidParameterValueException

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

HTTP ステータスコード：400

LimitExceededException

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

HTTP ステータスコード：400

MissingParameterValueException

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

HTTP ステータスコード：400

ServiceUnavailableException

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

HTTP ステータスコード：500

その他の参照資料

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。