Retrieve the instance

GET /metadata/v1/instance

This requests retrieves information for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance.read

Request

Response

200 - The instance was retrieved successfully

availability

InstanceAvailability

availability_policy

InstanceAvailabilityPolicy

The availability policy for this virtual server instance

bandwidth

integer

The total bandwidth (in megabits per second) shared across the instance network attachments or instance network interfaces and storage volumes of the virtual server instance

boot_volume_attachment

object

The boot volume attachment for this virtual server instance

catalog_offering

object

If present, this virtual server instance was provisioned from a catalog.

cluster_network

object

If present, the cluster network that this virtual server instance resides in

cluster_network_attachments

array

The cluster network attachments for this virtual server instance.

The cluster network attachments are ordered for consistent instance configuration.

confidential_compute_mode

string

The confidential compute mode for this virtual server instance.

created_at

string

The date and time that the virtual server instance was created

crn

string

The CRN for this virtual server instance

dedicated_host

object

If present, the dedicated host this virtual server instance has been placed on.

disks

array

The instance disks for this virtual server instance.

enable_secure_boot

boolean

Indicates whether secure boot is enabled for this virtual server instance.

gpu

InstanceGPU

The virtual server instance GPU configuration

health_reasons

array

The reasons for the current `health_state` (if any).

health_state

string

The health of this resource:

  • `ok`: No abnormal behavior detected
  • `degraded`: Experiencing compromised performance, capacity, or connectivity
  • `faulted`: Completely unreachable, inoperative, or otherwise entirely incapacitated
  • `inapplicable`: The health state does not apply because of the current lifecycle state. A resource with a lifecycle state of `failed` or `deleting` will have a health state of `inapplicable`. A `pending` resource may also have this state.

id

string

The unique identifier for this virtual server instance

image

object

The image the virtual server instance was provisioned from

instance_group_membership

object

The instance group membership for this virtual server instance

lifecycle_reasons

array

The reasons for the current `lifecycle_state` (if any).

lifecycle_state

object

The lifecycle state of the virtual server instance.

memory

integer

The amount of memory, truncated to whole gibibytes.

The maximum limit for this property may expand in the future.

metadata_service

InstanceMetadataService

The metadata service configuration

name

string

The name for this virtual server instance. The name is unique across all virtual server instances in the region.

network_attachments

array

The network attachments for this virtual server instance, including the primary network attachment.

network_interfaces

array

The network interfaces for this instance, including the primary network interface.

If this instance has network attachments, each network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface.

numa_count

integer

The number of NUMA nodes this virtual server instance is provisioned on.

placement_target

InstancePlacementTarget

The placement restrictions for the virtual server instance

primary_network_attachment

object

The primary network attachment for this virtual server instance

primary_network_interface

object

The primary network interface for this virtual server instance.

If this instance has network attachments, this primary network interface is a read-only representation of the primary network attachment and its attached virtual network interface.

profile

object

The profile for this virtual server instance

reservation

object

The reservation used by this virtual server instance.

If absent, no reservation is in use.

reservation_affinity

InstanceReservationAffinity

resource_group

object

The resource group for this instance

resource_type

string

The resource type

software_attachments

InstanceSoftwareAttachments

The software attachments for this instance.

startable

boolean

Indicates whether the state of the virtual server instance permits a start request.

status

string

The status of the virtual server instance.

The enumerated values for this property may expand in the future.

status_reasons

array

The reasons for the current status (if any).

threads_per_core

integer

The threads per core for this virtual server instance.

total_network_bandwidth

integer

The amount of bandwidth (in megabits per second) allocated exclusively to instance network attachments or instance network interfaces.

total_volume_bandwidth

integer

The amount of bandwidth (in megabits per second) allocated exclusively to instance storage volumes. An increase in this value will result in a corresponding decrease to `total_network_bandwidth`.

vcpu

InstanceVCPU

The virtual server instance VCPU configuration

volume_attachments

array

The volume attachments for this virtual server instance, including the boot volume attachment.

volume_bandwidth_qos_mode

string

The volume bandwidth QoS mode for this virtual server instance.

vpc

object

The VPC this virtual server instance resides in

zone

object

The zone this virtual server instance resides in

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List cluster network attachments

GET /metadata/v1/instance/cluster_network_attachments

This request lists cluster network attachments for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-cluster-network-attachment.list

Request

Path Parameters

Query Parameters

start

string

A server-provided token determining what resource to start the page on

limit

integer

The number of resources to return on a page

Response

200 - The instance cluster network attachments were retrieved successfully

cluster_network_attachments

array

A page of ordered cluster network attachments (sorted based on the `before` property) for the instance. A cluster network attachment represents a device to which a cluster network interface is attached.

first

object

A link to the first page of resources

limit

integer

The maximum number of resources that can be returned by the request

next

object

A link to the next page of resources. This property is present for all pages except the last page

total_count

integer

The total number of resources across all pages

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve a cluster network attachment

GET /metadata/v1/instance/cluster_network_attachments/{id}

This request retrieves a cluster network attachment for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-cluster-network-attachment.read

Request

Path Parameters

id

Required *

The instance cluster network attachment identifier

Query Parameters

Response

200 - The instance cluster network attachment was retrieved successfully

before

InstanceClusterNetworkAttachmentBefore

The instance cluster network attachment that is immediately before. If absent, this is the last instance cluster network attachment.

cluster_network_interface

object

The associated cluster network subnet

id

string

The unique identifier for this instance cluster network attachment

lifecycle_reasons

array

The reasons for the current `lifecycle_state` (if any).

lifecycle_state

InstanceClusterNetworkAttachmentLifecycleState

The lifecycle state of the instance cluster network attachment

name

string

The name for this instance cluster network attachment. The name is unique across all network attachments for the instance.

resource_type

string

The resource type

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - A cluster network attachment with the specified identifier could not be found or is not

associated with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve initialization information

GET /metadata/v1/instance/initialization

This request retrieves initialization information for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-initialization.read

Request

Response

200 - The initialization information was retrieved successfully

default_trusted_profile

object

The default trusted profile configuration specified at virtual server instance creation. If absent, no default trusted profile was specified.

keys

array

The public SSH keys used at instance initialization.

password

InstanceInitializationPassword

user_data

string

The user data to be made available when setting up the virtual server instance

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List network attachments

GET /metadata/v1/instance/network_attachments

This request lists network attachments for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-network-attachment.list

Request

Response

200 - The instance network attachments were retrieved successfully

network_attachments

array

The network attachments for the instance

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve a network attachment

GET /metadata/v1/instance/network_attachments/{id}

This request retrieves a network attachment for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-network-attachment.read

Request

Path Parameters

id

Required *

The instance network attachment identifier

Query Parameters

Response

200 - The instance network attachment was retrieved successfully

created_at

string

The date and time that the instance network attachment was created

id

string

The unique identifier for this instance network attachment

lifecycle_state

object

The lifecycle state of the instance network attachment

name

string

The name for this instance network attachment. The name is unique across all network attachments for the instance.

port_speed

integer

The port speed for this instance network attachment in Mbps

primary_ip

object

The primary IP address of the virtual network interface for the instance network attachment

resource_type

string

The resource type

subnet

object

The subnet of the virtual network interface for the instance network attachment

type

string

The instance network attachment type

virtual_network_interface

object

The virtual network interface for this instance network attachment

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - A network attachment with the specified identifier could not be found or is not

associated with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List instance network interfaces

GET /metadata/v1/instance/network_interfaces

This request lists network interfaces for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-network-interface.list

Request

Response

200 - The instance network interfaces were retrieved successfully

network_interfaces

array

The network interfaces for the instance

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve an instance network interface

GET /metadata/v1/instance/network_interfaces/{id}

This request retrieves a network interface for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-network-interface.read

Request

Path Parameters

id

Required *

The instance network interface identifier

Query Parameters

Response

200 - The instance network interface was retrieved successfully

allow_ip_spoofing

boolean

Indicates whether source IP spoofing is allowed on this instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and source IP spoofing is managed on the attached virtual network interface.

created_at

string

The date and time that the instance network interface was created.

If this instance has network attachments, this network interface was created as a read-only representation when its corresponding network attachment was created.

floating_ips

array

The floating IPs associated with this instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the floating IPs are associated with the attached virtual network interface.

id

string

The unique identifier for this instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the identifier is that of the corresponding network attachment.

name

string

The name for this instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the name matches its corresponding network attachment.

port_speed

integer

The instance network interface port speed in Mbps.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the port speed is that of its corresponding network attachment.

primary_ipv4_address

string

The primary IPv4 address.

If the address has not yet been selected, the value will be `0.0.0.0`.

resource_type

string

The resource type

security_groups

array

The security groups targeting this instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the security groups are associated with the attached virtual network interface.

status

string

The status of the instance network interface.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the status is computed from them.

subnet

object

The associated subnet

type

string

The instance network interface type.

If this instance has network attachments, this network interface is a read-only representation of its corresponding network attachment and its attached virtual network interface, and the type is that of its corresponding network attachment.

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - An instance network interface with the specified identifier could not be found or is not

associated with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List instance software attachments

GET /metadata/v1/instance/software_attachments

This request lists software attachments for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-software-attachment.list

Request

Response

200 - The instance software attachments were retrieved successfully

software_attachments

array

The software attachments for the instance

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve an instance software attachment

GET /metadata/v1/instance/software_attachments/{id}

This request retrieves an instance software attachment for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-software-attachment.read

Request

Path Parameters

id

Required *

The instance software attachment identifier

Query Parameters

Response

200 - The instance software attachment was retrieved successfully.

catalog_offering

InstanceSoftwareAttachmentCatalogOffering

The catalog offering for this instance software attachment. May be absent if `software_attachment.lifecycle_state` is not `stable`.

created_at

string

The date and time that the instance software attachment was created.

entitlement

InstanceSoftwareAttachmentEntitlement

The entitlement for the licensed software for this instance software attachment.

id

string

The unique identifier for this instance software attachment.

lifecycle_reasons

InstanceSoftwareAttachmentLifecycleReasons

The lifecycle reasons for this instance software attachment (if any).

lifecycle_state

string

The lifecycle state of the instance software attachment.

name

string

The name for this instance software attachment. The name is unique across all instance software attachments for the instance.

offering_instance

InstanceSoftwareAttachmentOfferingInstance

resource_type

string

The resource type

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - An instance software attachment with the specified identifier could not be found or is

not associated with the calling instance.

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List volume attachments

GET /metadata/v1/instance/volume_attachments

This request lists volume attachments for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-volume-attachment.list

Request

Response

200 - The volume attachments were retrieved successfully

volume_attachments

array

The volume attachments for the instance

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

Retrieve a volume attachment

GET /metadata/v1/instance/volume_attachments/{id}

This request retrieves a volume attachment for the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-volume-attachment.read

Request

Path Parameters

id

Required *

The volume attachment identifier

Query Parameters

Response

200 - The volume attachment was retrieved successfully

bandwidth

integer

The maximum bandwidth (in megabits per second) for the volume when attached to this instance. This may be lower than the volume bandwidth depending on the configuration of the instance.

created_at

string

The date and time that the volume was attached

delete_volume_on_instance_delete

boolean

Indicates whether deleting the instance will also delete the attached volume

device

VolumeAttachmentDevice

The configuration for the volume as a device in the instance or bare metal server operating system.

This property may be absent if the volume attachment's `status` is not `attached`.

id

string

The unique identifier for this volume attachment

name

string

The name for this volume attachment. The name is unique across all volume attachments on the instance or bare metal server.

protocol

string

The protocol used for this attachment: - `virtio_blk`: VirtIO block device protocol. This para-virtualized storage protocol provides efficient block device access for virtual server instances.

status

string

The status of this volume attachment.

The enumerated values for this property may expand in the future.

type

string

The type of volume attachment.

The enumerated values for this property may expand in the future.

volume

object

The attached volume.

This property will be absent if the volume has not yet been provisioned.

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - A volume attachment with the specified identifier could not be found or is not

associated with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List public SSH keys

GET /metadata/v1/keys

This request lists public SSH keys

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-key.list

Request

Response

200 - The keys were retrieved successfully

keys

array

A page of keys

Retrieve a public SSH key

GET /metadata/v1/keys/{id}

This request retrieves a public SSH key

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-key.read

Request

Path Parameters

id

Required *

The key identifier

Query Parameters

Response

200 - The key was retrieved successfully

created_at

string

The date and time that the key was created

crn

string

The CRN for this key

fingerprint

string

The fingerprint for this key. The value is returned base64-encoded and prefixed with the hash algorithm (such as `SHA256`).

The length of this property may expand in the future.

id

string

The unique identifier for this key

length

integer

The length of this key (in bits)

name

string

The name for this key. The name must not be used by another key in the region. If unspecified, the name will be a hyphenated list of randomly-selected words.

public_key

string

The public SSH key, consisting of two space-separated fields: the algorithm name, and the base64-encoded key.

resource_group

object

The resource group for this key

type

string

The crypto-system for this key.

The enumerated values for this property may expand in the future.

404 - A key with the specified identifier could not be found or is not associated with the

calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List placement groups

GET /metadata/v1/placement_groups

This request lists placement groups.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-placement-group.list

Request

Response

200 - The placement groups were retrieved successfully

placement_groups

array

A page of placement groups

Retrieve a placement group

GET /metadata/v1/placement_groups/{id}

This request retrieves a single placement group specified by identifier in the URL.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-placement-group.read

Request

Response

200 - The placement group was retrieved successfully

created_at

string

The date and time that the placement group was created

crn

string

The CRN for this placement group

id

string

The unique identifier for this placement group

lifecycle_state

object

The lifecycle state of the placement group

name

string

The name for this placement group. The name is unique across all placement groups in the region.

resource_group

object

The resource group for this placement group

resource_type

string

The resource type

strategy

string

The strategy for this placement group:

  • `host_spread`: place on different compute hosts
  • `power_spread`: place on compute hosts that use different power sources

The enumerated values for this property may expand in the future.

401 - An invalid authentication token was provided

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

403 - The provided token is not authorized for this operation

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - A placement group with the specified identifier could not be found or is not associated

with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

List virtual network interfaces

GET /metadata/v1/virtual_network_interfaces

This request lists virtual network interfaces targeting the calling instance

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-virtual-network-interface.list

Request

Response

200 - The virtual network interfaces were retrieved successfully

virtual_network_interfaces

array

A page of virtual network interfaces

Retrieve a virtual network interface

GET /metadata/v1/virtual_network_interfaces/{id}

This request retrieves a virtual network interface targeting the calling instance.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action.

Auditing

Calling this method generates the following auditing event.

  • is.metadata.instance-virtual-network-interface.read

Request

Path Parameters

id

Required *

The virtual network interface identifier

Query Parameters

Response

200 - The virtual network interface was retrieved successfully

allow_ip_spoofing

boolean

Indicates whether source IP spoofing is allowed on this interface. If `false`, source IP spoofing is prevented on this interface. If `true`, source IP spoofing is allowed on this interface.

auto_delete

boolean

Indicates whether this virtual network interface will be automatically deleted when `target` is deleted

created_at

string

The date and time that the virtual network interface was created

crn

string

The CRN for this virtual network interface

enable_infrastructure_nat

boolean

If `true`:

  • The VPC infrastructure performs any needed NAT operations.
  • `floating_ips` must not have more than one floating IP.

If `false`:

  • Packets are passed unchanged to/from the virtual network interface, allowing the workload to perform any needed NAT operations.
  • `allow_ip_spoofing` must be `false`.
  • Can only be attached to a `target` with a `resource_type` of `bare_metal_server_network_attachment`.

id

string

The unique identifier for this virtual network interface

ips

array

The reserved IPs bound to this virtual network interface.

May be empty when `lifecycle_state` is `pending`.

lifecycle_state

object

The lifecycle state of the virtual network interface

mac_address

string

The MAC address of the virtual network interface. May be absent if `lifecycle_state` is `pending`.

name

string

The name for this virtual network interface. The name is unique across all virtual network interfaces in the VPC.

primary_ip

object

The reserved IP for this virtual network interface.

protocol_state_filtering_mode

string

The protocol state filtering mode used for this virtual network interface. If `auto`, protocol state packet filtering is enabled or disabled based on the virtual network interface's `target` resource type:

  • `bare_metal_server_network_attachment`: disabled
  • `instance_network_attachment`: enabled
  • `share_mount_target`: enabled

Protocol state filtering monitors each network connection flowing over this virtual network interface, and drops any packets that are invalid based on the current connection state and protocol. See Protocol state filtering mode) for more information.

public_address_ranges

array

The public address ranges attached to this virtual network interface.

resource_group

object

The resource group for this virtual network interface

resource_type

string

The resource type

security_groups

array

The security groups for this virtual network interface.

subnet

object

The associated subnet

target

object

The target of this virtual network interface.

vpc

object

The VPC this virtual network interface resides in.

zone

object

The zone this virtual network interface resides in.

403 - The specified virtual network interface is not allowed to be viewed.

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier

404 - A virtual network interface with the specified identifier could not be found or is not

associated with the calling instance

errors

array

The errors that occurred.

status_code

integer

The HTTP status code of the response

trace

string

The unique error identifier