Crie uma tarefa para consultar o rastreamento de uma mensagem com base no nome do tópico em que a mensagem está armazenada e no ID da mensagem. Esta operação retorna o ID da tarefa de consulta.
Observação
Para consultar o rastreamento de uma mensagem pelo ID da mensagem, chame esta operação para criar uma tarefa de consulta. Após obter o ID da tarefa, use a operação OnsTraceGetResult para consultar os detalhes do rastreamento da mensagem com base nesse ID.
Limite de solicitações
Cada conta Alibaba Cloud pode chamar esta operação até 30 vezes por minuto. Se o número de solicitações enviadas dentro de um minuto atingir o limite, as novas solicitações falharão, o que pode interromper seus serviços. Para mais informações sobre os limites de cada operação, consulte Limites de solicitação de API.
Autorização
Contas Alibaba Cloud têm permissão padrão para chamar esta operação. Usuários do Resource Access Management (RAM) precisam receber as permissões necessárias antes de executá-la. A tabela a seguir descreve as permissões obrigatórias para um usuário RAM chamar esta operação. Para saber como conceder permissões, consulte Políticas.
|
API |
Action |
Recurso em uma instância com namespace |
Recurso em uma instância sem namespace |
|
OnsTraceQueryByMsgId |
mq:QueryInstanceBaseInfo mq:QueryTrace |
acs:mq:::{instanceId}%{topic} |
acs:mq:::{topic} |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
OnsTraceQueryByMsgId |
A operação a ser executada. Defina o valor como OnsTraceQueryByMsgId. |
|
Topic |
String |
Sim |
test |
O tópico em que a mensagem a ser consultada está armazenada. |
|
MsgId |
String |
Sim |
1E05791C117818B4AAC23B1BB0CE**** |
O ID da mensagem a ser consultada. |
|
BeginTime |
Long |
Sim |
1570852800000 |
O início do intervalo de tempo da consulta. O valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). |
|
EndTime |
Long |
Sim |
1570968000000 |
O fim do intervalo de tempo da consulta. O valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). |
|
InstanceId |
String |
Sim |
MQ_INST_111111111111_DOxxxxxx |
O ID da instância do Message Queue for Apache RocketMQ que contém o tópico especificado. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
B93332A3-160D-404F-880F-1F8736D1**** |
O ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use esse identificador para solucionar problemas. |
|
QueryId |
String |
272967562652883649157096685**** |
O ID da tarefa de consulta. Use a operação OnsTraceGetResult para consultar os detalhes do rastreamento da mensagem com base neste ID. |
Exemplos
Exemplos de solicitações
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsTraceQueryByMsgId
&BeginTime=1570852800000
&EndTime=1570968000000
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&MsgId=1E05791C117818B4AAC23B1BB0CE****
&Topic=test
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsTraceQueryByMsgIdResponse>
<RequestId>B93332A3-160D-404F-880F-1F8736D1039F</RequestId>
<QueryId>272967562652883649157096685****</QueryId>
</OnsTraceQueryByMsgIdResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B93332A3-160D-404F-880F-1F8736D1039F",
"QueryId" : "272967562652883649157096685****"
}Códigos de erro
Para obter uma lista de códigos de erro, visite a Central de Erros de API.
Consultar o rastreamento de uma mensagem no console
No console do Message Queue for Apache RocketMQ, consulte o rastreamento de uma mensagem. Para mais informações, consulte Consultar uma mensagem.