| Euca2ools Guide / Virtual Private Cloud (VPC)-Compatible Commands | |
Show information about virtual private gateways.
euca-describe-vpn-gateways [vgateway_ID [vgateway_ID ...]]
| Option | Description | Required |
|---|---|---|
| vgateway_ID | Limit results to specific virtual private gateways. | No |
| 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. |
You can add filters to your request so that the response includes information for only certain VPC gateways. For example, you can use a filter to return only the VPC gateway that has a specific ID. Some tips for using filters with this command:
The following are the available filters for euca-describe-vpc-gateways:
| Filter | Description |
|---|---|
| attachment.state | state of attachment with a VPC |
| attachment.vpc-id | ID of a VPC the virtual private gateway is attached to |
| availability-zone | availability zone in which the virtual private gateway resides |
| tag-key | key of a tag assigned to the VPC |
| tag-value | value of a tag assigned to the VPC |
| tag:KEY | specific tag key/value combination |
| vpc-connection-id | the VPN connection's ID |
| vpc-gateway-id | ID of the virtual private gateway |