Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListForecasts
傳回使用 CreateForecast操作建立的預測清單。對於每個預測,此操作會傳回其屬性的摘要,包括其 Amazon Resource Name (ARN)。若要擷取完整的屬性集,請使用 DescribeForecast操作指定 ARN。您可以使用 Filter 物件陣列來篩選清單。
重要
Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
請求語法
{
"Filters": [
{
"Condition": "string
",
"Key": "string
",
"Value": "string
"
}
],
"MaxResults": number
,
"NextToken": "string
"
}
請求參數
請求接受採用 JSON 格式的下列資料。
- Filters
-
篩選條件陣列。對於每個篩選條件,您提供條件和相符陳述式。條件為
IS
或IS_NOT
,指定要分別包含或排除符合清單中陳述式的預測。比對陳述式包含金鑰和值。篩選條件屬性
-
Condition
- 要套用的條件。有效值為IS
和IS_NOT
。若要包含符合陳述式的預測,請指定IS
。若要排除相符預測,請指定IS_NOT
。 -
Key
- 要篩選的參數名稱。有效值為DatasetGroupArn
、PredictorArn
和Status
。 -
Value
- 要比對的值。
例如,若要列出狀態不是 ACTIVE 的所有預測,您可以指定:
"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]
類型:Filter 物件陣列
必要:否
-
- MaxResults
-
回應中要傳回的項目數量。
類型:整數
有效範圍:最小值為 1。最大值為 100。
必要:否
- NextToken
-
如果先前請求的結果遭到截斷,回應會包含
NextToken
。若要擷取下一組結果,請在下一個請求中使用權杖。權杖會在 24 小時後過期。類型:字串
長度限制:長度下限為 1。長度上限為 3000。
模式:
.+
必要:否
回應語法
{
"Forecasts": [
{
"CreatedUsingAutoPredictor": boolean,
"CreationTime": number,
"DatasetGroupArn": "string",
"ForecastArn": "string",
"ForecastName": "string",
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string"
}
],
"NextToken": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Forecasts
-
彙整每個預測屬性的物件陣列。
類型:ForecastSummary 物件陣列
- NextToken
-
如果回應被截斷,Amazon Forecast 會傳回此字符。若要擷取下一組結果,請在下一個請求中使用權杖。
類型:字串
長度限制:長度下限為 1。長度上限為 3000。
模式:
.+
錯誤
- InvalidInputException
-
我們無法處理請求,因為它包含無效值或超過有效範圍的值。
HTTP 狀態碼:400
- InvalidNextTokenException
-
字符無效。權杖會在 24 小時後過期。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: