添加统计类型

最近更新时间:2019-05-13 18:48:10

1. 接口描述

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

为指标下的指定维度添加统计类型,一个指标可以有多种统计类型。
指标下必须有其对应的统计类型,才能查询得到上报的数据的分析结果。
当您在 创建指标创建指标聚合 时已经填写了统计类型相关信息时,可以跳过此接口。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateMetricStatisticsType。

参数名称 必选 类型 描述
namespace String 为该命名空间下的指标添加统计类型,调用 查询命名空间(DescribeNamespace) 接口查询
metricName String 为该指标添加统计类型,调用 查询指标 (DescribeMetric)接口查询
dimensionNames.n Array 该指标的所有维度组合或者聚合的维度组合,调用 查询指标(DescribeMetric) 接口查询
statisticsType.m.period Int 统计周期,以秒为单位,目前必须填写300s暂不支持其他值
statisticsType.m.statistics String 统计方式,包括max、min、last、sum、avg等

dimensionNames.n,此处的下标n,表示该指标的维度的下标。
可以填写指标的原始维度(即指标下的所有维度)或者指标下聚合的维度

statisticsType.m.statistics和statisticsType.m.period成对出现,可以对该指标的维度添加多组统计类型。
此处的下标m表示不同的统计类型数字下标
例如: statisticsType.0.statistics=max statisticsType.0.period=300
statisticsType.1.statistics=min statisticsType.1.period=300
表示在统计周期5分钟内取上报的数据的最大值和最小值。

3. 输出参数

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

4. 错误码列表

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

5. 示例

输入

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

输出

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