doc-exports/docs/modelarts/api-ref/CreateDatasetVersion.html

Creating a Dataset Labeling Version

Function

This API is used to create a dataset labeling version.

URI

POST /v2/{project_id}/datasets/{dataset_id}/versions

Table 1 Path Parameters

Parameter	Mandatory	Type	Description
dataset_id	Yes	String	Dataset ID.
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Request Parameters

Table 2 Request body parameters

Parameter	Mandatory	Type	Description
clear_hard_property	No	Boolean	Whether to clear hard example properties. The options are as follows: - true: Clear hard example properties. (Default value) - false: Do not clear hard example properties.
description	No	String	Version description. The value is empty by default. The description contains 0 to 256 characters and does not support the following special characters: !<>=&"'
export_images	No	Boolean	Whether to export images to the version output directory during release. The options are as follows: - true: Export images to the version output directory. - false: Do not export images to the version output directory. (Default value)
remove_sample_usage	No	Boolean	Whether to clear the existing usage information of a dataset during release. The options are as follows: - true: Clear the existing usage information of a dataset. (Default value) - false: Do not clear the existing usage information of a dataset.
train_evaluate_sample_ratio	No	String	Split training and verification ratio during version release. The default value is 1.00, indicating that all labeled samples are split into the training set.
version_format	No	String	Format of a dataset version. The options are as follows: - Default: default format - CarbonData: CarbonData (supported only by table datasets) - CSV: CSV
version_name	No	String	Version name. The value contains 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.
with_column_header	No	Boolean	Whether to write the column name in the first line of the CSV file during release. This field is valid for the table dataset. The options are as follows: - true: Write the column name in the first line of the CSV file. (Default value) - false: Do not write the column name in the first line of the CSV file.

Response Parameters

Status code: 201

Table 3 Response body parameters

Parameter	Type	Description
version_id	String	Dataset version ID.

Example Requests

Creating a Dataset Labeling Version

{
  "version_name" : "V004",
  "version_format" : "Default",
  "description" : "",
  "clear_hard_property" : true
}

Example Responses

Status code: 201

Created

{
  "version_id" : "sntOdOuB0D9C6fC4TXs"
}

Status Codes

Status Code	Description
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

Error Codes

See Error Codes.

Parent topic: Dataset Version Management