调用API TagResources为指定的弹性伸缩资源列表统一创建并绑定标签,可以帮助您更好地管理和分类资源,通过标签了解资源使用情况,提高资源利用率。
接口说明
- 伸缩组最多支持绑定 20 个标签。
说明
绑定标签前,阿里云会校验资源已有标签数量,超过限制值时返回报错信息。
如果
Tags.Propagate参数设置为true时,伸缩组设置的标签只会同步传播到伸缩组中新创建的实例上,而不会传播到已经在伸缩组中运行的实例上。- 如果伸缩配置设置了标签,且将伸缩组设置的标签进行传播,则即将创建的实例标签预期如下:
包含伸缩配置与伸缩组设置传播的所有标签。
如果伸缩配置设置的标签与伸缩组传播的标签具有相同的标签键,则伸缩组传播的标签会被伸缩配置设置的标签覆盖。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ess:TagResources |
update |
*ScalingGroup
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
资源所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| ResourceType |
string |
是 |
资源类型定义,目前仅支持伸缩组。取值:scalinggroup。 |
scalinggroup |
| ResourceIds |
array |
是 |
资源 ID。 |
|
|
string |
否 |
资源 ID。 |
asg-2zej7nf7hea77k5a**** |
|
| Tags |
array<object> |
是 |
资源的标签信息。 |
|
|
object |
否 |
资源的标签信息。 |
||
| Key |
string |
否 |
资源的标签键。 一旦传入该值,则不允许为空字符串。最多支持 128 个字符,不能以 |
TestKey |
| Value |
string |
否 |
资源的标签值。 一旦传入该值,可以为空字符串。最多支持 128 个字符,不能包含 |
TestValue |
| Propagate |
boolean |
否 |
标识该标签是否为可传播标签,取值范围:
默认值:false。 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
74C4E313-8570-479F-8791-DC25360D**** |
示例
正常返回示例
JSON格式
{
"RequestId": "74C4E313-8570-479F-8791-DC25360D****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。