关联集群接口
更新时间：2026-04-16
CProm监控实例关联CCE集群
描述
CProm监控实例关联绑定CCE集群
请求结构
Http
1PUT /v2/instance/{instanceId}?action={action} HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "clusterId": "{clusterId}"
7}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path | CProm 监控实例 ID。 |
| action | String | 是 | QueryString | 操作类型，可选值为 Bind、Unbind。Bind 表示绑定 CProm 实例与 CCE 集群，Unbind 表示解绑。缺省值为 Bind。 |
| clusterId | String | 是 | Body | CCE 集群 ID。 |
响应头域
除公共响应头域外，无其他特殊头域。响应示例中的 x-bce-request-id 可用于请求定位。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bindingStatus | String | 绑定状态。绑定请求返回 Binding，解绑请求返回 Unbinding。 |
请求示例
绑定集群请求示例：
Http
1PUT /v2/instance/cprom-xxxxx?action=Bind HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "clusterId": "cce-xxxxxx"
8}解绑集群请求示例：
Http
1PUT /v2/instance/cprom-xxxxx?action=Unbind HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "clusterId": "cce-xxxxx"
8}响应示例
绑定集群返回示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Fri, 20 May 2022 08:23:14 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "bindingStatus": "Binding"
8}解绑集群返回示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Tue, 27 May 2025 08:23:14 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "bindingStatus": "Unbinding"
8}查询 CCE 集群接入 CProm 状态
接口描述
查询指定 CCE 集群接入 CProm 的状态，并返回关联的 CProm 监控实例 ID 与 Agent ID。调用前需准备真实存在的 clusterId。接口使用 BCE AK/SK 签名鉴权，在 Authorization 头中传入签名字符串。
请求结构
Http
1GET /v2/cluster_binding?clusterId={clusterId} HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| clusterId | String | 是 | QueryString | CCE 集群 ID。 |
响应头域
除公共响应头域外，无其他特殊头域。响应示例中的 x-bce-request-id 可用于请求定位。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bindingStatus | String | 可能返回的值：Unbound（未接入）、Binding（接入中）、Bound（已接入）、BoundFailed（接入失败）、Unbinding（解绑中）、Unknown（其他非预期状态）。 |
| instanceId | String | CProm 监控实例 ID。 |
| agentId | String | Agent ID。 |
请求示例
Http
1GET /v2/cluster_binding?clusterId=xxxx HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Tue, 27 May 2025 08:23:14 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "bindingStatus": "Bound",
8 "instanceId": "cprom-xxxxx",
9 "agentId": "agent-xxxxx"
10}评价此篇文章