load-balancer

Create load balancer IP address

Attach a floating public IPv4 address to the service using the specified {service-uuid}. The number of attachable floating IPv4 addresses is limited to the number of nodes in the plan, and all addresses must be in the same zone as the service and detached.

Note: Floating public IPv4 addresses have configurable release policies. When the service is deleted or an IP address is detached, addresses with the keep policy will be converted to detached floating IPs that remain available in your account. Addresses with the release policy will be automatically deleted. For more details, see IP Addresses.

post/1.3/load-balancer/{service-uuid}/ip-addresses

Request

Base URL: https://api.upcloud.com
URL: https://api.upcloud.com/1.3/load-balancer/{service-uuid}/ip-addresses
Auth: HTTP bearer

Path parameters

service-uuidstring uuid required

The UUID of the service.

Example:01234567-89ab-cdef-0123-456789abcdef

The unique identifier for the service.

Request body

addressstring ipv4 required

IP address

network_namestring

Name of the target network

Example request

{
  "address": "192.168.1.10",
  "network_name": "private-net-1"
}

Response

Created

addressstring required

IP address assigned to the load balancer service on this network.

network_namestring required

Name of the network to which this IP address belongs.

created_atstring date-time required

Timestamp when the IP address was created (RFC 3339 format).

updated_atstring date-time required

Timestamp when the IP address was last updated (RFC 3339 format).

Example response

{
  "address": "192.168.1.10",
  "network_name": "public-network",
  "created_at": "2025-11-06T09:00:00.000Z",
  "updated_at": "2025-11-06T11:15:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.