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.

Adds or overwrites one or more tags for the specified resource. Tags are metadata that you can assign to your documents, managed instances, Maintenance Windows, Parameter Store parameters, and patch baselines. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test.

Each resource can have a maximum of 10 tags.

We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters.

For more information about tags, see Tagging Your Amazon EC2 Resources in the Amazon EC2 User Guide.

Note:

For PCL this operation is only available in asynchronous form. Please refer to AddTagsToResourceAsync.

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

Syntax

C#
public abstract AddTagsToResourceResponse AddTagsToResource(
         AddTagsToResourceRequest request
)
Parameters
request
Type: Amazon.SimpleSystemsManagement.Model.AddTagsToResourceRequest

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

Return Value
The response from the AddTagsToResource service method, as returned by SimpleSystemsManagement.

Exceptions

ExceptionCondition
InternalServerErrorException An error occurred on the server side.
InvalidResourceIdException The resource ID is not valid. Verify that you entered the correct ID and try again.
InvalidResourceTypeException The resource type is not valid. For example, if you are attempting to tag an instance, the instance must be a registered, managed instance.
TooManyTagsErrorException The Targets parameter includes too many tags. Remove one or more tags and try the command again.

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also