You need to enable JavaScript to run this app.
E-MapReduce

E-MapReduce

  • Documentation
    • E-MapReduceAPI referenceEMR on VKE API referenceCluster managementCreateVirtualCluster - Create a cluster
Copy page
Download PDF
Cluster management
CreateVirtualCluster - Create a cluster
Copy page
Download PDF
CreateVirtualCluster - Create a cluster

Create an EMR On VKE cluster

Use cases

Call CreateVirtualCluster to create an EMR On VKE virtual cluster.

Important notes

You must already have a Volcano Engine account and have enabled EMR permissions.

Request description

Request method: POST
Request URL: https://open.volcengineapi.com/?Version=2023-12-30&Action=CreateVirtualCluster

Request parameters

The following table lists only the request parameters specific to this API and some common parameters. For more information, see common parameters.

Parameter
Type
Required
Example
Description
Action
String
Yes

CreateVirtualCluster

The operation to perform. Value: CreateVirtualCluster

Version
String
Yes

2023-12-30

API version. Value: 2023-12-30

ClusterName
String
Yes

cluster1

Cluster name

Applications
ApplicationVKE
No

[]

Application list

ReleaseVersion
String
Yes

EMR-VKE-1.2.0

Release version

VkeCluster
VkeCluster
Yes

{}

VKE cluster information

ProjectName
String
No

default

Volcano Engine project name

ClientToken
String
No

xxx

Idempotency token

Response parameters

The following table lists only the response parameters specific to this API. For more information, see response structure

Parameter
Type
Example
Description
ClusterId
String

emr-xxx

Cluster ID

OperationId
String

op-xxx

Operation record ID

Sample request 

{ 
    "ProjectName": "default", 
    "ReleaseVersion": "EMR-VKE-1.0.0", 
    "ClusterName": "xxx", 
    "VkeCluster": { 
        "VkeClusterId": "xxx", 
        "VkeNodePoolIds": [ 
            "xxx" 
        ] 
    }, 
    "Applications": [ 
        { 
            "ApplicationName": "Ray", 
            "ApplicationConfigs": [ 
            ] 
        } 
    ] 
}

Sample response 

{ 
    "ResponseMetadata": { 
        "RequestId": "", 
        "Action": "CreateVirtualCluster", 
        "Error": null, 
        "Region": "cn-beijing", 
        "Service": "emr", 
        "Version": "2023-12-30" 
    }, 
    "Result": { 
        "ClusterId": "emr-xxx", 
        "OperationId": "op-xxx" 
    }

Error codes

You can visit common error codes for more information about error codes.

Last updated: 2026.06.01 17:05:26