CreateSolutionVersion - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

CreateSolutionVersion

训练或重新训练自定义数据集组中的活动解决方案。解决方案是使用 CreateSolution 操作创建的,并且在调用 CreateSolutionVersion 之前必须处于 ACTIVE 状态。每当您调用此操作时,就会创建一个新版本的解决方案。

状态

解决方案版本可以处于下列状态之一:

  • CREATE PENDING

  • CREATE IN_PROGRESS

  • ACTIVE

  • CREATE FAILED

  • CREATE STOPPING

  • CREATE STOPPED

要获取版本的状态,请调用 DescribeSolutionVersion。等到状态显示为 ACTIVE 后,再调用 CreateCampaign

如果状态显示为 CREATE FAILED,则响应中包含一个描述作业失败原因的 failureReason 键。

请求语法

{ "name": "string", "solutionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ], "trainingMode": "string" }

请求参数

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

name

解决方案版本的名称。

类型:字符串

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

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

必需:否

solutionArn

包含训练配置信息的解决方案的 Amazon 资源名称 (ARN)。

类型:字符串

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

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

必需:是

tags

要应用于解决方案版本的标签列表。

类型:Tag 对象数组

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

必需:否

trainingMode

创建解决方案版本时要执行的训练的范围。默认为 FULL。这将基于数据集组中数据集的全部训练数据,创建一个全新的模型。

如果您使用 User-Personalization,则可以将训练模式指定为 UPDATE。这会更新模型以考虑在建议中加入新物品。这并非全面的再训练。您仍然应该每周完成一次全面的再训练。如果您指定 UPDATE,则 Amazon Personalize 将停止解决方案版本的自动更新。要恢复更新,请创建一个将训练模式设置为 FULL 的新解决方案,然后将其部署到市场活动中。有关自动更新的更多信息,请参阅自动更新

只有当您已经使用 FULL 选项根据输入解决方案创建了有效的解决方案版本,并且输入解决方案已通过 User-Personalization 配方或旧版 HRNN-Coldstart 配方进行训练时,才能使用 UPDATE 选项。

类型:字符串

有效值:FULL | UPDATE

必需:否

响应语法

{ "solutionVersionArn": "string" }

响应元素

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

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

solutionVersionArn

新解决方案版本的 ARN。

类型:字符串

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

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

错误

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码:400

LimitExceededException

超出每秒请求次数的限制。

HTTP 状态代码:400

ResourceAlreadyExistsException

指定资源已经存在。

HTTP 状态代码:400

ResourceInUseException

指定的资源正在使用中。

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码:400

TooManyTagsException

您已超出您可以应用到此资源的最大标签数量。

HTTP 状态代码:400

另请参阅

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