Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
QueryForecast
擷取單一項目的預測，依提供的條件篩選。
條件是鍵/值對。金鑰是TARGET_TIME_SERIES來自資料集的 item_id（或同等的非時間戳記、非目標欄位），或指定為FeaturizationConfig物件一部分的其中一個預測維度。
根據預設， 會QueryForecast傳回篩選預測的完整日期範圍。您可以請求特定的日期範圍。
若要取得完整預測，請使用 CreateForecastExportJob 操作。
注意
Amazon Forecast 產生的預測與用來建立預測器的資料集位於相同的時區。
請求語法
{
"EndDate": "string",
"Filters": {
"string" : "string"
},
"ForecastArn": "string",
"NextToken": "string",
"StartDate": "string"
}請求參數
請求接受採用 JSON 格式的下列資料。
- EndDate
-
預測的結束日期。使用此格式指定日期：yyyy-MM-dd'T'HH：mm：ss (ISO 8601 格式）。例如，2015-01-01T20：00：00。
類型：字串
必要：否
- Filters
-
擷取預測時要套用的篩選條件。例如，若要在電力用量資料集
client_21中取得 的預測，請指定下列項目：{"item_id" : "client_21"}若要取得完整預測，請使用 CreateForecastExportJob 操作。
類型：字串到字串映射
映射項目：最多 50 個項目。
金鑰長度限制：長度上限為 256。
金鑰模式：
^[a-zA-Z0-9\_\-]+$值長度限制：長度上限為 256。
必要：是
- ForecastArn
-
要查詢之預測的 Amazon Resource Name (ARN)。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):forecast:.*:.*:.+必要：是
- NextToken
-
如果先前請求的結果遭到截斷，回應會包含
NextToken。若要擷取下一組結果，請在下一個請求中使用權杖。權杖會在 24 小時後過期。類型：字串
長度限制：長度下限為 1。長度上限為 3000。
必要：否
- StartDate
-
預測的開始日期。使用此格式指定日期：yyyy-MM-dd'T'HH：mm：ss (ISO 8601 格式）。例如，2015-01-01T08：00：00。
類型：字串
必要：否
回應語法
{
"Forecast": {
"Predictions": {
"string" : [
{
"Timestamp": "string",
"Value": number
}
]
}
}
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
錯誤
- InvalidInputException
-
值無效或太長。
HTTP 狀態碼：400
- InvalidNextTokenException
-
字符無效。權杖會在 24 小時後過期。
HTTP 狀態碼：400
- LimitExceededException
-
已超過每秒請求數的限制。
HTTP 狀態碼：400
- ResourceInUseException
-
指定的資源正在使用中。
HTTP 狀態碼：400
- ResourceNotFoundException
-
我們找不到該資源。請檢查您提供的資訊，然後再試一次。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
