euca-describe-internet-gateways

Syntax

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 ...]]

Options

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:

You can use multiple values for a filter. Eucalyptus responds with information for an Internet gateway only if it matches at least one of the filter values that you specified.
You can use multiple filters. For example, you can specify Internet gateways that have a specific tag. Eucalyptus responds with the information for a Internet gateway 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-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.

Example

The following example describes all Internet gateways for an account.

euca-describe-internet-gateways

This command will return output similar to the following:

INTERNETGATEWAY	igw-016d0212
ATTACHMENT	vpc-aa87a81b	available
INTERNETGATEWAY	igw-35f11866
ATTACHMENT	vpc-72ad7f86	available