查询指定云服务器安全组列表
功能介绍
查询指定弹性云服务器的安全组。
URI
GET /v2.1/{project_id}/servers/{server_id}/os-security-groups
请求消息
无
响应消息
响应参数如表2所示。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
description |
是 |
String |
安全组描述信息,长度0-255 |
id |
是 |
String |
安全组ID,UUID格式 |
name |
是 |
String |
安全组名字,长度0-255 |
rules |
是 |
Array of objects |
安全组规则列表,参见表4 |
tenant_id |
是 |
String |
租户ID或项目ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
parent_group_id |
是 |
String |
相关联的安全组ID,UUID格式。 |
ip_protocol |
是 |
String |
协议类型或直接指定IP协议号,取值可为icmp,tcp,udp或IP协议号。 |
from_port |
是 |
Integer |
起始端口,范围1-65535,且不大于to_port。 ip_protocol设置为icmp时,from_port表示type,范围是0-255。 |
to_port |
是 |
Integer |
终止端口,范围1-65535,且不小于from_port。 ip_protocol设置为icmp时,to_port表示code,范围是0-255,且如果from_port为-1,to_port为-1表示任意ICMP报文。 |
ip_range |
是 |
Object |
对端ip网段,cidr格式,参见表5。 ip_range或者group参数的值,必须有一个为空。 |
group |
是 |
Object |
对端安全组的名称和对端安全组所属租户的租户ID,参见表6。 ip_range或者group参数的值,必须有一个为空。 |
id |
是 |
String |
安全组规则ID,UUID格式。 |
请求示例
查询指定云服务器的安全组。
GET https://{endpoint}/v2.1/e73621affb8f44e1bc01898747ca09d4/servers/65fae4c2-3a09-46c6-af12-3b04f1fdba1e/os-security-groups
响应示例
{ "security_groups": [ { "rules": [ { "from_port": null, "group": { "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "name": "default" }, "ip_protocol": null, "to_port": null, "parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450", "ip_range": {}, "id": "bb3cc988-e06a-49f6-b668-600e8bf193ee" }, { "from_port": null, "group": { "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "name": "default" }, "ip_protocol": null, "to_port": null, "parent_group_id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450", "ip_range": {}, "id": "f9371051-d7e1-4be4-8748-77b1e0913730" } ], "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "description": "default", "id": "bc4ac1d1-dc77-4b7d-a97d-af86eb0dc450", "name": "default" }, { "rules": [ { "from_port": 200, "group": {}, "ip_protocol": "tcp", "to_port": 400, "parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5", "ip_range": { "cidr": "0.0.0.0/0" }, "id": "3330120d-bbd1-4a73-bda9-0196a84d5670" }, { "from_port": 201, "group": {}, "ip_protocol": "tcp", "to_port": 400, "parent_group_id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5", "ip_range": { "cidr": "0.0.0.0/0" }, "id": "b550c9a6-970a-462d-984e-265e88020818" } ], "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "description": "desc-sg", "id": "b3e4b615-a40f-4e1c-92af-2e0d382141d5", "name": "test-sg" } ] }
返回值
请参考通用请求返回值。