Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateDataset Amazon Forecast データセットを作成します。 **重要** Amazon Forecast は新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 提供するデータセットに関する情報は、Forecast がモデルトレーニングのためにデータを使用する方法を理解するのに役立ちます。これには以下が含まれます。 + * `DataFrequency` * - 履歴時系列データが収集される頻度。 + * `Domain` * および * `DatasetType` * - 各データセットには、関連付けられたデータセットドメインとドメイン内のタイプがあります。Amazon Forecast は、各ドメイン内の事前定義されたドメインとタイプのリストを提供します。一意の各データセットドメインとそのドメイン内のタイプについて、Amazon Forecast では、最小限の事前設定されたフィールドセットがデータに含まれている必要があります。 + * `Schema` * - スキーマは、フィールド名やデータ型など、データセット内のフィールドを指定します。 データセットを作成したら、それにトレーニングデータをインポートし、そのデータセットをデータセットグループに追加します。データセットグループを使用して予測子を作成します。詳細については、「[データセットのインポート](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)」を参照してください。 すべてのデータセットのリストを取得するには、[ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html) オペレーションを使用します。 例えば、Forecast データセットについては、「[Amazon Forecast Sample GitHub repository](https://github.com/aws-samples/amazon-forecast-samples)」(Amazon Forecast のサンプル GitHubリポジトリ) を参照してください。 **注記** データセットの `Status` は、トレーニングデータをインポートする前に `ACTIVE` である必要があります。キーのステータスを確認するには、[DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) オペレーションを使用します。 ## リクエストの構文 ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーター リクエストは以下のデータを JSON 形式で受け入れます。 ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** データ収集の頻度。このパラメータは、RELATED\$1TIME\$1SERIES データセットに必須です。 有効な間隔は、整数の後に Y (年)、M (月)、W (週)、D (日)、H (時)、min (分) をつけたものです。例えば、「1D」は毎日を示し、「15min」は 15 分ごとを示します。次に多頻度で重複するような値は指定できません。つまり、たとえば 60 分の間隔は 1 時間に相当するため、指定することはできません。各頻度の有効な値は以下のとおりです。 + 分 - 1～59 + 時間 - 1～23 + 日 - 1～6 + 週 - 1～4 + 月 - 1～11 + 年 - 1 したがって、隔週の予測が必要な場合は、「2W」と指定します。または、四半期ごとの予測が必要な場合は、「3M」と指定します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 5 です。 パターン: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` 必須: いいえ ** [DatasetName](#API_CreateDataset_RequestSyntax) ** データセットの名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 63 です。 パターン: `^[a-zA-Z][a-zA-Z0-9_]*` 必須: はい ** [DatasetType](#API_CreateDataset_RequestSyntax) ** データセットのタイプ。有効な値は、選択した `Domain` によって異なります。 型: 文字列 有効な値：`TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` 必須: はい ** [Domain](#API_CreateDataset_RequestSyntax) ** データセットに関連付けられているドメイン。データセットをデータセットグループに追加する場合、この値と、[CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) オペレーションの `Domain` パラメータ用に指定された値は一致する必要があります。 `Domain` と `DatasetType` を選択すると、データセットにインポートするトレーニングデータに存在しなければならないフィールドが決まります。例えば、`RETAIL` ドメインを選択し、`DatasetType` として `TARGET_TIME_SERIES` を指定した場合、Amazon Forecast では、`item_id`、`timestamp`、および `demand` フィールドがデータに存在している必要があります。詳細については、「[データセットのインポート](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)」を参照してください。 型: 文字列 有効な値：`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 必須: はい ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Amazon Forecast がキーにアクセスするために引き受けることができる AWS Key Management Service (KMS) キーと AWS Identity and Access Management (IAM) ロール。 型: [EncryptionConfig](API_EncryptionConfig.md) オブジェクト 必須: いいえ ** [Schema](#API_CreateDataset_RequestSyntax) ** データセットのスキーマ。スキーマ属性とその順序は、データのフィールドと一致する必要があります。データセット `Domain` と選択した `DatasetType` によって、トレーニングデータの最小必須フィールドが決まります。特定のデータセットドメインとタイプの必須フィールドについては、「[データセットドメインとデータセットタイプ](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html)」を参照してください。 型: [Schema](API_Schema.md) オブジェクト 必須: はい ** [Tags](#API_CreateDataset_RequestSyntax) ** サービスに適用し、データセットの分類と整理に役立つオプションのメタデータ。各タグはキーとオプションの値で構成され、どちらもお客様側が定義します。 タグには以下のベーシックな制限があります。 + リソースあたりのタグの最大数は 50 です。 + タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。 + キーの最大長 - 128 文字 (Unicode) (UTF-8)。 + 値の最大長 - 256 文字 (Unicode) (UTF-8)。 + 複数の のサービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスにも許容される文字数に制限がある可能性があることに注意してください。一般的に使用が許可される文字は、UTF-8 で表現可能な文字、数字、スペース、および以下の文字です: \$1、-、=、.、\$1、:、/、@。 + タグのキーと値では、大文字と小文字が区別されます。 + `aws:`、`AWS:`、またはキーのプレフィックスなどの大文字または小文字の組み合わせは使用しないでください。 AWS 使用のために予約されています。このプレフィックスが含まれるタグキーを編集したり削除することはできません。値にはこのプレフィックスを付けることができます。タグ値には `aws` がプレフィックスとして付されているが、キーには付されていない場合、Forecast は、それをユーザータグとみなし、タグ数の上限である 50 個を計算する際に算入します。`aws` のキープレフィックスのみを持つタグは、リソース制限あたりのタグに算入されません。 型: [Tag](API_Tag.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 必須: いいえ ## レスポンスの構文 ``` { "DatasetArn": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** データセットの Amazon リソースネーム (ARN)。 タイプ: 文字列 長さの制約: 最大長は 256 です。 パターン: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## エラー ** InvalidInputException ** 無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。 HTTP ステータスコード: 400 ** LimitExceededException ** アカウントあたりのリソース数の制限を超えました。 HTTP ステータスコード: 400 ** ResourceAlreadyExistsException ** この名前のリソースは既に存在します。別の名前で再試行してください。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDataset) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset)