         | Did this page help you? Yes No Tell us about it... |
ec2-describe-regions
Description
Describes Regions that are currently available to the account.
You can use filters with this call just as you can with other "describe" calls.
You can use wildcards with the filter values: * matches zero or more characters, and ? matches exactly one character. You can escape special characters using a backslash before the character. For example, a value of \*amazon\?\\ searches for the literal string *amazon?\.
The following table shows the available filters.
| Filter Name | Description |
|---|---|
|
|
Region's endpoint (e.g., ec2.us-east-1.amazonaws.com). Type: String |
|
|
Name of the Region. Type: String |
The short version of this command is ec2dre.
Syntax
ec2-describe-regions [
region...]
[[--filter name=value] ...]
Options
| Name | Description | Required |
|---|---|---|
|
|
Name of a Region. Type: String Default: Describes all Regions, or only those otherwise specified. Example: eu-west-1 |
No |
|
|
A filter for limiting the results. See the preceding table for a list of allowed filter names and values. If you're using the command line tools on a Windows system, you might need to use quotation marks (i.e., "name=value"). Type: String Default: Describes all Regions, or those otherwise specified. Example: --filter "endpoint=*ap*" |
No |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the Region specified in the Default: The Example: |
|
|
Default: The Example: |
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
Specifies a connection timeout (in seconds). Example: --connection-timeout 30 |
|
|
Specifies a request timeout (in seconds). Example: --request-timeout 45 |
|
|
Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API. |
|
|
Displays column headers in the output. |
|
|
Shows empty columns as |
|
|
Do not display tags for tagged resources. |
|
|
Prints internal debugging information. This is useful to assist us when troubleshooting problems. |
|
|
Displays Help. |
|
|
If Example: |
Output
The command returns a table that contains the following information:
REGION identifier
Region name
Service endpoint to which you make requests
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
This example displays information about all the Regions that are available to the account.
PROMPT>ec2-describe-regionsREGION ap-northeast-1 ec2.ap-northeast-1.amazonaws.com REGION ap-southeast-1 ec2.ap-southeast-1.amazonaws.com ..
Example Request
This example displays information about all Regions that have the string ap in the endpoint.
PROMPT>ec2-describe-regions --filter "endpoint=*ap*"REGION ap-southeast-1 ec2.ap-southeast-1.amazonaws.com
