server

Modify a network interface

Modify the IP addresses, source IP filtering, boot setting, or index of a network interface on a stopped Cloud Server. Changing the interface network or type is not supported.

put/1.3/server/{uuid}/networking/interface/{index}

Request

Base URL: https://api.upcloud.com
URL: https://api.upcloud.com/1.3/server/{uuid}/networking/interface/{index}
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

Request body

Example request

{
  "interface": {
    "bootable": "yes",
    "index": 5,
    "source_ip_filtering": "no"
  }
}

Response

Network interface modified

Example response

{
  "interface": {
    "bootable": "no",
    "index": 4,
    "ip_addresses": {
      "ip_address": [
        {
          "address": "10.0.0.20",
          "dhcp_provided": "yes",
          "family": "IPv4",
          "floating": "no",
          "release_policy": "release"
        }
      ]
    },
    "mac": "de:ff:ff:ff:cc:20",
    "network": "0374ce47-4303-4490-987d-32dc96cfd79b",
    "source_ip_filtering": "yes",
    "type": "private"
  }
}

Changes

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