创建数据集 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=CreateDataset&groupName=%E6%95%B0%E6%8D%AE%E9%9B%86%E7%AE%A1%E7%90%86&serviceCode=las&version=2025-08-15) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **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` 数据集描述 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **DatasetName** string `示例值：my_image_dataset_001` 数据集名称 ## 请求示例 ```text 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" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20251127115843208067209247E0C5D8", "Action": "CreateDataset", "Version": "2025-08-15", "Service": "las", "Region": "cn-beijing" }, "Result": { "DatasetName": "my_image_dataset_001" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |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. |由于未知错误，请求失败。 |

AI 数据湖服务