PATCH
/
cloud
/
v1
/
reserved_fixed_ips
/
{project_id}
/
{region_id}
/
{port_id}
Python
from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
reserved_fixed_ip = client.cloud.reserved_fixed_ips.vip.toggle(
    port_id="port_id",
    project_id=0,
    region_id=0,
    is_vip=True,
)
print(reserved_fixed_ip.network_id)
{
  "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",
  "fixed_ipv6_address": null,
  "is_external": false,
  "is_vip": false,
  "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,
    "shared": false,
    "subnets": [
      "f00624ab-41bc-4d54-a723-1673ce32d997",
      "41e0f698-4d39-483b-b77a-18eb070e4c09"
    ],
    "tags": [
      {
        "key": "my-tag",
        "read_only": false,
        "value": "my-tag-value"
      }
    ],
    "task_id": null,
    "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",
  "subnet_v6_id": null,
  "task_id": null,
  "updated_at": "2019-06-18T11:57:00+0000"
}

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

​
port_id
string
required

Port ID

Body

application/json
​
is_vip
boolean
required

If reserved fixed IP should be a VIP

Examples:

true

Response

Updated reserved fixed IP details

​
allowed_address_pairs
AllowedAddressPairsSerializer · object[]
required

Group of subnet masks and/or IP addresses that share the current IP as VIP

Examples:
[
  {
    "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
AttachmentSerializer · object[]
required

Reserved fixed IP attachment entities

Examples:
[
  {
    "resource_id": "e3c6ee77-48cb-416b-b204-11b492cc776e3",
    "resource_type": "instance"
  },
  {
    "resource_id": "e73a4dbd-da04-4b6e-8ef9-07e8742001b7",
    "resource_type": "ai_cluster"
  }
]
​
created_at
string<date-time>
required

Datetime when the reserved fixed IP was created

Examples:

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

​
is_external
boolean
required

If reserved fixed IP belongs to a public network

Examples:

false

​
is_vip
boolean
required

If reserved fixed IP is a VIP

Examples:

false

​
name
string
required

Reserved fixed IP name

Examples:

"Reserved fixed ip 10.100.179.44"

​
network
object
required

Network details

​
network_id
string<uuid4>
required

ID of the network the port is attached to

Examples:

"eed97610-708d-43a5-a9a5-caebd2b7b4ee"

​
port_id
string<uuid4>
required

ID of the port underlying the reserved fixed IP

Examples:

"817c8a3d-bb67-4b88-a0d1-aec980318ff1"

​
region
string
required

Region name

Examples:

"Luxembourg 1"

​
region_id
integer
required

Region ID

Examples:

7

​
reservation
object
required

Reserved fixed IP status with resource type and ID it is attached to

​
status
string
required

Underlying port status

Examples:

"DOWN"

​
updated_at
string<date-time>
required

Datetime when the reserved fixed IP was last updated

Examples:

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

​
creator_task_id
string<uuid4> | null

Task that created this entity

Examples:

"30378aea-9343-4ff6-be38-9756094e05da"

​
fixed_ip_address
string<ipv4> | null

IPv4 address of the reserved fixed IP

Examples:

"10.100.179.44"

​
fixed_ipv6_address
string<ipv6> | null

IPv6 address of the reserved fixed IP

Examples:

null

​
project_id
integer | null

Project ID

Examples:

1337

​
subnet_id
string<uuid4> | null

ID of the subnet that owns the IP address

Examples:

"747db04a-2aac-4fda-9492-d9b85a798c09"

​
subnet_v6_id
string<uuid4> | null

ID of the subnet that owns the IPv6 address

Examples:

null

​
task_id
string<uuid4> | null

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.

Examples:

null