Describe one or more VPC Internet gateways.


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


Option Description Required
gateway_ID [gateway_ID ...] Limit results to one or more supplied Internet gateway IDs. 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 Internet gateways. For example, you can use a filter to return only the Internet gateway that has a specific ID. Some tips for using filters with this command:

The following are the available filters for euca-describe-internet-gateways:

Filter Description
attachment.state attachment state, if the Internet gateway is attached to a VPC
attachment.vpc-id ID of the VPC the Internet gateway is attached to
internet-gateway-id Internet gateway-id ID
tag-key key of a tag assigned to the Internet gateway
tag-value value of a tag assigned to the Internet gateway
tag:KEY specific tag key/value combination

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.


The following example describes all Internet gateways for an account.


This command will return output similar to the following:

ATTACHMENT	vpc-aa87a81b	available
ATTACHMENT	vpc-72ad7f86	available