OpenAPI按量计费 附录一:接口清单 注意 以下V4.2 为当前最新接口版本,历史低版本接口将逐步下线,不再建议使用。存量调用请尽快迁移至 V4.2,避免下线后影响业务。 一、标准计费接口(共计 2 个) 表 1.1 标准计费接口 序号 接口名称 接口 接口状态 单次请求额度 1 实时监控数据:查询v4.2 POST /v4.2/monitor/querylatestmetricdata 正常维护,推荐使用 动态,取决于请求参数,具体见额度计算方法1 2 历史监控数据:查询v4.2 POST /v4.2/monitor/queryhistorymetricdata 常维护,推荐使用 动态,取决于请求参数,具体见额度计算方法1 额度计算方法1(适用于表1.1接口) 单次API消耗额度 监控项个数 × 设备标签列表最大长度 取值说明 监控项个数:接口请求参数中的itemNameList长度; 设备标签列表最大长度:接口请求参数中的 dimensions 子对象 value 的最大长度。 计算示例 plaintext POST /v4.2/monitor/querylatestmetricdata { "regionID": "bb9fdb42056f11eda1610242ac110002", "service": "ecs", "dimension": "ecs", "itemNameList": ["cpuutil", "memutil"], "dimensions": [ { "name": "uuid", "value": [ "fa7bb231215f48799cd2c8765cf423fa", "f7970585b52b46e9b98e999f7c22beb9", "377f44c7566d4356882f5df94c441bbc" ] } ] } 如上所示,该次请求监控项个数 itemNameList 为 2 个,设备标签列表最大长度 dimensions 下的 value 长度为 3 个,因此本次请求消耗额度为 2 3 6 次。 二、已废弃接口(共计 60 个,仍消耗额度) 注意:本节列举接口已废弃(不再维护),后续将下线。为避免对您的业务产生影响,强烈建议迁移至《一、标准计费接口》。 表 2.1 废弃(仍消耗额度)接口清单 序号 接口名称 接口 接口状态 单次请求额度 1 实时监控数据:查询v4.1 POST /v4.1/monitor/querylatestmetricdata 已废弃,仍计费 固定,取决于入参设备类型deviceType 详见表2.2 2 实时监控数据:云主机v4.1 POST /v4.1/monitor/queryvmlatestmetricdata 已废弃,仍计费 固定,参见表2.2(云主机) 3 实时监控数据:弹性IPv4.1 POST /v4.1/monitor/queryeiplatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性IP) 4 实时监控数据:共享带宽v4.1 POST /v4.1/monitor/querytrafficlatestmetricdata 已废弃,仍计费 固定,参见表2.2(共享带宽) 5 实时监控数据:裸金属v4.1 POST /v4.1/monitor/querybaremetallatestmetricdata 已废弃,仍计费 固定,参见表2.2(裸金属) 6 实时监控数据:云磁盘v4.1 POST /v4.1/monitor/querydisklatestmetricdata 已废弃,仍计费 固定,参见表2.2(云磁盘) 7 实时监控数据:负载均衡v4.1 POST /v4.1/monitor/queryelblatestmetricdata 已废弃,仍计费 固定,参见表2.2(负载均衡) 8 实时监控数据:监听器v4.1 POST /v4.1/monitor/querylistenerlatestmetricdata 已废弃,仍计费 固定,参见表2.2(监听器) 9 实时监控数据:弹性文件v4.1 POST /v4.1/monitor/querysfslatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性文件) 10 实时监控数据:弹性伸缩组v4.1 POST /v4.1/monitor/queryscalinglatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性伸缩) 11 实时监控数据:站点监控v4.1 POST /v4.1/monitor/querysitemonitorlatestmetricdata 已废弃,仍计费 固定,参见表2.2(站点监控) 12 实时监控数据:对象存储桶存储v4.1 POST /v4.1/monitor/queryzosbucketlatestmetricdata 已废弃,仍计费 固定,参见表2.2(对象存储存储桶) 13 实时监控数据:对象存储用户v4.1 POST /v4.1/monitor/queryzosuserlatestmetricdata 已废弃,仍计费 固定,参见表2.2(对象存储用户) 14 实时监控数据:NAT网关v4.1 POST /v4.1/monitor/querynatgwlatestmetricdata 已废弃,仍计费 固定,参见表2.2(NAT网关) 15 实时监控数据:VPC终端节点v4.1 POST /v4.1/monitor/queryvpcendpointlatestmetricdata 已废弃,仍计费 固定,参见表2.2(VPC终端节点) 16 实时监控数据:VPC终端节点服务v4.1 POST /v4.1/monitor/queryvpcendpointservicelatestmetricdata 已废弃,仍计费 固定,参见表2.2(VPC终端节点服务) 17 实时监控数据:云主机 POST /v4/monitor/queryvmlatestmetricdata 已废弃,仍计费 固定,参见表2.2(云主机) 18 实时监控数据:弹性IP POST /v4/monitor/queryeiplatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性IP) 19 实时监控数据:共享带宽 POST /v4/monitor/querytrafficlatestmetricdata 已废弃,仍计费 固定,参见表2.2(共享带宽) 20 实时监控数据:裸金属 POST /v4/monitor/querybaremetallatestmetricdata 已废弃,仍计费 固定,参见表2.2(裸金属) 21 实时监控数据:云磁盘 POST /v4/monitor/querydisklatestmetricdata 已废弃,仍计费 固定,参见表2.2(云磁盘) 22 实时监控数据:负载均衡 POST /v4/monitor/queryelblatestmetricdata 已废弃,仍计费 固定,参见表2.2(负载均衡) 23 实时监控数据:监听器 POST /v4/monitor/querylistenerlatestmetricdata 已废弃,仍计费 固定,参见表2.2(监听器) 24 实时监控数据:弹性文件 POST /v4/monitor/querysfslatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性文件) 25 实时监控数据:弹性伸缩组 POST /v4/monitor/queryscalinglatestmetricdata 已废弃,仍计费 固定,参见表2.2(弹性伸缩) 26 实时监控数据:站点监控 POST /v4/monitor/querysitemonitorlatestmetricdata 已废弃,仍计费 固定,参见表2.2(站点监控) 27 实时监控数据:对象存储 POST /v4/monitor/queryzoslatestmetricdata 已废弃,仍计费 固定,参见表2.2(对象存储存储桶、对象存储用户,取决于设备类型 deviceType ) 28 实时监控数据:NAT网关 POST /v4/monitor/querynatgwlatestmetricdata 已废弃,仍计费 固定,参见表2.2(NAT网关) 29 历史监控数据:查询v4.1 POST /v4.1/monitor/queryhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 30 历史监控数据:云主机v4.1 POST /v4.1/monitor/queryvmhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 31 历史监控数据:弹性IPv4.1 POST /v4.1/monitor/queryeiphistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 32 历史监控数据:共享带宽v4.1 POST /v4.1/monitor/querytraffichistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 33 历史监控数据:裸金属v4.1 POST /v4.1/monitor/querybaremetalhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 34 历史监控数据:云磁盘v4.1 POST /v4.1/monitor/querydiskhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 35 历史监控数据:负载均衡v4.1 POST /v4.1/monitor/queryelbhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 36 历史监控数据:监听器v4.1 POST /v4.1/monitor/querylistenerhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 37 历史监控数据:弹性文件v4.1 POST /v4.1/monitor/querysfshistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 38 历史监控数据:弹性伸缩组v4.1 POST /v4.1/monitor/queryscalinghistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 39 历史监控数据:站点监控v4.1 POST /v4.1/monitor/querysitemonitorhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 40 历史监控数据:对象存储桶存储v4.1 POST /v4.1/monitor/queryzosbuckethistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 41 历史监控数据:对象存储用户v4.1 POST /v4.1/monitor/queryzosuserhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 42 历史监控数据:NAT网关v4.1 POST /v4.1/monitor/querynatgwhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 43 历史监控数据:VPC终端节点v4.1 POST /v4.1/monitor/queryvpcendpointhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 44 历史监控数据:VPC终端节点服务v4.1 POST /v4.1/monitor/queryvpcendpointservicehistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 45 历史监控数据:云主机 POST /v4/monitor/queryvmhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 46 历史监控数据:弹性IP POST /v4/monitor/queryeiphistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 47 历史监控数据:共享带宽 POST /v4/monitor/querytraffichistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 48 历史监控数据:裸金属 POST /v4/monitor/querybaremetalhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 49 历史监控数据:云磁盘 POST /v4/monitor/querydiskhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 50 历史监控数据:负载均衡 POST /v4/monitor/queryelbhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 51 历史监控数据:监听器 POST /v4/monitor/querylistenerhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 52 历史监控数据:弹性文件 POST /v4/monitor/querysfshistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 53 历史监控数据:弹性伸缩组 POST /v4/monitor/queryscalinghistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 54 历史监控数据:站点监控 POST /v4/monitor/querysitemonitorhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 55 历史监控数据:对象存储 POST /v4/monitor/queryzoshistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 56 历史监控数据:NAT网关 POST /v4/monitor/querynatgwhistorymetricdata 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 57 统计数据查询:某段时间内平均值 POST /v4/monitor/querymetricdataavg 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 58 统计数据查询:某段时间内方差 POST /v4/monitor/querymetricdatavariance 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 59 统计数据查询:某段时间内最大值 POST /v4/monitor/querymetricdatamax 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 60 统计数据查询:某段时间内最小值 POST /v4/monitor/querymetricdatamin 已废弃,仍计费 动态,取决于请求参数,具体计算方法见额度计算方法2 表 2.2 设备类型对应单次计费额度 设备类型 传参 deviceType 单次请求消耗额度(次) 云主机 vm 71 弹性IP eip 10 共享带宽 traffic 10 裸金属 baremetal 20 云磁盘 disk 9 负载均衡 elb 17 监听器 listener 17 弹性文件 cstorsfs 9 弹性伸缩 scaling 11 站点监控 sitemonitor 8 对象存储存储桶 zosbucket 52 对象存储用户 zosuser 52 NAT网关 natgw 9 VPC终端节点 vnetmonitorendpointstatistic 19 VPC终端节点服务 vnetendpointservicestatistic 9 VPN网关 ipsecvpngwstats 6 VPN IPsec连接 ipsecvpnconnstats 4 VPC SSL客户端 sslvpnuserstats 4 VPN SSL连接 sslvpnnwisessioncount 1 流量镜像 mrgwqosstatsjob 2 组播 vnetmonitormcstatistic 8 云专线物理专线 cdaphysicalline 3 云专线专线网关 cdavirtualgatewaybase 2 云专线专线网关健康检查 cdavirtualgateway 2 注:表 2.1 的查询接口,单次调用会查询该产品下的所有监控项(itemNameList),并按监控项数量计费。如云主机单次查询含 71 个监控项,即消耗 71 次额度。 额度计算方法2(适用于表2.1引用接口) 单次API消耗额度 监控项名称个数 × 查询设备ID列表数 取值说明: 监控项名称个数:接口请求参数中的 itemNameList 长度; 查询设备ID列表数:接口请求参数中的 deviceUUIDList 长度。 计算示例 plaintext POST /v4.1/monitor/queryhistorymetricdata { "regionID":"bb9fdb42056f11eda1610242ac110002", "itemNameList":[ "cpuutil", "memutil" ], "deviceType": "vm", "startTime":"1665305264", "endTime":"1665391665", "deviceUUIDList":[ "fa7bb231215f48799cd2c8765cf423fa", "f7970585b52b46e9b98e999f7c22beb9", "377f44c7566d4356882f5df94c441bbc" ] } 如上所示,该次请求监控项名称个数 itemNameList 为2个,查询设备ID列表数 deviceUUIDList 长度为3,因此本次消耗额度为 23 6 次。 三、限流错误码 plaintext 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付费服务。" }