amazonka-resourcegroupstagging-1.6.0: Amazon Resource Groups Tagging API SDK.

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

Network.AWS.ResourceGroupsTagging.UntagResources

Contents

Description

Removes the specified tags from the specified resources. When you specify a tag key, the action removes both that key and its associated value. The operation succeeds even if you attempt to remove tags from a resource that were already removed. Note the following:

  • To remove tags from a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for removing tags. For more information, see Obtaining Permissions for Tagging in the AWS Resource Groups and Tag Editor User Guide .
  • You can only tag resources that are located in the specified region for the AWS account.

Synopsis

Creating a Request

untagResources Source #

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

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

  • urResourceARNList - A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to untag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference .
  • urTagKeys - A list of the tag keys that you want to remove from the specified resources.

data UntagResources Source #

See: untagResources smart constructor.

Instances

Eq UntagResources Source # 
Data UntagResources Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UntagResources -> c UntagResources #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UntagResources #

toConstr :: UntagResources -> Constr #

dataTypeOf :: UntagResources -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c UntagResources) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UntagResources) #

gmapT :: (forall b. Data b => b -> b) -> UntagResources -> UntagResources #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UntagResources -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UntagResources -> r #

gmapQ :: (forall d. Data d => d -> u) -> UntagResources -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> UntagResources -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> UntagResources -> m UntagResources #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UntagResources -> m UntagResources #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UntagResources -> m UntagResources #

Read UntagResources Source # 
Show UntagResources Source # 
Generic UntagResources Source # 

Associated Types

type Rep UntagResources :: * -> * #

Hashable UntagResources Source # 
ToJSON UntagResources Source # 
NFData UntagResources Source # 

Methods

rnf :: UntagResources -> () #

AWSRequest UntagResources Source # 
ToHeaders UntagResources Source # 
ToPath UntagResources Source # 
ToQuery UntagResources Source # 
type Rep UntagResources Source # 
type Rep UntagResources = D1 * (MetaData "UntagResources" "Network.AWS.ResourceGroupsTagging.UntagResources" "amazonka-resourcegroupstagging-1.6.0-5L2Cxw2zEoEKPDJx4TkmLS" False) (C1 * (MetaCons "UntagResources'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_urResourceARNList") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (List1 Text))) (S1 * (MetaSel (Just Symbol "_urTagKeys") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (List1 Text)))))
type Rs UntagResources Source # 

Request Lenses

urResourceARNList :: Lens' UntagResources (NonEmpty Text) Source #

A list of ARNs. An ARN (Amazon Resource Name) uniquely identifies a resource. You can specify a minimum of 1 and a maximum of 20 ARNs (resources) to untag. An ARN can be set to a maximum of 1600 characters. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference .

urTagKeys :: Lens' UntagResources (NonEmpty Text) Source #

A list of the tag keys that you want to remove from the specified resources.

Destructuring the Response

untagResourcesResponse Source #

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

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

  • urrsFailedResourcesMap - Details of resources that could not be untagged. An error code, status code, and error message are returned for each failed item.
  • urrsResponseStatus - -- | The response status code.

data UntagResourcesResponse Source #

See: untagResourcesResponse smart constructor.

Instances

Eq UntagResourcesResponse Source # 
Data UntagResourcesResponse Source # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UntagResourcesResponse -> c UntagResourcesResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UntagResourcesResponse #

toConstr :: UntagResourcesResponse -> Constr #

dataTypeOf :: UntagResourcesResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c UntagResourcesResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UntagResourcesResponse) #

gmapT :: (forall b. Data b => b -> b) -> UntagResourcesResponse -> UntagResourcesResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UntagResourcesResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UntagResourcesResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> UntagResourcesResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> UntagResourcesResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> UntagResourcesResponse -> m UntagResourcesResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UntagResourcesResponse -> m UntagResourcesResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UntagResourcesResponse -> m UntagResourcesResponse #

Read UntagResourcesResponse Source # 
Show UntagResourcesResponse Source # 
Generic UntagResourcesResponse Source # 
NFData UntagResourcesResponse Source # 

Methods

rnf :: UntagResourcesResponse -> () #

type Rep UntagResourcesResponse Source # 
type Rep UntagResourcesResponse = D1 * (MetaData "UntagResourcesResponse" "Network.AWS.ResourceGroupsTagging.UntagResources" "amazonka-resourcegroupstagging-1.6.0-5L2Cxw2zEoEKPDJx4TkmLS" False) (C1 * (MetaCons "UntagResourcesResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_urrsFailedResourcesMap") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe (Map Text FailureInfo)))) (S1 * (MetaSel (Just Symbol "_urrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int))))

Response Lenses

urrsFailedResourcesMap :: Lens' UntagResourcesResponse (HashMap Text FailureInfo) Source #

Details of resources that could not be untagged. An error code, status code, and error message are returned for each failed item.

urrsResponseStatus :: Lens' UntagResourcesResponse Int Source #

  • - | The response status code.