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

Observação

Use esta operação para consultar os grupos de consumidores online que assinam um tópico específico. Se todos os consumidores de um grupo estiverem offline, o sistema não retornará as informações desse grupo.

Limite de solicitações

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o número de solicitações enviadas em um segundo atingir o limite, as novas solicitações falharão, o que pode interromper seus serviços. Para obter detalhes sobre os limites de solicitação de cada operação, consulte Limites de solicitação de API.

Autorização

Contas Alibaba Cloud têm permissão padrão para executar esta operação. Usuários do Resource Access Management (RAM) precisam receber as permissões necessárias antes de chamá-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.

API

Action

Recurso em uma instância com namespace

Recurso em uma instância sem namespace

OnsTopicSubDetail

mq:QueryInstanceBaseInfo

mq:QueryTopicSubDetail

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

acs:mq:::{topic}

Parâmetros de solicitação

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

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	87B6207F-2908-42B5-A134-84956DCA****	ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use esse identificador para solucionar problemas.
Data	Object		Dados retornados pela operação.
SubscriptionDataList	Array of SubscriptionDataList		Informações sobre os grupos de consumidores online que assinam o tópico.
SubscriptionDataList
GroupId	String	GID_test	ID do grupo de consumidores.
MessageModel	String	CLUSTERING	Modo de consumo. Valores válidos: CLUSTERING: modo de cluster BROADCASTING: modo de broadcast Para mais detalhes sobre os modos de consumo, consulte Consumo em cluster e consumo por broadcast.
SubString	String	*	Expressão usada pelos consumidores do grupo para assinar o tópico.
Topic	String	test	Nome do tópico.

Exemplos

Exemplos de solicitações

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsTopicSubDetail
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Topic=test
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<OnsTopicSubDetailResponse>
<Data>
    <Topic>test</Topic>
    <SubscriptionDataList>
        <SubscriptionDataList>
            <SubString>*</SubString>
            <MessageModel>CLUSTERING</MessageModel>
            <GroupId>GID_test</GroupId>
        </SubscriptionDataList>
    </SubscriptionDataList>
</Data>
<RequestId>87B6207F-2908-42B5-A134-84956DCA****</RequestId>
</OnsTopicSubDetailResponse>

Formato JSON

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

{
  "Data" : {
    "Topic" : "test",
    "SubscriptionDataList" : {
      "SubscriptionDataList" : [ {
        "SubString" : "*",
        "MessageModel" : "CLUSTERING",
        "GroupId" : "GID_test"
      } ]
    }
  },
  "RequestId" : "87B6207F-2908-42B5-A134-84956DCA****"
}

Códigos de erro

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

Visualize grupos de consumidores que assinam um tópico no console

No Message Queue for Apache RocketMQ console, visualize as informações dos grupos de consumidores online que assinam um tópico. Para mais detalhes, consulte Visualizar assinaturas.