实例组操作接口
更新时间：2025-08-21
查询实例组列表
接口描述
查询指定集群的实例组信息
权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求，请参考 鉴权认证。
注意事项
如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden，错误信息：AccessDenied。
请求结构
Plain Text
1GET /v{version}/cluster/{clusterId}/instanceGroup HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: bmr.bj.baidubce.com
5connection: keep-alive
6accept: */*
7content-type: application/json
8authorization: {bce-authorization-string}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否必须 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clusterId | String | 是 | URL参数 | 指定的集群ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名 | 参数类型 | 参数描述 |
|---|---|---|
| instanceGroups | List<InstanceGroup> | 返回的实例组列表 |
请求示例
Plain Text
1GET /v1/cluster/0ce4f730-4af2-4f37-8fa2-b14f2f44e50e/instanceGroup HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2022-01-26T13:02:00Z
4host: bmr.bj.baidubce.com
5connection: keep-alive
6accept: */*
7content-type: application/json
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2022-01-26T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
4Cache-Control: no-cache
5Server: BWS
6Date: Wed, 26 Jan 2022 13:02:01 GMT
7Content-Type: application/json;charset=UTF-8
8{
9 "instanceGroups": [
10 {
11 "id": "04ef4f35-2d16-4e5b-9944-bd4003bd8139",
12 "name": "ngca0712f-master",
13 "type": "Master",
14 "spec": "bcc.g3.c4m16",
15 "cpu": 4,
16 "memory": 16,
17 "isSpot": false,
18 "bidModel": "",
19 "bidPrice": "",
20 "cds": [
21 {
22 "sizeInGB": 50,
23 "mediumType": "ssd"
24 }
25 ],
26 "diskType": "",
27 "localDiskSize": 0,
28 "rootDiskSizeInGB": 40,
29 "rootDiskMediumType": "ssd",
30 "requestedInstanceCount": 0,
31 "totalInstanceCount": 0,
32 "runningInstanceCount": 1,
33 "maxCount": 2,
34 "minCount": 1,
35 "canExpand": 0,
36 "canShrink": 0,
37 "code": "",
38 "message": ""
39 },
40 {
41 "id": "9fd3f4fe-85cc-459d-8548-214beffaa7f3",
42 "name": "ng138e063-core",
43 "type": "Core",
44 "spec": "bcc.g3.c4m16",
45 "cpu": 4,
46 "memory": 16,
47 "isSpot": false,
48 "bidModel": "",
49 "bidPrice": "",
50 "cds": [
51 {
52 "sizeInGB": 50,
53 "mediumType": "ssd"
54 }
55 ],
56 "diskType": "",
57 "localDiskSize": 0,
58 "rootDiskSizeInGB": 40,
59 "rootDiskMediumType": "ssd",
60 "requestedInstanceCount": 0,
61 "totalInstanceCount": 0,
62 "runningInstanceCount": 3,
63 "maxCount": 200,
64 "minCount": 2,
65 "canExpand": 1,
66 "canShrink": 0,
67 "state": "Initializing",
68 "code": "",
69 "message": ""
70 }
71 ]
72}修改实例组配置
接口描述
修改指定集群的实例组配置
权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求，请参考 鉴权认证。
注意事项
如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden，错误信息：AccessDenied。
请求结构
Plain Text
1PUT /v{version}/cluster/{clusterId}/instanceGroup?clientToken={clientToken} HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: bmr.bj.baidubce.com
5connection: keep-alive
6accept: */*
7content-type: application/json
8authorization: {bce-authorization-string}
9{
10 "instanceGroups": [
11 {
12 "id": "cefb0a10-6028-467b-8dd5-d71d3cf74fcb",
13 "instanceCount": 4
14 },
15 {
16 "id": "0575111f-a702-434c-b463-8991b5fb4552",
17 "instanceCount": 2
18 }
19 ]
20}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否必须 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clusterId | String | 是 | URL参数 | 待修改的集群ID，只有状态为RUNNING或WAITING的集群才能进行该操作 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符 |
| instanceGroups | List<ModifyInstanceGroupConfig> | 是 | RequestBody参数 | 待修改实例组配置，可省略无须修改的实例组 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无参数
请求示例
Plain Text
1PUT /v1/cluster/f5fa683d-4cf4-46b6-b5ab-bb2c0340c970/instanceGroup?clientToken=bf31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: 2022-01-26T13:02:00Z
4host: bmr.bj.baidubce.com
5connection: keep-alive
6accept: */*
7content-type: application/json
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2022-01-26T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903
9{
10 "instanceGroups": [
11 {
12 "id": "cefb0a10-6028-467b-8dd5-d71d3cf74fcb",
13 "instanceCount": 4
14 },
15 {
16 "id": "0575111f-a702-434c-b463-8991b5fb4552",
17 "instanceCount": 2
18 }
19 ]
20}响应示例
Plain Text
1HTTP/1.1 204 NO_CONTENT
2Transfer-Encoding: chunked
3x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
4Cache-Control: no-cache
5Server: BWS
6Date: Wed, 26 Jan 2022 13:02:01 GMT
7Content-Type: application/json;charset=UTF-8