Update floating IP

This endpoint updates the association and tags of an existing Floating IP. The behavior depends on the current association state and the provided fields:

Parameters:

port_id: The unique identifier of the network interface (port) to which the Floating IP should be assigned. This ID can be retrieved from the "Get instance" or "List network interfaces" endpoints.

fixed_ip_address: The private IP address assigned to the network interface. This must be one of the IP addresses currently assigned to the specified port. You can retrieve available fixed IP addresses from the "Get instance" or "List network interfaces" endpoints.

When the Floating IP has no port associated (port_id is null):

• Patch with both port_id and fixed_ip_address: Assign the Floating IP to the specified port and the provided fixed_ip_address, if that fixed_ip_address exists on the port and is not yet used by another Floating IP.
• Patch with port_id only (fixed_ip_address omitted): Assign the Floating IP to the specified port using the first available IPv4 fixed IP of that port.

When the Floating IP is already associated with a port:

• Patch with both port_id and fixed_ip_address: Re-assign the Floating IP to the specified port and address if all validations pass.
• Patch with port_id only (fixed_ip_address omitted): Re-assign the Floating IP to the specified port using the first available IPv4 fixed IP of that port.
• Patch with port_id = null: Unassign the Floating IP from its current port.

Tags:

• You can update tags alongside association changes. Tags are provided as a list of key-value pairs.

Idempotency and task creation:

• No worker task is created if the requested state is already actual, i.e., the requested port_id equals the current port_id and/or the requested fixed_ip_address equals the current fixed_ip_address, and the tags already match the current tags. In such cases, the endpoint returns an empty tasks list.