TagResources - - Centre de documentation Alibaba Cloud

Remarque

Appelez cette opération pour classer les ressources dans Message Queue for Apache RocketMQ et faciliter leur recherche et leur agrégation.

Limite de QPS

Aucune limite de requêtes par seconde (QPS) ne s'applique à cette opération pour un compte Alibaba unique. Appelez cette opération selon vos besoins métier. Pour plus d'informations sur la limite de 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 l'appeler qu'après avoir reçu les autorisations nécessaires. Le tableau ci-dessous décrit les permissions à accorder à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez les Politiques.

API

Action

Resource

|

TagResources

|

mq:QueryInstanceBaseInfo

mq:TagResources

|

acs:mq:::*

|

Paramètres de la requête

Parameter	Type	Required	Example	Description
Action	String	Yes	TagResources	Opération à effectuer. Définissez la valeur sur TagResources.
InstanceId	String	No	MQ_INST_188077086902****_BXSuW61e	ID de l'instance Message Queue for Apache RocketMQ à laquelle appartient la ressource à taguer. Remarque Ce paramètre est requis lorsque vous associez des tags à un topic ou à un group.
ResourceType	String	Yes	TOPIC	Type de la ressource à taguer. Valeurs possibles : INSTANCE TOPIC GROUP
Tag.N.Key	String	Yes	FinanceDept	Clé du tag à associer à la ressource spécifiée. Un tag est défini par les paramètres Tag.N.Key et Tag.N.Value. N est un nombre compris entre 1 et 20. Ce paramètre ne peut pas être une chaîne vide. La valeur peut comporter jusqu'à 18 caractères. Elle ne peut pas commencer par acs: ou aliyun, ni contenir http:// ou https://.
Tag.N.Value	String	Yes	FinanceJoshua	Valeur du tag à associer à la ressource spécifiée. Un tag est défini par les paramètres Tag.N.Key et Tag.N.Value. N est un nombre compris entre 1 et 20. Ce paramètre peut être une chaîne vide. La valeur peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par acs: ou aliyun, ni contenir http:// ou https://.
ResourceId.N	String	Yes	TopicA	ID de la ressource à laquelle associer les tags spécifiés. 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

| RequestId | String | 301D2CBE-66F8-403D-AEC0-82582478**** |

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 cet ID.

|

Exemples

Exemples de requêtes

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
&<Common request parameters>

Exemples de réponses réussies

XML format

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

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

JSON format

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

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

Codes d'erreur

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

Associer des tags à une ressource dans la console

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