调用ListTagResources查询资源绑定的标签列表。

使用说明

选择Tag.N.Key、Tag.N.Value和ResourceId.N中的一个作为已知参数，可以查询另外两个。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

授权信息

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

API

Action

Resource

ListTagResources

mq:ListTagResources

acs:mq:*:*:*

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

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

系统规定参数。取值：ListTagResources。

ResourceType String 是 TOPIC

资源类型。枚举类型。取值如下：

  • INSTANCE
  • TOPIC
  • GROUP
InstanceId String 否 MQ_INST_188077086902****_BXSuW61e

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

说明 如果您需查询的是Topic、Group ID的标签，则必须填写该参数。
Tag.N.Key String 否 CartService

资源的标签键。

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

资源的标签值。

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

需要打标的资源ID。支持打标的资源包括实例、Topic、Group ID。
NextToken String 否 caeba0****be03f84eb48b699f0a4883

下一页查询开始的Token。

返回数据

名称 类型 示例值 描述
NextToken String caeba0****be03f84eb48b699f0a4883

下一页查询开始的Token。
RequestId String 301D2CBE-66F8-403D-AEC0-82582478****

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

由资源及其标签组成的集合，包含了资源ID、资源类型和标签键值等信息。
InstanceId String MQ_INST_188077086902****_BXSuW61e

实例ID。
ResourceId String TopicA

资源ID。
ResourceType String ALIYUN::MQ::TOPIC

资源类型。
TagKey String CartService

标签键。
TagValue String ServiceA

标签值。

示例

请求示例

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=ListTagResources
&ResourceType=TOPIC
&ResourceId.1=TopicA
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<公共请求参数>

正常返回示例

XML格式 

<ListTagResourcesResponse>
  <RequestId>301D2CBE-66F8-403D-AEC0-82582478****</RequestId>
  <NextToken>caeba0****be03f84eb48b699f0a4883</NextToken>
  <TagResources>
        <ResourceId>TopicA</ResourceId>
        <InstanceId>MQ_INST_188077086902****_BXSuW61e</InstanceId>
        <TagKey>CartService</TagKey>
        <ResourceType>ALIYUN::MQ::TOPIC</ResourceType>
        <TagValue>ServiceA</TagValue>
  </TagResources>
</ListTagResourcesResponse>

JSON格式 

{
        "RequestId": "301D2CBE-66F8-403D-AEC0-82582478****",
        "NextToken": "caeba0****be03f84eb48b699f0a4883",
        "TagResources": {
            "ResourceId": "TopicA",
            "InstanceId": "MQ_INST_188077086902****_BXSuW61e",
            "TagKey": "CartService",
            "ResourceType": "ALIYUN::MQ::TOPIC",
            "TagValue": "ServiceA"
        }
}

错误码

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

控制台操作

除了调用ListTagResources接口，您还可以通过消息队列RocketMQ版控制台查看资源的标签信息。具体操作，请参见标签概述。