云监控数据查询类OpenAPI将于北京时间2026年12月1日00:00支持按量计费，开通云监控按量计费功能后，实际调用量超出当月免费额度后，则自动转入按量计费。

附录一：接口清单

一、标准计费接口（共计 2 个）

表 1.1 标准计费接口

额度计算方法1（适用于表1.1接口）

单次API消耗额度 = 监控项个数 × 设备标签列表最大长度

取值说明

• 监控项个数：接口请求参数中的itemNameList长度；

• 设备标签列表最大长度：接口请求参数中的 dimensions 子对象 value 的最大长度。

计算示例

POST /v4.2/monitor/query-latest-metric-data
{
  "regionID": "bb9fdb42056f11eda1610242ac110002",
  "service": "ecs",
  "dimension": "ecs",
  "itemNameList": ["cpu_util", "mem_util"],
  "dimensions": [
    {
      "name": "uuid",
      "value": [
          "fa7bb231-215f-4879-9cd2-c8765cf423fa",
          "f7970585-b52b-46e9-b98e-999f7c22beb9",
          "377f44c7-566d-4356-882f-5df94c441bbc"
      ]
    }
  ]
}

如上所示，该次请求监控项个数 itemNameList 为 2 个，设备标签列表最大长度 dimensions 下的 value 长度为 3 个，因此本次请求消耗额度为 2 * 3 = 6 次。

二、已废弃接口（共计 60 个，仍消耗额度）

注意：本节列举接口已废弃（不再维护），后续将下线。为避免对您的业务产生影响，强烈建议迁移至《一、标准计费接口》。

表 2.1 废弃（仍消耗额度）接口清单

表 2.2 设备类型对应单次计费额度

注：表 2.1 的查询接口，单次调用会查询该产品下的所有监控项（itemNameList），并按监控项数量计费。如云主机单次查询含 71 个监控项，即消耗 71 次额度。

额度计算方法2（适用于表2.1引用接口）

单次API消耗额度 = 监控项名称个数 × 查询设备ID列表数

取值说明：

• 监控项名称个数：接口请求参数中的 itemNameList 长度；

• 查询设备ID列表数：接口请求参数中的 deviceUUIDList 长度。

计算示例

POST /v4.1/monitor/query-history-metric-data
{
    "regionID":"bb9fdb42056f11eda1610242ac110002",
    "itemNameList":[
        "cpu_util",
        "mem_util"
    ],
    "deviceType": "vm",
    "startTime":"1665305264",
    "endTime":"1665391665",
    "deviceUUIDList":[
        "fa7bb231-215f-4879-9cd2-c8765cf423fa",
        "f7970585-b52b-46e9-b98e-999f7c22beb9",
        "377f44c7-566d-4356-882f-5df94c441bbc"
    ]
}

如上所示，该次请求监控项名称个数 itemNameList 为2个，查询设备ID列表数 deviceUUIDList 长度为3，因此本次消耗额度为 2*3 = 6 次。

三、限流错误码

Response Status Code/响应 HTTP 状态码: 200
Response body/响应数据:
{
  "statusCode": 900,
  "errorCode": "Monitor.DataQuery.Limit",
  "error": "Monitor.DataQuery.Limit",
  "messaage": "monitoring data query limit has been reached",
  "msgDesc": "本月监控数据查询次数已达上限，如有需要请登陆官网购买云监控openapi付费服务。",
  "description": "本月监控数据查询次数已达上限，如有需要请登陆官网购买云监控openapi付费服务。"
}