euca-describe-regions

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

Example

REGION  eucalyptus  http://86.75.30.9:8773/services/Eucalyptus
REGION  walrus  http://86.75.30.9:8773/services/Walrus
x