v32

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

Reserved IPs

Update reserved fixed IP

Update the VIP status of a reserved fixed IP.

patch/cloud/v1/reserved_fixed_ips/{project_id}/{region_id}/{port_id}

Path parameters

project_idinteger required

Project ID

region_idinteger required

Region ID

port_idstring required

Port ID

Request body

is_vipboolean required

If reserved fixed IP should be a VIP

Example request

{
  "is_vip": true
}

Response

Updated reserved fixed IP details

created_atstring date-time required

Datetime when the reserved fixed IP was created

creator_task_idstring uuid4 nullable

Task that created this entity

fixed_ip_addressstring ipv4 nullable

IPv4 address of the reserved fixed IP

fixed_ipv6_addressstring ipv6 nullable

IPv6 address of the reserved fixed IP

is_externalboolean required

If reserved fixed IP belongs to a public network

is_vipboolean required

If reserved fixed IP is a VIP

namestring required

Reserved fixed IP name

network_idstring uuid4 required

ID of the network the port is attached to

port_idstring uuid4 required

ID of the port underlying the reserved fixed IP

project_idinteger nullable

Project ID

regionstring required

Region name

region_idinteger required

Region ID

statusstring required

Underlying port status

subnet_idstring uuid4 nullable

ID of the subnet that owns the IP address

subnet_v6_idstring uuid4 nullable

ID of the subnet that owns the IPv6 address

task_idstring uuid4 nullable

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.

updated_atstring date-time required

Datetime when the reserved fixed IP was last updated

Example response

{
  "allowed_address_pairs": [
    {
      "ip_address": "192.168.123.20",
      "mac_address": "00:16:3e:f2:87:16"
    },
    {
      "ip_address": "192.168.0.2",
      "mac_address": "00:16:3e:f2:87:89"
    }
  ],
  "attachments": [
    {
      "resource_id": "e3c6ee77-48cb-416b-b204-11b492cc776e3",
      "resource_type": "instance"
    },
    {
      "resource_id": "e73a4dbd-da04-4b6e-8ef9-07e8742001b7",
      "resource_type": "ai_cluster"
    }
  ],
  "created_at": "2019-06-18T11:56:16+0000",
  "creator_task_id": "30378aea-9343-4ff6-be38-9756094e05da",
  "fixed_ip_address": "10.100.179.44",
  "name": "Reserved fixed ip 10.100.179.44",
  "network": {
    "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"
  },
  "network_id": "eed97610-708d-43a5-a9a5-caebd2b7b4ee",
  "port_id": "817c8a3d-bb67-4b88-a0d1-aec980318ff1",
  "project_id": 1337,
  "region": "Luxembourg 1",
  "region_id": 7,
  "reservation": {
    "resource_id": "83ed4ea6-bcae-4100-9e4d-36e541ff919b",
    "resource_type": "instance",
    "status": "attached"
  },
  "status": "DOWN",
  "subnet_id": "747db04a-2aac-4fda-9492-d9b85a798c09",
  "updated_at": "2019-06-18T11:57:00+0000"
}