network

Create interface

Creates a new network interface.

post/1.3/network/interface

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/network/interface
  • Auth: HTTP bearer

Request body

main_account_idinteger

Unique numeric identifier of an account.

Example request

{
  "main_account_id": 123456,
  "interface": {
    "type": "private",
    "network": "8f6d1ec2-8f5e-4b67-8fcb-6fa9c1a8a001",
    "source_ip_filtering": "yes",
    "bootable": "no"
  }
}

Response

Created network interface.

bootable'yes' | 'no' required

Boolean value represented as yes/no

ip_addressesobject[] required
macstring required
networkstring required
source_ip_filtering'yes' | 'no' required

Boolean value represented as yes/no

serverstring uuid

Universally unique identifier

type'public' | 'utility' | 'private' required

Network access type

uuidstring uuid required

Universally unique identifier

Example response

{
  "uuid": "8f6d1ec2-8f5e-4b67-8fcb-6fa9c1a8a003",
  "type": "private",
  "network": "8f6d1ec2-8f5e-4b67-8fcb-6fa9c1a8a001",
  "mac": "00:16:3e:12:34:56",
  "source_ip_filtering": "yes",
  "bootable": "no",
  "ip_addresses": [
    {
      "ip_address": {
        "address": "10.0.0.10",
        "family": "IPv4",
        "floating": "no",
        "release_policy": "keep",
        "dhcp_provided": "yes"
      }
    }
  ]
}

Changes

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