How to use “describe-scope” command in AWS CLI?

AWS CLI is an integrated tool used to access, control, and manage AWS resources through the terminal on your local machines. With AWS CLI, users can interact with AWS services using simple one-line commands. One of these simple one-line commands from the AWS CLI is “Describe areas” Permission. In AWS, some regions are active by default. However, some fields are only enabled when a user selects them manually. Therefore, this command can help AWS users to display a list of regions across the platform.

quick outline,

This article covers the following aspects:

What is the “describe-scope” command in AWS CLI?

“Describe areas” The command in the AWS CLI is used to list and display all the fields for a given account. This command supports pagination and is commonly used with EC2 instances. In Previous AWS Documentation, “list-field” The command was used to display all AWS regions. Although “Describe areas” The command update is also supported in AWS CLI v2 (version 2) and AWS's revised documentation,

Read more: AWS global infrastructure overview

How to use “describe-scope” command in AWS CLI?

“Describe areas” Commands are used with multiple optional arguments to execute various functionalities. These actions include filtering fields or displaying data in different formats. There are no required parameters for this command.


syntax for “Describe areas” The order is given below:

aws ec2 description-zone <Option,


A brief description of the various options that can be used with the above command is given below:

Option Description
-Filter -Filter Options are used to extract specific details from data. Three different filters can be used with it “Describe areas” Permission:

  • Endpoint: This filter type displays only fields that begin with or match the value specified for the endpoint.
  • Opt-in-status: Opt-in areas are areas that are manually activated by the user. They have more protection than normal examples. This is because they share IAM data between accounts in different opt-in areas. There are three different values ​​for this, for example, Opt-in not required, choose in, And Not opted-in.
  • Field Name: This option accepts a field name and then lists only those fields in the response.
-Rehearsal This option confirms permission for the desired action. The response is generated in error format. If the user is equipped with the required permissions, the output will display “dryrunoperation”, Otherwise, the response will include a “Unauthorized Operation” price.
-all areas This option is used to display all AWS Regions for a given account. This includes areas that are disabled for your account. To disable this option, use the -no-all-regions option.
-cli-input-json The -cli-input-json option is used to provide instructions to the CLI one at a time in JSON format. If other options are specified within the command the values ​​of these options will be overwritten.
-generate-cli-skeleton This option accepts string values ​​and is used to create JSON templates. This template will then be used by the -cli-input-json option.

Global options are also provided that are used with each command for the AWS CLI. They are not required fields. However, the user can control the output of the command using global options. To read about global options, see AWS Documentation,


In this part of the article, we will apply the following example:

Example 1: How to list all enabled zones in AWS CLI?

The command below lists all enabled fields for your account:


Example 2: How to list all regions in AWS CLI?

The following command is used to list all the fields for a given account. By all regions, this refers to include all enabled, disabled, or global regions on the AWS platform:

aws ec2 description-zone –all areas


To disable “-all areas” parameters, use the following command:

aws ec2 description-zone –not-all-areas


Example 3: How to filter fields in AWS CLI?

In AWS CLI, we can filter fields based on endpoint, tag, opt-in status, etc. through the following command:

aws ec2 description-zone –filter “name=endpoint, value=*ap*”


How to filter fields using the “opt-in-status” parameter

The output of this command will display only the regions Opt-in not required price:

aws ec2 description-zone –filter “name=opt-in-status, value=*opt-in-not required*”

Comment: User can also specify other options in the name field like chose in Or Not opted-in Option.


How to filter a region using the “region-name” parameter

The command to filter fields through field-name filter is given below:

aws ec2 description-zone –filter “name=region-name, value=*ap-southeast-1*”

Comment: change value ap-southeast-1 with someone AWS region name. However, the asterisk remains the same.


The output of the command will list only the specific field that matches the value mentioned in it “Value” Parameters. User can also specify fields like, “European Union” In *AP* The format specified in the previous part of this example:

Example 4: How to list fields in different output formats?

In “Describe areas” command, multiple output formats are available such as table, JSON, text, or YAML. The order in which the areas are listed in tabular format is given below:

aws ec2 description-zone –Output table

Comment: Replace the value of the -Output parameter with JSON, YAML, or text to get values ​​in different formats.


Example 5: How to query regions using the “describe-region” command in the AWS CLI?

User can also filter the response using JMESPATH “-Question” Parameters. The order is given below:

aws ec2 description-zone –Question “Area[], {name:fieldname}” –Output Basic lesson


Example 6: How to set permissions for the “describe-scope” command in the AWS CLI?

-Rehearsal option of “Describe areas” The command determines whether the user has the necessary permissions to perform the action. For this purpose, the order is given below:

aws ec2 description-zone –Rehearsal


Similarly, the user can also disable this flag for displaying regions using the following command:

aws ec2 description-zone –no-dry-run


Example 7: How to list specific fields in “describe-field” command?

To display specific fields, one method is to filter the query while the other method is to use “-field-name”, Uses the following commands “-field-name” option with “Describe areas” Permission:

aws ec2 description-zone –field-name AP-Southeast-1

Comment: change value ap-southeast-1 in command with you AWS region name.


That's all from this guide.

ground level

“Describe areas” Command in AWS CLI Lists all or enabled zones for a given account. To list EC2 regions, use “aws ec2 description-zone” Permission. It supports multiple output formats and accepts various arguments for filtering or querying. For AWS beginners, this command is useful when deploying region-specific resources or determining URLs of endpoints. To implement this functionality, log into the AWS CLI via CMD and provide the commands described earlier to the terminal. In this guide, we have discussed various examples step by step for a deeper understanding of “Describe areas” Commands in AWS CLI.

Add comment

By Ranjan