Auto Scaling
API Reference (API Version 2011-01-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

CreateOrUpdateTags

Description

Creates new tags or updates existing tags for an Auto Scaling group.

Note

A tag's definition is composed of a resource ID, resource type, key and value, and the propagate flag. Value and the propagate flag are optional parameters. See the Request Parameters for more information.

For information on creating tags for your Auto Scaling group, see Tag Your Auto Scaling Groups and Amazon EC2 Instances.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.

Tags.member.N

The tag to be created or updated. Each tag should be defined by its resource type, resource ID, key, value, and a propagate flag. The resource type and resource ID identify the type and name of resource for which the tag is created. Currently, auto-scaling-group is the only supported resource type. The valid value for the resource ID is groupname.

The PropagateAtLaunch flag defines whether the new tag will be applied to instances launched by the Auto Scaling group. Valid values are true or false. However, instances that are already running will not get the new or updated tag. Likewise, when you modify a tag, the updated version will be applied only to new instances launched by the Auto Scaling group after the change. Running instances that had the previous version of the tag will continue to have the older tag.

When you create a tag and a tag of the same name already exists, the operation overwrites the previous tag definition, but you will not get an error message.

Type: Tag list

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

AlreadyExists

The named Auto Scaling group or launch configuration already exists.

HTTP Status Code: 400

LimitExceeded

The quota for capacity groups or launch configurations for this customer has already been reached.

HTTP Status Code: 400

Examples

Sample Request

https://autoscaling.amazonaws.com/?Tags.member.1.ResourceId=my-test-asg
&Tags.member.1.ResourceType=auto-scaling-group
&Tags.member.1.Key=version
&Tags.member.1.Value=1.0
&Tags.member.1.PropagateAtLaunch=true
&Version=2011-01-01
&Action=CreateOrUpdateTags
&AUTHPARAMS 

Sample Response

<CreateOrUpdateTagsResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
  <ResponseMetadata>
    <RequestId>b0203919-bf1b-11e2-8a01-13263EXAMPLE</RequestId>
  </ResponseMetadata>
</CreateOrUpdateTagsResponse>