调用DescribeHybridMonitorDataList接口查询指定指标仓库中的监控数据。
接口说明
前提条件
请确保您已开通企业云监控。具体操作，请参见开通企业云监控。
使用限制
单次最多返回监控数据 1.5 MB。如果返回数据过大，则查询失败，请您重新设置查询条件。
使用说明
本文将提供一个示例，查询指标仓库default-aliyun中监控指标AliyunEcs_cpu_total在指定时间1653804865（2022-05-29 14:14:25）至1653805225（2022-05-29 14:20:25）内的监控数据。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| cms:DescribeCustomMetricDataPoint | list | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Namespace | string | 是 | 指标仓库名称。 关于如何获取指标仓库名称，请参见 DescribeHybridMonitorNamespaceList 。 | default-aliyun |
| PromSQL | string | 是 | 监控指标。
支持 PromQL 查询语句。
| AliyunEcs_cpu_total |
| Start | long | 是 | 开始时间戳。 单位：秒。 | 1653804865 |
| End | long | 是 | 结束时间戳。 单位：秒。 | 1653805225 |
| Period | string | 否 | 监控数据的统计周期。 单位：秒。 | 60 |
关于公共请求参数的详情，请参见公共参数。
返回参数
示例
正常返回示例
JSON格式
{
"Code": "200",
"Message": "end timestamp must not be before start time.",
"RequestId": "C240412F-3F5F-50E2-ACEC-DE808EF9C4BE",
"Success": "true",
"TimeSeries": [
{
"MetricName": "AliyunEcs_cpu_total",
"Labels": [
{
"K": "instanceId",
"V": "i-rj99xc6cptkk64ml****"
}
],
"Values": [
{
"V": "0.13",
"Ts": "1653804865"
}
]
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | %s | %s | - |
| 400 | BadRequest | Bad request. | 错误参数请求 |
| 409 | %s | Resources already exist. | - |
| 500 | InternalError | %s | - |
访问错误中心查看更多错误码。