Usage instructions

Call GetApplicationConfigFile to obtain the application configuration file for an E-MapReduce (EMR) cluster.

important notes

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

Request description

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

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 table below 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	GetApplicationConfigFile	The operation to be performed. Value: GetApplicationConfigFile.
Version	String	Yes	2023-08-15	API version. Value: 2023-08-15.
ClusterId	String	Yes	emr-xxx	Cluster ID
ApplicationName	String	Yes	HDFS	Application name
ConfigFileName	String	Yes	core-site.xml	Configuration file name of the application

response parameters

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

Parameter	Type	Example value	Description
ApplicationName	String	HDFS	Application name
FileName	String	core-site.xml	Configuration file name
FilePath	String	/etc/emr/hadoop/conf	Configuration file path
FileContent	String		Configuration file content
FileUser	String	hdfs	File permission: user
FileGroup	String	hadoop	File permission: group
SupportCustomConfigItem	Boolean	xxx	Whether the configuration file allows custom parameters
Description	String	xxx	Description of the configuration file

sample request

{ 
    "ClusterId":"emr-xxx", 
    "ApplicationName": "HDFS", 
    "ConfigFileName":"core-site.xml" 
}

sample response

{ 
    "ResponseMetadata": { 
        "RequestId": "20231204171503C7664BD9E36Axxx", 
        "Action": "GetApplicationConfigFile", 
        "Version": "2023-08-15", 
        "Service": "emr", 
        "Region": "cn-beijing", 
        "Error": null, 
        "Deprecated": false 
    }, 
    "Result": { 
        "ApplicationName": "HDFS", 
        "FileName": "core-site.xml", 
        "FilePath": "/etc/emr/hadoop/conf", 
        "FileMode": null, 
        "FileContent": "<?xml version="1.0" encoding="UTF-8"?>\n<?xml-stylesheet type="text/xsl" href="configuration.xsl"?>\n<configuration>...", 
        "FileUser": "hdfs", 
        "FileGroup": "hadoop", 
        "SupportCustomConfigItem": null, 
        "Description": null 
    } 
}

error codes

The table below 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	InvalidClusterId	cluster id {clusterId} not found	Cluster does not exist
400	IllegalOperationForCluster	The cluster id {clusterId} does not support the operation	Illegal operation. This cluster does not support the operation.
400	InvalidRequest	Access Denied {clusterId}	No permission for this cluster
400	IllegalConfigFileName	Illegal config fileName {0}, not exists
405	UnSupportedGetConfigFile	UnSupported getConfigFile when releaseVersion {0} is lower than 3.5.x

Last updated: 2026.06.01 17:04:20

E-MapReduce

Usage instructions #

important notes #

Request description #

Debug #

request parameters #

response parameters #

sample request #

sample response #

error codes #