更新时间:2025-09-18 GMT+08:00

修改资源管理计划阶段

功能介绍

修改资源管理计划阶段。

调用方法

请参见如何调用API

URI

PUT /v2/{project_id}/clusters/{cluster_id}/workload/plans/{plan_id}/stages/{stage_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

必须是有效的dws集群ID。

取值范围

36位UUID。

默认取值

不涉及。

plan_id

String

参数解释

计划ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

stage_id

String

参数解释

计划阶段ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

workload_plan_stage

workload_plan_stage object

参数解释

资源管理计划阶段详情。

取值范围

不涉及。

表3 workload_plan_stage

参数

是否必选

参数类型

描述

day

String

参数解释

日期。

取值范围

不涉及。

month

String

参数解释

月份。

取值范围

不涉及。

stage_name

String

参数解释

计划阶段。

取值范围

不涉及。

start_time

String

参数解释

开始时间。

取值范围

不涉及。

end_time

String

参数解释

结束时间。

取值范围

不涉及。

queue_list

Array of QueueResourceItem objects

参数解释

资源队列。

取值范围

不涉及。

表4 QueueResourceItem

参数

是否必选

参数类型

描述

queue_name

String

参数解释

资源池名称。

取值范围

不涉及。

queue_resources

Array of WorkloadResourceItem objects

参数解释

资源配置队列。

取值范围

不涉及。

表5 WorkloadResourceItem

参数

是否必选

参数类型

描述

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

表6 响应Body参数

参数

参数类型

描述

workload_res_code

Integer

参数解释

结果状态码。

取值范围

不涉及。

workload_res_str

String

参数解释

结果描述。

取值范围

不涉及。

workload_plan_stage

PlanStage object

参数解释

计划阶段详情。

取值范围

不涉及。

表7 PlanStage

参数

参数类型

描述

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

参数解释

资源队列列表。

取值范围

不涉及。

表8 QueueResourceItem

参数

参数类型

描述

queue_name

String

参数解释

资源池名称。

取值范围

不涉及。

queue_resources

Array of WorkloadResourceItem objects

参数解释

资源配置队列。

取值范围

不涉及。

表9 WorkloadResourceItem

参数

参数类型

描述

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

服务不可用。