This operation requires a request body. The request body must include one or both of the following attributes:
name. String. Specifies a symbolic name for the security group. Not required to be unique.description. String. Describes the security group.
This operation creates a security group with default
security group rules for the IPv4 and IPv6 ethertypes.
The following attributes of a security group rule have
a value of null:
port_range_maxport_range_minprotocolremote_group_idremote_ip_prefix
This operation returns a response body.
| Method | URI | Description |
|---|---|---|
| POST | /security-groups | Creates an OpenStack Networking security group. |
Normal Response Code(s): 201
Error Response Code(s): badRequest (400), unauthorized (401)
Example 5.51. Create Security Group Request: JSON
POST /v2.0/security-groups.json
Accept: application/json
{
"security_group":{
"name":"new-webservers",
"description":"security group for webservers"
}
}Example 5.52. Create Security Group Response: JSON
{
"security_group":{
"description":"security group for webservers",
"id":"2076db17-a522-4506-91de-c6dd8e837028",
"name":"new-webservers",
"security_group_rules":[
{
"direction":"egress",
"ethertype":"IPv4",
"id":"38ce2d8e-e8f1-48bd-83c2-d33cb9f50c3d",
"port_range_max":null,
"port_range_min":null,
"protocol":null,
"remote_group_id":null,
"remote_ip_prefix":null,
"security_group_id":"2076db17-a522-4506-91de-c6dd8e837028",
"tenant_id":"e4f50856753b4dc6afee5fa6b9b6c550"
},
{
"direction":"egress",
"ethertype":"IPv6",
"id":"565b9502-12de-4ffd-91e9-68885cff6ae1",
"port_range_max":null,
"port_range_min":null,
"protocol":null,
"remote_group_id":null,
"remote_ip_prefix":null,
"security_group_id":"2076db17-a522-4506-91de-c6dd8e837028",
"tenant_id":"e4f50856753b4dc6afee5fa6b9b6c550"
}
],
"tenant_id":"e4f50856753b4dc6afee5fa6b9b6c550"
}
}