全部文档
当前文档
最近更新时间：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>纯净模式