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

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

CreateDataset

创建一个空数据集并将其添加到指定的数据集组。使用 CreateDatasetImportJob 将您的训练数据导入数据集。

有 5 种类型的数据集:

  • 物品交互

  • 物品

  • 用户

  • 操作交互

  • 操作

每个数据集类型都有一个与所需字段类型关联的架构。训练模型(也称为创建解决方案)只需要 Item interactions 数据集。

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

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

  • DELETE PENDING > DELETE IN_PROGRESS

要获取数据集的状态,请调用 DescribeDataset

请求语法

{ "datasetGroupArn": "string", "datasetType": "string", "name": "string", "schemaArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

请求参数

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

datasetGroupArn

要添加到数据集的数据集组的 Amazon 资源名称 (ARN)。

类型:字符串

长度限制:最大长度为 256。

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

必需:是

datasetType

数据集的类型。

以下一个值(区分大小写):

  • 交互

  • 物品

  • 用户

  • 操作

  • Action_Interactions

类型:字符串

长度限制:最大长度为 256。

必需:是

name

数据集的名称。

类型:字符串

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

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

必需:是

schemaArn

与数据集关联的架构的 ARN。架构定义数据集字段。

类型:字符串

长度限制:最大长度为 256。

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

必需:是

tags

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

类型:Tag 对象数组

数组成员:最少 0 个物品。最多 200 个物品。

必需:否

响应语法

{ "datasetArn": "string" }

响应元素

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

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

datasetArn

数据集的 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

另请参阅

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