查询部署资源监控
更新时间：2025-08-05
接口描述
本接口用于获取用户具体部署资源使用量情况，例如CPU、带宽、存储等。
请求结构
Plain Text
1GET /v1/monitor/deployment/{deploymentID}?deploymentId={deploymentId}&start={start}&end={end}&serviceProvider={serviceProvider}&metricsType={metricsType} HTTP/1.1
2Host: bec.baidubce.com
3Content-Type: application/json; charset=utf-8
4Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| deploymentId | String | 是 | QueryString参数 | 部署ID |
| metricsType | String | 是 | RequestParam参数 | 监控类型。 CPU、MEMORY、BANDWIDTH_RECEIVE（入网带宽）、BANDWIDTH_TRANSMIT（出网带宽）。 |
| start | Long | 是 | RequestParam参数 | 起始时间，Unix时间戳，单位秒 |
| end | Long | 是 | RequestParam参数 | 终止时间，Unix时间戳，单位秒 |
| serviceProvider | String | 否 | RequestParam参数 | 指定服务运营商。移动：CHINA_MOBILE，联通：CHINA_UNICOM， 电信：CHINA_TELECOM，海外：BGP，内网：INTRA。默认不填为全部外网。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| metrics | List<Metric> | 监控数值 |
| maxValue | BigDecimal | 最大值 |
| avgValue | BigDecimal | 平均值 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET v1/monitor/deployment/sts-loy3f9tk-2-t-qingdao?deploymentId=sts-loy3f9tk-2-t-qingdao&start=1619107200&end=1619193600&serviceProvider=&metricsType=BANDWIDTH_TRANSMIT HTTP/1.1
2Host: bec.baidubce.com
3Content-Type: application/json; charset=utf-8
4Authorization: bce-auth-v1/318857a8f08b11e9845ca7e54775a0c2/2019-10-17T03:07:21Z/1800/host/212eef8cfe1ac94be56c4afedb9360bba621ef646c3c8288971d36801d70501a响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2019 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5X-Bce-Gateway-Region: BJ
6{
7 "metrics": [
8 {
9 "timeInSecond": 1574857013,
10 "value": 137.6
11 },
12 {
13 "timeInSecond": 1574857313,
14 "value": 152
15 },
16 {
17 "timeInSecond": 1574857613,
18 "value": 126.4
19 },
20 {
21 "timeInSecond": 1574857913,
22 "value": 68.8
23 }
24 ],
25 "maxValue": 152,
26 "avgValue": 121.200000
27}Model对象定义
Metric
| 参数名称 | 类型 | 描述 |
|---|---|---|
| timeInSecond | Integer | Unix时间戳，单位秒 |
| value | BigDecimal | 监控值 |