查询普通安全组列表
更新时间：2025-04-25
描述
该接口用于查询用户的普通安全组信息。
请求结构
Plain Text
1GET /v{version}/securityGroup?marker={marker}&maxKeys={maxKeys}&instanceId={instanceId}&vpcId={vpcId} HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为2 |
| marker | String | 否 | Query参数 | 批量获取列表的查询的起始位置，是一个由系统生成的字符串 |
| maxKeys | Integer | 否 | Query参数 | 每页包含的最大数量，最大数量通常不超过1000，缺省值为1000 |
| instanceId | String | 否 | Query参数 | 云产品实例ID，可查询实例关联的安全组列表。如需查询所有创建的安全组信息，不填写此参数。 |
| vpcId | String | 否 | Query参数 | VPC实例ID，可查询实例关联的安全组列表。若填写了instanceId，vpcId必填。 |
| securityGroupId | String | 否 | Query参数 | 指定查询的安全组 |
| securityGroupIds | String | 否 | Query参数 | 指定查询的安全组，多个安全组id用,分割 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| marker | String | 标记查询的起始位置 |
| isTruncated | Boolean | true表示后面还有数据，false表示已经是最后一页。 |
| nextMarker | String | 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现。 |
| maxKeys | Integer | 每页包含的最大数量 |
| securityGroups | List<SecurityGroupModel> | 安全组信息，由SecurityGroupModel组成的集合 |
请求示例
Plain Text
1GET /v2/securityGroup?instanceId=i-kjuinbcd&securityGroupIds=g-4NxWoxeq,g-3wxWqqxz HTTP/1.1
2Host: bcc.bj.baidubce.com
3Content-Type: application/json;charset=UTF-8
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "nextMarker": "",
9 "marker": "",
10 "maxKeys": 1000,
11 "securityGroups": [
12 {
13 "desc": "",
14 "id": "g-4NxWoxeq",
15 "name": "common2",
16 "vpcId":"vpc-9xuevtmc6u",
17 "createdTime":"2019-09-24T08:25:59Z",
18 "sgVersion": 0,
19 "rules": [
20 {
21 "destGroupId": "",
22 "destIp": "all",
23 "direction": "egress",
24 "ethertype": "IPv4",
25 "portRange": "1-65535",
26 "protocol": "all",
27 "remark": "remark",
28 "securityGroupId": "g-4NxWoxeq",
29 "securityGroupRuleId": "r-gkv8yupumvx2",
30 "createdTime": "2020-07-27T13:00:52Z",
31 "updatedTime": "2020-07-27T13:00:52Z"
32 }
33 ],
34 "tags":[
35 {
36 "tagKey": "tagKey",
37 "tagValue": "tagValue"
38 }
39 ]
40 },
41 {
42 "id": "g-3wxWqqxz",
43 "desc": "",
44 "name": "common5",
45 "vpcId":"vpc-9xuevtmc6u",
46 "createdTime":"2019-09-24T08:25:59Z",
47 "sgVersion": 0,
48 "rules": [],
49 "tags":[
50 {
51 "tagKey": "tagKey",
52 "tagValue": "tagValue"
53 }
54 ]
55 }
56 ],
57 "isTruncated": false
58}