euca-describe-network-interfaces

Syntax

euca-describe-network-interfaces [--show-empty-fields] [-U URL]
	[--region USER@REGION] [-I KEY_ID]
	[-S KEY] [--security-token TOKEN]
	[--filter NAME=VALUE] [--debug]
	[--debugger] [--version] [-h]
	[interface_ID [interface_ID ...]]

Options

Option	Description	Required
`[interface_ID [interface_ID ...]]`	Limit results to the specified network interfaces.	No
`-F, --filter name=value`	Filter for limiting the results. See the table in the Available Filters section for a list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value").	No

Available Filters

You can add filters to your request so that the response includes information for only certain DHCP option sets. For example, you can use a filter to return only the network interface that has a specific ID. Some tips for using filters with this command:

You can use multiple values for a filter. Eucalyptus responds with information for a network interface only if it matches at least one of the filter values that you specified.
You can use multiple filters. For example, you can specify network interfaces that have a specific tag. Eucalyptus responds with the information for a network interface only if it matches all the filters that you specified. If there is no match, Eucalyptus returns an empty response.
You can use wildcards in a filter value. Use an asterisk (*) to match zero or more characters. Use a question mark (?) to match exactly one character. To escape special characters, use a backslash (\) before the character. For example, a value of \*eucalyptus\?\\ searches for the literal string *eucalyptus?\.

The following are the available filters for euca-describe-network-interface:

Filter	Description
`addresses.private-ip-addresses`	the interface's private IP addresses
`addresses.primary`	whether the private IP address is the network interface's primary IP address
`addresses.association.public-ip`	association ID for the network interface's elastic IP address
`addresses.association.owner-id`	owner ID of the addresses associated with the network interface
`association.association-id`	association ID of the network interface's IP address
`association.allocation-id`	allocation ID of the network interface's elastic IP address
`association.ip-owner-id`	owner ID of the network interface's elastic IP address
`association.ip-owner-id`	owner ID of the network interface's elastic IP address
`association.public-ip`	network interface's elastic IP address
`association.public-dns-name`	network interface's public DNS name
`attachment.attachment-id`	ID of the network interface's attachment
`attachment.instance-id`	ID of the instance the network interface is attached to
`attachment.instance-owner-id`	owner ID of the instance the network interface is attached to
`attachment.device-index`	device index to which the network interface is attached
`attachment.status`	attachment status (attaching, attached, detaching, detached)
`attachment.attach.time`	time the network interface was attached
`availability-zone`	availability zone in which the network interface resides
`description`	network interface's description
`group-id`	ID of a security group associated with the network interface
`group-name`	name of a security group associated with the network interface
`mac-address`	MAC (hardware) address
`network-interface-id`	ID of the network interface
`owner-id`	account ID of the network interface's owner
`private-ip-address`	the network interface's private address(es)
`private-dns-name`	the network interface's private DNS name
`requester-id`	ID of the entity that created the network interface
`requester-managed`	whether the network interface is being managed by one of the cloud's services
`source-dest-check`	whether the network interface's traffic is subject to source/destination address checking
`status`	the interface's status (available, in-use)
`subnet-id`	ID of the subnet in which the network interface resides
`vpc-id`	ID of the VPC in which the network interface resides
`tag-value`	value of a tag assigned to the DHCP option set
`tag:KEY`	specific tag key/value combination
`type`	type of the DHCP option set

Common Options

Option	Description
`--show-empty-fields`	Show empty fields using `(nil)` as a placeholder to indicate that this data was not requested. Empty fields are not shown by default.
`--region value`	Specify region value as the cloud region to use. You can set this by using the environment variable AWS_DEFAULT_REGION.
`-U,--url value`	Overrides the URL for the service call with the value entered. You can set this by using the environment variable `AWS_AUTOSCALING_URL`.
`-I, --access-key-id value`	User's access key ID
`-S, --secret-key value`	User's AWS secret Key to use.
`--debug`	Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
`--debugger`	Enable interactive debugger on error.
`--version`	Display the version of this tool.
`-h,--help`	Display the manual page for the command.

Example

The following example describes all network interfaces for an account.

euca-describe-network-interfaces

This command will return output similar to the following:

NETWORKINTERFACE	eni-79a17793	subnet-b1ad288b	vpc-72ad7f86	085276049315	in-use	10.0.0.176		true
ATTACHMENT		0	attached	2014-12-11T08:40:05.899Z	true
PRIVATEIPADDRESS	10.0.0.176		primary