使用示例
最近更新时间: 2019-11-22 20:50:26
为了帮助您快速使用云监控API，这里给出一个使用示例。该示例查询云服务器的cpu利用率：
读取监控数据
需要查询云服务器的cpu利用率这里namespace取值为qce/cvm，metricName取值为cpu_usage。
其公共请求参数的Action字段为GetMetricStatistics， 接口请求参数如下表：
查询云服务器指标dimensions.n.name固定为instanceId，dimensions.n.value的取值是调用查看示例列表(DescribeInstances)接口查询得到的。
入参中period取默认值为300s,statistics取默认值avg,表示取5分钟内的cpu平均使用率。
startTime默认为当天00:00:00 ，endTime默认为当前时间。
| 参数名称 | 描述 | 取值 |
| namespace | 名字空间,表示统计指标所属的产品类型，如: "qce/cvm", 表示云服务器 | qce/cvm |
| metricName | 指标名称 | cpu_usage |
| dimensions.n.name | 指标维度的名称 | instanceId |
| dimensions.n.value | 指标维度的值 | ins-dyhv4ltt |
| period | 统计周期 | 无 |
| statistics | 上报数据的统计方法 | 无 |
| startTime | 统计起始时间 | 无 |
| endTime | 统计结束时间 | 无 |
结合公共请求参数和接口请求参数，最终得到的请求形式如下：
https://monitor.api.qcloud.com/v2/index.php?
Action=GetMetricStatistics
&Region=gz
&Timestamp=1465750149
&Nonce=46364
&SecretId=AKIDxxxxugEY
&Signature=5umi9gUWpTTyk18V2g%2FYi56hqls%3D
&namespace=qce/cvm
&dimensions.1.name=instanceId
&dimensions.1.value=ins-dyhv4ltt
&metricName=cpu_usage上述请求的返回结果如下
{
"metricName": "cpu_usage",
"dataPoints": [
0.4,
0.5,
...
0.4,
0.4
],
"code": 0,
"message": ""
}由返回的结果可知instanceId为ins-dyhv4ltt在当天的cpu_usage的数据，其中每个数据表示5分钟内，统计得到的cpu平均使用率。