OnsTopicSubDetail - - Centre de documentation Alibaba Cloud

Renvoie la liste des groupes de consommateurs en ligne abonnés à un topic donné.

Remarque

Appelez cette opération pour obtenir la liste des groupes de consommateurs en ligne abonnés à un topic donné. Si tous les consommateurs d'un groupe sont hors ligne, les informations relatives à ce groupe ne sont pas renvoyées.

Limites des requêtes

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Toute requête excédant cette limite par seconde échoue, ce qui risque d'interrompre votre activité. Pour connaître les limites applicables à chaque opération, consultez la page Limites des requêtes API.

Autorisation

Les comptes Alibaba Cloud peuvent appeler cette opération par défaut. Les utilisateurs RAM (Resource Access Management) doivent disposer des autorisations nécessaires. Le tableau ci-dessous détaille les autorisations requises pour appeler cette opération. Pour savoir comment attribuer ces autorisations, consultez la page Politiques.

API

Action

Ressource dans une instance utilisant un namespace

Ressource dans une instance n'utilisant pas de namespace

OnsTopicSubDetail

mq:QueryInstanceBaseInfo

mq:QueryTopicSubDetail

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

acs:mq:*:*:{topic}

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	OnsTopicSubDetail	Nom de l'opération à appeler. Définissez la valeur sur OnsTopicSubDetail.
InstanceId	String	Oui	MQ_INST_111111111111_DOxxxxxx	ID de l'instance Message Queue for Apache RocketMQ contenant le topic à interroger.
Topic	String	Oui	test	Nom du topic à interroger.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	87B6207F-2908-42B5-A134-84956DCA****	ID de la requête. Le système génère un ID unique pour chaque requête, utile pour le dépannage.
Data	Object		Données renvoyées.
SubscriptionDataList	Array of SubscriptionDataList		Informations sur les groupes de consommateurs en ligne abonnés au topic.
SubscriptionDataList
GroupId	String	GID_test	ID du groupe de consommateurs.
MessageModel	String	CLUSTERING	Mode de consommation. Valeurs possibles : CLUSTERING : mode clustering BROADCASTING : mode broadcasting Pour en savoir plus sur les modes de consommation, consultez la page Consommation en cluster et consommation par diffusion.
SubString	String	*	Expression définissant l'abonnement des consommateurs du groupe au topic.
Topic	String	test	Nom du topic.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format 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****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.

Consulter les groupes de consommateurs abonnés à un topic dans la console

Dans la console Message Queue for Apache RocketMQ, consultez les informations relatives aux groupes de consommateurs en ligne abonnés à un topic. Pour plus d'informations, voir Consulter les abonnements.