创建数据集

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：CreateDataset

要执行的操作，取值：CreateDataset。

Version string 必选示例值：2025-08-15

API的版本，取值：2025-08-15。

ClientToken string 可选示例值：uuid-xxxxxx

客户端token

Tags object[] 可选示例值：---

tags

Key string 可选示例值：test_key

标签键

Value string 可选示例值：test_value

标签值

Format string 必选示例值：Lance

数据集数据格式

Storage string 必选示例值：TOS

文件来源，TOS

Category string 可选示例值：Common

数据集分类

DataPath string 必选示例值：tos://my-bucket/image-dataset/

数据集资源路径

Nickname string 可选示例值：MyImageDataset

数据集昵称

SourceType string 可选示例值：User

数据集来源

CatalogInfo object 可选示例值：---

数据集catalog信息

TableName string 可选示例值：image_table

表名

SchemaName string 可选示例值：image_schema

数据库名

CatalogName string 可选示例值：las_catalog

目录名

DatasetName string 必选示例值：my_image_dataset_001

数据集名称

Description string 可选示例值：A dataset containing 10,000 images for classification task

数据集描述

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

DatasetName string 示例值：my_image_dataset_001

数据集名称

请求示例 1

返回示例 1

请求示例 2

返回示例 2

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The required parameter {} is missing.	缺少必需的参数 {}。
400	InvalidRequestParam	Invalid request param {}, cause {}	非法请求参数 {}, 原因 {}
400	DryRunOperation	The request is validated by a dryrun operation.	该请求通过 dryrun 操作进行验证。
400	InvalidParameter	The specified parameter {} is invalid.	指定的参数 {} 无效。
400	IllegalArgument	非法参数	非法参数
400	DatasetNameNotAllowed	The dataset name duplicates an existing example dataset. Please try a different name.	数据集名称与示例数据集重复，请尝试其他名称。
400	DatasetLocationEmpty	The catalog info is empty.	元数据存储-catalog为空。
400	DatasetTosBucketRegionMismatch	The TOS bucket must be in the same region.	tos 桶须与 las 服务位于同一地域。
400	DatasetTosBucketInvalid	The TOS bucket is invalid.	tos 桶无效。
400	DatasetUserNotBelongToAccount	The user does not belong to this account.	用户不属于该账号。
400	DatasetSampleLimitExceeded	The limit for datasets created from sample files has been reached.	通过示例文件创建的数据集数量已达上限。
400	AccessDenied	Access Denied
403	DatasetOperationNotAllowed	You are not authorized to perform this operation.	您无权进行此操作。
409	DatasetExists	The dataset English name {{datasetName}} already exists.	数据集英文名称 {{datasetName}} 已存在。
409	DatasetDuplicateCatalogError	The catalog is already associated with another dataset.	该 catalog 已与其他数据集关联。
500	InternalError	The request has failed due to an unknown error.	由于未知错误，请求失败。

AI 数据湖服务