IAmazonApplicationAutoScaling.TagResource Method (TagResourceRequest)

Adds or edits tags on an Application Auto Scaling scalable target.

Each tag consists of a tag key and a tag value, which are both case-sensitive strings. To add a tag, specify a new tag key and a tag value. To edit a tag, specify an existing tag key and a new tag value.

You can use this operation to tag an Application Auto Scaling scalable target, but you cannot tag a scaling policy or scheduled action.

You can also add tags to an Application Auto Scaling scalable target while creating it (RegisterScalableTarget).

For general information about tags, including the format and syntax, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference.

Use tags to control access to a scalable target. For more information, see Tagging support for Application Auto Scaling in the Application Auto Scaling User Guide.

Note:

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

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

Syntax

public abstract TagResourceResponse TagResource(
         TagResourceRequest request
)

Parameters

request: Type: Amazon.ApplicationAutoScaling.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 ApplicationAutoScaling.

Exceptions

Exception	Condition
ResourceNotFoundException	The specified resource doesn't exist.
TooManyTagsException	The request contains too many tags. Try the request again with fewer tags.
ValidationException	An exception was thrown for a validation issue. Review the available parameters for the API request.

Examples

This example adds a tag with the key name "environment" and the value "production" to the scalable target specified by its ARN.

To add a tag to a scalable target


var client = new AmazonApplicationAutoScalingClient();
var response = client.TagResource(new TagResourceRequest 
{
    ResourceARN = "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123",
    Tags = new Dictionary<string, string> {
        { "environment", "production" }
    }
});

Version Information

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

IAmazonApplicationAutoScaling.TagResource (TagResourceRequest)

Method