amazonka-location-2.0: Amazon Location 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.Location.TagResource

Description

Assigns one or more tags (key-value pairs) to the specified Amazon Location Service resource.

 <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values.</p> <p>You can use the <code>TagResource</code> operation with an Amazon Location Service resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the tags already associated with the resource. If you specify a tag key that's already associated with the resource, the new tag value that you specify replaces the previous value for that tag. </p> <p>You can associate up to 50 tags with a resource.</p>
Synopsis

Creating a Request

data TagResource Source #

See: newTagResource smart constructor.

Constructors

TagResource' 

Fields

  • resourceArn :: Text

    The Amazon Resource Name (ARN) of the resource whose tags you want to update.

    • Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource
  • tags :: HashMap Text Text

    Applies one or more tags to specific resource. A tag is a key-value pair that helps you manage, identify, search, and filter your resources.

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource.
    • Each tag key must be unique and must have exactly one associated value.
    • Maximum key length: 128 Unicode characters in UTF-8.
    • Maximum value length: 256 Unicode characters in UTF-8.
    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @
    • Cannot use "aws:" as a prefix for a key.

Instances

Instances details
ToJSON TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

ToHeaders TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Methods

toHeaders :: TagResource -> [Header] #

ToPath TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

ToQuery TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

AWSRequest TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Associated Types

type AWSResponse TagResource #

Generic TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Associated Types

type Rep TagResource :: Type -> Type #

Read TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Show TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

NFData TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Methods

rnf :: TagResource -> () #

Eq TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

Hashable TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

type AWSResponse TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

type Rep TagResource Source # 
Instance details

Defined in Amazonka.Location.TagResource

type Rep TagResource = D1 ('MetaData "TagResource" "Amazonka.Location.TagResource" "amazonka-location-2.0-4NLaYgEbMXwF6j2j7LAFNb" 'False) (C1 ('MetaCons "TagResource'" 'PrefixI 'True) (S1 ('MetaSel ('Just "resourceArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (HashMap Text Text))))

newTagResource Source #

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 whose tags you want to update.

  • Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource

$sel:tags:TagResource', tagResource_tags - Applies one or more tags to specific resource. A tag is a key-value pair that helps you manage, identify, search, and filter your resources.

Format: "key" : "value"

Restrictions:

  • Maximum 50 tags per resource.
  • Each tag key must be unique and must have exactly one associated value.
  • Maximum key length: 128 Unicode characters in UTF-8.
  • Maximum value length: 256 Unicode characters in UTF-8.
  • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @
  • Cannot use "aws:" as a prefix for a key.

Request Lenses

tagResource_resourceArn :: Lens' TagResource Text Source #

The Amazon Resource Name (ARN) of the resource whose tags you want to update.

  • Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource

tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #

Applies one or more tags to specific resource. A tag is a key-value pair that helps you manage, identify, search, and filter your resources.

Format: "key" : "value"

Restrictions:

  • Maximum 50 tags per resource.
  • Each tag key must be unique and must have exactly one associated value.
  • Maximum key length: 128 Unicode characters in UTF-8.
  • Maximum value length: 256 Unicode characters in UTF-8.
  • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @
  • Cannot use "aws:" as a prefix for a key.

Destructuring the Response

data TagResourceResponse Source #

See: newTagResourceResponse smart constructor.

Constructors

TagResourceResponse' 

Fields

Instances

Instances details
Generic TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

Associated Types

type Rep TagResourceResponse :: Type -> Type #

Read TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

Show TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

NFData TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

Methods

rnf :: TagResourceResponse -> () #

Eq TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

type Rep TagResourceResponse Source # 
Instance details

Defined in Amazonka.Location.TagResource

type Rep TagResourceResponse = D1 ('MetaData "TagResourceResponse" "Amazonka.Location.TagResource" "amazonka-location-2.0-4NLaYgEbMXwF6j2j7LAFNb" 'False) (C1 ('MetaCons "TagResourceResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newTagResourceResponse Source #

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