CreateDatasetGroup - Amazon Personalize
请求语法请求参数响应语法响应元素错误另请参阅

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

CreateDatasetGroup

创建空数据集组。数据集组是存放 Amazon Personalize 资源的容器。一个数据集组最多可以包含三个数据集，其中每个对应一种数据集：

  • 物品交互

  • 物品

  • 用户

  • 操作

  • 操作交互

数据集组可以是域数据集组，您可以在其中指定域并使用诸如推荐器之类的预配置资源，也可以是自定义数据集组，在其中使用通过市场活动部署的自定义资源，例如带有解决方案版本的解决方案。如果您从域数据集组开始，则仍然可以添加自定义资源，例如解决方案和解决方案版本，这些版本使用自定义使用案例食谱进行训练，并通过市场活动部署。

数据集组可处于以下几种状态之一：

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED

  • DELETE PENDING

要获取数据集组的状态，请调用DescribeDatasetGroup。如果状态显示为 CREATE FAILED，则响应中包含一个描述创建失败原因的 failureReason 键。

注意

必须等到数据集组的 status 为 ACTIVE，然后才能向该组添加数据集。

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

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

请求语法

{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

请求参数

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

domain

数据集组的域。要创建域数据集组，请指定域。您指定的域决定了数据集的默认架构和推荐器可用的使用案例。如果您未指定域，则可以创建一个自定义数据集组，其中包含您通过市场活动部署的解决方案版本。

类型：字符串

有效值：ECOMMERCE | VIDEO_ON_DEMAND

必需：否

kmsKeyArn

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

类型：字符串

长度约束：最大长度为 2048。

模式：arn:aws.*:kms:.*:[0-9]{12}:key/.*

必需：否

name

新数据集组的名称。

类型：字符串

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

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

必需：是

roleArn

有权访问 (KMS) 密钥的 AWS Identity and Access Management (IAM) 角色的 AWS Key Management Service ARN。仅当同时指定 KMS 密钥时，提供 IAM 角色才有效。

类型：字符串

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

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

必需：否

tags

要应用于数据集组的标签列表。

类型：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

另请参阅

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