获取指标接口

最近更新时间:2019-08-06 14:45:47

获取监控指标

1.接口描述

2.输入参数

3.输出参数

4.示例

1.接口描述

域名:monitor.region.api.ksyun.com
接口名: ListMetrics

查询实例的监控指标。查询到对应的名字空间下对应实例的监控指标类型。

用户单位时间内调动单API次数,每分钟5000次请求。

2.输入参数

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

参数名称 必选 类型 描述
Namespace String 表示一类云产品,指定命名空间。
InstanceID String 监控实例的ID
MetricName String 监控项名称,传入该参数将返回对应监控项的详细信息。
PageIndex Interger 返回列表的分页索引
PageSize Interger 返回列表显示的对象数量

3.输出参数

参数名称 类型 描述
Metrics Array 监控指标的集合
RequestId String 请求ID

Metrics的内容:

参数名称 类型 描述
InstanceId String 监控实例的ID
Interval String 监控周期
MetricName String 指标名称
Namespace String 云产品类型
Type String 数值类型,Integer/Float
Unit String 指标单位

4.示例

输入

https://monitor.${region}.api.ksyun.com?
Action=ListMetrics
&Version=2010-05-25
&InstanceID=instanceId
&Namespace=KEC
&PageIndex=1
&PageSize=1
&公共参数

${region}可替换相应区域,详见region说明

输出

<ListMetricsResponse xmlns="https://ksyun.kingeyes.com/">
    <ListMetricsResult>
        <Metrics>
            <member>
                <InstanceId>instanceId</InstanceId>
                <Interval>60</Interval>
                <MetricName>cpu.utilizition.total</MetricName>
                <Namespace>KEC</Namespace>
                <Type>Float</Type>
                <Unit>%</Unit>
            </member>
        </Metrics>
    </ListMetricsResult>
    <ResponseMetadata>
        <RequestId>b46a778c-d73e-4b24-a478-0f448218ddb6</RequestId>
    </ResponseMetadata>
</ListMetricsResponse>

金山云,开启您的云计算之旅

立即注册