本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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:.*:.*:.+
必需:是
-
要应用于数据集的标签列表。
类型: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
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: