修改YARN资源调度的资源配置
最近更新时间: 2026-09-17 00:05:50
1. 接口描述
接口请求域名： tbdsnew.api3.fincloud.tencent.cn。
经典集群中，修改YARN资源调度的资源配置
默认接口请求频率限制：20次/秒。
接口更新时间：2025-09-11 22:17:15。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：ModifyResourceScheduleConfig |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-01-03 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | emr集群的英文id 示例值： tbds-664nmwbe |
| Key | 是 | 否 | String | 业务标识，fair表示编辑公平的配置项，fairPlan表示编辑执行计划，capacity表示编辑容量的配置项 示例值： capacity |
| Value | 是 | 否 | String | 修改后的模块消息 建议从页面复制修改 示例值： |
| OpType | 否 | 否 | Int64 | 操作类型 1 给root新增子节点 、3 新增、2 编辑、5克隆、4 删除 示例值： 1 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| IsDraft | Bool | true为草稿，表示还没有刷新资源池 示例值： 1 |
| ErrorMsg | String | 校验错误信息，如果不为空，则说明校验失败，配置没有成功 示例值： 1 |
| Data | String | 返回数据 示例值： 1 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameter | 参数错误。 |
| InternalError.CamCgwError | 内部服务调用异常。 |
| InternalError | 内部错误。 |
| UnauthorizedOperation.CheckCamAuth | 校验账号操作无权限。 |
| ResourceNotFound.InstanceNotFound | 无法找到该实例。 |
| InternalError.WoodServerError | 内部服务调用异常。 |
5. 示例
示例1 新建计划模式接口示例
1、公平队列新建计划模式传参Value解释
字段由前端拼凑，分两个部分，基于default创建的新的计划模式会添加到plan的实体中，基于default配置集生成的新的配置集会添加到schedulerInfo实体中，一个计划模式对应一个配置集
{
"plans": "[{"repeatType":"DAILY","scheduleName":"demo1","startTime":"2024-12-05","duration":{"start":"00:00","end":"00:00"},"daysOfRepeat":[]},{"repeatType":"","scheduleName":"default","startTime":"","duration":null,"daysOfRepeat":null,"isDefault":true,"disable":false}]",
"schedulerInfo": "{"users":null,"userMaxAppsDefault":null,"defaultFairSharePreemptionTimeout":null,"defaultFairSharePreemptionThreshold":null,"defaultMinSharePreemptionTimeout":null,"queueMaxAppsDefault":null,"defaultQueueSchedulingPolicy":null,"queueMaxAMShareDefault":-1,"queuePlacementPolicy":null,"queues":[{"name":"root","type":null,"aclSubmitApps":null,"aclAdministerApps":null,"minSharePreemptionTimeout":null,"fairSharePreemptionTimeout":null,"fairSharePreemptionThreshold":null,"allowPreemptionFrom":null,"schedulingPolicy":null,"isDefault":null,"isRoot":true,"configSets":[{"name":"demo1","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":-1},{"name":"default","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":-1}],"queues":[{"name":"default","type":null,"aclSubmitApps":null,"aclAdministerApps":null,"minSharePreemptionTimeout":null,"fairSharePreemptionTimeout":null,"fairSharePreemptionThreshold":null,"allowPreemptionFrom":null,"schedulingPolicy":null,"isDefault":true,"isRoot":null,"configSets":[{"name":"demo1","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":null},{"name":"default","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":null}],"queues":null,"parentId":"1","spId":"1-0"}],"spId":"1","parentId":""}]}"
}
2、容量队列新建计划模式传参Value解释
字段由前端拼凑，分两个部分，基于default创建的新的计划模式会添加到plan的实体中，基于default配置集生成的新的配置集会添加到schedulerInfo实体中，一个计划模式对应一个配置集
{
"plans": "[{"repeatType":"DAILY","scheduleName":"test2","startTime":"2024-12-05","duration":{"start":"00:00","end":"00:00"},"daysOfRepeat":[]},{"repeatType":"","scheduleName":"default","startTime":"","duration":null,"daysOfRepeat":null,"isDefault":true,"disable":false}]",
"schedulerInfo": "{"queueMappings":null,"queue":{"name":"root","myId":"root","parentId":"root","configs":[{"configName":"default","labels":[{"labelName":"","capacity":null,"maximum-capacity":null,"min-abs-capacity":null,"max-abs-capacity":null},{"labelName":"label1","capacity":null,"maximum-capacity":null,"min-abs-capacity":null,"max-abs-capacity":null}],"minimum-user-limit-percent":null,"user-limit-factor":null,"maximum-allocation-mb":null,"maximum-allocation-vcores":null,"maximum-applications":null,"maximum-am-resource-percent":null,"default-application-priority":null,"user-settings":null}],"state":null,"default-node-label-expression":null,"acl_submit_applications":null,"acl_administer_queue":null,"isDefault":null,"isRoot":true,"queues":[{"name":"default","myId":"root.default","parentId":"root","configs":[{"configName":"test2","labels":[{"labelName":"","capacity":100,"maximum-capacity":100,"min-abs-capacity":null,"max-abs-capacity":null}],"minimum-user-limit-percent":null,"user-limit-factor":1,"maximum-allocation-mb":null,"maximum-allocation-vcores":null,"maximum-applications":null,"maximum-am-resource-percent":null,"default-application-priority":null,"user-settings":[]},{"configName":"default","labels":[{"labelName":"","capacity":100,"maximum-capacity":100,"min-abs-capacity":null,"max-abs-capacity":null}],"minimum-user-limit-percent":null,"user-limit-factor":1,"maximum-allocation-mb":null,"maximum-allocation-vcores":null,"maximum-applications":null,"maximum-am-resource-percent":null,"default-application-priority":null,"user-settings":[]}],"state":null,"default-node-label-expression":null,"acl_submit_applications":null,"acl_administer_queue":null,"isDefault":true,"isRoot":null,"queues":[]},{"name":"Albert1","myId":"root.Albert1","parentId":"root","configs":[{"configName":"test2"}],"state":"RUNNING","default-node-label-expression":null,"acl_submit_applications":{"user":"","group":""},"acl_administer_queue":{"user":"","group":""},"isDefault":false,"isRoot":false,"queues":[]},{"name":"demo1","myId":"root.demo1","parentId":"root","configs":[{"configName":"test2"}],"state":"RUNNING","default-node-label-expression":null,"acl_submit_applications":{"user":"","group":""},"acl_administer_queue":{"user":"","group":""},"isDefault":false,"isRoot":false,"queues":[]}]},"queueMappingsOverride":null,"defaultSettings":null,"version":"v2","queues":[{"name":"default","myId":"root.default","parentId":"root","configs":[{"configName":"test2","labels":[{"labelName":"","capacity":100,"maximum-capacity":100,"min-abs-capacity":null,"max-abs-capacity":null}],"minimum-user-limit-percent":null,"user-limit-factor":1,"maximum-allocation-mb":null,"maximum-allocation-vcores":null,"maximum-applications":null,"maximum-am-resource-percent":null,"default-application-priority":null,"user-settings":[]},{"configName":"default","labels":[{"labelName":"","capacity":100,"maximum-capacity":100,"min-abs-capacity":null,"max-abs-capacity":null}],"minimum-user-limit-percent":null,"user-limit-factor":1,"maximum-allocation-mb":null,"maximum-allocation-vcores":null,"maximum-applications":null,"maximum-am-resource-percent":null,"default-application-priority":null,"user-settings":[]}],"state":null,"default-node-label-expression":null,"acl_submit_applications":null,"acl_administer_queue":null,"isDefault":true,"isRoot":null,"queues":[]},{"name":"Albert1","myId":"root.Albert1","parentId":"root","configs":[{"configName":"test2"}],"state":"RUNNING","default-node-label-expression":null,"acl_submit_applications":{"user":"","group":""},"acl_administer_queue":{"user":"","group":""},"isDefault":false,"isRoot":false,"queues":[]},{"name":"demo1","myId":"root.demo1","parentId":"root","configs":[{"configName":"test2"}],"state":"RUNNING","default-node-label-expression":null,"acl_submit_applications":{"user":"","group":""},"acl_administer_queue":{"user":"","group":""},"isDefault":false,"isRoot":false,"queues":[]}]}"
}
输入示例
https://emr.api3.{{conf.domain_main}}/?Action=ModifyResourceScheduleConfig
&<公共请求参数>
&InstanceId=emr-0sfuq468
&Key=0
&Value="{\"plans\":\"[{\\\"repeatType\\\":\\\"DAILY\\\",\\\"scheduleName\\\":\\\"demo1\\\",\\\"startTime\\\":\\\"2024-12-05\\\",\\\"duration\\\":{\\\"start\\\":\\\"00:00\\\",\\\"end\\\":\\\"00:00\\\"},\\\"daysOfRepeat\\\":[]},{\\\"repeatType\\\":\\\"\\\",\\\"scheduleName\\\":\\\"default\\\",\\\"startTime\\\":\\\"\\\",\\\"duration\\\":null,\\\"daysOfRepeat\\\":null,\\\"isDefault\\\":true,\\\"disable\\\":false}]\",\"schedulerInfo\":\"{\\\"queueMappings\\\":null,\\\"queue\\\":{\\\"name\\\":\\\"root\\\",\\\"myId\\\":\\\"root\\\",\\\"parentId\\\":\\\"root\\\",\\\"configs\\\":[{\\\"configName\\\":\\\"default\\\",\\\"labels\\\":[{\\\"labelName\\\":\\\"<DEFAULT_PARTITION>\\\",\\\"capacity\\\":null,\\\"maximum-capacity\\\":null,\\\"min-abs-capacity\\\":null,\\\"max-abs-capacity\\\":null}],\\\"minimum-user-limit-percent\\\":null,\\\"user-limit-factor\\\":null,\\\"maximum-allocation-mb\\\":null,\\\"maximum-allocation-vcores\\\":null,\\\"maximum-applications\\\":null,\\\"maximum-am-resource-percent\\\":null,\\\"default-application-priority\\\":null,\\\"user-settings\\\":null}],\\\"state\\\":null,\\\"default-node-label-expression\\\":null,\\\"acl_submit_applications\\\":null,\\\"acl_administer_queue\\\":null,\\\"isDefault\\\":null,\\\"isRoot\\\":true,\\\"queues\\\":[{\\\"name\\\":\\\"default\\\",\\\"myId\\\":\\\"root.default\\\",\\\"parentId\\\":\\\"root\\\",\\\"configs\\\":[{\\\"configName\\\":\\\"demo1\\\",\\\"labels\\\":[{\\\"labelName\\\":\\\"<DEFAULT_PARTITION>\\\",\\\"capacity\\\":100,\\\"maximum-capacity\\\":100,\\\"min-abs-capacity\\\":null,\\\"max-abs-capacity\\\":null}],\\\"minimum-user-limit-percent\\\":null,\\\"user-limit-factor\\\":1,\\\"maximum-allocation-mb\\\":null,\\\"maximum-allocation-vcores\\\":null,\\\"maximum-applications\\\":null,\\\"maximum-am-resource-percent\\\":null,\\\"default-application-priority\\\":null,\\\"user-settings\\\":null},{\\\"configName\\\":\\\"default\\\",\\\"labels\\\":[{\\\"labelName\\\":\\\"<DEFAULT_PARTITION>\\\",\\\"capacity\\\":100,\\\"maximum-capacity\\\":100,\\\"min-abs-capacity\\\":null,\\\"max-abs-capacity\\\":null}],\\\"minimum-user-limit-percent\\\":null,\\\"user-limit-factor\\\":1,\\\"maximum-allocation-mb\\\":null,\\\"maximum-allocation-vcores\\\":null,\\\"maximum-applications\\\":null,\\\"maximum-am-resource-percent\\\":null,\\\"default-application-priority\\\":null,\\\"user-settings\\\":null}],\\\"state\\\":null,\\\"default-node-label-expression\\\":null,\\\"acl_submit_applications\\\":null,\\\"acl_administer_queue\\\":null,\\\"isDefault\\\":true,\\\"isRoot\\\":null,\\\"queues\\\":null}]},\\\"queueMappingsOverride\\\":null,\\\"defaultSettings\\\":null,\\\"version\\\":\\\"v2\\\",\\\"queues\\\":[{\\\"name\\\":\\\"default\\\",\\\"myId\\\":\\\"root.default\\\",\\\"parentId\\\":\\\"root\\\",\\\"configs\\\":[{\\\"configName\\\":\\\"demo1\\\",\\\"labels\\\":[{\\\"labelName\\\":\\\"<DEFAULT_PARTITION>\\\",\\\"capacity\\\":100,\\\"maximum-capacity\\\":100,\\\"min-abs-capacity\\\":null,\\\"max-abs-capacity\\\":null}],\\\"minimum-user-limit-percent\\\":null,\\\"user-limit-factor\\\":1,\\\"maximum-allocation-mb\\\":null,\\\"maximum-allocation-vcores\\\":null,\\\"maximum-applications\\\":null,\\\"maximum-am-resource-percent\\\":null,\\\"default-application-priority\\\":null,\\\"user-settings\\\":null},{\\\"configName\\\":\\\"default\\\",\\\"labels\\\":[{\\\"labelName\\\":\\\"<DEFAULT_PARTITION>\\\",\\\"capacity\\\":100,\\\"maximum-capacity\\\":100,\\\"min-abs-capacity\\\":null,\\\"max-abs-capacity\\\":null}],\\\"minimum-user-limit-percent\\\":null,\\\"user-limit-factor\\\":1,\\\"maximum-allocation-mb\\\":null,\\\"maximum-allocation-vcores\\\":null,\\\"maximum-applications\\\":null,\\\"maximum-am-resource-percent\\\":null,\\\"default-application-priority\\\":null,\\\"user-settings\\\":null}],\\\"state\\\":null,\\\"default-node-label-expression\\\":null,\\\"acl_submit_applications\\\":null,\\\"acl_administer_queue\\\":null,\\\"isDefault\\\":true,\\\"isRoot\\\":null,\\\"queues\\\":null}]}\"}"
&OpType=0
输出示例
{
"Response": {
"Data": "",
"ErrorMsg": null,
"IsDraft": true,
"RequestId": "0f869322-bc45-45bd-ba2a-a092c8bb2938"
}
}