获取数据接口

最近更新时间:2019-10-11 11:49:01

获取监控数据

1.接口描述

2.输入参数

3.输出参数

4.示例

1.接口描述

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

获取监控数据,支持获取30天以内的数据,容器引擎产品见容器引擎获取数据接口

用户单位时间内调用单API次数,每分钟最多3600次请求。

查询历史数据(时间间隔>15min),支持并发量小。若需实时查询(时间间隔<15min)高并发量数据,请用批量获取数据接口

2.输入参数

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

参数名称 必选 类型 描述
Namespace String 表示一类云产品,指定命名空间。
InstanceID String 监控实例的ID
MetricName String 监控项名称
StartTime String 本地时间,开始时间戳,如2017-02-28T17:00:00Z
EndTime String 本地时间,结束时间戳,如2017-02-28T18:00:00Z, 数据采集有2分钟左右延迟,EndTime需比当前时间延迟两分钟
Period Interger 采样周期,60的整数倍,单位为秒,如果和控制台不一致,会导致数据不一致。默认值为空,将不对数据进行降采样,按产品线的推送频率进行展示。
Aggregate String 数据聚合的方法,Average,Max,Min ,如果和控制台不一致,会导致数据不一致

3.输出参数

参数名称 类型 描述
Datapoints Array 按照指定的统计方法获取的监控数据
Label String 监控指标
RequestId String 请求ID

4.示例

输入

https://monitor.${region}.api.ksyun.com?
Action=GetMetricStatistics
&Version=2010-05-25
&InstanceID=instanceId
&Namespace=KEC
&MetricName=cpu.utilizition.total
&StartTime=2017-02-28T017:00:00Z
&EndTime=2017-02-28T017:14:00Z
&Aggregate=Average,Sum,Count,Max,Min
&Period=600
&公共参数

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

输出

<GetMetricStatisticsResponse xmlns="https://ksyun.kingeyes.com/">
    <GetMetricStatisticsResult>
        <Datapoints>
            <member>
                <Average>0.158</Average>
                <Max>0.217</Max>
                <Min>0.117</Min>
                <SampleCount>1</SampleCount>
                <Sum>2</Sum>
                <Timestamp>2017-02-28T17:00:00Z</Timestamp>
            </member>
            <member>
                <Average>0.158</Average>
                <Max>0.183</Max>
                <Min>0.117</Min>
                <SampleCount>1</SampleCount>
                <Sum>2</Sum>
                <Timestamp>2017-02-28T17:10:00Z</Timestamp>
            </member>       
        </Datapoints>
        <Label>cpu.utilizition.total</Label>
    </GetMetricStatisticsResult>
    <ResponseMetadata>
        <RequestId>11eb1447-e7ee-402e-bc31-5c21f90a2955</RequestId>
    </ResponseMetadata>
</GetMetricStatisticsResponse>

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

注册有礼