server

Add a network interface

Add a network interface to a stopped Cloud Server. A private interface must identify the SDN network to attach. The combined limit of network interfaces and storage devices is 24.

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

Request

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

Path parameters

uuidstring uuid required

Universally unique identifier

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

Cloud Server UUID

Request body

Example request

{
  "interface": {
    "ip_addresses": {
      "ip_address": [
        {
          "address": "10.0.0.20",
          "dhcp_provided": "yes",
          "family": "IPv4"
        }
      ]
    },
    "network": "0374ce47-4303-4490-987d-32dc96cfd79b",
    "source_ip_filtering": "yes",
    "type": "private"
  }
}

Response

Network interface added

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.