QueryMqttTraceMessagePublish - - Centre de documentation Alibaba Cloud

Interroge les traces d'envoi d'un message spécifié. Si un message n'est pas envoyé ni reçu comme prévu, appelez cette opération pour afficher ses détails, tels que l'heure de publication et le client émetteur. Cette opération vous aide à localiser le problème et à en identifier la cause.

Facturation

Chaque appel réussi à l'opération QueryMqttTraceMessagePublish augmente le nombre de transactions de messagerie par seconde (TPS) d'une unité. Cet appel est donc facturé. Pour plus d'informations sur la facturation, consultez la rubrique Facturation.

Limite QPS

La limite de requêtes par seconde (QPS) pour cette opération est de 500 par utilisateur. Le système déclenche une limitation du débit si le nombre d'appels dépasse cette limite, ce qui peut affecter votre activité. Appelez cette opération selon vos besoins. Pour plus d'informations, consultez la rubrique Limites QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryMqttTraceMessagePublish	Opération à effectuer. Définissez la valeur sur QueryMqttTraceMessagePublish.
MqttRegionId	String	Oui	cn-hangzhou	ID de région de l'instance ApsaraMQ for MQTT. Pour plus d'informations, consultez la rubrique Endpoints.
InstanceId	String	Oui	mqtt-cn-i7m26mf****	ID de l'instance ApsaraMQ for MQTT. La valeur doit correspondre à l'ID d'instance utilisé par le client ApsaraMQ for MQTT. Vous pouvez consulter l'ID d'instance dans la section Basic Information de la page Instance Details de l'instance, dans la console ApsaraMQ for MQTT.
BeginTime	Long	Oui	1618646400000	Début de la plage de temps à interroger. Cette valeur correspond à un horodatage UNIX (nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC). Unité : millisecondes.
EndTime	Long	Oui	1621591200000	Fin de la plage de temps à interroger. Cette valeur correspond à un horodatage UNIX (nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC). Unité : millisecondes.
MsgId	String	Oui	AC1EC0030EAB78308DB16A3EC773****	ID du message.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	69AD5550-BF22-438A-9202-A6E89185****	ID de la requête. Ce paramètre commun attribue un identifiant unique à chaque requête, facilitant ainsi le dépannage et la localisation des problèmes.
MessageTraceLists	Array of MessageTraceLists		Traces du message interrogé.
Action	String	pub_mqtt	Action effectuée sur le message. Valeurs possibles : pub_mqtt : un client ApsaraMQ for MQTT a envoyé le message. pub_mq : un client Message Queue for Apache RocketMQ a envoyé le message.
ActionCode	String	mqtt.trace.action.msg.pub.mqtt	Code renvoyé pour l'action sur le message. Valeurs possibles : mqtt.trace.action.msg.pub.mqtt : renvoyé si la valeur du paramètre Action est pub_mqtt. mqtt.trace.action.msg.pub.mq : renvoyé si la valeur du paramètre Action est pub_mq.
ActionInfo	String	Pub From Mqtt Client	Informations renvoyées pour l'action sur le message. Valeurs possibles : Pub From Mqtt Client : renvoyé si la valeur du paramètre Action est pub_mqtt. Pub From MQ : renvoyé si la valeur du paramètre Action est pub_mq.
ClientId	String	GID_test@@@producer	ID du client ayant envoyé le message.
MsgId	String	AC1EC0030EAB78308DB16A3EC773BD95	ID du message.
Time	String	2021-05-21 15:08:19.210	Heure d'envoi du message.

Exemples

Exemple de requête

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=QueryMqttTraceMessagePublish
&MqttRegionId=cn-hangzhou
&InstanceId=mqtt-cn-i7m26mf****
&BeginTime=1618646400000
&EndTime=1621591200000
&MsgId=AC1EC0030EAB78308DB16A3EC773****
&<Common request parameters>

Exemple de réponse réussie

Format XML

<QueryMqttTraceMessagePublishResponse>
    <MessageTraceLists>
        <Action>pub_mqtt</Action>
        <ActionCode>mqtt.trace.action.msg.pub.mqtt</ActionCode>
        <ClientId>GID_test@@@producer</ClientId>
        <Time>2021-05-21 15:08:19.210</Time>
        <ActionInfo>Pub From Mqtt Client</ActionInfo>
        <MsgId>AC1EC0030EAB78308DB16A3EC773****</MsgId>
    </MessageTraceLists>
    <RequestId>69AD5550-BF22-438A-9202-A6E89185****</RequestId>
</QueryMqttTraceMessagePublishResponse>

Format JSON

{   
        "MessageTraceLists": {
            "Action": "pub_mqtt",
            "ActionCode": "mqtt.trace.action.msg.pub.mqtt",
            "ClientId": "GID_test@@@producer",
            "Time": "2021-05-21 15:08:19.210",
            "ActionInfo": "Pub From Mqtt Client",
            "MsgId": "AC1EC0030EAB78308DB16A3EC773****"
        },
        "RequestId": "69AD5550-BF22-438A-9202-A6E89185****"
}

Codes d'erreur

Code HTTP	Code d'erreur	Message d'erreur	Description
404	ApiNotSupport	The specified API operation is not supported.	L'opération API n'est pas prise en charge.
500	SystemOverFlow	An error occurred while processing your request. Please try again.	Le système a déclenché une limitation du débit. Réessayez ultérieurement.

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

Opérations dans la console ApsaraMQ for MQTT

Outre l'appel à l'opération QueryMqttTraceMessagePublish, vous pouvez également consulter les traces d'envoi d'un message dans la console ApsaraMQ for MQTT. Pour plus d'informations, consultez la rubrique Interroger les traces des messages.