1. 接口描述
接口请求域名： tbdsnew.api3.fincloud.tencent.cn。
修改资源调度中资源池
默认接口请求频率限制：20次/秒。
接口更新时间：2025-09-12 15:44:08。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：ModifyYarnQueue |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-01-03 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | 集群Id 示例值： tbds-664nmwbe |
| Scheduler | 是 | 否 | String | 调度器，固定值：capacity 示例值： capacity |
| ConfigModifyInfo | 是 | 否 | ConfigModifyInfo | 资源池数据 示例值：查看 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| IsDraft | Bool | true表示是草稿 示例值： 1 |
| ErrorMsg | String | 错误信息，忽略 示例值： 1 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.WoodServerError | 内部服务调用异常。 |
| UnauthorizedOperation.CheckCamAuth | 校验账号操作无权限。 |
| InternalError.CamCgwError | 内部服务调用异常。 |
| FailedOperation | 操作失败。 |
| ResourceNotFound.InstanceNotFound | 无法找到该实例。 |
5. 示例
示例1 修改队列配置接口示例
1、公平队列修改配置传参Value解释
字段由前端拼凑
{"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":"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":"default","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":null}],"queues":null,"parentId":"1","spId":"1-0"},{"name":"test1","showMaxChildResources":false,"aclSubmitApps":null,"aclAdministerApps":null,"schedulingPolicy":"fair","configSets":[{"name":"default","minResources":{},"maxResources":{},"maxAMShare":0.5,"weight":1}],"queues":[],"index":1,"type":null,"spId":"1-1","parentId":"1"}],"spId":"1","parentId":""}]}
https://emr.api3.fincloud.tencent.cn/?Action=ModifyResourceScheduleConfig
&<公共请求参数>
&InstanceId=tbds-4fhbt9um
&Key="capacity"
&Value="{"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":"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":"default","minResources":null,"maxResources":null,"maxChildResources":null,"maxRunningApps":null,"weight":null,"maxAMShare":null}],"queues":null,"parentId":"1","spId":"1-0"},{"name":"test1","showMaxChildResources":false,"aclSubmitApps":null,"aclAdministerApps":null,"schedulingPolicy":"fair","configSets":[{"name":"default","minResources":{},"maxResources":{},"maxAMShare":0.5,"weight":1}],"queues":[],"index":1,"type":null,"spId":"1-1","parentId":"1"}],"spId":"1","parentId":""}]}"
2、容量队列修改配置传参Value解释
字段由是json实体
{"Config":"default","ParentId":"","MyId":"root.test1","Name":"test1","BasicParams":{"Items":[{"Key":"state","Value":"RUNNING"},{"Key":"default-node-label-expression","Value":null},{"Key":"acl_submit_applications","Value":"{"user":"","group":""}"},{"Key":"acl_administer_queue","Value":"{"user":"","group":""}"},{"Key":"maximum-capacity","Value":100},{"Key":"minimum-user-limit-percent","Value":null},{"Key":"user-limit-factor","Value":null},{"Key":"maximum-allocation-mb","Value":null},{"Key":"maximum-allocation-vcores","Value":null},{"Key":"maximum-applications","Value":10000},{"Key":"maximum-am-resource-percent","Value":0.1},{"Key":"default-application-priority","Value":null},{"Key":"user-settings","Value":"[]"}]},"LabelParams":[{"Items":[{"Key":"labelName","Value":""},{"Key":"min-abs-capacity","Value":null},{"Key":"max-abs-capacity","Value":null},{"Key":"capacity","Value":60},{"Key":"maximum-capacity","Value":100}]},{"Items":[{"Key":"labelName","Value":"jolin"},{"Key":"min-abs-capacity","Value":null},{"Key":"max-abs-capacity","Value":null},{"Key":"capacity","Value":60},{"Key":"maximum-capacity","Value":100}]}],"OpType":1}
输入示例
https://emr.api3.{{conf.domain_main}}/?Action=ModifyYarnQueue
&<公共请求参数>
&InstanceId=tbds-4fhbt9um
&Scheduler="capacity"
&ConfigModifyInfo="{"Config":"default","ParentId":"","MyId":"root.test1","Name":"test1","BasicParams":{"Items":[{"Key":"state","Value":"RUNNING"},{"Key":"default-node-label-expression","Value":null},{"Key":"acl_submit_applications","Value":"{\"user\":\"*\",\"group\":\"*\"}"},{"Key":"acl_administer_queue","Value":"{\"user\":\"*\",\"group\":\"*\"}"},{"Key":"maximum-capacity","Value":100},{"Key":"minimum-user-limit-percent","Value":null},{"Key":"user-limit-factor","Value":null},{"Key":"maximum-allocation-mb","Value":null},{"Key":"maximum-allocation-vcores","Value":null},{"Key":"maximum-applications","Value":10000},{"Key":"maximum-am-resource-percent","Value":0.1},{"Key":"default-application-priority","Value":null},{"Key":"user-settings","Value":"[]"}]},"LabelParams":[{"Items":[{"Key":"labelName","Value":"<DEFAULT_PARTITION>"},{"Key":"min-abs-capacity","Value":null},{"Key":"max-abs-capacity","Value":null},{"Key":"capacity","Value":60},{"Key":"maximum-capacity","Value":100}]},{"Items":[{"Key":"labelName","Value":"jolin"},{"Key":"min-abs-capacity","Value":null},{"Key":"max-abs-capacity","Value":null},{"Key":"capacity","Value":60},{"Key":"maximum-capacity","Value":100}]}],"OpType":1}"
输出示例
{
"Response": {
"Data": "",
"ErrorMsg": null,
"IsDraft": true,
"RequestId": "0f869322-bc45-45bd-ba2a-a092c8bb2938"
}
}