最近更新时间:2024-04-22 11:56:52
域名:monitor.api.ksyun.com
VPC内调用域名:monitor.internal.api.ksyun.com
接口名: GetMetricStatistics
本接口支持查询最近15min以前的历史数据(30天以内),支持并发量小。
若需查询最近15min内的实时数据,且为高并发量数据,请用批量获取数据接口。
容器引擎产品见容器引擎获取数据接口。
用户单位时间内调用单API次数,每分钟最多3600次请求。
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。
其中此接口的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,Sum ,如果和控制台不一致,会导致数据不一致 |
参数名称 | 类型 | 描述 |
---|---|---|
Datapoints | Array | 按照指定的统计方法获取的监控数据 |
Label | String | 监控指标 |
RequestId | String | 请求ID |
输入
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>
纯净模式