CreateDatasetVersion

更新时间:
复制 MD 格式

Creates a dataset version. Currently supports DataWorks datasets only, with a maximum of 20 versions.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

DatasetId

string

Yes

The dataset ID. Currently supports DataWorks datasets only.

dataworks-dataset:3pXXXb8o0ngr07njhps1

Comment

string

No

The description for this dataset version. Maximum length: 1,024 characters.

this is a comment

Url

string

Yes

URL

oss://test-oss-bucket/test_dir/

MountPath

string

No

The mount path, which must start with /mnt/. Default value: /mnt/data.

/mnt/data

ImportInfo

object

No

The storage import configuration for the dataset. Required configuration varies by storage type.

NAS

For valid values, see the response from the file storage API DescribeFileSystems.

{
"fileSystemId": "3b6XXX89c9", // The file system ID.
"fileSystemStorageType":  "Performance" // The file system storage type.
"vpcId": "vpc-uf66oxxxrqge1t2gson7s" // The VPC ID for the mount point.
}

string

No

The dataset storage import configuration

None

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Id of the request

22C97E95-F023-56B5-8852-B1A77A17XXXX

Success

boolean

Indicates whether the request was successful.

true

Id

string

ID

dataworks-datasetVersion:3pXXXb8o0ngr07njhps1 :2

Examples

Success response

JSON format

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX\n",
  "Success": true,
  "Id": "dataworks-datasetVersion:3pXXXb8o0ngr07njhps1\n:2"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.