CreateAutoPredictor - Amazon Forecast

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

CreateAutoPredictor

创建Amazon Forecast 指标。

Amazon Forecast 使用以下方法创建预测变量 AutoPredictor,这涉及将算法的最佳组合应用于数据集中的每个时间序列。您可以使用CreateAutoPredictor创建新的预测变量或升级/重新训练现有预测变量。

创建新预测变量

创建新的预测变为必需要以下参数为为为为为为必为必为必为必为必

  • PredictorName-预测变量的唯一名称。

  • DatasetGroupArn-用于训练预测变量的数据集组的 ARN。

  • ForecastFrequency-预测的精细度(每小时、每天、每周等)。

  • ForecastHorizon-模型预测的时间步长。预测范围也称为预测长度。

创建新预测变量时,请勿指定值ReferencePredictorArn.

升级和再训练预测变量

在重新训练或升级预测变量时,以下参数为为为为为为必为必为必为必为必为

  • PredictorName-预测变量的唯一名称。

  • ReferencePredictorArn-要重新训练或升级的预测变量的 ARN。

升级或重新训练预测变量时,仅为预测变量指定值ReferencePredictorArnPredictorName.

请求语法

{ "DataConfig": { "AdditionalDatasets": [ { "Configuration": { "string" : [ "string" ] }, "Name": "string" } ], "AttributeConfigs": [ { "AttributeName": "string", "Transformations": { "string" : "string" } } ], "DatasetGroupArn": "string" }, "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "ExplainPredictor": boolean, "ForecastDimensions": [ "string" ], "ForecastFrequency": "string", "ForecastHorizon": number, "ForecastTypes": [ "string" ], "MonitorConfig": { "MonitorName": "string" }, "OptimizationMetric": "string", "PredictorName": "string", "ReferencePredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeAlignmentBoundary": { "DayOfMonth": number, "DayOfWeek": "string", "Hour": number, "Month": "string" } }

请求参数

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

DataConfig

您的数据集组和任何其他数据集的数据配置。

类型:DataConfig 对象

必需:否

EncryptionConfig

AAmazon Forecast Forect 可以代入以访问该密钥的 AWS Idity Management (IAM) 角色为必需一一一AWS Management (IAM),AWS KS 您可以在CreateDatasetCreatePredictor请求。

类型:EncryptionConfig 对象

必需:否

ExplainPredictor

为预测变量创建可解释性资源。

类型: 布尔值

必需:否

ForecastDimensions

一个维度(字段)名称数组,用于指定如何对生成的预测进行分组。

例如,如果您要生成所有门店的商品销售预测,并且您的数据集包含store_id字段,你要指定store_id作为对每家商店的销售预测进行分组的维度。

类型: 字符串数组

数组成员:最少 1 项。最多 10 项。

长度约束:最小长度为 1。最大长度为 63。

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

必需:否

ForecastFrequency

预测中预测的频率。

有效间隔为整数后跟 Y(年)、M(月)、W(周)、D(天)、H(小时)和分钟(分钟)。例如,“1D” 表示每天,“15 分钟” 表示每 15 分钟一次。您不能指定与下一个较大频率重叠的值。这意味着,例如,您不能将频率指定为 60 分钟,因为这相当于 1 小时。每个频率的有效值如下所示:

  • 分钟-1-59

  • 小时-1-23

  • 第 1-6 天

  • 第 1-4 周

  • 月份-1-11

  • 年份-1

因此,如果您想每隔一周进行一次预测,请指定 “2W”。或者,如果您想要季度预测,则指定 “3M”。

该频率必须大于或等于 TARGET_TIME_SERIES 数据集的频率必须大于或等于或等于该

当提供 RELATED_TIME_SERIES 数据集时,频率必须等于 RELATED_TIME_SERIES 数据集的频率。

类型: 字符串

长度约束:最小长度为 1。长度上限为 5。

模式:^1Y|Y|([1-9]|1[0-1])M|M|[1-4]W|W|[1-6]D|D|([1-9]|1[0-9]|2[0-3])H|H|([1-9]|[1-5][0-9])min$

必需:否

ForecastHorizon

模型预测的时间步长。预测范围也称为预测长度。

最大预测范围是 500 个时间步长或 TARGET_TIME_SERIES 数据集长度的 1/4 中的较小值。如果你正在对现有的人进行再培训 AutoPredictor,则最大预测范围是 500 个时间步长或 TARGET_TIME_SERIES 数据集长度的 1/3 中的较小值。

如果您要升级到 AutoPredictor 或再培训现有 AutoPredictor,您无法更新预测展望参数。您可以通过在数据集中提供更长的时间序列来满足此要求。

类型: 整数

必需:否

ForecastTypes

用于训练预测变量的预测类型。您最多可以指定五种预测类型。Forecast 类型可以是从 0.01 到 0.99 的分位数,增量为 0.01 或更高。您也可以使用指定平均预测值mean.

类型: 字符串数组

数组成员:最少 1 项。最多 20 项。

长度约束:最小长度为 2。长度上限为 4。

模式:(^0?\.\d\d?$|^mean$)

必需:否

MonitorConfig

预测器监控的配置详细信息。为监视器资源提供名称以启用预测器监控。

Preditor Monity 可让您了解您的预测变量随着的时间的推移如何变化。有关更多信息,请参阅 。预测器监控.

类型:MonitorConfig 对象

必需:否

OptimizationMetric

用于优化预测变量的精度指标。

类型: 字符串

有效值: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

必需:否

PredictorName

预测变量的唯一名称

类型: 字符串

长度约束:最小长度为 1。最大长度为 63。

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

必需:是

ReferencePredictorArn

要重新训练或升级的预测变量的 ARN。此参数仅在重新训练或升级预测变量时使用。创建新的预测变量时,请勿为此参数指定值。

升级或重新训练预测变量时,仅为预测变量指定值ReferencePredictorArnPredictorName. 的值PredictorName必须是唯一的预测变量名称。

类型: 字符串

长度约束:长度上限为 256。

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

必需:否

Tags

可可帮助您对预测因子进行分类和组织,可可可可可帮助您对预测变量进行分类和组织 每个标签都包含您定义的一个键和一个可选值。标签键和值区分大小写。

以下限制适用于标签:

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

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

  • 最大密钥长度:采用 UTF-8 格式。

  • 最大值长度:采用 UTF-8 格式。

  • 可接受的字符:所有字母和数字为可用 UTF-8 表示的所有字母和数字为必需的全部字母和数字为必需为所有字母和数字为必需 _:/@。 如果您的标记方案针对其它服务和资源使用,则您的标记方案针对其它服务和资源使用,如果您的标记方案针对其它服务和资源使用,则您的标记方案也适用于您的标记方案。

  • 按键前缀不能包含以下的任何大写或小写组合aws:要么AWS:. 值可以有这个前缀。如果标签值有aws作为其前缀,但密钥不是,Forecast 将其视为用户标签,并将计入 50 个标签的限制。仅带有key prefix 的标签aws不要计入每个资源的标签数限制。您无法编辑或删除带此前缀的标签键。

类型: 数组Tag对象

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

必需:否

TimeAlignmentBoundary

Forecast 用于对齐和汇总任何与您的预测频率不一致的数据的时间界限。以键值对的形式提供时间单位和时间边界。有关指定时间界限的更多信息,请参阅指定时间边界. 如果您未提供时间界限,则 Forecast 使用一组默认时间边界.

类型:TimeAlignmentBoundary 对象

必需:否

响应语法

{ "PredictorArn": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

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

PredictorArn

预测变量的亚马逊资源名称 (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

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: