ec2-attach-internet-gateway

Description

Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC. For more information about your VPC and Internet gateway, go to the Amazon Virtual Private Cloud User Guide.

	Note
	For VPCs that existed before the 2011-01-01 API version: Before you can attach an Internet gateway, you must delete the legacy security group. For more information, go to "Deleting the Legacy Security Group" in the Security Groups section of the Amazon Virtual Private Cloud User Guide.

The short version of this command is ec2attigw.

Syntax

ec2-attach-internet-gateway internet_gateway_id -c vpc_id

Options

Name Description Required

Name	Description	Required
`internet_gateway_id`	The ID of the Internet gateway to attach. Type: String Default: None Example: igw-c3a643aa	Yes
`-c, --vpc` `vpc_id`	The ID of the VPC. Type: String Default: None Example: -c vpc-d9a045b0	Yes

internet_gateway_id

The ID of the Internet gateway to attach.

Type: String

Default: None

Example: igw-c3a643aa

Yes

-c, --vpc vpc_id

The ID of the VPC.

Type: String

Default: None

Example: -c vpc-d9a045b0

Yes

Common Options

Option	Description
`--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

Boolean true or false

Amazon EC2 command line tools display errors on stderr.

Examples

Example Request

This example attaches the Internet gateway with ID igw-eaad4883 to the VPC with ID vpc-11ad4878.

PROMPT> ec2-attach-internet-gateway igw-eaad4883 -c vpc-11ad4878
ATTACHMENT      vpc-11ad4878    attaching