IAmazonECS.TagResource Method (TagResourceRequest)

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags that are associated with that resource are deleted as well.

Note:

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

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

Syntax

public abstract TagResourceResponse TagResource(
         TagResourceRequest request
)

Parameters

request: Type: Amazon.ECS.Model.TagResourceRequest

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

Return Value

Type: TagResourceResponse

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

Exceptions

Exception	Condition
ClientException	These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.
ClusterNotFoundException	The specified cluster wasn't found. You can view your available clusters with ListClusters. Amazon ECS clusters are Region specific.
InvalidParameterException	The specified parameter isn't valid. Review the available parameters for the API request. For more information about service event errors, see Amazon ECS service event messages.
ResourceNotFoundException	The specified resource wasn't found.
ServerException	These errors are usually caused by a server issue.

Examples

This example tags the 'dev' cluster with key 'team' and value 'dev'.

To tag a cluster.


var client = new AmazonECSClient();
var response = client.TagResource(new TagResourceRequest 
{
    ResourceArn = "arn:aws:ecs:region:aws_account_id:cluster/dev",
    Tags = new List<Tag> {
        new Tag {
            Key = "team",
            Value = "dev"
        }
    }
});

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

IAmazonECS.TagResource (TagResourceRequest)

Method