本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateDatasetGroup
创建空数据集组。数据集组是存放 Amazon Personalize 资源的容器。一个数据集组最多可以包含三个数据集，其中每个对应一种数据集：
-
物品交互
-
物品
-
用户
-
操作
-
操作交互
数据集组可以是域数据集组，您可以在其中指定域并使用诸如推荐器之类的预配置资源，也可以是自定义数据集组，在其中使用通过市场活动部署的自定义资源，例如带有解决方案版本的解决方案。如果您从域数据集组开始，则仍然可以添加自定义资源，例如解决方案和解决方案版本，这些版本使用自定义使用案例配方进行训练，并通过市场活动部署。
数据集组可处于以下几种状态之一：
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED
-
DELETE PENDING
要获取数据集组的状态，请调用 DescribeDatasetGroup。如果状态显示为 CREATE FAILED，则响应中包含一个描述创建失败原因的 failureReason 键。
注意
必须等到数据集组的 status 为 ACTIVE，然后才能向该组添加数据集。
您可以指定 Amazon Key Management Service (KMS) 密钥来加密组中的数据集。如果您指定 KMS 密钥，则还必须包括有权访问该密钥的 Amazon Identity and Access Management (IAM) 角色。
请求中需要数据集组 ARN 的 API
请求语法
{
"domain": "string",
"kmsKeyArn": "string",
"name": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}请求参数
请求接受采用 JSON 格式的以下数据。
- domain
-
数据集组的域。要创建域数据集组，请指定域。您指定的域决定了数据集的默认架构和推荐器可用的使用案例。如果您未指定域，则可以创建一个自定义数据集组，其中包含您通过市场活动部署的解决方案版本。
类型：字符串
有效值：
ECOMMERCE | VIDEO_ON_DEMAND必需：否
- kmsKeyArn
-
用于加密数据集的 Amazon Key Management Service (KMS) 密钥的 Amazon 资源名称 (ARN)。
类型：字符串
长度限制：最大长度为 2048。
模式：
arn:aws.*:kms:.*:[0-9]{12}:key/.*必需：否
- name
-
新数据集组的名称。
类型：字符串
长度限制：最小长度为 1。最大长度为 63。
模式：
^[a-zA-Z0-9][a-zA-Z0-9\-_]*必需：是
- roleArn
-
有权访问 Amazon Key Management Service (KMS) 密钥的 Amazon Identity and Access Management (IAM) 角色的 ARN。仅当同时指定 KMS 密钥时，提供 IAM 角色才有效。
类型：字符串
长度限制：最大长度为 256。
模式：
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+必需：否
-
要应用于数据集组的标签列表。
类型：Tag 对象数组
数组成员：最少 0 个物品。最多 200 个物品。
必需：否
响应语法
{
"datasetGroupArn": "string",
"domain": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- datasetGroupArn
-
新数据集组的 Amazon 资源名称 (ARN)。
类型：字符串
长度限制：最大长度为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+ - domain
-
新域数据集组的域。
类型：字符串
有效值：
ECOMMERCE | VIDEO_ON_DEMAND
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码：400
- LimitExceededException
-
超出每秒请求次数的限制。
HTTP 状态代码：400
- ResourceAlreadyExistsException
-
指定资源已经存在。
HTTP 状态代码：400
- TooManyTagsException
-
您已超出您可以应用到此资源的最大标签数量。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：