Creating a Security Group (Discarded)

Function

This API is used to create a security group.

This API has been discarded. Use the API described in section "Security Group (OpenStack Neutron APIs) > Creating a Security Group" in Virtual Private Network API Reference.

URI

POST /v2/{project_id}/os-security-groups

POST /v2.1/{project_id}/os-security-groups

Table 1 describes the parameters in the URI.

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

Request

Table 2 describes the request parameters.

Table 2 Request parameters

Parameter

Mandatory

Type

Description

security_group

Yes

Object

Specifies the security group, which is configured in the message body. For details, see Table 3.

Table 3 Objects of request parameter security_group

Parameter

Mandatory

Type

Description

name

No

String

Specifies the security group name. It must contain 0 to 255 characters.

description

No

String

Specifies information about a security group. It must contain 0 to 255 characters.

Response

Table 4 describes the response parameters.

Table 4 Response parameters

Parameter

Type

Description

security_group

Object

Specifies the security group. For details, see Table 5.

Table 5 Objects of response parameter security_group

Parameter

Type

Description

description

String

Provides supplementary information about the security group.

id

String

Specifies the security group ID in UUID format.

name

String

Specifies the security group name.

rules

Array of objects

Specifies the rules of the security group. The list is empty.

tenant_id

String

Specifies the tenant or project ID.

Example Request

POST https://{endpoint}/v2/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups
POST https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups
{
    "security_group": {
        "name": "test",
        "description": "description"
    }
}

Example Response

{
    "security_group": {
        "rules": [],
        "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
        "description": "desc-sg",
        "id": "81f1d23b-b1e2-42cd-bdee-359b4a065a42",
        "name": "test-sg"
    }
}

Returned Values

See Returned Values for General Requests.