Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . discovery ]



Retrieves a list of configuration items that have tags as specified by the key-value pairs, name and value, passed to the optional parameter filters .

There are three valid tag filter names:

  • tagKey
  • tagValue
  • configurationId

Also, all configuration items associated with your user account that have tags can be listed if you call DescribeTags as is without passing any parameters.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


[--filters <value>]
[--max-results <value>]
[--next-token <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--filters (list)

You can filter the list using a key -value format. You can separate these items by using logical operators. Allowed filters include tagKey , tagValue , and configurationId .

Shorthand Syntax:

name=string,values=string,string ...

JSON Syntax:

    "name": "string",
    "values": ["string", ...]

--max-results (integer)

The total number of items to return in a single page of output. The maximum value is 100.

--next-token (string)

A token to start the list. Use this token to get the next set of results.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


tags -> (list)

Depending on the input, this is a list of configuration items tagged with a specific tag, or a list of tags for a specific configuration item.


Tags for a configuration item. Tags are metadata that help you categorize IT assets.

configurationType -> (string)

A type of IT asset to tag.

configurationId -> (string)

The configuration ID for the item to tag. You can specify a list of keys and values.

key -> (string)

A type of tag on which to filter. For example, serverType .

value -> (string)

A value on which to filter. For example key = serverType and value = web server .

timeOfCreation -> (timestamp)

The time the configuration tag was created in Coordinated Universal Time (UTC).

nextToken -> (string)

The call returns a token. Use this token to get the next set of results.