Shows information about regions.
Syntax
euca-describe-regions [ region_name ] [[--filter "name=value"] ...]
Options
Option |
Description |
Required |
region_name |
Region name to describe |
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 only certain regions. You
can also 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-regions:
Filter |
Description |
endpoint |
Endpoint of the region |
region-name |
Name of the region |
Common Options
Option |
Description |
--show-empty-fields |
Show empty fields as "(nil)". |
--region user@region |
Region and/or user name to search when looking up config file data. Only valid for EC2
endpoints. |
-U,--url url |
URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean. |
-I,--access-key-id key_id |
User's access key ID. |
-S,--secret-key secret_key |
User's secret key. |
--security-token token |
User's security token. |
--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. |
-h,--help |
Display the manual page for the
command. |
--version |
Display the version of this tool. |
Output
- Output type identifier ("REGION")
- Region name
- Service endpoint
Example
REGION eucalyptus http://86.75.30.9:8773/services/Eucalyptus
REGION walrus http://86.75.30.9:8773/services/Walrus