DescribeMetricLast分页
查询指定监控项的最新监控数据
服务地址:
华东1(杭州)
输入参数
只看必填
Namespace云产品的数据命名空间
MetricName云产品的监控项名称
Period监控数据的统计周期
StartTime查询监控项的开始时间
EndTime查询监控项的结束时间
Dimensions指定资源的监控维度
Length返回监控数据的每页大小
Express对现有查询结果进行实时计算的表达式
分页参数
NextToken分页游标的标识
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

使用限制

  • 调用 DescribeMetricLast、DescribeMetricList、DescribeMetricData 和 DescribeMetricTop 的接口,有 100 万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该 API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该 API 仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见开通按量计费
  • 单个 API 的调用次数限制为 50 次/秒,即一个阿里云账号及该账号下的 RAM 用户共用 50 次/秒。
说明 当您调用 API 时,如果返回信息Throttling.UserRequest was denied due to user flow control,则说明该 API 被限流。处理方法,请参见如何处理查询 API 限流问题

注意事项

各云产品监控数据的存储时长与Period(统计周期)有关,Period越大,查询的监控数据越稀疏,监控数据的存储时间越长,具体关系如下:

  • Period小于 60 秒,存储时长为 7 天。
  • Period等于 60 秒,存储时长为 31 天。
  • Period大于等于 300 秒,存储时长为 91 天。

使用说明

本文将提供一个示例,查询云产品acs_ecs_dashboard监控项CPUUtilization的最新监控数据。返回结果显示,当前账号123456789876****下实例i-abcdefgh12****间隔 60 秒的最大值为 100、最小值为 93.1、平均值为 99.52。

请求参数

字段名称字段详情
Namespacestring

云产品的数据命名空间。展开详情

示例值:acs_ecs_dashboard参考取值来源:
    ModifyHybridMonitorNamespace
    DeleteHybridMonitorNamespace
    CreateHybridMonitorNamespace
    DescribeHybridMonitorNamespaceList
MetricNamestring

云产品的监控项名称。展开详情

示例值:CPUUtilization参考取值来源:
    CreateMetricRuleTemplate
    DescribeMetricMetaList
Periodstring

监控数据的统计周期。展开详情

示例值:60
StartTimestring

查询监控项的开始时间。

示例值:2019-01-31 10:00:00
EndTimestring

查询监控项的结束时间。展开详情

示例值:2019-01-31 10:10:00
Dimensionsstring

指定资源的监控维度。展开详情

示例值:[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextTokenstring

分页游标的标识。展开详情

示例值:15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Lengthstring

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

示例值:1000
Expressstring

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

示例值:{"groupby":["userId","instanceId"]}

请求说明

关于公共请求参数的详情,请参见公共参数

返回参数

字段名称字段详情
NextTokenstring

分页游标标识。

示例值:xxxxxx
RequestIdstring

请求 ID。

示例值:021472A6-25E3-4094-8D00-BA4B6A5486C3
Successboolean

操作是否成功。取值:展开详情

示例值:true
Datapointsstring

监控数据列表。

示例值:[{"timestamp":1548777660000,"userId":"123456789876****","instanceId":"i-abcdefgh12****","Minimum":93.1,"Average":99.52,"Maximum":100}]
Codestring

状态码。展开详情

示例值:200
Messagestring

错误信息。

示例值:The specified resource is not found.
Periodstring

时间间隔。展开详情

示例值:60
变更历史
暂无变更历史