CreateDatasetGroup - Amazon Forecast
リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラーその他の参照資料

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

CreateDatasetGroup

関連するデータセットのコレクションを保持するデータセットグループを作成します。データセットグループを作成するとき、または後で UpdateDatasetGroup オペレーションを使用して、データセットグループにデータセットを追加できます。

データセットグループを作成してデータセットを追加した後、予測子を作成するときにデータセットグループを使用します。データセットグループの詳細については、「データセットグループ」を参照してください。

すべてのデータセットグループのリストを取得するには、ListDatasetGroups オペレーションを使用します。

注記

データセットグループを使用して予測子を作成する前に、データセットグループの Status が ACTIVE となっている必要があります。DescribeDatasetGroup オペレーションを使用して、ステータスを取得します。

リクエストの構文

{
   "DatasetArns": [ "string" ],
   "DatasetGroupName": "string",
   "Domain": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

リクエストパラメータ

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

DatasetArns

データセットグループに含めるデータセットの Amazon リソースネーム (ARN) の配列。

タイプ：文字列の配列

長さの制限：最大長は 256 です。

パターン: arn:([a-z\d-]+):forecast:.*:.*:.+

必須: いいえ

DatasetGroupName

データセットグループの名前。

型: 文字列

長さの制限：最小長は 1 です。最大長は 63 です。

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

必須：はい

Domain

データセットグループに関連付けられているドメイン。データセットをデータセットグループに追加する場合、この値と、CreateDataset オペレーションの Domain パラメータ用に指定された値は一致する必要があります。

Domain と DatasetType を選択すると、データセットにインポートするトレーニングデータに存在しなければならないフィールドが決まります。例えば、RETAIL ドメインを選択し、DatasetType として TARGET_TIME_SERIES を指定した場合、Amazon Forecast では、item_id、timestamp、および demand フィールドがデータに存在している必要があります。データセットグループの詳細については、「データセットグループ」を参照してください。

型: 文字列

有効な値：RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

必須: はい

Tags

サービスに適用し、データセットグループの分類と整理に役立つオプションのメタデータ。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。

タグには以下のベーシックな制限があります。

  • リソースあたりのタグの最大数は 50 です。

  • タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。

  • キーの最大長 - 128 文字 (Unicode) (UTF-8)。

  • 値の最大長 - 256 文字 (Unicode) (UTF-8)。

  • 複数の のサービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスにも許容される文字数に制限がある可能性があることに注意してください。一般的に使用が許可される文字は、UTF-8 で表現可能な文字、数字、スペース、および以下の文字です: +、-、=、.、_、:、/、@。

  • タグのキーと値では、大文字と小文字が区別されます。

  • aws:、AWS:、またはその大文字または小文字の組み合わせを、キーのプレフィックスとして使用しないでください。これらの文字列は AWS による使用のために予約されています。このプレフィックスが含まれるタグキーを編集したり削除することはできません。値にはこのプレフィックスを付けることができます。タグ値には aws がプレフィックスとして付されているが、キーには付されていない場合、Forecast は、それをユーザータグとみなし、タグ数の上限である 50 個を計算する際に算入します。aws のキープレフィックスのみを持つタグは、リソース制限あたりのタグに算入されません。

タイプ：Tag オブジェクトの配列

配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。

必須: いいえ

レスポンスの構文

{
   "DatasetGroupArn": "string"
}

レスポンス要素

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

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

DatasetGroupArn

データセットグループの Amazon リソースネーム (ARN)。

型: 文字列

長さの制限：最大長は 256 です。

パターン：arn:([a-z\d-]+):forecast:.*:.*:.+

エラー

InvalidInputException

無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。

HTTP ステータスコード：400

LimitExceededException

アカウントあたりのリソース数の制限を超えました。

HTTP ステータスコード：400

ResourceAlreadyExistsException

この名前のリソースは既に存在します。別の名前で再試行してください。

HTTP ステータスコード：400

ResourceInUseException

指定されたリソースは使用中です。

HTTP ステータスコード：400

ResourceNotFoundException

その Amazon リソースネーム (ARN) を持つリソースが見つかりません。ARN を確認して、もう一度お試しください。

HTTP ステータスコード：400

その他の参照資料

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