amazonka-ec2-1.3.4: Amazon Elastic Compute Cloud SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.DescribeTags

Contents

Description

Describes one or more of the tags for your EC2 resources.

For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.

See: AWS API Reference for DescribeTags.

This operation returns paginated results.

Synopsis

Creating a Request

describeTags :: DescribeTags Source

Creates a value of DescribeTags with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

dtFilters :: Lens' DescribeTags [Filter] Source

One or more filters.

  • key - The tag key.
  • 'resource-id' - The resource ID.
  • 'resource-type' - The resource type ('customer-gateway' | 'dhcp-options' | image | 'instance' | 'internet-gateway' | 'network-acl' | 'network-interface' | 'reserved-instances' | 'route-table' | 'security-group' | snapshot | 'spot-instances-request' | subnet | volume | vpc | 'vpn-connection' | 'vpn-gateway').
  • value - The tag value.

dtNextToken :: Lens' DescribeTags (Maybe Text) Source

The token to retrieve the next page of results.

dtDryRun :: Lens' DescribeTags (Maybe Bool) Source

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

dtMaxResults :: Lens' DescribeTags (Maybe Int) Source

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1000; if MaxResults is given a value larger than 1000, only 1000 results are returned.

Destructuring the Response

describeTagsResponse Source

Creates a value of DescribeTagsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

dtrsNextToken :: Lens' DescribeTagsResponse (Maybe Text) Source

The token to use to retrieve the next page of results. This value is null when there are no more results to return..