v32

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

Reserved IPs

List reserved fixed IPs

List all reserved fixed IPs in the specified project and region.

get/cloud/v1/reserved_fixed_ips/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

region_idinteger required

Region ID

Query parameters

available_onlyboolean

Set to true if the response should only list IP addresses that are not attached to any instance

device_idstring

Filter IPs by device ID it is attached to

external_onlyboolean

Set to true if the response should only list public IP addresses

internal_onlyboolean

Set to true if the response should only list private IP addresses

ip_addressstring

An IPv4 address to filter results by. Regular expression allowed

limitinteger

Limit the number of returned IPs

offsetinteger

Offset value is used to exclude the first set of records from the result

order_bystring

Ordering reserved fixed IP list result by name, status, updated_at, created_at or fixed_ip_address fields and directions (status.asc), default is "fixed_ip_address.asc"

vip_onlyboolean

Set to true if the response should only list VIPs

Response

List of reserved fixed IPs

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "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"
    }
  ]
}