调用TagResources为资源绑定标签。

使用说明

本接口一般在需要对消息队列RocketMQ版的资源进行归类时使用,便于搜索和资源聚合。

QPS限制

本接口无单用户QPS限制,请您根据实际需要合理调用。更多信息,请参见QPS限制

授权信息

默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。本接口的授权信息如下表所示。更多信息,请参见权限策略和示例

API

Action

Resource

TagResources

mq:TagResources

acs:mq:*:*:*

请求参数

名称 类型 是否必选 示例值 描述
Action String TagResources

系统规定参数。取值:TagResources

InstanceId String MQ_INST_188077086902****_BXSuW61e

所需绑定标签的资源所在的实例的ID。

说明 如需为Topic或Group ID绑定标签,则必须填写该参数。
ResourceType String TOPIC

资源类型。枚举类型。取值:

  • INSTANCE
  • TOPIC
  • GROUP
Tag.N.Key String FinanceDept

资源的标签键。KeyValue值必须同时输入。

  • N的取值范围为1~20。
  • 该值不允许为空字符串。
  • 最多支持18个字符,不能以aliyun和acs:开头,不能包含http://或者https://。
Tag.N.Value String FinanceJoshua

资源的标签值。KeyValue值必须同时输入。

  • N的取值范围为1~20。
  • 该值可以为空字符串。
  • 最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。
ResourceId.N String TopicA

需要绑定标签的资源ID。

  • 当需要绑定标签的资源类型为实例时,该参数输入实例ID。
  • 当需要绑定标签的资源类型为Topic时,该参数输入Topic名称。
  • 当需要绑定标签的资源类型为Group时,该参数输入Group ID。

返回数据

名称 类型 示例值 描述
RequestId String 301D2CBE-66F8-403D-AEC0-82582478****

公共参数,每个请求的ID都是唯一的,可用于排查和定位问题。

示例

请求示例

http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=TagResources
&ResourceId.1=TopicA
&ResourceType=TOPIC
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
<RequestId>301D2CBE-66F8-403D-AEC0-82582478****</RequestId>
</TagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "301D2CBE-66F8-403D-AEC0-82582478****"
}

错误码

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

控制台操作

除了调用TagResources接口,您还可以通过消息队列RocketMQ版控制台为相关资源绑定标签。具体操作,请参见标签概述