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

E-MapReduce

  • Documentation
    • E-MapReduceAPI referenceEMR on ECS API referenceCluster managementUpdateClusterAttribute - Update cluster attributes
Copy page
Download PDF
Cluster management
UpdateClusterAttribute - Update cluster attributes
Copy page
Download PDF
UpdateClusterAttribute - Update cluster attributes

Update cluster attributes

Use cases

Call UpdateClusterAttribute to update the attributes of a specified account and E-MapReduce (EMR) cluster, such as the cluster name.

Important notes

The account has already logged in to Volcano Engine.

Request description

Request method: POST
Request URL: https://open.volcengineapi.com/?Version=2023-08-15&Action=UpdateClusterAttribute

Debugging

API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Go to debug

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 value
Description
Action
String
Yes

UpdateClusterAttribute

The operation to be performed. Value: UpdateClusterAttribute.

Version
String
Yes

2023-08-15

API version. Value: 2023-08-15.

ClusterId
String
Yes

emr-xxx

Cluster ID

ClusterName
String
Yes

emr-test-xxx

Cluster name

ClientToken
String
No

xxx

A unique identifier generated by the caller for this request, used to ensure idempotency.

Response parameters

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

Parameter
Type
Example value
Description
ClusterId
String

xxx

Cluster ID

OperationId
String

emr-xxx

Cluster operation ID

Sample request 

{ 
    "ClusterId":"emr-xxx", 
"ClusterName":"emr-openapi test V1" 
}

Sample response 

{ 
    "ResponseMetadata": { 
        "RequestId": "202312042119240BF214985128722xxx", 
        "Action": "UpdateClusterAttribute", 
        "Version": "2023-08-15", 
        "Service": "emr", 
        "Region": "cn-beijing", 
        "Error": null, 
        "Deprecated": false 
    }, 
    "Result": { 
        "OperateId": "xxx", 
        "ClusterId": "emr-xxx", 
        "ResultData": null 
    } 
}

Error codes

The following table lists the error codes related to the business logic of this API. For common error codes, see the common error codes documentation.

Status code
Error code
Error message
Description
400
InvalidClusterId
cluster id {clusterId} not found

Cluster does not exist

400
InvalidRequest
Access Denied {clusterId}

No permission for this cluster

Last updated: 2026.06.01 17:04:20