本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateSolutionVersion
训练或重新训练自定义数据集组中的活动解决方案。解决方案是使用CreateSolution操作创建的,并且在调用之前必须处于 ACTIVE 状态CreateSolutionVersion
。每当您调用此操作时,就会创建一个新版本的解决方案。
状态
解决方案版本可以处于下列状态之一:
-
CREATE PENDING
-
CREATE IN_PROGRESS
-
ACTIVE
-
CREATE FAILED
-
CREATE STOPPING
-
CREATE STOPPED
要获取版本的状态,请致电DescribeSolutionVersion。等到状态显示为 ACTIVE 后,再调用 CreateCampaign
。
如果状态显示为 CREATE FAILED,则响应中包含一个描述作业失败原因的 failureReason
键。
相关 API
请求语法
{
"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:.*:.*:.+
必需:是
-
要应用于解决方案版本的标签列表。
类型:Tag 对象数组
数组成员:最少 0 个物品。最多 200 项。
必需:否
- trainingMode
-
创建解决方案版本时要执行的训练的范围。默认值为
FULL
。这将基于数据集组中数据集的全部训练数据,创建一个全新的模型。如果您使用 User-Personalization,则可以将训练模式指定为
UPDATE
。这会更新模型以考虑在建议中加入新物品。这并非全面的再训练。您仍然应该每周完成一次全面的再训练。如果您指定UPDATE
,则 Amazon Personalize 将停止解决方案版本的自动更新。要恢复更新,请创建一个将训练模式设置为FULL
的新解决方案,然后将其部署到市场活动中。有关自动更新的更多信息,请参阅自动更新。只有当您已经使用
FULL
选项根据输入解决方案创建了有效的解决方案版本,并且输入解决方案已通过 User-Personalization 食谱或旧版 HRNN-Coldstart 食谱进行训练时,才能使用UPDATE
选项。类型:字符串
有效值:
FULL | UPDATE | AUTOTRAIN
必需:否
响应语法
{
"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
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: