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

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

CreateDatasetGroup

创建空数据集组。数据集组包含为训练模型提供数据的相关数据集。数据集组最多可以包含三个数据集,每种数据集类型一个:

  • 交互

  • 项目

  • 用户

要训练模型(创建解决方案),包含Interactions数据集是必需的。CallCreateDataset将数据集添加到组中。

数据集组可以处于以下某种状态:

  • “创建挂起” > “正在创建” > “活动” 或 “创建失败”

  • 删除待处理

要获取数据集组的状态,请调用DescribeDatasetGroup。如果状态显示为 CREATE FOREATE FOREATE FOREATEfailureReason键,它描述了创建失败的原因。

注意

您必须等到status数据集组的ACTIVE,然后再将数据集添加到组中。

您可以指定Amazon Key Management Service(KMS) 密钥来加密组中的数据集。如果指定 KMS 密钥,您还必须包含Amazon Identity and Access Management(IAM) 角色,该角色有权访问密钥。

请求中需要数据集组 ARN 的 API

请求语法

{ "kmsKeyArn": "string", "name": "string", "roleArn": "string" }

请求参数

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

KmsKeyArn

的 Amazon 资源名称 (ARN)Amazon Key Management Service(KMS) 密钥用于加密数据集。

类型: 字符串

:必需 否

name

新数据集组的名称。

类型: 字符串

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

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

:必需 是

roleArn

的 ARNAmazon Identity and Access Management(IAM) 角色,该角色有权访问Amazon Key Management Service(KMS) 密钥。提供 IAM 角色仅在同时指定 KMS 密钥时才有效。

类型: 字符串

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

模式:arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

:必需 否

响应语法

{ "datasetGroupArn": "string" }

响应元素

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

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

DatasetGroupArn

新数据集组的 Amazon 资源名称 (ARN)。

类型: 字符串

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

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

Errors

InvalidInputException

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

HTTP 状态代码:HTTP:HTTP:400

LimitExceededException

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

HTTP 状态代码:HTTP:HTTP:400

ResourceAlreadyExistsException

已存在指定的资源。

HTTP 状态代码:HTTP:HTTP:400