Amazon Elastic Compute Cloud
CLI Reference (API Version 2012-04-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

ec2-create-network-interface

Description

Creates a network interface in the subnet that you specify.

The short version of this command is ec2addnic.

Syntax

ec2-create-network-interface -d, --description DESCRIPTION [--private-ip-address IP_ADDRESS] [-g, --group GROUP] SUBNET

Options

NameDescriptionRequired

-d, --description DESCRIPTION

Set the description of the network interface.

Type: String

Default: None

Example: -d "My ENI"

No

--private-ip-address IP_ADDRESS

Specifies the private IP address of the network interface. If an IP address is not specified, one will be auto-assigned to the interface.

Type: String

Default: None

Example: --private-ip-address 10.0.2.17

No

-g, --group GROUP

Adds a security group to the network interface. It can be used multiple times to add multiple groups.

Type: String

Default: None. If no security group is specified, the interface will become a member of the default security group.

Example: -g sg-bba1bcd7 –g sg-6d495601

No

Common Options

OptionDescription

--region REGION

Overrides the Region specified in the EC2_URL environment variable and the URL specified by the -U option.

Default: The EC2_URL environment variable, or us-east-1 if the environment variable is not set.

Example: --region eu-west-1

-U, --url URL

URL is the uniform resource locator of the Amazon EC2 web service entry point.

Default: The EC2_URL environment variable, or https://ec2.amazonaws.com if the environment variable is not set.

Example: -U https://ec2.amazonaws.com

-K, --private-key EC2-PRIVATE-KEY

The private key to use when constructing requests to Amazon EC2.

Default: The value of the EC2_PRIVATE_KEY environment variable.

Example: -K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

-C, --cert EC2-CERT

The X.509 certificate to use when constructing requests to Amazon EC2.

Default: The value of the EC2_CERT environment variable.

Example: -C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

--connection-timeout TIMEOUT

Specifies a connection timeout (in seconds).

Example: --connection-timeout 30

--request-timeout TIMEOUT

Specifies a request timeout (in seconds).

Example: --request-timeout 45

-v, --verbose

Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.

-H, --headers

Displays column headers in the output.

--show-empty-fields

Shows empty columns as (nil).

--hide-tags

Do not display tags for tagged resources.

--debug

Prints internal debugging information. This is useful to assist us when troubleshooting problems.

-?, --help, -h

Displays Help.

-

If - is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another.

Example: ec2-describe-instances | grep stopped | cut -f 2 | ec2-start-instances -

Output

The command returns the ENI ID for the network interface that was created, along with the subnet ID, VPC ID, Availability Zone, and security group membership.

Amazon EC2 command line tools display errors on stderr.

Examples

Example Request

This example creates a network interface address in the specified subnet.

PROMPT> ec2-create-network-interface -d "My ENI" -g sg-bba1bcd7 --private-ip-address 10.0.2.17 subnet-fd04ff94
NETWORKINTERFACE        eni-3b9f6552    My ENI  subnet-fd04ff94 vpc-e604ff8f    us-east-1b      089818748305            false   pending 02:1a:80:41:52:9c       10.0.2.17               true
				GROUP   sg-bba1bcd7     default