DescribeMetricData_云监控_API文档

插件下载了解更多
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 的调用次数限制为 10 次/秒。一个阿里云账号及该账号下的 RAM 用户共用 10 次/秒。

使用说明

说明 DescribeMetricList 不同,本接口具有统计功能(即Dimension={"instanceId": "i-abcdefgh12****"}),将该账号下的所有监控数据进行聚合统计。

本文将提供一个示例,查询云产品acs_ecs_dashboard监控项cpu_idle的监控数据。

流控信息

请求速率为10/1(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
Namespacestring

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

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

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

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

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

示例值:60
StartTimestring

查询监控数据的开始时间。展开详情

示例值:1618368900000
EndTimestring

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

示例值:1618368960000
Dimensionsstring

维度 Map,用于查询指定资源的监控数据。展开详情

示例值:[{"instanceId": "i-abcdefgh12****"}]
Expressstring

对查询出的现有结果进行实时计算的表达式。展开详情

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

每页显示的记录条数,用于分页查询。展开详情

示例值:1000

请求说明

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

返回参数

字段名称字段详情
Codestring

状态码。展开详情

示例值:200
Messagestring

错误信息。

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

请求 ID。

示例值:6A5F022D-AC7C-460E-94AE-B9E75083D027
Datapointsstring

监控数据列表。包括如下信息:展开详情

示例值:[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]
Periodstring

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

示例值:60

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
ParameterInvalid
Illegal parameters.诊断
403
AccessForbidden
User not authorized to operate on the specified resource.诊断
404
ResourceNotFound
The specified resource is not found.诊断
500
InternalError
The request processing has failed due to some unknown error.诊断

变更历史

变更时间变更内容概要操作
2024-01-23
删除返回参数
2023-01-10
新增返回参数

相关示例