v32

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

Networks

Update network

Rename network and/or update network tags. The request will only process the fields that are provided in the request body. Any fields that are not included will remain unchanged.

patch/cloud/v1/networks/{project_id}/{region_id}/{network_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

network_idstring uuid4 required

Network ID

Example:b39792c3-3160-4356-912e-ba396c95cdcf

Network ID

Request body

namestring

Name.

tagsUpdateTagsSerializer

Example request

{
  "name": "some_name"
}

Response

created_atstring date-time required

Datetime when the network was created

creator_task_idstring uuid4 nullable required

Task that created this entity

defaultboolean nullable required

True if network has is_default attribute

externalboolean required

True if the network router:external attribute

idstring uuid4 required

Network ID

mtuinteger required

MTU (maximum transmission unit). Default value is 1450

namestring required

Network name

port_security_enabledboolean required

Indicates port_security_enabled status of all newly created in the network ports.

project_idinteger nullable required

Project ID

regionstring required

Region name

region_idinteger required

Region ID

segmentation_idinteger nullable required

Id of network segment

sharedboolean required

True when the network is shared with your project by external owner

subnetsstring[] required

List of subnetworks

task_idstring uuid4 nullable required

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

typestring required

Network type (vlan, vxlan)

updated_atstring date-time required

Datetime when the network was last updated

Example response

{
  "created_at": "2019-06-18T11:56:16+0000",
  "creator_task_id": "fd50fdd1-0482-4c9b-b847-fc9924665af6",
  "default": true,
  "external": true,
  "id": "eed97610-708d-43a5-a9a5-caebd2b7b4ee",
  "mtu": 1500,
  "name": "public",
  "port_security_enabled": true,
  "project_id": 1337,
  "region": "Luxembourg 1",
  "region_id": 7,
  "segmentation_id": 9,
  "subnets": [
    "f00624ab-41bc-4d54-a723-1673ce32d997",
    "41e0f698-4d39-483b-b77a-18eb070e4c09"
  ],
  "tags": [
    {
      "key": "my-tag",
      "read_only": false,
      "value": "my-tag-value"
    }
  ],
  "type": "vlan",
  "updated_at": "2019-06-18T11:57:00+0000"
}