文档首页/ 云监控服务 CES/ API参考/ API/ 云资源监控/ 监控视图/ 批量更新监控视图 - BatchUpdateWidgets

更新时间：2026-01-05 GMT+08:00

查看PDF

批量更新监控视图 - BatchUpdateWidgets

功能介绍

批量更新监控视图

接口约束

目前华东-青岛、拉美-墨西哥城一、土耳其-伊斯坦布尔、亚太-雅加达、中东-利雅得、亚太-马尼拉6个局点不支持该接口

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ces:widgets:put	Write	-	ces:namespace	-	-

URI

POST /v2/{project_id}/widgets/batch-update

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见获取项目ID。约束限制: 不涉及。取值范围: 字符串的长度必须在 1 到 64个字符之间。默认取值: 不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	否	String	参数解释: 发送的实体的MIME类型。约束限制: 不涉及。取值范围: 最小字符数量为1，最大为64。默认取值: 默认使用application/json; charset=UTF-8。
X-Auth-Token	否	String	参数解释: 用户Token。约束限制: 不涉及。取值范围: 最小字符数量为1，最大为16384。默认取值: 不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
[数组元素]	是	Array of UpdateWidgetInfo objects	参数解释待修改的监控视图列表约束限制包含的监控视图对象个数为[1,50]

表4 UpdateWidgetInfo
参数	是否必选	参数类型	描述
group_id	否	String	参数解释视图分区id 约束限制不涉及取值范围字符串必须以dg开头，后跟22个字母和数字，总长度为24个字符或者为default，default代表不分组默认取值不涉及
widget_id	是	String	参数解释视图id 约束限制不涉及取值范围字符串必须以wg开头，后跟22个字母和数字，总长度为24个字符默认取值不涉及
metrics	否	Array of WidgetMetric objects	参数解释指标列表约束限制包含的指标对象个数为[1,200]
title	否	String	参数解释监控视图标题约束限制不涉及取值范围字符串可以包含中文字符，字母，数字，下划线（_），横线（-），冒号（:），分号（;），左圆括号（(），右圆括号（)），句号（.），波浪线（~），中文左括号（（），中文右括号（））长度为[1,128]个字符默认取值不涉及
threshold	否	Double	参数解释监控视图指标的阈值约束限制不涉及取值范围阈值为[0,1.7976931348623157e+308] 默认取值不涉及
threshold_enabled	否	Boolean	参数解释阈值是否展示约束限制不涉及取值范围 true 展示 false 不展示默认取值不涉及
view	否	String	参数解释监控视图图表类型约束限制不涉及取值范围枚举值： bar 条形图 line 折线图 bar_chart 柱状图 table 表格 circular_bar 环形柱状图 area_chart 面积图默认取值不涉及
metric_display_mode	否	String	参数解释指标展示类型约束限制不涉及取值范围枚举值： single 单指标展示 multiple 多指标展示默认取值不涉及
properties	否	properties object	参数解释视图展示配置约束限制不涉及
location	否	location object	参数解释监控视图图表坐标约束限制不涉及
unit	否	String	参数解释单位约束限制不涉及取值范围长度为[0,32]个字符默认取值不涉及

表5 WidgetMetric
参数	是否必选	参数类型	描述
namespace	是	String	参数解释查询服务的命名空间，各服务命名空间请参阅支持监控的服务列表约束限制不涉及取值范围格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_。字符串的长度必须在 3 到 32个字符之间。默认取值不涉及
dimensions	是	DimensionInfo object	参数解释维度信息列表。约束限制不涉及
metric_name	是	String	参数解释多个指标名称约束限制不涉及取值范围长度为[1,1080]个字符，多个指标名称之间用逗号隔开默认取值不涉及
alias	否	Array of strings	参数解释监控视图的指标别名列表约束限制当资源类型为指定资源时才允许传该参数包含的指标别名对象个数为[0,200]
extra_info	否	ExtraInfo object	参数解释指标信息约束限制不涉及
rollup_enable	否	Boolean	参数解释是否开启聚合约束限制当rollup_enable开启时，rollup_filter和rollup_dimension必填取值范围 true：表示开启聚合 false：表示不开启聚合默认取值 false
rollup_filter	否	String	参数解释聚合规则约束限制当rollup_enable开启时，rollup_filter和rollup_dimension必填取值范围 last:最新值 max:最大值 min:最小值 average:平均值 sum:求和值默认取值不涉及
rollup_dimension	否	String	参数解释聚合维度约束限制不涉及取值范围长度为[1,32]个字符默认取值不涉及
last_week_compare_enable	否	Boolean	参数解释是否展示同比（上周同一时间）数据约束限制不涉及取值范围 true:展示 false:不展示默认取值不涉及
yesterday_compare_enable	否	Boolean	参数解释是否展示环比（昨天同一时间）数据约束限制不涉及取值范围 true:展示 false:不展示默认取值不涉及
metric_dimension	否	String	参数解释维度名称，多维度用逗号分隔，各服务资源的维度名称，请参阅具体云服务的文档。您可以直接从支持监控的服务列表页面导航至相应文档。，必须以字母开头，只能包含0-9/a-z/A-Z/_/-，多维度用","分隔，每个维度的最大长度为32。总长度为[1,131]个字符。目前最大支持4个维度。举例：单维度场景：instance_id；多维度场景：instance_id,disk 约束限制不涉及取值范围长度为[1,131]个字符默认取值不涉及
top_num	否	Integer	参数解释展示数据数量约束限制不涉及取值范围最小值为1，最大值为200 默认取值不涉及
unit	否	String	参数解释单位约束限制不涉及取值范围长度为[0,32]个字符默认取值不涉及
order	否	String	参数解释排序字段约束限制不涉及取值范围 asc:正序 desc:倒序默认取值不涉及
topn_metric_name	否	String	参数解释资源的监控指标名称，必须以字母开头，只能包含0-9/a-z/A-Z/_，字符长度最短为1，最大为64；如：弹性云服务器中的监控指标cpu_util，表示弹性服务器的CPU使用率；文档数据库中的指标mongo001_command_ps，表示command执行频率；各服务资源的指标名称，请参阅具体云服务的文档。您可以直接从支持监控的服务列表页面导航至相应文档。约束限制不涉及取值范围长度为[1,96]个字符默认取值不涉及

表6 DimensionInfo
参数	是否必选	参数类型	描述
name	是	String	参数解释：维度名称。约束限制不涉及取值范围：多维度用逗号分隔，各服务资源的维度名称，请参阅具体云服务的文档。您可以直接从支持监控的服务列表页面导航至相应文档。。必须以字母开头，只能包含0-9/a-z/A-Z/_/-，多维度用","分隔，每个维度的最大长度为32。总长度为[1,131]个字符。目前最大支持4个维度。举例：单维度场景：instance_id；多维度场景：instance_id,disk 默认取值不涉及
filter_type	是	String	参数解释：资源类型。约束限制 view参数取值为柱状图条形图环形柱状图表格时，则filter_type参数不支持指定资源取值范围： all_instances: 全部资源 specific_instances: 指定资源默认取值不涉及
values	否	Array of strings	参数解释：维度值列表。约束限制包含的维度值对象个数为[0,200]

表7 ExtraInfo
参数	是否必选	参数类型	描述
origin_metric_name	是	String	参数解释指标名称约束限制不涉及取值范围长度为[1,4096]个字符默认取值不涉及
metric_prefix	否	String	参数解释指标名称前缀约束限制不涉及取值范围长度为[1,4096]个字符默认取值不涉及
metric_type	否	String	参数解释指标类型约束限制不涉及取值范围长度为[1,32]个字符默认取值不涉及
custom_proc_name	否	String	参数解释自定义进程名称约束限制不涉及取值范围长度为[1,250]个字符默认取值不涉及

表8 properties
参数	是否必选	参数类型	描述
filter	否	String	参数解释聚合类型约束限制折线图不支持该参数取值范围枚举值： topN topN类型默认取值不涉及
topN	否	Integer	参数解释 Top值前N个约束限制折线图时表示随机展示的时序数据条数取值范围 Top值为[1,2147483647] 默认取值不涉及
order	否	String	参数解释排序字段约束限制折线图不支持该参数取值范围枚举值： asc 正序 desc 倒序默认取值不涉及
description	否	String	参数解释监控视图的描述信息约束限制不涉及取值范围信息长度为[0,200]个字符默认取值不涉及
last_week_compare_enable	否	Boolean	参数解释是否展示同比（上周同一时间）数据约束限制不涉及取值范围 true 展示 false 不展示默认取值不涉及
yesterday_compare_enable	否	Boolean	参数解释是否展示环比（昨天同一时间）数据约束限制不涉及取值范围 true 展示 false 不展示默认取值不涉及
legend_location	否	String	参数解释图例位置标记约束限制表格不支持该参数取值范围枚举值： hide 隐藏图例 right 图例放在监控视图右侧 bottom 图例放在监控视图底部默认取值不涉及
legend_values	否	Array of strings	参数解释当前时序数据需要在图例中展示的统计值名称列表约束限制表格不支持该参数，条形图和柱状图仅支持选择当前值包含的名称对象个数为[0,5]
thresholds	否	Array of ThresholdInfo objects	参数解释监控视图的阈值辅助线配置约束限制包含的配置对象个数为[0,6]
is_all_compare_enable	否	Boolean	参数解释同比环比总开关是否生效约束限制不涉及取值范围 true 生效 false 不生效默认取值不涉及

表9 ThresholdInfo
参数	是否必选	参数类型	描述
threshold	是	Number	参数解释监控视图辅助线的阈值约束限制不涉及取值范围最小值为0，最大值为2147483647 默认取值不涉及
threshold_color	是	String	参数解释监控视图辅助线的颜色约束限制不涉及取值范围 "#B50E65":紫色 "#F23030":红色 "#FF8800":橙色 "#F2E70C":黄色默认取值不涉及

**表10** location
参数	是否必选	参数类型	描述
top	是	Integer	参数解释监控视图的上坐标约束限制不涉及取值范围坐标的取值范围[0,2147483647] 默认取值不涉及
left	是	Integer	参数解释监控视图的左坐标约束限制不涉及取值范围坐标的取值范围[0,9] 默认取值不涉及
width	是	Integer	参数解释监控视图图表宽度约束限制不涉及取值范围宽度的取值范围[3,12] 默认取值不涉及
height	是	Integer	参数解释监控视图图表高度约束限制不涉及取值范围高度的取值范围[3,2147483647] 默认取值不涉及

响应参数

状态码：200

**表11** 响应Body参数
参数	参数类型	描述
widgets	Array of BatchUpdateWidgetInfo objects	参数解释更新结果列表

**表12** BatchUpdateWidgetInfo
参数	参数类型	描述
widget_id	String	参数解释视图id 取值范围字符串必须以wg开头，后跟22个字母和数字，总长度为24个字符
ret_status	String	参数解释修改结果取值范围枚举值： successful 成功 error 失败
error_msg	String	参数解释如果失败则返回失败信息取值范围长度为[1,2048]个字符

状态码：400

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：401

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：500

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

请求示例

[ {
  "widget_id" : "wgXXXXXXXXXXXXXXXXXXXXXX",
  "metrics" : [ {
    "namespace" : "SYS.ECS",
    "dimensions" : {
      "name" : "instance_id",
      "filter_type" : "all_instances"
    },
    "metric_name" : "cpu_util",
    "alias" : [ "cpuutilalias" ],
    "extra_info" : {
      "origin_metric_name" : "cpu_util",
      "metric_prefix" : "cpu",
      "metric_type" : "type",
      "custom_proc_name" : "app.sh"
    }
  } ],
  "view" : "bar",
  "metric_display_mode" : "single",
  "threshold" : 500,
  "threshold_enabled" : false,
  "title" : "widget_title_new",
  "properties" : {
    "filter" : "topN",
    "topN" : 10,
    "order" : "asc"
  },
  "location" : {
    "left" : 0,
    "top" : 3,
    "width" : 4,
    "height" : 3
  },
  "unit" : "%"
} ]

响应示例

状态码：200

{
  "widgets" : [ {
    "widget_id" : "wgXXXXXXXXXXXXXXXXXXXXXX",
    "ret_status" : "successful"
  }, {
    "widget_id" : "wg9876543210123456789012",
    "ret_status" : "error",
    "error_msg" : "record not found"
  } ]
}

状态码

状态码	描述
200	OK
400	Bad Request, 请求错误
401	Unauthorized, 未提供认证信息，或认证信息错误
500	Internal Server Error, 请求未完成, 服务异常

错误码

请参见错误码。

父主题： 监控视图

上一篇：删除指定监控视图 - DeleteOneWidget

下一篇：资源标签管理

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问