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

Observação

Use esta operação para consultar informações sobre os tópicos aos quais os consumidores de um grupo estão inscritos. Se todos os consumidores do grupo especificado estiverem offline, nenhum tópico será retornado.

Limite de solicitações

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

Autorização

Por padrão, contas Alibaba Cloud podem chamar esta operação. Usuários do Resource Access Management (RAM) só podem executá-la após receberem as permissões necessárias. 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

OnsGroupSubDetail

mq:QueryInstanceBaseInfo

mq:QueryGroupSubDetail

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

acs:mq:::{groupId}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsGroupSubDetail	Operação a ser executada. Defina o valor como OnsGroupSubDetail.
InstanceId	String	Sim	MQ_INST_111111111111_DOxxxxxx	ID da instância do Message Queue for Apache RocketMQ que contém o grupo de consumidores a ser consultado.
GroupId	String	Sim	GID_test_group_id	ID do grupo de consumidores a ser consultado.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	3364E875-013B-442A-BC3C-C1A84DC6****	ID da solicitação. O sistema gera um ID único para cada requisição. Use este ID para solucionar problemas.
Data	Object		Dados retornados.
SubscriptionDataList	Array of SubscriptionDataList		Tópicos aos quais os consumidores do grupo estão inscritos. Se todos os consumidores do grupo especificado estiverem offline, nenhum tópico será retornado.
SubscriptionDataList
SubString	String	*	Expressão usada pelos consumidores do grupo para se inscreverem no tópico.
Topic	String	test-mq_topic	Nome do tópico ao qual os consumidores do grupo estão inscritos.
GroupId	String	GID_test_group_id	ID do grupo de consumidores.
MessageModel	String	CLUSTERING	Modo de consumo. Valores válidos: CLUSTERING: modo de cluster BROADCASTING: modo de broadcast Para obter mais informações sobre modos de consumo, consulte Consumo em cluster e consumo por broadcast.
Online	Boolean	true	Indica se os consumidores do grupo estão online.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta de sucesso

Formato XML

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

<OnsGroupSubDetailResponse>
<Data>
    <MessageModel>CLUSTERING</MessageModel>
    <Online>true</Online>
    <SubscriptionDataList>
        <SubscriptionDataList>
            <SubString>*</SubString>
            <Topic>test-mq_topic</Topic>
        </SubscriptionDataList>
    </SubscriptionDataList>
    <GroupId>GID_test_group_id</GroupId>
</Data>
<RequestId>3364E875-013B-442A-BC3C-C1A84DC6****</RequestId>
</OnsGroupSubDetailResponse>

Formato JSON

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

{
  "Data" : {
    "MessageModel" : "CLUSTERING",
    "Online" : true,
    "SubscriptionDataList" : {
      "SubscriptionDataList" : [ {
        "SubString" : "*",
        "Topic" : "test-mq_topic"
      } ]
    },
    "GroupId" : "GID_test_group_id"
  },
  "RequestId" : "3364E875-013B-442A-BC3C-C1A84DC6****"
}

Códigos de erro

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

Visualize os tópicos aos quais um grupo de consumidores está inscrito no console

No Message Queue for Apache RocketMQ console, visualize os tópicos aos quais os consumidores de um grupo estão inscritos. Para obter mais informações, consulte Visualizar inscrições.