Pousse un message vers un consommateur spécifié.
Remarque
Cette opération permet de vérifier si les messages d'un topic spécifié peuvent être consommés par les consommateurs d'un groupe de consommateurs donné. Elle récupère le corps du message identifié par le paramètre MsgId, réencapsule ce corps pour générer un nouveau message, puis le pousse vers le consommateur cible. Le contenu du message envoyé au consommateur est identique à celui du message d'origine. Il ne s'agit pas du même message, car les ID de message diffèrent.
Limite de requêtes
Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées en une seconde atteint cette limite, les nouvelles requêtes échouent, ce qui peut interrompre votre activité. Pour plus d'informations sur les limites de requêtes de chaque opération, consultez la rubrique Limites des requêtes 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 autorisations à accorder à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez la rubrique Politiques.
|
API |
Action |
Ressource dans une instance utilisant un namespace |
Ressource dans une instance n'utilisant pas de namespace |
|
OnsMessagePush |
mq:QueryInstanceBaseInfo mq:SUB |
acs:mq:::{instanceId}%{topic} |
acs:mq:::{topic} |
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
Action |
String |
Oui |
OnsMessagePush |
Opération à effectuer. Définissez la valeur sur OnsMessagePush. |
|
GroupId |
String |
Oui |
GID_test_group_id |
ID du groupe de consommateurs. Pour en savoir plus sur la notion de groupe de consommateurs, consultez la rubrique Termes. |
|
ClientId |
String |
Oui |
30.5.121.**@24813#-1999745829#-1737591554#453111174894656 |
ID du consommateur. Appelez l'opération OnsConsumerGetConnection pour interroger l'ID de chaque consommateur au sein d'un groupe de consommateurs. |
|
MsgId |
String |
Oui |
0BC1669963053CF68F733BB70396**** |
ID du message. |
|
Topic |
String |
Oui |
test-mq_topic |
Topic vers lequel le message est poussé. |
|
InstanceId |
String |
Oui |
MQ_INST_111111111111_DOxxxxxx |
ID de l'instance Message Queue for Apache RocketMQ à laquelle appartient le groupe de consommateurs spécifié. |
Paramètres de réponse
|
Paramètre |
Type |
Exemple |
Description |
|
RequestId |
String |
B8EDC90D-F726-4B9E-8BEF-F0DD25EC**** |
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=OnsMessagePush
&GroupId=GID_test_group_id
&ClientId=30.5.121.**@24813#-1999745829#-1737591554#453111174894656
&MsgId=0BC1669963053CF68F733BB70396****
&Topic=test-mq_topic
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&<Common request parameters>Exemples de réponses réussies
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsMessagePushResponse>
<RequestId>B8EDC90D-F726-4B9E-8BEF-F0DD25EC****</RequestId>
</OnsMessagePushResponse>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B8EDC90D-F726-4B9E-8BEF-F0DD25EC****"
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.