Skip to main content

Get Security Group Details

GET/v2.0/security-groups/{security_group_id}

Returns one security group with all of its rules.

Request​

Parameters​

security_group_idstringrequiredpath

The ID of the security group.

verbosebooleanquery

Return detailed information.

fieldsstringquery

Return only the listed attributes. Can be repeated.

Sample Request​

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:9696/v2.0/security-groups/{security_group_id}

Response​

Sample Response​

Response body
{
"security_group": {
"id": "e7489f02-f846-46f2-9edf-cc5a2640041a",
"name": "web-sg",
"description": "HTTP and HTTPS from anywhere",
"stateful": true,
"tenant_id": "f5d834d636c642c7bfe8af86139c6f26",
"project_id": "f5d834d636c642c7bfe8af86139c6f26",
"security_group_rules": [
{
"id": "5c9f3a21-7d4e-4b8f-a0c6-3e2d1b0a9f88",
"direction": "ingress",
"ethertype": "IPv4",
"protocol": "tcp",
"port_range_min": 443,
"port_range_max": 443,
"remote_ip_prefix": "0.0.0.0/0",
"remote_group_id": null,
"security_group_id": "e7489f02-f846-46f2-9edf-cc5a2640041a"
}
],
"tags": [],
"created_at": "2026-02-11T08:21:14Z",
"updated_at": "2026-02-11T08:25:03Z",
"revision_number": 2
}
}

Status Code​

Success​

Status CodeDescription
200 - OKRequest was successful.

Error​

Status CodeDescription
401 - UnauthorizedUser must authenticate before making a request.
403 - ForbiddenPolicy does not allow current user to do this operation.
404 - Not FoundThe security group does not exist, or is not visible to your project.