amazonka-cost-explorer-2.0: Amazon Cost Explorer Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.CostExplorer.TagResource

Description

An API operation for adding one or more tags (key-value pairs) to a resource.

You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value you specify replaces the previous value for that tag.

Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

Synopsis

Creating a Request

data TagResource Source #

See: newTagResource smart constructor.

Constructors

TagResource' 

Fields

  • resourceArn :: Text

    The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

  • resourceTags :: [ResourceTag]

    A list of tag key-value pairs to be added to the resource.

    Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

    • Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
    • The maximum length of a key is 128 characters
    • The maximum length of a value is 256 characters
    • Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
    • Keys and values are case sensitive
    • Keys and values are trimmed for any leading or trailing whitespaces
    • Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use

Instances

Instances details
ToJSON TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

toJSON :: TagResource -> Value #

toEncoding :: TagResource -> Encoding #

toJSONList :: [TagResource] -> Value #

toEncodingList :: [TagResource] -> Encoding #

ToHeaders TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

toHeaders :: TagResource -> [Header] #

ToPath TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

toPath :: TagResource -> ByteString #

ToQuery TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

toQuery :: TagResource -> QueryString #

AWSRequest TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Associated Types

type AWSResponse TagResource #

Methods

request :: (Service -> Service) -> TagResource -> Request TagResource #

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy TagResource -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse TagResource))) #

Generic TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Associated Types

type Rep TagResource :: Type -> Type #

Methods

from :: TagResource -> Rep TagResource x #

to :: Rep TagResource x -> TagResource #

Read TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

readsPrec :: Int -> ReadS TagResource #

readList :: ReadS [TagResource] #

readPrec :: ReadPrec TagResource #

readListPrec :: ReadPrec [TagResource] #

Show TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

showsPrec :: Int -> TagResource -> ShowS #

show :: TagResource -> String #

showList :: [TagResource] -> ShowS #

NFData TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

rnf :: TagResource -> () #

Eq TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

(==) :: TagResource -> TagResource -> Bool #

(/=) :: TagResource -> TagResource -> Bool #

Hashable TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

hashWithSalt :: Int -> TagResource -> Int #

hash :: TagResource -> Int #

type AWSResponse TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

type AWSResponse TagResource = TagResourceResponse
type Rep TagResource Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

type Rep TagResource = D1 ('MetaData "TagResource" "Amazonka.CostExplorer.TagResource" "amazonka-cost-explorer-2.0-QqVzyVvst98QYs5s2Ea4h" 'False) (C1 ('MetaCons "TagResource'" 'PrefixI 'True) (S1 ('MetaSel ('Just "resourceArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "resourceTags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [ResourceTag])))

newTagResource Source #

Arguments

:: Text

$sel:resourceArn:TagResource'

-> TagResource 

Create a value of TagResource 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:resourceArn:TagResource', tagResource_resourceArn - The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

$sel:resourceTags:TagResource', tagResource_resourceTags - A list of tag key-value pairs to be added to the resource.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

  • Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
  • The maximum length of a key is 128 characters
  • The maximum length of a value is 256 characters
  • Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
  • Keys and values are case sensitive
  • Keys and values are trimmed for any leading or trailing whitespaces
  • Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use

Request Lenses

tagResource_resourceArn :: Lens' TagResource Text Source #

The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

tagResource_resourceTags :: Lens' TagResource [ResourceTag] Source #

A list of tag key-value pairs to be added to the resource.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

  • Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
  • The maximum length of a key is 128 characters
  • The maximum length of a value is 256 characters
  • Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
  • Keys and values are case sensitive
  • Keys and values are trimmed for any leading or trailing whitespaces
  • Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use

Destructuring the Response

data TagResourceResponse Source #

See: newTagResourceResponse smart constructor.

Constructors

TagResourceResponse' 

Fields

Instances

Instances details
Generic TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Associated Types

type Rep TagResourceResponse :: Type -> Type #

Methods

from :: TagResourceResponse -> Rep TagResourceResponse x #

to :: Rep TagResourceResponse x -> TagResourceResponse #

Read TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

readsPrec :: Int -> ReadS TagResourceResponse #

readList :: ReadS [TagResourceResponse] #

readPrec :: ReadPrec TagResourceResponse #

readListPrec :: ReadPrec [TagResourceResponse] #

Show TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

showsPrec :: Int -> TagResourceResponse -> ShowS #

show :: TagResourceResponse -> String #

showList :: [TagResourceResponse] -> ShowS #

NFData TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

rnf :: TagResourceResponse -> () #

Eq TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

Methods

(==) :: TagResourceResponse -> TagResourceResponse -> Bool #

(/=) :: TagResourceResponse -> TagResourceResponse -> Bool #

type Rep TagResourceResponse Source # 
Instance details

Defined in Amazonka.CostExplorer.TagResource

type Rep TagResourceResponse = D1 ('MetaData "TagResourceResponse" "Amazonka.CostExplorer.TagResource" "amazonka-cost-explorer-2.0-QqVzyVvst98QYs5s2Ea4h" 'False) (C1 ('MetaCons "TagResourceResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newTagResourceResponse Source #

Arguments

:: Int

$sel:httpStatus:TagResourceResponse'

-> TagResourceResponse 

Create a value of TagResourceResponse 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:httpStatus:TagResourceResponse', tagResourceResponse_httpStatus - The response's http status code.

Response Lenses

tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int Source #

The response's http status code.