获取组件默认配置项
最近更新时间: 2026-09-17 00:05:50
1. 接口描述
接口请求域名： tbdsnew.api3.fincloud.tencent.cn。
获取组件默认配置项
默认接口请求频率限制：20次/秒。
接口更新时间：2025-07-13 02:08:55。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeDefaultFileConfig |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-01-03 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| ClassName | 是 | 否 | String | 集群类型 示例值： Hadoop |
| ProductId | 是 | 否 | Int64 | 产品id 示例值： 70 |
| ServiceNames | 否 | 否 | Array of String | 组件名称 示例值： [] |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| DefaultConfMetas | Array of DefaultConfMeta | 默认配置信息 示例值：查看 |
| ServiceFiles | Array of ServiceFile | 服务和文件信息 示例值：查看 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。
5. 示例
示例1 获取组件默认配置项
输入示例
POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: DescribeDefaultFileConfig
<公共请求参数>
{
"ClassName": "Hadoop",
"ProductId": 70,
"ServiceNames": []
}
输出示例
{
"Response": {
"DefaultConfMetas": [
{
"ClassName": "Hadoop",
"Classification": "hbase-site.xml",
"Description": "Count of RPC Listener instances spun up on RegionServers. Same property is used by the Master for count of master handlers.",
"FieldName": "hbase.regionserver.handler.count",
"FieldValue": "256",
"Id": 7,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "HBASE",
"ServiceVersion": "2.4.5",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hdfs-site.xml",
"Description": "Added to grow Queue size so that more client connections are allowed",
"FieldName": "dfs.namenode.handler.count",
"FieldValue": "64",
"Id": 8,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "HDFS",
"ServiceVersion": "3.2.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hdfs-site.xml",
"Description": "Default block replication. The number of replications to make when the file is created. The default value is used if a replication number is not specified.",
"FieldName": "dfs.replication",
"FieldValue": "3",
"Id": 9,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "HDFS",
"ServiceVersion": "3.2.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hdfs-site.xml",
"Description": "DFS Block大小，单位byte",
"FieldName": "dfs.blocksize",
"FieldValue": "134217728",
"Id": 10,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "HDFS",
"ServiceVersion": "3.2.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hive-site.xml",
"Description": "location of default database for the warehouse",
"FieldName": "hive.metastore.warehouse.dir",
"FieldValue": "/usr/hive/warehouse",
"Id": 11,
"ProductId": 0,
"Range": [],
"ServiceName": "HIVE",
"ServiceVersion": "3.1.3",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "server.properties",
"Description": "A comma-separated list of one or more directories in which Kafka data is stored. Each new partition that is created will be placed in the directory which currently has the fewest partitions.",
"FieldName": "log.dirs",
"FieldValue": "/data/emr/kafka/data",
"Id": 12,
"ProductId": 0,
"Range": [],
"ServiceName": "KAFKA",
"ServiceVersion": "2.8.2",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "server.properties",
"Description": "",
"FieldName": "num.partitions",
"FieldValue": "1",
"Id": 13,
"ProductId": 0,
"Range": [
"1",
"2147483647"
],
"ServiceName": "KAFKA",
"ServiceVersion": "2.8.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "server.properties",
"Description": "",
"FieldName": "log.retention.hours",
"FieldValue": "168",
"Id": 14,
"ProductId": 0,
"Range": [
"1",
"2147483647"
],
"ServiceName": "KAFKA",
"ServiceVersion": "2.8.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "spark-defaults.conf",
"Description": "任务driver内存",
"FieldName": "spark.driver.memory",
"FieldValue": "4g",
"Id": 18,
"ProductId": 0,
"Range": [],
"ServiceName": "SPARK",
"ServiceVersion": "3.5.4",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "spark-defaults.conf",
"Description": "任务executor内存",
"FieldName": "spark.executor.memory",
"FieldValue": "4g",
"Id": 19,
"ProductId": 0,
"Range": [],
"ServiceName": "SPARK",
"ServiceVersion": "3.5.4",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "spark-defaults.conf",
"Description": "The default number of partitions to use when shuffling data for joins or aggregations.",
"FieldName": "spark.sql.shuffle.partitions",
"FieldValue": "200",
"Id": 20,
"ProductId": 0,
"Range": null,
"ServiceName": "SPARK",
"ServiceVersion": "3.5.4",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "spark-defaults.conf",
"Description": "THIS CONFIG AFFECTS spark-sql CLIENT. Whether to use dynamic resource allocation, which scales the number of executors registered with this application up and down based on the workload. For more detail, see the description here. This requires spark.shuffle.service.enabled to be set. The following configurations are also relevant:spark.dynamicAllocation.minExecutors,spark.dynamicAllocation.maxExecutors, and spark.dynamicAllocation.initialExecutors.",
"FieldName": "spark.dynamicAllocation.enabled",
"FieldValue": "true",
"Id": 21,
"ProductId": 0,
"Range": null,
"ServiceName": "SPARK",
"ServiceVersion": "3.5.4",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "spark-defaults.conf",
"Description": "任务executor占用cpu核",
"FieldName": "spark.executor.cores",
"FieldValue": "1",
"Id": 22,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "SPARK",
"ServiceVersion": "3.5.4",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "config.properties",
"Description": "查询内存占用内存最大值",
"FieldName": "query.max-memory",
"FieldValue": "1.5GB",
"Id": 37,
"ProductId": 0,
"Range": [],
"ServiceName": "TRINO",
"ServiceVersion": "435",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "config.properties",
"Description": "每个节点的最大查询内存，默认JVM max memory * 0.1",
"FieldName": "query.max-memory-per-node",
"FieldValue": "0.5GB",
"Id": 38,
"ProductId": 0,
"Range": [],
"ServiceName": "TRINO",
"ServiceVersion": "435",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "node.properties",
"Description": "",
"FieldName": "datadir",
"FieldValue": "/data/emr/trino",
"Id": 39,
"ProductId": 0,
"Range": [],
"ServiceName": "TRINO",
"ServiceVersion": "435",
"Type": "directory",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "Amount of physical memory, in MB, that can be allocated for containers.",
"FieldName": "yarn.nodemanager.resource.memory-mb",
"FieldValue": "emr-default",
"Id": 40,
"ProductId": 0,
"Range": null,
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "Number of vcores that can be allocated for containers. This is used by the RM scheduler when allocating resources for containers. This is not used to limit the number of CPUs used by YARN containers. If it is set to -1 and yarn.nodemanager.resource.detect-hardware-capabilities is true, it is automatically determined from the hardware in case of Windows and Linux. In other cases, number of vcores is 8 by default.",
"FieldName": "yarn.nodemanager.resource.cpu-vcores",
"FieldValue": "emr-default",
"Id": 41,
"ProductId": 0,
"Range": null,
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "List of directories to store localized files in. An application's localized file directory will be found in: ${yarn.nodemanager.local-dirs}/usercache/${user}/appcache/application_${appid}. Individual containers' work directories, called container_${contid}, will be subdirectories of this.",
"FieldName": "yarn.nodemanager.local-dirs",
"FieldValue": "/emr-default-dir",
"Id": 42,
"ProductId": 0,
"Range": [],
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "directory",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "Where to store container logs. An application's localized log directory will be found in ${yarn.nodemanager.log-dirs}/application_${appid}. Individual containers' log directories will be below this, in directories named container_{$contid}. Each container directory will contain the files stderr, stdin, and syslog generated by that container.",
"FieldName": "yarn.nodemanager.log-dirs",
"FieldValue": "/emr-default-dir",
"Id": 43,
"ProductId": 0,
"Range": [],
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "directory",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "是否启用日志聚集",
"FieldName": "yarn.log-aggregation-enable",
"FieldValue": "true",
"Id": 44,
"ProductId": 0,
"Range": [
"true",
"false"
],
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "enum",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "yarn-site.xml",
"Description": "在HDFS上聚集的日志最多保存多长时间，单位秒",
"FieldName": "yarn.log-aggregation.retain-seconds",
"FieldValue": "604800",
"Id": 45,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "YARN",
"ServiceVersion": "3.2.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "zoo.cfg",
"Description": "Data directory for ZooKeeper.",
"FieldName": "dataDir",
"FieldValue": "/data/emr/zookeeper/data",
"Id": 46,
"ProductId": 0,
"Range": [],
"ServiceName": "ZOOKEEPER",
"ServiceVersion": "3.7.2",
"Type": "directory",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "zoo.cfg",
"Description": "同步时间限制，超过时限没有回应心跳则认为follower离线",
"FieldName": "syncLimit",
"FieldValue": "50",
"Id": 47,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "ZOOKEEPER",
"ServiceVersion": "3.7.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "zoo.cfg",
"Description": "表示ZK中的一个单位时间，所有时间都是以此为基础的，单位为毫秒。",
"FieldName": "tickTime",
"FieldValue": "6000",
"Id": 48,
"ProductId": 0,
"Range": [
"0",
"2147483647"
],
"ServiceName": "ZOOKEEPER",
"ServiceVersion": "3.7.2",
"Type": "number",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hbase-site.xml",
"Description": "Percentage of RegionServer memory to allocate to read buffers.",
"FieldName": "hfile.block.cache.size",
"FieldValue": "0.4",
"Id": 49,
"ProductId": 0,
"Range": null,
"ServiceName": "HBASE",
"ServiceVersion": "2.4.5",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hbase-site.xml",
"Description": "Percentage of RegionServer memory to allocate to write buffers. Each column family within each region is allocated a smaller pool (the memstore) within this shared write pool. If this buffer is full, updates are blocked and data is flushed from memstores until a global low watermark (hbase.regionserver.global.memstore.size.lower.limit) is reached.",
"FieldName": "hbase.regionserver.global.memstore.size",
"FieldValue": "0.4",
"Id": 50,
"ProductId": 0,
"Range": null,
"ServiceName": "HBASE",
"ServiceVersion": "2.4.5",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "hdfs-site.xml",
"Description": "Number of failed disks a DataNode would tolerate before it stops offering service",
"FieldName": "dfs.datanode.failed.volumes.tolerated",
"FieldValue": "0",
"Id": 55,
"ProductId": 0,
"Range": null,
"ServiceName": "HDFS",
"ServiceVersion": "3.2.2",
"Type": "string",
"Valid": 1
},
{
"ClassName": "Hadoop",
"Classification": "catalogd.flgs",
"Description": " ",
"FieldName": "mem_limit",
"FieldValue": "80%",
"Id": 58,
"ProductId": 0,
"Range": [],
"ServiceName": "IMPALA",
"ServiceVersion": "4.1.0",
"Type": "string",
"Valid": 1
}
],
"RequestId": "0a96d679-a5ea-4922-ae56-93d19b508c8d",
"ServiceFiles": [
{
"Classifications": [
"hbase-site.xml"
],
"ServiceName": "HBASE"
},
{
"Classifications": [
"hive-site.xml"
],
"ServiceName": "HIVE"
},
{
"Classifications": [
"server.properties"
],
"ServiceName": "KAFKA"
},
{
"Classifications": [
"spark-defaults.conf"
],
"ServiceName": "SPARK"
},
{
"Classifications": [
"yarn-site.xml"
],
"ServiceName": "YARN"
},
{
"Classifications": [
"zoo.cfg"
],
"ServiceName": "ZOOKEEPER"
},
{
"Classifications": [
"hdfs-site.xml"
],
"ServiceName": "HDFS"
},
{
"Classifications": [
"config.properties",
"node.properties"
],
"ServiceName": "TRINO"
},
{
"Classifications": [
"catalogd.flgs"
],
"ServiceName": "IMPALA"
}
]
}
}