Querying Security Groups (Discarded)
Function
This API is used to query security groups.
This API has been discarded. Use the API described in section "Security Group (OpenStack Neutron APIs) > Querying Security Groups" in Virtual Private Network API Reference.
URI
GET /v2.1/{project_id}/os-security-groups
Parameter |
Mandatory |
Description |
---|---|---|
project_id |
Yes |
Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
![](https://support.huaweicloud.com/intl/en-us/my-kualalumpur-1-api-ecs/public_sys-resources/note_3.0-en-us.png)
Pagination query is not supported.
Request
N/A
Response
Table 2 describes the response parameters.
Parameter |
Type |
Description |
---|---|---|
security_groups |
Array of objects |
Specifies security groups. For details, see Table 3. |
Parameter |
Type |
Description |
---|---|---|
description |
String |
Specifies information about a security group. It must contain 0 to 255 characters. |
id |
String |
Specifies the security group ID in UUID format. |
name |
String |
Specifies the security group name. It must contain 0 to 255 characters. |
rules |
Array of objects |
Specifies security group rules. For details, see Table 4. |
tenant_id |
String |
Specifies the tenant or project ID. |
Parameter |
Type |
Description |
---|---|---|
parent_group_id |
String |
Specifies the associated security group ID in UUID format. |
ip_protocol |
String |
Specifies the protocol type or the IP protocol number. The value can be icmp, tcp, udp, or the IP protocol number. |
from_port |
Integer |
Specifies the start port number. The value ranges from 1 to 65,535 and cannot be greater than to_port. When ip_protocol is icmp, this parameter indicates the ICMP type field with a length from 0 to 255 characters.
NOTE:
The ICMP message type is determined by the type field and code field in the packet. For details, see Appendix > ICMP-Port Range Relationship Table in Virtual Private Cloud API Reference. port_range_min indicates the ICMP type field, and port_range_max indicates the ICMP code field. |
to_port |
Integer |
Specifies the stop port number. The value ranges from 1 to 65,535 and cannot be less than from_port. When ip_protocol is icmp, this parameter indicates the ICMP code field with a length from 0 to 255 characters.
NOTE:
The ICMP message type is determined by the type field and code field in the packet. For details, see Appendix > ICMP-Port Range Relationship Table in Virtual Private Cloud API Reference. port_range_min indicates the ICMP type, and port_range_max indicates the ICMP code. |
ip_range |
Object |
Specifies the peer IP segment in CIDR format. For details, see Table 5. Specify either ip_range or group. |
group |
Object |
Specifies the name of the peer security group and the ID of the tenant in the peer security group. For details, see Table 6. Specify either ip_range or group. |
id |
String |
Specifies the security group rule ID in UUID format. |
Example Request
GET https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups
Example Response
{ "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" } ] }
Returned Values
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot