本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListForecastExportJobs
返回使用该CreateForecastExportJob操作创建的预测导出任务列表。对于每个预测导出任务,此操作会返回其 Amazon 资源名称的摘要,包括其 Amazon 资源名称 (ARN)。要检索完整的属性集,请将 ARN 与DescribeForecastExportJob操作一起使用。您可以使用Filter对象数组来筛选列表。
请求语法
{
"Filters": [
{
"Condition": "string
",
"Key": "string
",
"Value": "string
"
}
],
"MaxResults": number
,
"NextToken": "string
"
}
请求参数
请求接受采用 JSON 格式的以下数据。
- Filters
-
数组。对于每个过滤器,您需要提供条件和匹配语句。条件是
IS
或IS_NOT
,它指定是从列表中分别包括还是排除与该语句相匹配的预测导出任务。match 中包含一个键和一个值。筛选器属性
-
Condition
-申请条件。有效值为IS
和IS_NOT
。要包括与声明相匹配的预测导出任务,请指定IS
。要排除匹配的预测导出任务,请指定IS_NOT
。 -
Key
-要筛选的参数的名称。有效值为ForecastArn
和Status
。 -
Value
-要匹配的值。
例如,要列出所有导出名为 E lectricityforecase 的预测的任务,请指定以下筛选条件:
"Filters": [ { "Condition": "IS", "Key": "ForecastArn", "Value": "arn:aws:forecast:us-west-2:<acct-id>:forecast/electricityforecast" } ]
类型:Filter 对象数组
必需:否
-
- MaxResults
-
要在响应中返回的项目数量。
类型:整数
有效范围:最小值为 1。最大值为 100。
必需:否
- NextToken
-
如果先前请求的结果被截断,则响应将包含
NextToken
。要检索下一组结果,请在下一个请求中使用令牌。令牌在 24 小时。类型:字符串
长度限制:最小长度为 1。最大长度为 3000。
模式:
.+
必需:否
响应语法
{
"ForecastExportJobs": [
{
"CreationTime": number,
"Destination": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"ForecastExportJobArn": "string",
"ForecastExportJobName": "string",
"LastModificationTime": number,
"Message": "string",
"Status": "string"
}
],
"NextToken": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- ForecastExportJobs
-
汇总每个导出任务属性的对象数组。
类型:ForecastExportJobSummary 对象数组
- NextToken
-
如果响应被截断,Amazon Forecast 会返回此令牌。要检索下一组结果,请在下一个请求中使用令牌。
类型:字符串
长度限制:最小长度为 1。最大长度为 3000。
模式:
.+
错误
- InvalidInputException
-
我们无法处理该请求,因为它包含无效值或超出有效范围的值。
HTTP 状态代码:400
- InvalidNextTokenException
-
令牌无效。令牌在 24 小时。
HTTP 状态代码:400
另请参阅
有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: