CreateForecastExportJob - Amazon Forecast

Amazon Forecast 不再向新买家开放。Amazon Forecast 的现有客户可以继续照常使用该服务。了解更多

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CreateForecastExportJob

CreateForecast 操作创建的预测导出到 Amazon Simple Storage Service(Amazon S3)存储桶中。预测文件名将符合以下惯例:

<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>

其中 < ExportTimestamp > 组件在 Java 中 SimpleDateFormat(yyyy-mm-dd-mm-THH ssz)。

重要

Amazon Forecast 不再向新买家开放。Amazon Forecast 的现有客户可以继续照常使用该服务。了解更多

您必须指定一个包含 AWS Identity and Access Management (IAM) 角色的DataDestination对象,Amazon Forecast 可以代入该角色来访问 Amazon S3 存储桶。有关更多信息,请参阅 为 Amazon Forecast 设置权限

有关更多信息,请参阅 生成预测

要获取所有预测导出作业的列表,请使用 ListForecastExportJobs 操作。

注意

预测导出作业的 Status 必须为 ACTIVE,然后才能访问 Amazon S3 存储桶中的预测。要获取此状态,请使用 DescribeForecastExportJob 操作。

请求语法

{ "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ForecastArn": "string", "ForecastExportJobName": "string", "Format": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

请求参数

该请求接受以下JSON格式的数据。

Destination

您要保存预测的位置,以及 Amazon Forecast 可以担任的访问该位置的 AWS Identity and Access Management (IAM) 角色。必须将预测导出到 Amazon S3 存储桶中。

如果使用加密,则Destination必须包含 AWS Key Management Service (KMS) 密钥。该IAM角色必须允许 Amazon Forecast 访问密钥的权限。

类型:DataDestination 对象

必需:是

ForecastArn

您要导出的预测的 Amazon 资源名称 (ARN)。

类型:字符串

长度约束:最大长度为 256。

模式:arn:([a-z\d-]+):forecast:.*:.*:.+

必需:是

ForecastExportJobName

预测导出作业的名称。

类型:字符串

长度限制:最小长度为 1。最大长度为 63。

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

必需:是

Format

导出数据的格式,CSV或PARQUET。默认值为CSV。

类型:字符串

长度限制:最大长度为 7。

模式:^CSV|PARQUET$

必需:否

Tags

您应用于预测导出作业以帮助您对其进行分类和组织的可选元数据。每个标签都包含定义的一个密钥和一个可选值。

下面是适用于标签的基本限制:

  • 每个资源的最大标签数 - 50。

  • 对于每个资源,每个标签键都必须是唯一的,每个标签键只能有一个值。

  • 最大密钥长度--8 中的 128 个 Unicode 字符。UTF

  • 最大值长度--8 中的 256 个 Unicode 字符。UTF

  • 如果标签方案针对多个服务和资源使用,请记得其它服务可能对允许使用的字符有限制。通常允许的字符有:可用 UTF -8 表示的字母、数字和空格,以及以下字符:+-=。_:/@。

  • 标签键和值区分大小写。

  • 请勿使用aws:AWS:、或任何大写或小写组合,例如密钥的前缀,因为它是保留供 AWS 使用的。不能编辑或删除带此前缀的标签键。值可以带有该前缀。如果标签值将 aws 作为其前缀,但键没有前缀,则 Forecast 会将其视为用户标签,并将计入 50 个标签的限制。仅具有 aws 的键前缀的标签不计入每个资源的标签数限制。

类型:Tag 对象数组

数组成员:最少 0 个物品。最多 200 项。

必需:否

响应语法

{ "ForecastExportJobArn": "string" }

响应元素

如果操作成功,服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

ForecastExportJobArn

导出任务的 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,请参阅以下内容: