Euca2ools Guide / Virtual Private Cloud (VPC)-Compatible Commands |
Describes available VPCs.
euca-describe-vpcs [--show-empty-fields] [-U URL] [--region USER@REGION] [-I KEY_ID] [-S KEY] [--security-token TOKEN] [--filter NAME=VALUE] [--debug] [--debugger] [--version] [-h] [VPC [VPC ...]]
Option | Description | Required |
---|---|---|
VPC_ID [VPC_ID ...] | Limit results to one or more supplied VPC 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 |
You can add filters to your request so that the response includes information for only certain VPCs. For example, you can use a filter to return only the VPC that has a specific ID. Some tips for using filters with this command:
The following are the available filters for euca-describe-vpcs:
Filter | Description |
---|---|
cidr | CIDR address block |
dhcp-options-id | DHCP option set ID |
isDefault | The VPC is a default VPC |
state | The state of the VPC |
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-id | the ID of the VPC |
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 VPCs for an account.
euca-describe-vpcs
This command will return output similar to the following:
VPC vpc-2a0af901 available 10.0.0.0/16 dopt-68a46350 default