instance_network_interface_create

Create network interface
post/v1/network-interfaces

Query Parameters

instance

Name or ID of the instance

project

Name or ID of the project, only required if instance is provided as a Name

Request Body

Create-time parameters for an InstanceNetworkInterface

Object
description
ip_config

The IP stack configuration for this interface.

If not provided, a default configuration will be used, which creates a dual-stack IPv4 / IPv6 interface.

Create parameters for a network interface's IP stack.

name

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

subnet_name

The VPC Subnet in which to create the interface.

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

vpc_name

The VPC in which to create the interface.

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

Responses

Object
description

human-readable free-form text about a resource

id

unique, immutable, system-controlled identifier for each resource

instance_id

The Instance to which the interface belongs.

ip_stack

The VPC-private IP stack for this interface.

The VPC-private IP stack for a network interface.

mac

The MAC address assigned to this interface.

A Media Access Control address, in EUI-48 format

name

unique, mutable, user-controlled identifier for each resource

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

primary

True if this interface is the primary for the instance to which it's attached.

subnet_id

The subnet to which the interface belongs.

time_created

timestamp when this resource was created

time_modified

timestamp when this resource was last modified

vpc_id

The VPC to which the interface belongs.