CreateDataset - 创建数据集--AI 数据湖服务-火山引擎

文档中心

立即注册

AI 数据湖服务

数据集管理

CreateDataset - 创建数据集

创建数据集

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	CreateDataset	要执行的操作，取值：CreateDataset。
Version	String	是	2025-08-15	API的版本，取值：2025-08-15。
ClientToken	String	否	uuid-xxxxxx	客户端token
Tags	Array of Object	否		tags
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信息
DatasetName	String	是	my_image_dataset_001	数据集名称
Description	String	否	A dataset containing 10,000 images for classification task	数据集描述

返回参数

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

参数	类型	示例值	描述
DatasetName	String	my_image_dataset_001	数据集名称

请求示例

POST /?Action=CreateDataset&Version=2025-08-15 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20251128T062817Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251128/cn-beijing/las/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "ClientToken": "uuid-xxxxxx",
  "Tags": [
    {
      "Key": "test_key",
      "Value": "test_value"
    }
  ],
  "Format": "Lance",
  "Storage": "TOS",
  "Category": "Common",
  "DataPath": "tos://my-bucket/image-dataset/",
  "Nickname": "MyImageDataset",
  "SourceType": "User",
  "CatalogInfo": {
    "TableName": "image_table",
    "SchemaName": "image_schema",
    "CatalogName": "las_catalog"
  },
  "DatasetName": "my_image_dataset_001",
  "Description": "A dataset containing 10,000 images for classification task"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20251127115843208067209247E0C5D8",
    "Action": "CreateDataset",
    "Version": "2025-08-15",
    "Service": "las",
    "Region": "cn-beijing"
  },
  "Result": {
    "DatasetName": "my_image_dataset_001"
  }
}

错误码

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

状态码	错误码	错误信息	说明
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	AccessDenied	Access Denied
500	InternalError	The request has failed due to an unknown error.	由于未知错误，请求失败。

最近更新时间：2025.12.25 16:57:29

这个页面对您有帮助吗？

有用

无用

AI 数据湖服务

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码