DescribeTags
GET /?Action=DescribeTags
Description
Describes one or more tags for your resources.
You can use the Filter.N
parameter to filter the tags on the following properties:
-
key
: The key of the tag. -
value
: The value of the tag. -
resource-id
: The ID of the resource with which the tag is associated. -
resource-type
: The resource type (instance
|image
|volume
|snapshot
|public-ip
|security-group
|route-table
|network-interface
|vpc
|subnet
|network-link
|vpc-endpoint
|nat-gateway
|internet-gateway
|customer-gateway
|vpn-gateway
|vpn-connection
|dhcp-options
|task
).
Note
|
If you exceed the number of identical requests allowed for a configured time period, the |
Body parameter
Required: false
Name: DescribeTagsRequest
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
Filter.N |
One or more filters. Example: |
false |
|||
MaxResults |
The maximum number of results that can be returned in a single page. You can use the |
false |
integer |
||
NextToken |
The token to request the next results page. |
false |
string |
Responses
HTTP Code 200
HTTP Code | Description | Schema |
---|---|---|
200 |
DescribeTagsResult |
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
nextToken |
The token to request the next results page. If the value is |
false |
string |
||
requestId |
The ID of the request. |
false |
string |
||
tagSet.N |
Information about one or more tags. |
false |