Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.EC2.DeleteTags

Contents

Creating a Request
Request Lenses
Destructuring the Response

Description

Deletes the specified set of tags from the specified set of resources.

To list the current tags, use DescribeTags. For more information about tags, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.

Synopsis

data DeleteTags = DeleteTags' {
- dryRun :: Maybe Bool
- tags :: Maybe [Tag]
- resources :: [Text]
}
newDeleteTags :: DeleteTags
deleteTags_dryRun :: Lens' DeleteTags (Maybe Bool)
deleteTags_tags :: Lens' DeleteTags (Maybe [Tag])
deleteTags_resources :: Lens' DeleteTags [Text]
data DeleteTagsResponse = DeleteTagsResponse' {
}
newDeleteTagsResponse :: DeleteTagsResponse

Creating a Request

data DeleteTags Source #

See: newDeleteTags smart constructor.

Constructors

DeleteTags'

Fields

dryRun :: Maybe Bool
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.
tags :: Maybe [Tag]
The tags to delete. Specify a tag key and an optional tag value to delete specific tags. If you specify a tag key without a tag value, we delete any tag with this key regardless of its value. If you specify a tag key with an empty string as the tag value, we delete the tag only if its value is an empty string.
If you omit this parameter, we delete all user-defined tags for the specified resources. We do not delete Amazon Web Services-generated tags (tags that have the aws: prefix).
Constraints: Up to 1000 tags.
resources :: [Text]
The IDs of the resources, separated by spaces.
Constraints: Up to 1000 resource IDs. We recommend breaking up this request into smaller batches.

Instances

Instances details

ToHeaders DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods toHeaders :: DeleteTags -> [Header] #
ToPath DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods toPath :: DeleteTags -> ByteString #
ToQuery DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods toQuery :: DeleteTags -> QueryString #
AWSRequest DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Associated Types type AWSResponse DeleteTags # Methods request :: (Service -> Service) -> DeleteTags -> Request DeleteTags # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DeleteTags -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DeleteTags))) #
Generic DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Associated Types type Rep DeleteTags :: Type -> Type # Methods from :: DeleteTags -> Rep DeleteTags x # to :: Rep DeleteTags x -> DeleteTags #
Read DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods readsPrec :: Int -> ReadS DeleteTags # readList :: ReadS [DeleteTags] # readPrec :: ReadPrec DeleteTags # readListPrec :: ReadPrec [DeleteTags] #
Show DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods showsPrec :: Int -> DeleteTags -> ShowS # show :: DeleteTags -> String # showList :: [DeleteTags] -> ShowS #
NFData DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods rnf :: DeleteTags -> () #
Eq DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods (==) :: DeleteTags -> DeleteTags -> Bool # (/=) :: DeleteTags -> DeleteTags -> Bool #
Hashable DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods hashWithSalt :: Int -> DeleteTags -> Int # hash :: DeleteTags -> Int #
type AWSResponse DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags type AWSResponse DeleteTags = DeleteTagsResponse
type Rep DeleteTags Source #
Instance details Defined in Amazonka.EC2.DeleteTags type Rep DeleteTags = D1 ('MetaData "DeleteTags" "Amazonka.EC2.DeleteTags" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DeleteTags'" 'PrefixI 'True) (S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])) :: S1 ('MetaSel ('Just "resources") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]))))

newDeleteTags :: DeleteTags Source #

Create a value of DeleteTags with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dryRun:DeleteTags', deleteTags_dryRun - 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.

DeleteTags, deleteTags_tags - The tags to delete. Specify a tag key and an optional tag value to delete specific tags. If you specify a tag key without a tag value, we delete any tag with this key regardless of its value. If you specify a tag key with an empty string as the tag value, we delete the tag only if its value is an empty string.

If you omit this parameter, we delete all user-defined tags for the specified resources. We do not delete Amazon Web Services-generated tags (tags that have the aws: prefix).

Constraints: Up to 1000 tags.

DeleteTags, deleteTags_resources - The IDs of the resources, separated by spaces.

Constraints: Up to 1000 resource IDs. We recommend breaking up this request into smaller batches.

Request Lenses

deleteTags_dryRun :: Lens' DeleteTags (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.

deleteTags_tags :: Lens' DeleteTags (Maybe [Tag]) Source #

The tags to delete. Specify a tag key and an optional tag value to delete specific tags. If you specify a tag key without a tag value, we delete any tag with this key regardless of its value. If you specify a tag key with an empty string as the tag value, we delete the tag only if its value is an empty string.

If you omit this parameter, we delete all user-defined tags for the specified resources. We do not delete Amazon Web Services-generated tags (tags that have the aws: prefix).

Constraints: Up to 1000 tags.

deleteTags_resources :: Lens' DeleteTags [Text] Source #

The IDs of the resources, separated by spaces.

Constraints: Up to 1000 resource IDs. We recommend breaking up this request into smaller batches.

Destructuring the Response

data DeleteTagsResponse Source #

See: newDeleteTagsResponse smart constructor.

Constructors

DeleteTagsResponse'

Instances

Instances details

Generic DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags Associated Types type Rep DeleteTagsResponse :: Type -> Type # Methods from :: DeleteTagsResponse -> Rep DeleteTagsResponse x # to :: Rep DeleteTagsResponse x -> DeleteTagsResponse #
Read DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods readsPrec :: Int -> ReadS DeleteTagsResponse # readList :: ReadS [DeleteTagsResponse] # readPrec :: ReadPrec DeleteTagsResponse # readListPrec :: ReadPrec [DeleteTagsResponse] #
Show DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods showsPrec :: Int -> DeleteTagsResponse -> ShowS # show :: DeleteTagsResponse -> String # showList :: [DeleteTagsResponse] -> ShowS #
NFData DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods rnf :: DeleteTagsResponse -> () #
Eq DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags Methods (==) :: DeleteTagsResponse -> DeleteTagsResponse -> Bool # (/=) :: DeleteTagsResponse -> DeleteTagsResponse -> Bool #
type Rep DeleteTagsResponse Source #
Instance details Defined in Amazonka.EC2.DeleteTags type Rep DeleteTagsResponse = D1 ('MetaData "DeleteTagsResponse" "Amazonka.EC2.DeleteTags" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DeleteTagsResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newDeleteTagsResponse :: DeleteTagsResponse Source #

Create a value of DeleteTagsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.