TagResources - 添加资源标签_负载均衡(SLB)-阿里云帮助中心

为指定的资源列表创建并绑定标签。

调试

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

gwlb:TagResources

update

ServerGroup

acs:gwlb:{#regionId}:{#accountId}:servergroup/{#ServerGroupId}

Listener

acs:gwlb:{#regionId}:{#accountId}:listener/{#ListenerId}

LoadBalancer

acs:gwlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

无

名称	类型	必填	描述	示例值
ResourceType	string	是	资源类型，取值： loadbalancer：网关型负载均衡实例。 listener：监听。 servergroup：服务器组。	loadbalancer
ResourceId	array	是	资源 ID 列表。一次调用最多支持添加 50 个资源 ID。
	string	否	资源 ID。	gwlb-nrnrxwd15en27r****
Tag	array<object>	是	标签列表。一次调用最多支持 20 个标签。
	object	是	标签。
Key	string	是	标签键。一旦传入该值，则不允许为空字符串。最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	testKey
Value	string	是	标签值。最多支持 256 个字符，不能包含`http://`或`https://`。	testValue
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会添加标签。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-42665544****

正常返回示例

JSON格式

{
  "RequestId": "54F6E60A-1777-5C17-A6A9-BCC1A7FE945B"
}

HTTP status code	错误码	错误信息	描述
400	MissingParam.TagKey	The param of TagKey is missing.	标签键参数缺失
400	MissingParam.TagValue	The param of TagValue is missing.	标签值参数缺失
400	ResourceQuotaExceeded.TagNum	The quota of %s is exceeded for resource %s, usage %s/%s.	资源绑定的标签数量超限
400	DuplicatedParam.TagKey	The param of %s is duplicated.	标签键参数重复
400	IllegalParam.TagKey	The param of %s is illegal.
400	IllegalParam.TagValue	The param of %s is illegal.	标签值参数不合法
400	DuplicatedParam.ResourceId	The param of %s is duplicated.	参数%s重复
404	ResourceNotFound.LoadBalancer	The specified resource of %s is not found.	指定的负载均衡资源不存在
404	ResourceNotFound.Listener	The specified resource of %s is not found.	指定的监听资源不存在
404	ResourceNotFound.ServerGroup	The specified resource of %s is not found.	指定的服务器组资源不存在。

访问错误中心查看更多错误码。

更多信息，参考变更详情。