ListTagResources - - Centro de documentación de Alibaba Cloud

Consulta las etiquetas asociadas a un recurso.

Nota

Al invocar la operación ListTagResources, debe especificar como mínimo uno de los siguientes parámetros en la solicitud: Tag.N.Key o ResourceId.N. Puede indicar un ID de recurso para consultar todas las etiquetas vinculadas a dicho recurso. También puede especificar una clave de etiqueta para obtener su valor y el recurso al que está asociada.

Si configura el parámetro Tag.N.Key en una solicitud, obtendrá el valor de la etiqueta y el ID del recurso al que está vinculada.
Si configura el parámetro ResourceId.N en una solicitud, obtendrá las claves y valores de todas las etiquetas asociadas al recurso especificado.

Límite de QPS

Cada cuenta de Alibaba Cloud puede invocar esta operación hasta 10 veces por segundo. Si la cantidad de solicitudes enviadas en un segundo supera el límite de consultas por segundo (QPS), se activa el estrangulamiento, lo cual podría interrumpir su servicio. Para más información sobre el límite de QPS de cada operación, consulte Límites de velocidad de la API.

Autorización

Las cuentas de Alibaba Cloud pueden invocar esta operación de forma predeterminada. Un usuario de Resource Access Management (RAM) solo podrá hacerlo si cuenta con los permisos necesarios. La siguiente tabla describe los permisos que se deben otorgar a un usuario de RAM para invocar esta operación. Para obtener detalles sobre cómo asignar permisos, consulte Políticas.

API

Action

Resource

ListTagResources

mq:QueryInstanceBaseInfo

mq:ListTagResources

acs:mq:::*

acs:mq:::{InstanceId}

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListTagResources	La operación que desea ejecutar. Establezca el valor en ListTagResources.
InstanceId	String	No	MQ_INST_188077086902****_BXSuW61e	El ID de la instancia de Message Queue for Apache RocketMQ a la que pertenece el recurso cuyas etiquetas desea consultar. Nota Este parámetro es obligatorio cuando consulta las etiquetas de un tema o un grupo.
ResourceType	String	Sí	TOPIC	El tipo de recurso cuyas etiquetas desea consultar. Este campo acepta valores enumerados. Valores válidos: INSTANCE TOPIC GROUP
NextToken	String	No	caeba0****be03f84eb48b699f0a4883	El token utilizado para consultar la página siguiente.
Tag.N.Key	String	No	CartService	La clave de la etiqueta que desea consultar. El valor de N puede ser un número del 1 al 20. Si incluye este parámetro en la solicitud, su valor no puede ser una cadena vacía. El valor de este parámetro puede tener hasta 128 caracteres de longitud y no puede comenzar with acs: ni aliyun, ni contener http:// o https://.
Tag.N.Value	String	No	ServiceA	El valor de la etiqueta que desea consultar. El valor de N puede ser un número del 1 al 20. El valor de este parámetro puede ser una cadena vacía. El valor de este parámetro puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: ni aliyun, ni contener http:// o https://.
ResourceId.N	String	No	test	El ID del recurso cuyas etiquetas desea consultar. Si el recurso es una instancia de Message Queue for Apache RocketMQ, especifique el ID de la instancia. Si el recurso es un tema, especifique el nombre del tema. Si el recurso es un grupo, especifique el ID del grupo.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
NextToken	String	caeba0****be03f84eb48b699f0a4883	El token utilizado para consultar la página siguiente.
RequestId	String	301D2CBE-66F8-403D-AEC0-82582478****	El ID de la solicitud. El sistema genera un ID único para cada solicitud, el cual sirve para solucionar problemas.
TagResources	Array of TagResource		Los detalles del recurso y sus etiquetas, que incluyen el ID del recurso, el tipo de recurso, así como las claves y valores de las etiquetas.
ResourceType	String	ALIYUN::MQ::TOPIC	El tipo de recurso. ALIYUN::MQ::INSTANCE: indica que el recurso es una instancia de Message Queue for Apache RocketMQ. ALIYUN::MQ::TOPIC: indica que el recurso es un tema. ALIYUN::MQ::GROUP: indica que el recurso es un grupo.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	El ID de la instancia de Message Queue for Apache RocketMQ a la que pertenece el recurso.
TagValue	String	ServiceA	El valor de la etiqueta.
ResourceId	String	TopicA	El ID del recurso.
TagKey	String	CartService	La clave de la etiqueta.

Ejemplos

Solicitudes de ejemplo

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=ListTagResources
&ResourceType=TOPIC
&ResourceId.1=TopicA
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/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>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/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"
  }
}

Códigos de error

Para consultar la lista de códigos de error, visite el Centro de errores de la API.

Consultar etiquetas de un recurso en la consola

En la Message Queue for Apache RocketMQ console, puede consultar las etiquetas asociadas a un recurso. Para más información, consulte Gestionar etiquetas.