Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.EC2.DescribeTags

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

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 .

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:

dtFilters - One or more filters. * key - The tag key. * resource-id - The resource ID. * resource-type - The resource type (customer-gateway | dhcp-options | elastic-ip | fpga-image | image | instance | internet-gateway | launch-template | natgateway | network-acl | network-interface | reserved-instances | route-table | security-group | snapshot | spot-instances-request | subnet | volume | vpc | vpc-peering-connection | vpn-connection | vpn-gateway ). * value - The tag value.
dtNextToken - The token to retrieve the next page of results.
dtDryRun - 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 - The maximum number of results to return in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

data DescribeTags Source #

Contains the parameters for DescribeTags.

See: describeTags smart constructor.

Instances

Eq DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods (==) :: DescribeTags -> DescribeTags -> Bool # (/=) :: DescribeTags -> DescribeTags -> Bool #
Data DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeTags -> c DescribeTags # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeTags # toConstr :: DescribeTags -> Constr # dataTypeOf :: DescribeTags -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeTags) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeTags) # gmapT :: (forall b. Data b => b -> b) -> DescribeTags -> DescribeTags # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeTags -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeTags -> r # gmapQ :: (forall d. Data d => d -> u) -> DescribeTags -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeTags -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeTags -> m DescribeTags # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeTags -> m DescribeTags # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeTags -> m DescribeTags #
Read DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods readsPrec :: Int -> ReadS DescribeTags # readList :: ReadS [DescribeTags] # readPrec :: ReadPrec DescribeTags # readListPrec :: ReadPrec [DescribeTags] #
Show DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods showsPrec :: Int -> DescribeTags -> ShowS # show :: DescribeTags -> String # showList :: [DescribeTags] -> ShowS #
Generic DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Associated Types type Rep DescribeTags :: Type -> Type # Methods from :: DescribeTags -> Rep DescribeTags x # to :: Rep DescribeTags x -> DescribeTags #
Hashable DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods hashWithSalt :: Int -> DescribeTags -> Int # hash :: DescribeTags -> Int #
AWSPager DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods page :: DescribeTags -> Rs DescribeTags -> Maybe DescribeTags #
AWSRequest DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Associated Types type Rs DescribeTags :: Type # Methods request :: DescribeTags -> Request DescribeTags # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy DescribeTags -> ClientResponse -> m (Response DescribeTags) #
ToHeaders DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods toHeaders :: DescribeTags -> [Header] #
ToPath DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods toPath :: DescribeTags -> ByteString #
ToQuery DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods toQuery :: DescribeTags -> QueryString #
NFData DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods rnf :: DescribeTags -> () #
type Rep DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags type Rep DescribeTags = D1 (MetaData "DescribeTags" "Network.AWS.EC2.DescribeTags" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeTags'" PrefixI True) ((S1 (MetaSel (Just "_dtFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])) :: S1 (MetaSel (Just "_dtNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) :: (S1 (MetaSel (Just "_dtDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 (MetaSel (Just "_dtMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))))
type Rs DescribeTags Source #
Instance details Defined in Network.AWS.EC2.DescribeTags type Rs DescribeTags = DescribeTagsResponse

Request Lenses

dtFilters :: Lens' DescribeTags [Filter] Source #

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 in a single call. This value can be between 5 and 1000. To retrieve the remaining results, make another call with the returned NextToken value.

Destructuring the Response

describeTagsResponse Source #

Arguments

:: Int	`dtrsResponseStatus`
-> DescribeTagsResponse

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:

dtrsNextToken - The token to use to retrieve the next page of results. This value is null when there are no more results to return..
dtrsTags - A list of tags.
dtrsResponseStatus - -- | The response status code.

data DescribeTagsResponse Source #

Contains the output of DescribeTags.

See: describeTagsResponse smart constructor.

Instances

Eq DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods (==) :: DescribeTagsResponse -> DescribeTagsResponse -> Bool # (/=) :: DescribeTagsResponse -> DescribeTagsResponse -> Bool #
Data DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeTagsResponse -> c DescribeTagsResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeTagsResponse # toConstr :: DescribeTagsResponse -> Constr # dataTypeOf :: DescribeTagsResponse -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeTagsResponse) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeTagsResponse) # gmapT :: (forall b. Data b => b -> b) -> DescribeTagsResponse -> DescribeTagsResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeTagsResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeTagsResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> DescribeTagsResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeTagsResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeTagsResponse -> m DescribeTagsResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeTagsResponse -> m DescribeTagsResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeTagsResponse -> m DescribeTagsResponse #
Read DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods readsPrec :: Int -> ReadS DescribeTagsResponse # readList :: ReadS [DescribeTagsResponse] # readPrec :: ReadPrec DescribeTagsResponse # readListPrec :: ReadPrec [DescribeTagsResponse] #
Show DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods showsPrec :: Int -> DescribeTagsResponse -> ShowS # show :: DescribeTagsResponse -> String # showList :: [DescribeTagsResponse] -> ShowS #
Generic DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Associated Types type Rep DescribeTagsResponse :: Type -> Type # Methods from :: DescribeTagsResponse -> Rep DescribeTagsResponse x # to :: Rep DescribeTagsResponse x -> DescribeTagsResponse #
NFData DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags Methods rnf :: DescribeTagsResponse -> () #
type Rep DescribeTagsResponse Source #
Instance details Defined in Network.AWS.EC2.DescribeTags type Rep DescribeTagsResponse = D1 (MetaData "DescribeTagsResponse" "Network.AWS.EC2.DescribeTags" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeTagsResponse'" PrefixI True) (S1 (MetaSel (Just "_dtrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: (S1 (MetaSel (Just "_dtrsTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [TagDescription])) :: S1 (MetaSel (Just "_dtrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

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..

dtrsTags :: Lens' DescribeTagsResponse [TagDescription] Source #

A list of tags.

dtrsResponseStatus :: Lens' DescribeTagsResponse Int Source #

- | The response status code.