AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Assigns one or more tags (key-value pairs) to the specified CloudWatch resource. Currently, the only CloudWatch resources that can be tagged are alarms and Contributor Insights rules.

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 an alarm 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 CloudWatch resource.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to TagResourceAsync.

Namespace: Amazon.CloudWatch
Assembly: AWSSDK.CloudWatch.dll
Version: 3.x.y.z

Syntax

C#
public abstract TagResourceResponse TagResource(
         TagResourceRequest request
)

Parameters

request
Type: Amazon.CloudWatch.Model.TagResourceRequest

Container for the necessary parameters to execute the TagResource service method.

Return Value


The response from the TagResource service method, as returned by CloudWatch.

Exceptions

ExceptionCondition
ConcurrentModificationException More than one process tried to modify a resource at the same time.
InternalServiceException Request processing has failed due to some unknown error, exception, or failure.
InvalidParameterValueException The value of an input parameter is bad or out-of-range.
ResourceNotFoundException The named resource does not exist.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also