实例组接口

更新时间：2025-08-20

创建实例组

请求结构体

Method: Post

Url: /csm/api/v1/userId/{userId}/instance-group

请求参数

名称	类型	描述	是否必须	参数位置
userId	String	用户Id	是	Path
mergedGroup	MergedGroup		是	requestBody

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:

请求示例

Plain

1POST /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group
2  
3  
4request body:
5{
6    "name": "group_name",
7    "region": "bj",
8    "typeName": "Instance",
9    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
10    "serviceName": "BCE_BCC",
11    "resourceIdList": [
12        {
13            "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
14            "region": "bj",
15            "serviceName": "BCE_BCC",
16            "typeName": "Instance",
17            "resourceId": "InstanceId:04b91096-a294-477d-bd11-1a7bcfbxxxxx"
18        }
19    ]
20}

响应示例

Plain

1{
2    "id": 7900,
3    "name": "group_name",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "6c9a3ce6-b984-4bf7-9868-b81ec17xxxxx",
9    "count": 0,
10    "serviceNameAlias": null,
11    "typeNameAlias": null,
12    "regionAlias": null,
13    "tagKey": "",
14    "typeTarget": ""
15}

更新实例组名称

请求结构体

Method: Patch

Url：/csm/api/v1/userId/{userId}/instance-group

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
group	Group	实例组信息	是	requestBody

Group

名称	类型	说明	是否必须
id	Long	实例组Id	是
name	String	更新后实例组名称	是
serviceName	String	云服务名称	是
typeName	String	对象类型，如实例、集群	是
region	String	区域	是

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:

请求示例

Plain

1PATCH  /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group
2  
3  
4request Body
5{
6    "id":7900,
7    "name":"group_name_new",
8    "region":"bj",
9    "serviceName":"BCE_BCC",
10    "typeName":"Instance"
11}

响应示例

Plain

1{
2    "id": 7900,
3    "name": "group_name_new",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
9    "count": 0,
10    "serviceNameAlias": null,
11    "typeNameAlias": null,
12    "regionAlias": null,
13    "tagKey": "",
14    "typeTarget": ""
15}

删除实例组

请求结构体

Method: Delete

Url: /csm/api/v1/userId/{userId}/instance-group/{id}

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
id	Long	实例组Id	是	Path

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:

请求示例

Plain

1DELETE   /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/7900

响应示例

Plain

1{
2    "id": 7900,
3    "name": "group_name_new",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
9    "count": 0,
10    "serviceNameAlias": null,
11    "typeNameAlias": null,
12    "regionAlias": null,
13    "tagKey": "",
14    "typeTarget": ""
15}

获取实例组详情

请求结构体

Method: Get

Url： /csm/api/v1/userId/{userId}/instance-group/{id}

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
id	Long	实例组Id	是	Path

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:

请求示例

Plain

1GET   /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/7900

响应示例

Plain

1{
2    "id": 7900,
3    "name": "group_name",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
9    "count": 1,
10    "serviceNameAlias": "云服务器BCC",
11    "typeNameAlias": "云服务器BCC",
12    "regionAlias": "北京",
13    "tagKey": "INSTANCE_GROUP_5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx:5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
14    "typeTarget": ""
15}

查询实例组列表

请求结构体

Method: Get

Url： /csm/api/v1/userId/{userId}/instance-group/list

请求参数

名称	类型	描述	是否必须	参数位置
userId	String	用户Id	是	Path
name	String	实例组名称	否	Param
serviceName	String	云服务名称	否	Param
region	String	区域	否	Param
typeName	String	实例类型	否	Param
pageNo	int	页码数	是	Param
pageSize	int	每页返回数量	是	Param

请求示例

Plain

1GET /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/list?
2name=group_name
3&serviceName=BCE_BCC
4&region=bj
5&typeName=Instance
6&pageNo=1
7&pageSize=10

响应示例

Plain

1{
2    "orderBy": "",
3    "order": "",
4    "pageNo": 1,
5    "pageSize": 10,
6    "totalCount": 1,
7    "result": [
8        {
9            "id": 7900,
10            "name": "group_name",
11            "serviceName": "BCE_BCC",
12            "typeName": "Instance",
13            "region": "bj",
14            "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
15            "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
16            "count": 1,
17            "serviceNameAlias": "云服务器BCC",
18            "typeNameAlias": "云服务器BCC",
19            "regionAlias": "北京",
20            "tagKey": "INSTANCE_GROUP_5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx:5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
21            "typeTarget": ""
22        }
23    ]
24}

实例组添加实例成员

请求结构体

Method: Post

Url: /csm/api/v1/userId/{userId}/instance-group/{id}/instance/add

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
id	Long	实例组Id	是	Path
mergedGroup	MergedGroup		是	requestBody

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:

请求示例

Plain

1POST   /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/7900/instance/add
2
3request Body
4{
5    "id": 7900,
6    "name": "group_name",
7    "region": "bj",
8    "typeName": "Instance",
9    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
10    "resourceIdList": [
11        {
12            "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
13            "region": "bj",
14            "serviceName": "BCE_BCC",
15            "typeName": "Instance",
16            "resourceId": "InstanceId:dd0109a3-a7fe-4ffb-b2ae-3c6aa0bxxxxx"
17        }
18    ]
19}

响应示例

响应说明，返回为实例组添加实例前的信息

Plain

1{
2    "id": 7900,
3    "name": "group_name",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
9    "count": 1,
10    "serviceNameAlias": "云服务器BCC",
11    "typeNameAlias": "云服务器BCC",
12    "regionAlias": "北京",
13    "tagKey": "INSTANCE_GROUP_5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx:5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
14    "typeTarget": ""
15}

获取实例组实例成员列表

请求结构体

Method: Get

Url: /csm/api/v1/userId/{userId}/instance-group/instance/list

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
id	Long	实例Id	是	Param
serviceName	String	云服务名称	是	Param
typeName	String	对象类型	是	Param
region	String	区域	是	Param
viewType	ViewType(枚举类型)	查询实例列表表头时传参：LIST_VIEW，查询实例组成员列表表头时传参：DETAIL_VIEW	是	Param
pageNo	int	页码数	是	Param
pageSize	int	每页返回数量	是	Param

响应参数

名称	类型	描述
orderBy	String	排序字段
order	String	排序方式
pageNo	int	页码数
pageSize	int	每页返回数量
totalCount	int	实例组中实例数量
result	List<List>	实例组中实例信息

请求示例

Plain

1GET    /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/instance/list？
2id=7900
3&serviceName=BCE_BCC
4&typeName=Instance
5&region=bj
6&viewType=DETAIL_VIEW
7&pageNo=1
8&pageSize=10

响应示例

Plain

1{
2    "orderBy": "",
3    "order": "",
4    "pageNo": 1,
5    "pageSize": 10,
6    "totalCount": 2,
7    "result": [
8        [
9            {
10                "itemName": "id",
11                "itemAlias": "实例id",
12                "itemValue": "04b91096-a294-477d-bd11-1a7bcfxxxxx",
13                "itemSeq": 2,
14                "itemIdentitable": true,
15                "itemDimension": "InstanceId",
16                "itemIsConn": true,
17                "itemView": false
18            },
19            {
20                "itemName": "name",
21                "itemAlias": "实例名称",
22                "itemValue": "bcc_name",
23                "itemSeq": 1,
24                "itemIdentitable": false,
25                "itemDimension": "",
26                "itemIsConn": true,
27                "itemView": false
28            },
29            {
30                "itemName": "internalIp",
31                "itemAlias": "内网ip",
32                "itemValue": "192.168.xx.xx",
33                "itemSeq": 2,
34                "itemIdentitable": false,
35                "itemDimension": "",
36                "itemIsConn": true,
37                "itemView": false
38            },
39            {
40                "itemName": "publicIp",
41                "itemAlias": "公网ip",
42                "itemValue": "",
43                "itemSeq": 4,
44                "itemIdentitable": false,
45                "itemDimension": "",
46                "itemIsConn": true,
47                "itemView": false
48            }
49        ],
50        [
51            {
52                "itemName": "id",
53                "itemAlias": "实例id",
54                "itemValue": "dd0109a3-a7fe-4ffb-b2ae-3c6aa0bxxxxx",
55                "itemSeq": 2,
56                "itemIdentitable": true,
57                "itemDimension": "InstanceId",
58                "itemIsConn": true,
59                "itemView": false
60            },
61            {
62                "itemName": "name",
63                "itemAlias": "实例名称",
64                "itemValue": "bcc_name_2",
65                "itemSeq": 1,
66                "itemIdentitable": false,
67                "itemDimension": "",
68                "itemIsConn": true,
69                "itemView": false
70            },
71            {
72                "itemName": "internalIp",
73                "itemAlias": "内网ip",
74                "itemValue": "192.168.xx.xx",
75                "itemSeq": 2,
76                "itemIdentitable": false,
77                "itemDimension": "",
78                "itemIsConn": true,
79                "itemView": false
80            },
81            {
82                "itemName": "publicIp",
83                "itemAlias": "公网ip",
84                "itemValue": "",
85                "itemSeq": 4,
86                "itemIdentitable": false,
87                "itemDimension": "",
88                "itemIsConn": true,
89                "itemView": false
90            }
91        ]
92    ]
93}

实例组移除实例成员

请求结构体

Method: Post

Url: /csm/api/v1/userId/{userId}/instance-group/{id}/instance/remove

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
id	Long	实例组Id	是	Path
mergedGroup	MergedGroup		是	requestBody

响应参数

名称	类型	描述
id	Long	实例组Id
name	String	实例组名称
serviceName	String	云服务名称
typeName	String	对象类型
region	String	区域
userId	String	用户Id
uuid	String	实例组UUID
count	int	实例组含有实例数量
serviceNameAlias	String	云服务中文名称
typeNameAlias	String	对象类型中午名称
regionAlias	String	区域中文名称
tagKey	String	实例组对应Tag，格式为：INSTANCEGROUP:
typeTarget	String	对象类型所含有的维度内容

请求示例

Plain

1POST  /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance-group/7900/instance/remove
2  
3  
4request Body
5{
6    "id": 7900,
7    "name": "group_name",
8    "region": "bj",
9    "typeName": "Instance",
10    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
11    "resourceIdList": [
12        {
13            "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
14            "region": "bj",
15            "serviceName": "BCE_BCC",
16            "typeName": "Instance",
17            "resourceId": "InstanceId:dd0109a3-a7fe-4ffb-b2ae-3c6aa0bxxxxx"
18        }
19    ]
20}

响应示例

响应说明，返回为实例组移除实例前的信息

Plain

1{
2    "id": 7900,
3    "name": "group_name",
4    "serviceName": "BCE_BCC",
5    "typeName": "Instance",
6    "region": "bj",
7    "userId": "a0d04d7c202140cb80155ff7b67xxxxx",
8    "uuid": "5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
9    "count": 2,
10    "serviceNameAlias": "云服务器BCC",
11    "typeNameAlias": "云服务器BCC",
12    "regionAlias": "北京",
13    "tagKey": "INSTANCE_GROUP_5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx:5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx",
14    "typeTarget": ""
15}

查看实例列表接口（创建实例组时用）

请求结构体

Method: Get

Url：/csm/api/v1/userId/{userId}/instance/list

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
serviceName	String	云服务名称	是	Param
typeName	String	对象类型	是	Param
region	String	区域	是	Param
viewType	ViewType	查询实例列表时传参：LIST_VIEW 查询实例组成员列表时传参：DETAIL_VIEW	是	Param
pageNo	int	页码数	是	Param
pageSize	int	每页返回数量	是	Param
keywordType	String	模糊查询的属性	是	Param
keyword	String	模糊查询的值	是	Param

请求示例

Plain

1GET /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance/list?
2serviceName=BCE_BCC
3&typeName=Instance
4&region=bj
5&viewType=LIST_VIEW
6&pageNo=1
7&pageSize=10
8&keywordType=name
9&keyword=

响应示例

Plain

1{
2    "orderBy": "",
3    "order": "",
4    "pageNo": 1,
5    "pageSize": 10,
6    "totalCount": 58,
7    "result": [
8        [
9            {
10                "itemName": "name",
11                "itemAlias": "实例名称",
12                "itemValue": "bcc_name",
13                "itemSeq": 1,
14                "itemIdentitable": false,
15                "itemDimension": "",
16                "itemIsConn": true,
17                "itemView": true
18            },
19            {
20                "itemName": "internalIp",
21                "itemAlias": "内网ip",
22                "itemValue": "192.168.xx.xx",
23                "itemSeq": 3,
24                "itemIdentitable": false,
25                "itemDimension": "",
26                "itemIsConn": true,
27                "itemView": false
28            },
29            {
30                "itemName": "id",
31                "itemAlias": "实例id",
32                "itemValue": "04b91096-a294-477d-bd11-1a7bcfbxxxxx",
33                "itemSeq": 2,
34                "itemIdentitable": true,
35                "itemDimension": "InstanceId",
36                "itemIsConn": true,
37                "itemView": false
38            },
39            {
40                "itemName": "shortId",
41                "itemAlias": "实例短ID",
42                "itemValue": "i-mPkxxxxx",
43                "itemSeq": 4,
44                "itemIdentitable": false,
45                "itemDimension": "InstanceShortId",
46                "itemIsConn": true,
47                "itemView": false
48            }
49        ]
50        ...
51    ]
52}

查看实例列表（用于对已经创建的实例组进行添加实例操作—过滤掉已经添加的实例）

请求结构体

Method: Get

Url：/csm/api/v1/userId/{userId}/instance/filteredList

请求参数

名称	类型	说明	是否必须	参数位置
userId	String	用户Id	是	Path
serviceName	String	云服务名称	是	Param
typeName	String	对象区域	是	Param
region	String	区域	是	Param
viewType	ViewType	查询实例列表时传参：LIST_VIEW 查询实例组成员列表时传参：DETAIL_VIEW	是	Param
pageNo	int	页码数	是	Param
pageSize	int	每页返回数量	是	Param
keywordType	String	模糊查询的属性	是	Param
keyword	String	模糊查询的值	是	Param
id	Long	实例组Id	是	Param
uuid	String	实例组唯一标识	是	Param

请求示例

Plain

1GET   /csm/api/v1/userId/a0d04d7c202140cb80155ff7b67xxxxx/instance/filteredList
2serviceName=BCE_BCC
3&typeName=Instance
4&region=bj
5&viewType=LIST_VIEW
6&pageNo=1
7&pageSize=10
8&keywordType=name
9&keyword=
10&id=7900
11&uuid=5ac4bdcd-4ba5-46c8-b879-36f57f3xxxxx

响应示例

Plain

1{
2    "orderBy": "",
3    "order": "",
4    "pageNo": 1,
5    "pageSize": 10,
6    "totalCount": 57,
7    "result": [
8        [
9            {
10                "itemName": "name",
11                "itemAlias": "实例名称",
12                "itemValue": "bcc_name_3",
13                "itemSeq": 1,
14                "itemIdentitable": false,
15                "itemDimension": "",
16                "itemIsConn": true,
17                "itemView": true
18            },
19            {
20                "itemName": "internalIp",
21                "itemAlias": "内网ip",
22                "itemValue": "192.168.xx.xx",
23                "itemSeq": 3,
24                "itemIdentitable": false,
25                "itemDimension": "",
26                "itemIsConn": true,
27                "itemView": false
28            },
29            {
30                "itemName": "id",
31                "itemAlias": "实例id",
32                "itemValue": "dd0109a3-a7fe-4ffb-b2ae-3c6aa0bxxxxx",
33                "itemSeq": 2,
34                "itemIdentitable": true,
35                "itemDimension": "InstanceId",
36                "itemIsConn": true,
37                "itemView": false
38            },
39            {
40                "itemName": "shortId",
41                "itemAlias": "实例短ID",
42                "itemValue": "i-6nfxxxxx",
43                "itemSeq": 4,
44                "itemIdentitable": false,
45                "itemDimension": "InstanceShortId",
46                "itemIsConn": true,
47                "itemView": false
48            }
49        ],
50        ...
51    ]
52}

附录

MergedGroup

名称	类型	描述	是否必须
userId	String	用户Id	是
region	String	区域	是
serviceName	String	云服务名称	是
typeName	String	对象类型	是
name	String	实例组名称	是
resourceIdList	List < MonitorResource >	监控实例。添加实例时只填写新增实例信息。	是
typeTarget	String	eg：{"resourceType":"RD_ST_INSTANCE","resourceId":["ClusterId","NodeId"]}	否

MonitorResource

名称	类型	描述	是否必须
userId	String	用户Id	是
region	String	区域	是
serviceName	String	云服务名称	是
resourceId	String	实例Id，格式为：维度名称:维度ID	是
typeName	String	对象类型	是

InstanceGroupViewConfig

名称	类型	描述
itemName	String	属性名称
itemAlias	String	属性别称
itemValue	String	属性值
itemSeq	int	属性顺序
itemIdentitable	boolean	属性是否为实例属性
itemDimension	String	实例属性名称
itemIsConn	boolean	前端展示是否拼接
itemView	boolean	前端是否展示该属性

事件监控

部分维度查询最新指标数据

云监控 BCM

云监控 BCM

实例组接口

创建实例组

请求结构体

请求参数

响应参数

请求示例

响应示例

更新实例组名称

请求结构体

请求参数

响应参数

请求示例

响应示例

删除实例组

请求结构体

请求参数

响应参数

请求示例

响应示例

获取实例组详情

请求结构体

请求参数

响应参数

请求示例

响应示例

查询实例组列表

请求结构体

请求参数

请求示例

响应示例

实例组添加实例成员

请求结构体

请求参数

响应参数

请求示例

响应示例

获取实例组实例成员列表

请求结构体

请求参数

响应参数

请求示例

响应示例

实例组移除实例成员

请求结构体

请求参数

响应参数

请求示例

响应示例

查看实例列表接口（创建实例组时用）

请求结构体

请求参数

请求示例

响应示例

查看实例列表（用于对已经创建的实例组进行添加实例操作—过滤掉已经添加的实例）

请求结构体

请求参数

请求示例

响应示例

附录

MergedGroup

MonitorResource

InstanceGroupViewConfig