ListTagResources - - Centre de documentation Alibaba Cloud

Interroge les tags associés à une ressource.

Remarque

Lorsque vous appelez l'opération ListTagResources, vous devez spécifier au moins l'un des paramètres suivants dans la requête : Tag.N.Key et ResourceId.N. Vous pouvez spécifier un ID de ressource pour interroger tous les tags associés à la ressource indiquée. Vous pouvez également spécifier une clé de tag pour interroger la valeur du tag et la ressource à laquelle le tag est associé.

Si vous configurez le paramètre Tag.N.Key dans une requête, vous pouvez obtenir la valeur du tag et l'ID de la ressource à laquelle le tag est associé.
Si vous configurez le paramètre ResourceId.N dans une requête, vous pouvez obtenir les clés et les valeurs de tous les tags associés à la ressource spécifiée.

Limite QPS

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées pour appeler cette opération en une seconde dépasse la limite de requêtes par seconde (QPS), une limitation du débit est déclenchée. Cela peut interrompre votre activité commerciale. Pour plus d'informations sur la limite QPS de chaque opération, consultez les Limites de débit des API.

Autorisation

Par défaut, les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur RAM (Resource Access Management) ne peut appeler cette opération qu'après avoir reçu les autorisations requises. Le tableau suivant décrit les autorisations qui doivent être accordées à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez les Politiques.

API

Action

Resource

ListTagResources

mq:QueryInstanceBaseInfo

mq:ListTagResources

acs:mq:::*

acs:mq:::{InstanceId}

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ListTagResources	L'opération que vous souhaitez effectuer. Définissez la valeur sur ListTagResources.
InstanceId	String	No	MQ_INST_188077086902****_BXSuW61e	L'ID de l'instance Message Queue for Apache RocketMQ à laquelle appartient la ressource dont vous souhaitez interroger les tags. Remarque Ce paramètre est requis lorsque vous interrogez les tags d'un topic ou d'un group.
ResourceType	String	Yes	TOPIC	Le type de la ressource dont vous souhaitez interroger les tags. La valeur est une valeur énumérée. Valeurs valides : INSTANCE TOPIC GROUP
NextToken	String	No	caeba0****be03f84eb48b699f0a4883	Le jeton utilisé pour interroger la page suivante.
Tag.N.Key	String	No	CartService	La clé du tag que vous souhaitez interroger. La valeur de N peut être un nombre compris entre 1 et 20. Si vous incluez ce paramètre dans une requête, la valeur de ce paramètre ne peut pas être une chaîne vide. La valeur de ce paramètre peut comporter jusqu'à 128 caractères et ne peut pas commencer par acs: ou aliyun, ni contenir http:// ou https://.
Tag.N.Value	String	No	ServiceA	La valeur du tag que vous souhaitez interroger. La valeur de N peut être un nombre compris entre 1 et 20. La valeur de ce paramètre peut être une chaîne vide. La valeur de ce paramètre peut comporter jusqu'à 128 caractères et ne peut pas commencer par acs: ou aliyun, ni contenir http:// ou https://.
ResourceId.N	String	No	test	L'ID de la ressource dont vous souhaitez interroger les tags. Si la ressource est une instance Message Queue for Apache RocketMQ, spécifiez l'ID de l'instance. Si la ressource est un topic, spécifiez le nom du topic. Si la ressource est un group, spécifiez l'ID du group.

Paramètres de réponse

Parameter	Type	Example	Description
NextToken	String	caeba0****be03f84eb48b699f0a4883	Le jeton utilisé pour interroger la page suivante.
RequestId	String	301D2CBE-66F8-403D-AEC0-82582478****	L'ID de la requête. Le système génère un ID unique pour chaque requête. Vous pouvez résoudre les problèmes en vous basant sur l'ID de la requête.
TagResources	Array of TagResource		Les détails de la ressource et des tags, y compris l'ID de la ressource, le type de ressource et les clés et valeurs des tags.
ResourceType	String	ALIYUN::MQ::TOPIC	Le type de la ressource. ALIYUN::MQ::INSTANCE : indique que la ressource est une instance Message Queue for Apache RocketMQ. ALIYUN::MQ::TOPIC : indique que la ressource est un topic. ALIYUN::MQ::GROUP : indique que la ressource est un group.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	L'ID de l'instance Message Queue for Apache RocketMQ à laquelle la ressource appartient.
TagValue	String	ServiceA	La valeur du tag.
ResourceId	String	TopicA	L'ID de la ressource.
TagKey	String	CartService	La clé du tag.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

Format 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"
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.

Afficher les tags d'une ressource dans la console

Dans la Message Queue for Apache RocketMQ console, vous pouvez consulter les tags associés à une ressource. Pour plus d'informations, consultez Gérer les tags.