修改资源管理计划阶段
功能介绍
修改资源管理计划阶段。
调用方法
请参见如何调用API。
URI
PUT /v2/{project_id}/clusters/{cluster_id}/workload/plans/{plan_id}/stages/{stage_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| cluster_id | 是 | String | 参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
| plan_id | 是 | String | 参数解释: 计划ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| stage_id | 是 | String | 参数解释: 计划阶段ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| workload_plan_stage | 否 | workload_plan_stage object | 参数解释: 资源管理计划阶段详情。 取值范围: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| day | 否 | String | 参数解释: 日期。 取值范围: 不涉及。 |
| month | 否 | String | 参数解释: 月份。 取值范围: 不涉及。 |
| stage_name | 否 | String | 参数解释: 计划阶段。 取值范围: 不涉及。 |
| start_time | 否 | String | 参数解释: 开始时间。 取值范围: 不涉及。 |
| end_time | 否 | String | 参数解释: 结束时间。 取值范围: 不涉及。 |
| queue_list | 否 | Array of QueueResourceItem objects | 参数解释: 资源队列。 取值范围: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| queue_name | 是 | String | 参数解释: 资源池名称。 取值范围: 不涉及。 |
| queue_resources | 是 | Array of WorkloadResourceItem objects | 参数解释: 资源配置队列。 取值范围: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource_name | 是 | String | 参数解释: 资源名称。 约束限制: 不涉及。 取值范围: cpu:占用CPU时间片的百分比。 cpu_limit:使用CPU物理核数的百分比。 memory:指每个数据节点上可用内存资源的百分比。 concurrency:并发数。 shortQueryConcurrencyNum:简单语句并发数。 weight:网络调度时权重值。 默认取值: 不涉及。 |
| resource_value | 是 | Integer | 参数解释: 资源属性值。 约束限制: 不涉及。 取值范围: 根据配置不同,取值范围不同 cpu:取值范围为1~99的整数。 cpu_limit:取值范围为0~100的整数,0表示不限制。 memory:取值范围为0~100的整数,0表示不管控。 concurrency:取值范围为-1~2147483647的整数,-1/0表示不限制。 shortQueryConcurrencyNum:取值范围为-1~2147483647的整数,-1/0表示不管控。 weight:取值范围为1~2147483647的整数,默认配置为-1。 默认取值: 不涉及。 |
| value_unit | 否 | String | 参数解释: 资源属性单位。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_description | 否 | String | 参数解释: 资源附加描述。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| workload_res_code | Integer | 参数解释: 结果状态码。 取值范围: 不涉及。 |
| workload_res_str | String | 参数解释: 结果描述。 取值范围: 不涉及。 |
| workload_plan_stage | PlanStage object | 参数解释: 计划阶段详情。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| month | String | 参数解释: 计划月份。 取值范围: 不涉及。 |
| day | String | 参数解释: 计划日期。 取值范围: 不涉及。 |
| plan_id | String | 参数解释: 计划ID。 取值范围: 不涉及。 |
| stage_id | String | 参数解释: 计划阶段ID。 取值范围: 不涉及。 |
| stage_name | String | 参数解释: 计划阶段名称。 取值范围: 不涉及。 |
| start_time | String | 参数解释: 计划开始时间。 取值范围: 不涉及。 |
| end_time | String | 参数解释: 计划结束时间。 取值范围: 不涉及。 |
| next_valid_time | String | 参数解释: 下次校验时间。 取值范围: 不涉及。 |
| queue_list | Array of QueueResourceItem objects | 参数解释: 资源队列列表。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| queue_name | String | 参数解释: 资源池名称。 取值范围: 不涉及。 |
| queue_resources | Array of WorkloadResourceItem objects | 参数解释: 资源配置队列。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| resource_name | String | 参数解释: 资源名称。 约束限制: 不涉及。 取值范围: cpu:占用CPU时间片的百分比。 cpu_limit:使用CPU物理核数的百分比。 memory:指每个数据节点上可用内存资源的百分比。 concurrency:并发数。 shortQueryConcurrencyNum:简单语句并发数。 weight:网络调度时权重值。 默认取值: 不涉及。 |
| resource_value | Integer | 参数解释: 资源属性值。 约束限制: 不涉及。 取值范围: 根据配置不同,取值范围不同 cpu:取值范围为1~99的整数。 cpu_limit:取值范围为0~100的整数,0表示不限制。 memory:取值范围为0~100的整数,0表示不管控。 concurrency:取值范围为-1~2147483647的整数,-1/0表示不限制。 shortQueryConcurrencyNum:取值范围为-1~2147483647的整数,-1/0表示不管控。 weight:取值范围为1~2147483647的整数,默认配置为-1。 默认取值: 不涉及。 |
| value_unit | String | 参数解释: 资源属性单位。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_description | String | 参数解释: 资源附加描述。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求示例
put https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/e59d6b86-9072-46eb-a996-13f8b44994c1/workload/plans/0c2145ad-4d76-4abe-bd1b-cdbe9128478a/stages/00bc8bc5-c885-42e5-b205-80547d3f94c4
{
"workload_plan_stage" : {
"day" : "1",
"month" : "1",
"stage_name" : "stage1",
"start_time" : "00:00:00",
"end_time" : "00:00:00",
"queue_list" : [ {
"queue_name" : "test_1",
"queue_resources" : [ {
"resource_name" : "cpu",
"resource_value" : 80
}, {
"resource_name" : "cpu_limit",
"resource_value" : 0
}, {
"resource_name" : "memory",
"resource_value" : 0
}, {
"resource_name" : "concurrency",
"resource_value" : 10
}, {
"resource_name" : "shortQueryConcurrencyNum",
"resource_value" : -1
}, {
"resource_name" : "weight",
"resource_value" : -1
} ]
} ]
}
} 响应示例
状态码:200
修改资源管理计划阶段信息成功。
{
"workload_plan_stage" : {
"day" : "1",
"month" : "1",
"stage_name" : "stage1",
"start_time" : "00:00:00",
"end_time" : "00:00:00",
"queue_list" : [ {
"queue_name" : "test_1",
"queue_resources" : [ {
"resource_name" : "cpu",
"resource_value" : 80
}, {
"resource_name" : "cpu_limit",
"resource_value" : 0
}, {
"resource_name" : "memory",
"resource_value" : 0
}, {
"resource_name" : "concurrency",
"resource_value" : 10
}, {
"resource_name" : "shortQueryConcurrencyNum",
"resource_value" : -1
}, {
"resource_name" : "weight",
"resource_value" : -1
} ]
} ]
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 修改资源管理计划阶段信息成功。 |
| 400 | 请求错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 404 | 找不到资源。 |
| 500 | 服务内部错误。 |
| 503 | 服务不可用。 |