调用DescribeMetricLast接口查询指定监控对象的最新监控数据。

关于各个阿里云产品的Project、Metric、Period、Dimensions等参数的取值,请参见DescribeMetricMetaList预设监控项参考

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeMetricLast

系统规定参数,取值:DescribeMetricLast。

MetricName String CPUUtilization

监控项名称。

Namespace String acs_ecs_dashboard

产品的数据命名空间,用于区分不同的产品。

命名方式:acs_产品名。

Dimensions String [{"instanceId":"XXXXXX"}]

维度map,用于查询指定资源的监控数据。

格式为key-value键值对形式的集合,常用的key-value集合为instanceId:XXXXXX

keyvalue的长度为1~64个字节,超过64个字节时截取前64字节。keyvalue的取值可包含字母、数字、点号(.)、短横线(-)、下划线(_)、正斜线(/)和反斜线(\)。

说明 Dimensions传入时需要使用JSON字符串表示该map对象,必须按顺序传入。
EndTime String 2019-01-31 10:10:00

结束时间。

格式为Unix时间戳,即从1970年1月1日开始所经过的秒数。

说明 只能查询270天以内的监控数据。
Express String {"groupby":["userId","instanceId"]}

对现有查询结果进行实时计算的表达式。

Length String 1000

返回监控数据的每页大小,用于分页查询。

默认值为1000,即每页1000条监控数据。

NextToken String 15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****

分页游标的标识。

  • 如果匹配查询条件的返回结果超过了分页大小,则会返回这个分页游标。
  • 如果需要获取下一页数据,将返回的游标值作为请求参数即可,直到没有游标值的返回则表示已经获取了全部结果数据。
Period String 60

时间间隔,通常为监控项的上报周期,单位为秒。

说明
  • 如果不填写,则按照注册监控项时申明的上报周期来查询原始数据。
  • 如果设置报警规则时设置了统计周期,则会按照此周期查询对应的统计数据。
StartTime String 2019-01-31 10:00:00

开始时间。

格式为Unix时间戳,即从1970年1月1日开始所经过的秒数。

说明 只能查询270天以内且开始时间和结束时间不超过31天的监控数据。

返回数据

名称 类型 示例值 描述
RequestId String 021472A6-25E3-4094-8D00-BA4B6A5486C3

请求ID。

Code String 200

状态码。

说明 状态码为200表示成功。
Success Boolean true

请求是否成功。

Period String 60

时间间隔,单位为秒。

NextToken String xxxxxx

分页游标标识。

Datapoints String [{"timestamp":1548777660000,"userId":"123","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]

监控数据列表。

Message String Success

错误信息。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeMetricLast
&MetricName=CPUUtilization
&Namespace=acs_ecs_dashboard
&<公共请求参数>

正常返回示例

XML 格式

<QueryMetricListResponse>
    <Period>60</Period>
    <Datapoints>
        <Datapoints>
            <timestamp>1490152860000</timestamp>
            <Maximum>100</Maximum>