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

E-MapReduce

  • Documentation
    • E-MapReduceAPI referenceEMR on ECS API referenceApplication managementUpdateApplicationConfig - update configuration items
Copy page
Download PDF
Application management
UpdateApplicationConfig - update configuration items
Copy page
Download PDF
UpdateApplicationConfig - update configuration items

Update configuration items

Note

Call UpdateApplicationConfig to update the application configuration of an E-MapReduce (EMR) cluster.

important notes

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

Note

Request method: POST
Request URL: https://emr.cn-beijing.volcengineapi.com/?Version=2023-08-15&Action=UpdateApplicationConfig

Debug

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.

**Action **string %%require%% Example value: UpdateApplicationConfig
The operation to be performed. Value: UpdateApplicationConfig.

**Version **string %%require%% Example value: 2023-08-15
API version. Value: 2023-08-15.

**ClusterId **string %%require%% Example value: emr-xxx
Cluster ID

**ApplicationName **string %%require%% Example value: HDFS
Service name

**Remark **string %%require%% Example value: test
Operation note

**Configs **object[] %%require%% Example value: [{
"ConfigFileName":"hdfs-site.xml",<br>
"ConfigItemKey":"dfs.blockreport.initialDelay",<br>
"ConfigItemValue":2
}]
Configuration items to be modified

**ConfigFileName **string %%require%% Example value: hdfs-site.xml
Configuration file name

**ConfigItemKey **string %%require%% Example value: dfs.blockreport.initialDelay
Configuration item name

**ConfigItemValue **string %%require%% Example value: 1
Configuration item value

**EffectiveScope **object Optional Example value: {"effectiveType":"CLUSTER"}
Affected components

**EffectiveType **string %%require%% Example value: CLUSTER,NODE_GROUP_NAME,
NODE_GROUP_ID,
NODE_GROUP_TYPE,
NODE_NAME,
NODE_ID,
COMPONENT_NAME
Effective type

**NodeGroupIds **string[] Optional Example value: ["xxx"]
List of node group IDs. Required when effectiveType=NODE_GROUP_ID

**NodeGroupNames **string[] Optional Example value: ["xxx"]
List of node group names. Required when effectiveType=NODE_GROUP_NAME

**NodeGroupTypes **string[] Optional Example value: MASTER, CORE, TASK
List of node group types. Required when effectiveType=NODE_GROUP_TYPE. Currently includes MASTER, CORE, TASK

**NodeNames **string[] Optional Example value: ["xxx"]
List of node names. Required when effectiveType=NODE_NAME

**NodeIds **string[] Optional Example value: ["xxx"]
List of node IDs. Required when effectiveType=NODE_ID

**ComponentNames **string[] Optional Example value: ["xxx"]
List of component names. Required when EffectiveType=COMPONENT_NAME

**Deleted **boolean Optional Example value: false
Deleted

**ComponentName **string Optional
Component name

**ComponentInstanceName **string Optional
Component instance name

**ClientToken **string Optional Example value: 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

**ClusterId **string Example value: emr-xxx
Cluster ID

**OperationId **string Example value: 73xxx
Cluster operation ID

**ResultData **object Example value: --
Result data

sample request 

{ 
    "ClusterId":"emr-xxx", 
    "ApplicationName": "HDFS", 
    "Configs":[{ 
        "ConfigFileName":"hdfs-site.xml", 
        "ConfigItemKey":"dfs.blockreport.initialDelay", 
        "ConfigItemValue":2 
    }], 
"Remark":"Liu Bin test" 
}

sample response 

{ 
    "ResponseMetadata": { 
        "RequestId": "202312042119240BF2149851287xxx", 
        "Action": "UpdateApplicationConfig", 
        "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
Note
400
InvalidRequest

Access Denied {clusterId}

No permission for this cluster

400
IllegalOperationForCluster

The cluster id {clusterId} does not support the operation

Illegal operation. This cluster does not support this operation

400
InvalidClusterId

cluster id {clusterId} not found

Cluster does not exist

Last updated: 2026.06.01 17:04:19