Create security group

POST /cloud/v1/securitygroups/{project_id}/{region_id}

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
security_group = client.cloud.security_groups.create(
    project_id=0,
    region_id=0,
    security_group={
        "name": "my_security_group"
    },
)
print(security_group.id)

200

{
  "created_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "name": "<string>",
  "project_id": 123,
  "region": "<string>",
  "region_id": 123,
  "revision_number": 123,
  "tags_v2": [
    {
      "key": "<string>",
      "read_only": true,
      "value": "<string>"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "Some description",
  "security_group_rules": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "direction": "egress",
      "id": "<string>",
      "revision_number": 123,
      "security_group_id": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "Some description",
      "ethertype": "IPv4",
      "port_range_max": 80,
      "port_range_min": 80,
      "protocol": "tcp",
      "remote_group_id": [
        "00000000-0000-4000-8000-000000000000"
      ],
      "remote_ip_prefix": "10.0.0.0/8"
    }
  ]
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id · integer · required

Project ID

region_id · integer · required

Region ID

Body

application/json

security_group · SingleCreateSecurityGroupSerializer · object · required

Security group

Show child attributes

instances · string[]

List of instances

Example:

["00000000-0000-4000-8000-000000000000"]

Response

200 - application/json

Created security group

created_at · string<date-time> · required

Datetime when the security group was created

Example:

"2019-06-18T11:56:16+0000"

id · string<uuid4> · required

Security group ID

Example:

"00000000-0000-4000-8000-000000000000"

name · string · required

Security group name

Example:

"my_security_group"

project_id · integer · required

Project ID

Example:

1337

region · string · required

Region name

Example:

"Luxembourg 1"

region_id · integer · required

Region ID

Example:

7

revision_number · integer · required

The number of revisions

Example:

1

tags_v2 · TagSerializer · object[] · required

Tags for a security group

Show child attributes

Example:

[
  {
    "key": "my-tag",
    "read_only": false,
    "value": "my-tag-value"
  }
]

updated_at · string<date-time> · required

Datetime when the security group was last updated

Example:

"2019-06-18T11:57:00+0000"

description · string | null

Security group description

Example:

"Some description"

security_group_rules · SecurityGroupRuleSerializer · object[]

Security group rules

Show child attributes