server

Add an IP address to a network interface

Add an IPv4 or IPv6 address to a private network interface. The interface cannot contain addresses from both families and can have at most five addresses.

post/1.3/server/{uuid}/networking/interface/{index}/ip_address

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/server/{uuid}/networking/interface/{index}/ip_address
  • Auth: HTTP bearer

Path parameters

uuidstring uuid required

Universally unique identifier

Example:0414e0d7-4436-4037-9dd8-6eaf47dce599

Cloud Server UUID

indexinteger required

Network interface index

Query parameters

force'yes' | 'no'

Boolean value represented as yes/no

Example:yes

Move the address from another interface when that interface can retain its required minimum number of addresses

Request body

Example request

{
  "ip_address": {
    "address": "10.0.0.30",
    "family": "IPv4"
  }
}

Response

IP address added

Example response

{
  "ip_address": {
    "address": "10.0.0.30",
    "dhcp_provided": "no",
    "family": "IPv4"
  }
}

Changes

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