Creating a Security Group
Function
This API is used to create a security group.
URI
POST /v2.0/security-groups
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
security_group | Yes | security_group object | Specifies the security group. For details, see Table 2. |
Attribute | Mandatory | Type | Description |
---|---|---|---|
name | No | String | Specifies the security group name. |
description | No | String | Provides supplementary information about the security group. |
Example Request
Create a security group named sg-test.
POST https://{Endpoint}/v2.0/security-groups{"security_group": {"name": "sg-test"}}
Response Parameters
Parameter | Type | Description |
---|---|---|
security_group | security_group object | Specifies the security group. For details, see Table 4. |
Attribute | Type | Description |
---|---|---|
id | String | Specifies the security group ID. This parameter is not mandatory when you query security groups. |
tenant_id | String | Specifies the project ID. |
name | String | Specifies the security group name. |
description | String | Provides supplementary information about the security group. |
security_group_rules | Array of Security Group Rule objects | Specifies the security group rule list. For details, see Table 5. |
project_id | String | Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
created_at | String | Specifies the time (UTC) when the security group is created. Format: yyyy-MM-ddTHH:mm:ss |
updated_at | String | Specifies the time (UTC) when the security group is updated. Format: yyyy-MM-ddTHH:mm:ss |
Attribute | Type | Description |
---|---|---|
id | String | Specifies the security group rule ID. This parameter is not mandatory when you query security group rules. |
description | String | Provides supplementary information about the security group rule. |
security_group_id | String | Specifies the ID of the belonged security group. |
remote_group_id | String | Specifies the peer ID of the belonged security group. |
direction | String | Specifies the direction of the traffic for which the security group rule takes effect. |
remote_ip_prefix | String | Specifies the peer IP address segment. |
protocol | String | Specifies the protocol type or the IP protocol number. |
port_range_max | Integer | Specifies the maximum port number. When ICMP is used, the value is the ICMP code. |
port_range_min | Integer | Specifies the minimum port number. If the ICMP protocol is used, this parameter indicates the ICMP type. When the TCP or UDP protocol is used, both port_range_max and port_range_min must be specified, and the port_range_max value must be greater than the port_range_min value. When the ICMP protocol is used, if you specify the ICMP code (port_range_max), you must also specify the ICMP type (port_range_min). |
ethertype | String | Specifies the network type. IPv4 and IPv6 are supported. |
tenant_id | String | Specifies the project ID. |
project_id | String | Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
created_at | String | Specifies the time (UTC) when the security group rule is created. Format: yyyy-MM-ddTHH:mm:ss |
updated_at | String | Specifies the time (UTC) when the security group rule is updated. Format: yyyy-MM-ddTHH:mm:ss |
Example Response
{"security_group": {"id": "d29ae17d-f355-4992-8747-1fb66cc9afd2","name": "sg-test","description": "","tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c","project_id": "bbfe8c41dd034a07bebd592bf03b4b0c","security_group_rules": [{"id": "3f51e52c-0e85-40f7-a137-85927392e436","direction": "egress","protocol": null,"ethertype": "IPv4","description": null,"remote_group_id": null,"remote_ip_prefix": null,"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c","port_range_max": null,"port_range_min": null,"security_group_id": "d29ae17d-f355-4992-8747-1fb66cc9afd2"},{"id": "6332de3e-98fb-4f8c-b44a-fcb8ff09881e","direction": "egress","protocol": null,"ethertype": "IPv6","description": null,"remote_group_id": null,"remote_ip_prefix": null,"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c","port_range_max": null,"port_range_min": null,"security_group_id": "d29ae17d-f355-4992-8747-1fb66cc9afd2"}],"created_at": "2018-09-20T02:15:34","updated_at": "2018-09-20T02:15:34"}}
Status Code
See Status Codes.
Error Code
See Error Codes.
- Function
- URI
- Request Parameters
- Example Request
- Response Parameters
- Example Response
- Status Code
- Error Code