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

Observações de uso

Use esta operação para obter informações sobre a utilização de recursos de um tópico. Os dados retornados incluem o número total de mensagens no tópico e o timestamp da publicação mais recente.

Limite de requisições

Cada conta Alibaba Cloud pode chamar esta operação até uma vez por segundo. Se o volume de requisições enviadas dentro de um segundo atingir esse limite, as novas requisições falharão, o que pode interromper seus serviços. Para detalhes sobre os limites de cada operação, consulte Limites de taxa de API.

Autorização

Por padrão, apenas contas Alibaba Cloud têm permissã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 usuários RAM. Para saber como conceder essas permissões, consulte Políticas e exemplos.

API

Action

Recurso em uma instância com namespace

Recurso em uma instância sem namespace

OnsTopicStatus

mq:QueryInstanceBaseInfo

mq:QueryTopicStatus

acs:mq:::{instanceId}%{topic}

acs:mq:::{topic}

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsTopicStatus	Operação a ser executada. Defina o valor como OnsTopicStatus.
Topic	String	Sim	test	Nome do tópico a ser consultado.
InstanceId	String	Sim	MQ_INST_188077086902****_BXSuW61e	ID da instância do Message Queue for Apache RocketMQ que contém o tópico.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	427EE49D-D762-41FB-8F3D-9BAC96C3****	ID da requisição. O sistema gera um ID exclusivo para cada requisição. Use esse identificador para solucionar problemas.
Data	Object		Dados retornados pela operação.
Perm	Integer	6	Indica as operações permitidas no tópico. Valores válidos: 2: Permite publicar mensagens no tópico. 4: Permite inscrever-se no tópico. 6: Permite publicar mensagens e inscrever-se no tópico.
LastTimeStamp	Long	1570864984364	Momento mais recente de publicação de uma mensagem no tópico.
TotalCount	Long	2310	Número total de mensagens em todas as partições do tópico.

Exemplos

Exemplos de requisição

http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=OnsTopicStatus
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&Topic=test
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<OnsTopicStatusResponse>
<Data>
    <Perm>6</Perm>
    <TotalCount>2310</TotalCount>
    <LastTimeStamp>1570864984364</LastTimeStamp>
</Data>
<RequestId>427EE49D-D762-41FB-8F3D-9BAC96C3****</RequestId>
</OnsTopicStatusResponse>

Formato JSON

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

{
  "Data" : {
    "Perm" : 6,
    "TotalCount" : 2310,
    "LastTimeStamp" : 1570864984364
  },
  "RequestId" : "427EE49D-D762-41FB-8F3D-9BAC96C3****"
}

Códigos de erro

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