OnsDLQMessageGetById - : Central de Documentação do Alibaba Cloud

Observações de uso

A consulta de mensagem dead-letter por ID usa correspondência exata. Obtenha o ID necessário para consultar a mensagem dead-letter chamando a operação de consulta em lote ou usando os dados retornados em SendResult após o envio. As informações consultadas incluem o momento de armazenamento, o corpo da mensagem e atributos como tag e chave.

Limite de QPS

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o volume de requisições por segundo ultrapassar o limite de consultas por segundo (QPS), o sistema aplicará limitação de taxa (throttling), o que pode interromper suas operações. Para mais detalhes, consulte Limites de QPS.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários do Resource Access Management (RAM) precisam das permissões necessárias para executar essa chamada. A tabela a seguir descreve as permissões exigidas. Para mais informações, consulte Políticas e exemplos.

API

Action

Resource in an instance that contains a namespace

Resource in an instance that does not contain a namespace

OnsDLQMessageGetById

mq:QueryInstanceBaseInfo

mq:QueryDLQMessage

acs:mq:::{instanceId}%{groupId}

acs:mq:::{groupId}

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsDLQMessageGetById	Operação a ser executada. Defina o valor como OnsDLQMessageGetById.
MsgId	String	Sim	0BC16699165C03B925DB8A404E2D****	ID da mensagem dead-letter a ser consultada.
GroupId	String	Sim	GID_test_group_id	ID do grupo de consumidores a ser consultado.
InstanceId	String	Sim	MQ_INST_111111111111_DOxxxxxx	ID da instância que contém a mensagem dead-letter a ser consultada.

Nota

Para mais informações sobre os parâmetros da requisição, consulte

Parâmetros comuns

e

Fazer requisições de API

.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	ID da requisição. Parâmetro comum com identificador exclusivo para cada requisição.
Data	Object		Resultados retornados.
StoreSize	Integer	407	Tamanho da mensagem dead-letter. Unidade: KB.
ReconsumeTimes	Integer	1	Número de tentativas do Message Queue for Apache RocketMQ para enviar a mensagem dead-letter aos consumidores.
StoreTimestamp	Long	1570761026708	Timestamp indicando quando o broker do Message Queue for Apache RocketMQ armazenou a mensagem dead-letter. Unidade: milissegundos.
InstanceId	String	MQ_INST_111111111111_DOxxxxxx	ID da instância.
MsgId	String	0BC16699165C03B925DB8A404E2D****	ID da mensagem dead-letter.
StoreHost	String	11.220.*.*:10911	Broker do Message Queue for Apache RocketMQ que armazena a mensagem dead-letter.
Topic	String	test-mq_topic	Tópico ao qual a mensagem dead-letter pertence.
PropertyList	Array of MessageProperty		Atributos da mensagem dead-letter.
MessageProperty
Value	String	TagA	Valor do atributo.
Name	String	TAGS	Nome do atributo. Valores válidos: TRACE_ON: indica se existe rastro da mensagem dead-letter. KEYS: indica a chave da mensagem dead-letter. TAGS: indica a tag associada à mensagem dead-letter. INSTANCE_ID: indica o ID da instância que contém a mensagem dead-letter. Para mais informações sobre termos do Message Queue for Apache RocketMQ, consulte Termos.
BornTimestamp	Long	1570761026630	Timestamp indicando quando a mensagem dead-letter foi gerada. Unidade: milissegundos.
BodyCRC	Integer	914112295	Valor CRC (verificação cíclica de redundância) do corpo da mensagem.
BornHost	String	42.120..:64646	Instância do produtor que gerou a mensagem dead-letter.

Exemplos

Exemplo de requisição

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsDLQMessageGetById
&GroupId=GID_test_group_id
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&MsgId=0BC16699165C03B925DB8A404E2D****
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<OnsDLQMessageGetByIdResponse>
<Data>
    <MsgId>1E0578FE110F18B4AAC235C0C8460BA2</MsgId>
    <InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
    <ReconsumeTimes>1</ReconsumeTimes>
    <BornHost>42.120.**.**:64646</BornHost>
    <BodyCRC>914112295</BodyCRC>
    <StoreHost>11.220.***.***:10911</StoreHost>
    <StoreTimestamp>1570761026708</StoreTimestamp>
    <BornTimestamp>1570761026630</BornTimestamp>
    <Topic>test-mq_topic</Topic>
    <StoreSize>407</StoreSize>
    <PropertyList>
        <MessageProperty>
            <Name>TRACE_ON</Name>
            <Value>true</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>RETRY_TOPIC</Name>
            <Value>MQ_INST_111111111111_DOxxxxxx%test-mq_topic</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>KEYS</Name>
            <Value>ORDERID_993</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>UNIQ_KEY</Name>
            <Value>1E0578FE110F18B4AAC235C0C84*****</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>WAIT</Name>
            <Value>false</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>TAGS</Name>
            <Value>TagA</Value>
        </MessageProperty>
        <MessageProperty>
            <Name>INSTANCE_ID</Name>
            <Value>MQ_INST_111111111111_DOxxxxxx</Value>
        </MessageProperty>
    </PropertyList>
</Data>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsDLQMessageGetByIdResponse>

Formato JSON

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

{
  "Data" : {
    "MsgId" : "0BC16699165C03B925DB8A404E2D****",
    "InstanceId" : "MQ_INST_111111111111_DOxxxxxx",
    "ReconsumeTimes" : 1,
    "BornHost" : "42.120.**.**:64646",
    "BodyCRC" : 914112295,
    "StoreHost" : "11.220.***.***:10911",
    "StoreTimestamp" : 1570761026708,
    "BornTimestamp" : 1570761026630,
    "Topic" : "test-mq_topic",
    "StoreSize" : 407,
    "PropertyList" : {
      "MessageProperty" : [ {
        "Name" : "TRACE_ON",
        "Value" : "true"
      }, {
        "Name" : "RETRY_TOPIC",
        "Value" : "MQ_INST_111111111111_DOxxxxxx%test-mq_topic"
      }, {
        "Name" : "KEYS",
        "Value" : "ORDERID_993"
      }, {
        "Name" : "UNIQ_KEY",
        "Value" : "1E0578FE110F18B4AAC235C0C84*****"
      }, {
        "Name" : "WAIT",
        "Value" : "false"
      }, {
        "Name" : "TAGS",
        "Value" : "TagA"
      }, {
        "Name" : "INSTANCE_ID",
        "Value" : "MQ_INST_111111111111_DOxxxxxx"
      } ]
    }
  },
  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.

Consultar informações de mensagem dead-letter pelo console

Além da operação OnsDLQMessageGetById, use o console do Message Queue for Apache RocketMQ para consultar informações de mensagens dead-letter. Para saber como realizar essa consulta no console, consulte Filas dead-letter.