选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

DescribePredictor - Amazon Forecast

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

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

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

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

DescribePredictor

注意

此操作仅对使用 CreatePredictor创建的传统预测变量有效。如果您没有使用传统预测器,请使用 DescribeAutoPredictor

描述使用 CreatePredictor 操作创建的预测器。

重要

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

除了列出 CreatePredictor 请求中提供的属性外,该操作还列出了以下属性:

  • DatasetImportJobArns - 用于导入训练数据的数据集导入作业。

  • AutoMLAlgorithmArns - 如果执行了 AutoML,则为已评估的算法。

  • CreationTime

  • LastModificationTime

  • Status

  • Message - 如果出现错误,则为错误相关的信息。

请求语法

{ "PredictorArn": "string" }

请求参数

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

PredictorArn

您想要了解的预测变量的 Amazon 资源名称 (ARN)。

类型:字符串

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

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

必需:是

响应语法

{ "AlgorithmArn": "string", "AutoMLAlgorithmArns": [ "string" ], "AutoMLOverrideStrategy": "string", "CreationTime": number, "DatasetImportJobArns": [ "string" ], "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "EstimatedTimeRemainingInMinutes": number, "EvaluationParameters": { "BackTestWindowOffset": number, "NumberOfBacktestWindows": number }, "FeaturizationConfig": { "Featurizations": [ { "AttributeName": "string", "FeaturizationPipeline": [ { "FeaturizationMethodName": "string", "FeaturizationMethodParameters": { "string" : "string" } } ] } ], "ForecastDimensions": [ "string" ], "ForecastFrequency": "string" }, "ForecastHorizon": number, "ForecastTypes": [ "string" ], "HPOConfig": { "ParameterRanges": { "CategoricalParameterRanges": [ { "Name": "string", "Values": [ "string" ] } ], "ContinuousParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ], "IntegerParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ] } }, "InputDataConfig": { "DatasetGroupArn": "string", "SupplementaryFeatures": [ { "Name": "string", "Value": "string" } ] }, "IsAutoPredictor": boolean, "LastModificationTime": number, "Message": "string", "OptimizationMetric": "string", "PerformAutoML": boolean, "PerformHPO": boolean, "PredictorArn": "string", "PredictorExecutionDetails": { "PredictorExecutions": [ { "AlgorithmArn": "string", "TestWindows": [ { "Message": "string", "Status": "string", "TestWindowEnd": number, "TestWindowStart": number } ] } ] }, "PredictorName": "string", "Status": "string", "TrainingParameters": { "string" : "string" } }

响应元素

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

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

AlgorithmArn

用于模型训练的算法的 Amazon 资源名称 (ARN)。

类型:字符串

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

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

AutoMLAlgorithmArns

如果指定,PerformAutoML则为ARN所选算法的。

类型:字符串数组

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

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

AutoMLOverrideStrategy
注意

LatencyOptimized AutoML 覆盖策略仅在私有测试版中可用。请联系 Su AWS pport 或您的客户经理,详细了解访问权限。

用于训练预测器的 AutoML 策略。除非指定 LatencyOptimized,否则 AutoML 策略会优化预测器的准确性。

此参数仅对使用 AutoML 训练的预测器有效。

类型:字符串

有效值:LatencyOptimized | AccuracyOptimized

CreationTime

创建模型训练任务的时间。

类型:时间戳

DatasetImportJobArns

用于为预测器导入训练数据的数据集导入任务的数组。ARNs

类型:字符串数组

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

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

EncryptionConfig

一个 AWS Key Management Service (KMS) 密钥和 AWS Identity and Access Management (IAM) 角色,Amazon Forecast 可以代入该密钥访问该密钥。

类型:EncryptionConfig 对象

EstimatedTimeRemainingInMinutes

完成预测器训练作业的估计剩余时间(分钟)。

类型:长整型

EvaluationParameters

用于覆盖指定算法的默认评估参数。Amazon Forecast 通过将数据集拆分为训练数据和测试数据来评估预测器。评估参数定义了如何执行拆分和迭代次数。

类型:EvaluationParameters 对象

FeaturizationConfig

特征化配置。

类型:FeaturizationConfig 对象

ForecastHorizon

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

类型:整数

ForecastTypes

预测器训练期间使用的预测类型。默认值为 ["0.1","0.5","0.9"]

类型:字符串数组

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

长度限制:最小长度为 2。最大长度为 4。

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

HPOConfig

超参数覆盖算法的值。

类型:HyperParameterTuningJobConfig 对象

InputDataConfig

描述包含要用于训练预测器的数据的数据集组。

类型:InputDataConfig 对象

IsAutoPredictor

预测器是否通过 CreateAutoPredictor 创建。

类型:布尔值

LastModificationTime

上次修改资源的时间。时间戳取决于作业的状态:

  • CREATE_PENDING - CreationTime

  • CREATE_IN_PROGRESS - 当前时间戳。

  • CREATE_STOPPING - 当前时间戳。

  • CREATE_STOPPED - 当作业停止时。

  • ACTIVE 或者 CREATE_FAILED - 当作业完成或失败时。

类型:时间戳

Message

如果出现错误,则为错误的信息消息。

类型:字符串

OptimizationMetric

用于优化预测器的准确性指标。

类型:字符串

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

PerformAutoML

预测器是否设置为执行 AutoML。

类型:布尔值

PerformHPO

预测变量是否设置为执行超参数优化 () HPO。

类型:布尔值

PredictorArn

预测变ARN量的。

类型:字符串

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

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

PredictorExecutionDetails

为评估预测器准确性而进行的回测的状态和结果详情。在调用 CreatePredictor 操作时,可以指定要执行的回测次数。

类型:PredictorExecutionDetails 对象

PredictorName

预测器的名称。

类型:字符串

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

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

Status

预测器的状态。状态包括:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

注意

在使用预测器创建预测之前,预测器的 Status 必须为 ACTIVE

类型:字符串

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

TrainingParameters

模型训练期间选择的默认训练参数或覆盖。运行 autoML 或HPO使用 CNN-QR 或 Deepar+ 进行选择时,将返回所选超参数的优化值。有关更多信息,请参阅 Amazon Forecast 算法

类型:字符串到字符串映射

映射条目:最低 0 项。最多 100 个项目。

密钥长度限制:最大长度为 256。

键模式:^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$

值长度限制:最大长度为 256。

值模式:^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$

错误

InvalidInputException

我们无法处理该请求,因为其包含无效值或超出有效范围的值。

HTTP状态码:400

ResourceNotFoundException

我们找不到带有该 Amazon 资源名称的资源 (ARN)。请检查ARN并重试。

HTTP状态码:400

另请参阅

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

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。