CreatePredictor - Amazon Forecast
リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

Amazon Forecast は、新規顧客では利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

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

CreatePredictor

注記

このオペレーションにより、Amazon Forecast が提供するすべての予測子機能が含まれていないレガシー予測子が作成されます。Forecast のすべての側面と互換性のある予測子を作成するには、CreateAutoPredictor を使用します。

Amazon Forecast 予測子を作成します。

重要

Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

リクエストで、データセットグループを指定し、アルゴリズムを指定するか、AutoML を使用して Amazon Forecast にアルゴリズムを選択させます。アルゴリズムを指定すると、アルゴリズム固有のハイパーパラメータを上書きすることもできます。

Amazon Forecast は、アルゴリズムを使用して、指定されたデータセットグループ内のデータセットの最新バージョンを使用して予測子をトレーニングします。その後、CreateForecast オペレーションを使用して予測を生成できます。

評価メトリクスを表示するには、GetAccuracyMetrics オペレーションを使用します。

モデルトレーニングを改善するために、TARGET_TIME_SERIES データセットのデータフィールドに入力して集計する特徴量化の設定を指定できます。詳細については、「FeaturizationConfig」を参照してください。

RELATED_TIME_SERIES データセットの場合、 CreatePredictor はデータセットの作成時にDataFrequency指定された が と一致することを確認しますForecastFrequency。TARGET_TIME_SERIES データセットにはこの制限はありません。Amazon Forecast は、区切り文字とタイムスタンプの形式も検証します。詳細については、「データセットのインポート」を参照してください。

デフォルトでは、予測子は 0.1 (P10)、0.5 (P50)、および 0.9 (P90) 分位数でトレーニングおよび評価されます。ForecastTypes を設定することにより、予測子をトレーニングおよび評価するためのカスタム予測タイプを選択できます。

AutoML

Amazon Forecast で各アルゴリズムを評価し、objective function を最小化するアルゴリズムを選択する場合は、PerformAutoML を true に設定します。objective function は、予測タイプに対する重み付けされた損失の平均として定義されます。デフォルトでは、これらは p10、p50、および p90 分位数のロスです。詳細については、「EvaluationResult」を参照してください。

AutoML が有効になっている場合、次のプロパティは許可されません。

  • AlgorithmArn

  • HPOConfig

  • PerformHPO

  • TrainingParameters

すべての予測子のリストを取得するには、ListPredictors オペレーションを使用します。

注記

予測子を使用して予測を作成する前に、予測子の Status が ACTIVE になっている必要があります。これは、トレーニングが完了したことを意味します。DescribePredictor オペレーションを使用して、ステータスを取得します。

リクエストの構文

{
   "AlgorithmArn": "string",
   "AutoMLOverrideStrategy": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "EvaluationParameters": { 
      "BackTestWindowOffset": number,
      "NumberOfBacktestWindows": number
   },
   "FeaturizationConfig": { 
      "Featurizations": [ 
         { 
            "AttributeName": "string",
            "FeaturizationPipeline": [ 
               { 
                  "FeaturizationMethodName": "string",
                  "FeaturizationMethodParameters": { 
                     "string" : "string" 
                  }
               }
            ]
         }
      ],
      "ForecastDimensions": [ "string" ],
      "ForecastFrequency": "string"
   },
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "HPOConfig": { 
      "ParameterRanges": { 
         "CategoricalParameterRanges": [ 
            { 
               "Name": "string",
               "Values": [ "string" ]
            }
         ],
         "ContinuousParameterRanges": [ 
            { 
               "MaxValue": number,
               "MinValue": number,
               "Name": "string",
               "ScalingType": "string"
            }
         ],
         "IntegerParameterRanges": [ 
            { 
               "MaxValue": number,
               "MinValue": number,
               "Name": "string",
               "ScalingType": "string"
            }
         ]
      }
   },
   "InputDataConfig": { 
      "DatasetGroupArn": "string",
      "SupplementaryFeatures": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ]
   },
   "OptimizationMetric": "string",
   "PerformAutoML": boolean,
   "PerformHPO": boolean,
   "PredictorName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TrainingParameters": { 
      "string" : "string" 
   }
}

リクエストパラメータ

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

AlgorithmArn

モデルトレーニングに使用するアルゴリズムの Amazon リソースネーム (ARN）。PerformAutoML が true に設定されていない場合は必須です。

サポートされているアルゴリズム:

  • arn:aws:forecast:::algorithm/ARIMA

  • arn:aws:forecast:::algorithm/CNN-QR

  • arn:aws:forecast:::algorithm/Deep_AR_Plus

  • arn:aws:forecast:::algorithm/ETS

  • arn:aws:forecast:::algorithm/NPTS

  • arn:aws:forecast:::algorithm/Prophet

型: 文字列

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

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

必須: いいえ

AutoMLOverrideStrategy
注記

LatencyOptimized AutoML 上書き戦略は、プライベートベータでのみ使用できます。アクセス権限の詳細については、 AWS サポートまたはアカウントマネージャーにお問い合わせください。

デフォルトの AutoML 戦略を上書きするために使用されます。これは、予測子の精度を最適化するために行われます。トレーニング時間を最小限に抑える AutoML 戦略を適用するには、LatencyOptimized を使用します。

このパラメータは、AutoML を使用してトレーニングした予測子についてのみ有効です。

型: 文字列

有効な値: LatencyOptimized | AccuracyOptimized

必須：いいえ

EncryptionConfig

Amazon Forecast がキーにアクセスするために引き受けることができる AWS Key Management Service （KMS) キーと AWS Identity and Access Management （IAM) ロール。

型: EncryptionConfig オブジェクト

必須：いいえ

EvaluationParameters

指定されたアルゴリズムのデフォルトの評価パラメータを上書きするために使用されます。Amazon Forecast は、データセットをトレーニングデータとテストデータに分割することで予測子を評価します。評価パラメータは、分割の実行方法と反復回数を定義します。

型: EvaluationParameters オブジェクト

必須：いいえ

FeaturizationConfig

特徴量化の設定。

型: FeaturizationConfig オブジェクト

必須：はい

ForecastHorizon

モデルが予測するようにトレーニングされている時間ステップの数を指定します。予測期間は予測長とも呼ばれます。

例えば、(CreateDataset オペレーションの DataFrequency パラメータを使用して) 毎日のデータ収集用にデータセットを設定し、予測期間を 10 に設定すると、モデルは 10 日間の予測を返します。

最大予測期間は、500 タイムステップまたは TARGET_TIME_SERIES データセットの長さの 1/3 のいずれか小さい方です。

型: 整数

必須：はい

ForecastTypes

予測子のトレーニングに使用される予測タイプを指定します。最大 5 つの予測タイプを指定できます。予測タイプは、0.01 以上の増分で 0.01 から 0.99 までの分位数にすることができます。mean で平均予測を指定することもできます。

デフォルト値は ["0.10", "0.50", "0.9"] です。

型: 文字列の配列

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

長さの制限: 最小長は 2 です。最大長は 4 です。

パターン: (^0?\.\d\d?$|^mean$)

必須: いいえ

HPOConfig

アルゴリズム用にハイパーパラメータの上書き値を提供します。このパラメータを指定しない場合、Amazon Forecast はデフォルト値を使用します。個々のアルゴリズムは、ハイパーパラメータの最適化 () をサポートするハイパーパラメータを指定しますHPO。詳細については、「Amazon Forecast アルゴリズム」を参照してください。

HPOConfig オブジェクトを含めた場合は、PerformHPO を true に設定する必要があります。

型: HyperParameterTuningJobConfig オブジェクト

必須：いいえ

InputDataConfig

予測子のトレーニングに使用するデータを含むデータセットグループを記述します。

型: InputDataConfig オブジェクト

必須：はい

OptimizationMetric

予測子を最適化するために使用される精度メトリクス。デフォルト値は AverageWeightedQuantileLoss です。

型: 文字列

有効な値: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

必須：いいえ

PerformAutoML

AutoML を実行するかどうか。Amazon Forecast が AutoML を実行すると、提供するアルゴリズムが評価され、トレーニングデータセットに最適なアルゴリズムと設定が選択されます。

デフォルト値は false です。この場合、アルゴリズムを指定する必要があります。

Amazon Forecast が AutoML を実行するように PerformAutoML を true に設定します。これは、トレーニングデータに適したアルゴリズムがわからない場合に適したオプションです。この場合、PerformHPO は false である必要があります。

型: ブール値

必須：いいえ

PerformHPO

ハイパーパラメータ最適化を実行するかどうか (HPO）。HPO は、トレーニングデータに最適なハイパーパラメータ値を見つけます。を実行するプロセスはHPO、ハイパーパラメータ調整ジョブの実行と呼ばれます。

デフォルト値は false です。この場合、Amazon Forecast は、選択したアルゴリズムのデフォルトのハイパーパラメータ値を使用します。

デフォルト値を上書きするには、PerformHPO を true に設定し、オプションで HyperParameterTuningJobConfig オブジェクトを指定します。チューニングジョブは、最適化するメトリクス、チューニングに関係するハイパーパラメータ、およびチューニング可能な各ハイパーパラメータの有効範囲を指定します。この場合、アルゴリズムを指定する必要があり、PerformAutoML は false である必要があります。

次のアルゴリズムは をサポートしますHPO。

  • DeepAR+

  • CNN-QR

型: ブール値

必須：いいえ

PredictorName

予測子の名前。

型: 文字列

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

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

必須：はい

Tags

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

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

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

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

  • 最大キー長 - -8 で 12UTF8 Unicode 文字。

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

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

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

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

型: Tag オブジェクトの配列

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

必須：いいえ

TrainingParameters

モデルトレーニングのために上書きするハイパーパラメータ。上書きできるハイパーパラメータは、個々のアルゴリズムにリストされています。サポートされているアルゴリズムのリストについては、「Amazon Forecast アルゴリズム」を参照してください。

型: 文字列間のマッピング

マップエントリ: 最小数は 0 項目です。最大数は 100 項目です。

キーの長さの制限: 最大長は 256 です。

キーパターン: ^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$

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

値のパターン: ^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$

必須：いいえ

レスポンスの構文

{
   "PredictorArn": "string"
}

レスポンス要素

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

次のデータは、 サービスによって JSON 形式で返されます。

PredictorArn

予測子の 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

以下の資料も参照してください。

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