云监控服务 CES-批量更新监控视图:请求参数

时间:2024-10-29 14:57:13

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

发送的实体的MIME类型。推荐用户默认使用application/json

缺省值:application/json;charset=UTF-8

最小长度:1

最大长度:64

X-Auth-Token

String

用户Token。用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度:1

最大长度:16000

表3 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of UpdateWidgetInfo objects

批量更新监控视图请求体

表4 UpdateWidgetInfo

参数

是否必选

参数类型

描述

widget_id

String

视图id

正则匹配:^wg([a-z]|[A-Z]|[0-9]){22}$

metrics

Array of WidgetMetric objects

指标列表

数组长度:1 - 200

title

String

监控视图标题

最小长度:1

最大长度:128

正则匹配:^([\u4E00-\u9FFF]|[a-z]|[A-Z]|[0-9]|_|-|:|;|\(|\)|\.|~|(|))+$

threshold

Double

监控视图指标的阈值

最小值:0

最大值:1.7976931348623157E308

threshold_enabled

Boolean

阈值是否展示,true:展示,false:不展示

view

String

监控视图图表类型, bar条形图,line折线图,bar_chart柱状图,table表格,circular_bar环形柱状图,area_chart面积图

枚举值:

  • bar

  • line

  • bar_chart

  • table

  • circular_bar

  • area_chart

metric_display_mode

String

指标展示类型,single 单指标展示,multiple 多指标展示

枚举值:

  • single

  • multiple

properties

properties object

视图展示配置

location

location object

监控视图图表坐标

unit

String

单位

表5 WidgetMetric

参数

是否必选

参数类型

描述

namespace

String

服务维度

最小长度:3

最大长度:32

正则匹配:^([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_)*\.([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_)*$

dimensions

DimensionInfo object

维度信息列表

metric_name

String

指标名称

最小长度:1

最大长度:96

正则匹配:^([A-Za-z]){1}([0-9A-Za-z]|_|-)*$

alias

Array of strings

监控视图的指标别名列表

最小长度:1

最大长度:128

数组长度:0 - 200

extra_info

ExtraInfo object

指标信息

表6 DimensionInfo

参数

是否必选

参数类型

描述

name

String

维度名称,多维度用逗号分隔,各服务支持的维度可参考:“服务维度名称

最小长度:1

最大长度:131

正则匹配:^([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_|-){0,31}(,([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_|-){0,31}){0,3}$

filter_type

String

资源类型, all_instances: 全部资源, specific_instances: 指定资源

枚举值:

  • all_instances

  • specific_instances

values

Array of strings

维度值列表

最小长度:1

最大长度:1024

数组长度:0 - 200

表7 ExtraInfo

参数

是否必选

参数类型

描述

origin_metric_name

String

指标名称

最小长度:1

最大长度:4096

正则匹配:^([a-z]|[A-Z]|[0-9]|_|-|~|\.|/|:)*$

metric_prefix

String

指标名称前缀

最小长度:1

最大长度:4096

正则匹配:^([a-z]|[A-Z]|[0-9]|_|-|~|\.|/|:)*$

metric_type

String

指标类型

最小长度:1

最大长度:32

正则匹配:^([a-z]|[A-Z]|[0-9]|_|-|~|\.|/|:)*$

custom_proc_name

String

自定义进程名称

最小长度:1

最大长度:250

表8 properties

参数

是否必选

参数类型

描述

filter

String

聚合类型,目前只有TopN这一种类型,折线图不支持该参数

枚举值:

  • topN

topN

Integer

Top值前N个;折线图时表示随机展示的时序数据条数

最小值:1

最大值:2147483647

缺省值:100

order

String

排序字段,asc正序,desc倒序,折线图不支持该参数

枚举值:

  • asc

  • desc

表9 location

参数

是否必选

参数类型

描述

top

Integer

监控视图的上坐标

最小值:0

最大值:2147483647

left

Integer

监控视图的左坐标

最小值:0

最大值:9

width

Integer

监控视图图表宽度

最小值:3

最大值:12

height

Integer

监控视图图表高度

最小值:3

最大值:2147483647

support.huaweicloud.com/api-ces/BatchUpdateWidgets.html