修改资源管理计划阶段
功能介绍
修改资源管理计划阶段。
调用方法
请参见如何调用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 |
服务不可用。 |