Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Security Groups

Create security group

Creates a new security group with the specified configuration. If no egress rules are provided, default set of egress rules will be applied If rules are explicitly set to empty, no rules will be created.

post/cloud/v2/security_groups/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

Request body

descriptionstring

Security group description

namestring required

Security group name

tagsCreateTagsSerializer

A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.

Example request

{
  "description": "My security group description",
  "name": "my_security_group",
  "rules": [
    {
      "description": "Some description",
      "direction": "ingress",
      "ethertype": "IPv4",
      "port_range_max": 80,
      "port_range_min": 80,
      "remote_group_id": "00000000-0000-4000-8000-000000000000",
      "remote_ip_prefix": "10.0.0.0/8"
    }
  ]
}

Response

OK

tasksstring[] required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
idstring required

Example response

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}