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 |
Assigns one or more tags (key-value pairs) to the specified resource. Both sinks and links can be tagged.
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.
Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.
You can use the TagResource
action with a resource that already has
tags. If you specify a new tag key for the alarm, this tag is appended
to the list of tags associated with the alarm. If you specify a tag key
that is already associated with the alarm, the new tag value that you
specify replaces the previous value for that tag.
You can associate as many as 50 tags with a resource.
Unlike tagging permissions in other Amazon Web Services services, to tag
or untag links and sinks you must have the oam:ResourceTag
permission.
The iam:ResourceTag
permission does not allow you to tag and untag
links and sinks.
Synopsis
- data TagResource = TagResource' {}
- newTagResource :: Text -> TagResource
- tagResource_resourceArn :: Lens' TagResource Text
- tagResource_tags :: Lens' TagResource (HashMap Text Text)
- data TagResourceResponse = TagResourceResponse' {
- httpStatus :: Int
- newTagResourceResponse :: Int -> TagResourceResponse
- tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int
Creating a Request
data TagResource Source #
See: newTagResource
smart constructor.
TagResource' | |
|
Instances
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 ARN of the resource that you're adding tags to.
The ARN format of a sink is
arn:aws:oam:
Region
:
account-id
:sink/
sink-id
The ARN format of a link is
arn:aws:oam:
Region
:
account-id
:link/
link-id
For more information about ARN format, see CloudWatch Logs resources and operations.
$sel:tags:TagResource'
, tagResource_tags
- The list of key-value pairs to associate with the resource.
Request Lenses
tagResource_resourceArn :: Lens' TagResource Text Source #
The ARN of the resource that you're adding tags to.
The ARN format of a sink is
arn:aws:oam:
Region
:
account-id
:sink/
sink-id
The ARN format of a link is
arn:aws:oam:
Region
:
account-id
:link/
link-id
For more information about ARN format, see CloudWatch Logs resources and operations.
tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #
The list of key-value pairs to associate with the resource.
Destructuring the Response
data TagResourceResponse Source #
See: newTagResourceResponse
smart constructor.
TagResourceResponse' | |
|
Instances
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
tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int Source #
The response's http status code.