# 创建数据集标注版本
#### 功能介绍
创建数据集标注版本。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=CreateDatasetVersion)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/datasets/{dataset_id}/versions
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| dataset_id | 是    | String | 数据集ID。                                                                                           |
| project_id | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
#### 请求参数
表2请求Body参数 
| 参数                          | 是否必选 | 参数类型    | 描述                                                                                            |
|:---|:---|:---|:---|
| clear_hard_property         | 否    | Boolean | 是否清空难例属性。可选值如下： - true：清空难例属性（默认值） - false：不清空难例属性                                            |
| description                 | 否    | String  | 版本描述信息，默认为空，长度为0-256位，不能包含!\<\>=\&"'特殊字符。                                                     |
| export_images               | 否    | Boolean | 发布时是否导出图片到版本输出目录。可选值如下： - true：导出图片到版本输出目录 - false：不导出图片到版本输出目录（默认值）                          |
| remove_sample_usage         | 否    | Boolean | 发布时是否清除数据集已有的usage信息。可选值如下： - true：发布时清除数据集已有的usage信息（默认值） - false：发布时不清除数据集已有的usage信息        |
| train_evaluate_sample_ratio | 否    | String  | 发布版本时切分训练验证比例，默认为1.00，即全部分为训练集。                                                               |
| version_format              | 否    | String  | 数据集版本格式。可选值如下： - Default：默认格式 - CarbonData：Carbon格式（仅表格数据集支持） - CSV：CSV格式                     |
| version_name                | 否    | String  | 版本名称。                                                                                         |
| with_column_header          | 否    | Boolean | 发布时是否将列名写到CSV文件的第一行，对于表格数据集有效。可选值如下： - true：发布时将列名写到CSV文件的第一行（默认值） - false：发布时不将列名写到CSV文件的第一行 |
   
#### 响应参数
**状态码： 201**
表3响应Body参数 
| 参数         | 参数类型   | 描述       |
|:---|:---|:---|
| version_id | String | 数据集版本ID。 |
   
#### 请求示例
创建数据集标注版本。设置版本名称为"V004"，数据集版本格式为"Default"。
```
{
  "version_name" : "V004",
  "version_format" : "Default",
  "description" : "",
  "clear_hard_property" : true
}
```
#### 响应示例
**状态码： 201**
Created
```
{
  "version_id" : "sntOdOuB0D9C6fC4TXs"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 201 | Created      |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。