创建指标聚合

最近更新时间:2019-05-13 18:47:44

1. 接口描述

添加指标聚合,将该指标下的指定维度聚合起来,以实现统计指标下部分维度的信息的功能以及查询指标下部分维度信息的功能。
例如:指标diskusage有维度dimensionNames.0=ip dimensionNames.1=diskname
将维度dimensionNames.0=ip聚合起来,调用添加统计类型接口时,才可以只指定维度ip。此处表示以机器的ip的维度去统计磁盘的使用率。

域名:monitor.api.qcloud.com
接口名:CreateMetricAggeration

2. 输入参数

参数名称 必选 类型 描述
namespace String 命名空间,调用查询命名空间(DescribeNamespace)接口查询
metricName String 指标名,调用查询指标(DescribeMetric)接口查询
dimensionNames.n String 需要聚合的维度名称,调用查询指标(DescribeMetric)接口查询
statisticsType.m.period Int 统计周期目前只能填写300秒
statisticsType.m.statistics String 为聚合的维度添加统计方式,包括max、min、last、sum、avg等

statisticsType.m.statistics 和 statisticsType.m.period 填写时,为该聚合下的所有维度添加统计类型

3. 输出参数

参数名称 类型 描述
code Int 错误码, 0: 成功, 其他值表示失败,详见错误码表
message String 错误信息

4. 错误码表

错误代码 错误描述 英文描述
-503 请求参数有误 InvalidParameter
-505 参数缺失 InvalidParameter.MissingParameter
-507 超出限制 OperationDenied.ExceedLimit
-509 错误的维度组合 InvalidParameter.DimensionGroupError
-513 DB操作失败 InternalError.DBoperationFail
-514 资源重复 OperationDenied.SourceAlreadyExists

5. 示例

输入

https://monitor.api.qcloud.com/v2/index.php?Action=CreateMetricAggeration
&<公共请求参数>
&namespace=cvm
&metricName=diskusage
&dimensionNames.0=ip
&statisticsType.0.period=300
&statisticsType.0.statistics=max

输出

{
    "code":"0",
    "message":""
}