Amazon Forecast は、新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetAccuracyMetrics
CreatePredictor オペレーションによってトレーニングされたモデルの精度に関するメトリクスを提供します。メトリクスを使用して、モデルのパフォーマンスを確認し、予測子を使用して予測を生成するかどうかを決定します。詳細については、「Predictor Metrics」(予測子メトリクス) を参照してください。
重要
Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら
このオペレーションにより、評価された各バックテストウィンドウのメトリクスが生成されます。バックテストウィンドウの数 (NumberOfBacktestWindows
) は、EvaluationParameters オブジェクトを使用して指定されます。このオブジェクトは、オプションで CreatePredictor
リクエストに含まれます。NumberOfBacktestWindows
が指定されていない場合、番号はデフォルトで 1 になります。
filling
メソッドのパラメータは、どの項目がメトリクスに寄与するかを決定します。すべての項目が寄与するようにするには、zero
を指定します。評価対象の範囲内の完全なデータを持つ項目のみが寄与するようにするには、nan
を指定します。詳細については、「FeaturizationMethod」を参照してください。
注記
精度メトリクスを取得する前に、予測子の Status
が ACTIVE
になっている必要があります。これは、トレーニングが完了したことを意味します。DescribePredictor オペレーションを使用して、ステータスを取得します。
リクエストの構文
{
"PredictorArn": "string
"
}
リクエストパラメータ
リクエストは、 JSON形式の次のデータを受け入れます。
- PredictorArn
-
メトリクスを取得する予測子の Amazon リソースネーム (ARN)。
型: 文字列
長さの制限:最大長は 256 です。
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+
必須:はい
レスポンスの構文
{
"AutoMLOverrideStrategy": "string",
"IsAutoPredictor": boolean,
"OptimizationMetric": "string",
"PredictorEvaluationResults": [
{
"AlgorithmArn": "string",
"TestWindows": [
{
"EvaluationType": "string",
"ItemCount": number,
"Metrics": {
"AverageWeightedQuantileLoss": number,
"ErrorMetrics": [
{
"ForecastType": "string",
"MAPE": number,
"MASE": number,
"RMSE": number,
"WAPE": number
}
],
"RMSE": number,
"WeightedQuantileLosses": [
{
"LossValue": number,
"Quantile": number
}
]
},
"TestWindowEnd": number,
"TestWindowStart": number
}
]
}
]
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを返します。
次のデータは、 サービスによって JSON 形式で返されます。
- AutoMLOverrideStrategy
-
注記
LatencyOptimized
AutoML 上書き戦略は、プライベートベータでのみ使用できます。アクセス権限の詳細については、 AWS サポートまたはアカウントマネージャーにお問い合わせください。予測子のトレーニングに使用する AutoML 戦略。
LatencyOptimized
が指定されていない限り、AutoML 戦略は予測子の精度を最適化します。このパラメータは、AutoML を使用してトレーニングした予測子についてのみ有効です。
型: 文字列
有効な値:
LatencyOptimized | AccuracyOptimized
- IsAutoPredictor
-
予測子が CreateAutoPredictor を使用して作成されたかどうか。
型: ブール値
- OptimizationMetric
-
予測子を最適化するために使用される精度メトリクス。
型: 文字列
有効な値:
WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE
- PredictorEvaluationResults
-
予測子の評価から得られた結果の配列。
型: EvaluationResult オブジェクトの配列
エラー
- InvalidInputException
-
無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。
HTTP ステータスコード: 400
- ResourceInUseException
-
指定されたリソースは使用中です。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
Amazon リソースネーム () を持つリソースが見つかりませんARN。を確認してARN、もう一度試してください。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。