TagResources

Updated at:

Creates and binds tags to a specified list of Auto Scaling resources.

Operation description

Description

  • A scaling group supports binding up to 20 tags.

    Note

    Before binding tags, Alibaba Cloud verifies the number of existing tags on the resource. If the limit is exceeded, an error message is returned.

  • If the Tag.N.Propagate parameter is set to true, the tags set on the scaling group are only propagated to instances that are about to be created in the scaling group, and are not propagated to instances that are already running in the scaling group.

  • If tags are configured in the scaling configuration and the tags set on the scaling group are propagated, the tags on the instances that are about to be created are expected as follows:

    • The instances contain all tags from both the scaling configuration and the propagated tags from the scaling group.

    • If a tag in the scaling configuration has the same tag key as a propagated tag from the scaling group, the propagated tag from the scaling group is overridden by the tag in the scaling configuration.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID of the resource. You can call DescribeRegions to view the latest list of Alibaba Cloud regions.

cn-hangzhou

ResourceType

string

Yes

The resource type. Currently, only scaling groups are supported. Set the value to scalinggroup.

scalinggroup

ResourceId

array

Yes

The resource ID. Valid values of N: 1 to 50.

asg-bp17xb4x1vr29lgt****

string

No

The resource ID. Valid values of N: 1 to 50.

asg-2zej7nf7hea77k5a****

Tag

array<object>

Yes

The tag information of the resource.

object

No

The tag information of the resource.

Key

string

No

The tag key of the resource. Valid values of N: 1 to 20.

Once specified, the tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with aliyun or acs:, or contain http:// or https://.

TestKey

Value

string

No

The tag value of the resource. Valid values of N: 1 to 20.

The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain http:// or https://.

TestValue

Propagate

boolean

No

Specifies whether the tag is a propagated tag. Valid values:

  • true: The tags on the scaling group are propagated only to instances that are about to be created, and are not propagated to instances that are already running in the scaling group.

  • false: The tags on the scaling group are not propagated to instances.

Default value: false.

false

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

74C4E313-8570-479F-8791-DC25360D****

Examples

Success response

JSON format

{
  "RequestId": "74C4E313-8570-479F-8791-DC25360D****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.