调用TagResources为资源绑定标签。

使用说明

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

QPS限制

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

授权信息

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

API

Action

Resource

TagResources

mq:QueryInstanceBaseInfo

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

资源的标签键。Key和Value值必须同时输入。

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

资源的标签值。Key和Value值必须同时输入。

  • 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版控制台为相关资源绑定标签。具体操作，请参见标签管理。