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

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

CreateDatasetGroup

创建空数据集组。数据集组是 Amazon Persate(个性化)资源的容器。数据集组最多可以包含三个数据集,每种数据集类型对应一种:

  • 交互

  • 项目

  • 用户

数据集组可以是域数据集组,您可以在其中指定域并使用预配置的资源(如推荐者),也可以是自定义数据集组,您可以在其中使用自定义资源(例如具有解决方案版本的解决方案)与营销活动一起部署的自定义数据集组。如果您从域数据集组开始,您仍可以添加自定义资源,例如经过自定义使用案例配方训练并与营销活动一起部署的解决方案和解决方案版本。

数据集组可以处于以下状态之一:

  • 创建待处理 > 创建进度 > 活动-或-创建失败

  • 删除 PENDING

要获取数据集组的状态,请调用DescribeDatasetGroup. 如果状态显示为 CREATE Failed,响应将包括failureReasonkey,它描述了创建失败的原因。

注意

你必须等到status的数据集组是ACTIVE在向组中添加数据集之前。

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

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

请求语法

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

请求参数

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

domain

数据集组的域。指定域以创建域数据集组。您指定的域决定了数据集的默认模式以及推荐者可用的使用案例。如果不指定域,则可以创建一个自定义数据集组,其中包含与营销活动一起部署的解决方案版本。

类型: 字符串

有效值: ECOMMERCE | VIDEO_ON_DEMAND

:必需 否

kmsKeyArn

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

类型: 字符串

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

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

:必需 否

name

新数据集组的名称。

类型: 字符串

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

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

:必需 是

roleArn

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

类型: 字符串

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

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

:必需 否

响应语法

{ "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

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: