CreateWhatIfAnalysis - Amazon Forecast

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

CreateWhatIfAnalysis

假设分析是一种情景建模技术,您可以对时间序列进行假设更改,并将这些更改生成的预测与基准、未更改的时间序列进行比较。重要的是要记住,假设分析的目的是了解在对基准时间序列进行不同修改的情况下,预测会如何变化。

例如,假设您是一家服装零售商,正在考虑季末促销,为新款式腾出空间。创建基准预测后,您可以使用假设分析来调查不同的销售策略可能如何影响您的目标。

您可以创建一个场景,让所有商品都降价 25%,而另一个场景是所有商品都给予固定金额的降价。您可以创建一个场景,让销售持续一周,而另一个场景是让销售持续一个月。通过假设分析,您可以对许多不同的场景进行相互比较。

请注意,假设分析旨在显示预测模型已了解的内容,以及它在您正在评估的场景中的行为方式。不要盲目使用假设分析的结果来做出业务决策。例如,在没有可用参考来确定预测是否准确的新场景中,预测可能不准确。

TimeSeriesSelector 对象定义了您想要在假设分析中使用的项目。

注意

您的数据必须采用逗号分隔值(CSV)格式,以创建假设分析。

请求语法

{ "ForecastArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } }, "WhatIfAnalysisName": "string" }

请求参数

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

ForecastArn

基准预测的 Amazon 资源名称(ARN)。

类型:字符串

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

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

必需:是

Tags

适用于假设分析预测的标签列表。

类型:Tag 对象数组

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

必需:否

TimeSeriesSelector

定义在对 TimeSeriesIdentifiers 对象进行假设分析时使用的一组时间序列。假设分析仅针对此对象中的时间序列执行。

TimeSeriesIdentifiers 对象需要具备以下信息:

  • DataSource

  • Format

  • Schema

类型:TimeSeriesSelector 对象

必需:否

WhatIfAnalysisName

假设分析的名称。各名称必须唯一。

类型:字符串

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

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

必需:是

响应语法

{ "WhatIfAnalysisArn": "string" }

响应元素

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

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

WhatIfAnalysisArn

假设分析的 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

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: