Renvoie le nombre total de messages d’un topic et l’horodatage de la dernière publication dans ce topic.
Notes d'utilisation
Utilisez les données renvoyées par cette opération pour évaluer l’utilisation des ressources d’un topic. Vous obtenez ainsi le nombre total de messages présents dans le topic et l’horodatage de la dernière publication.
Limites des requêtes
Chaque compte Alibaba Cloud est limité à un appel par seconde. Au-delà de cette limite, les nouvelles requêtes échouent, ce qui peut perturber vos activités. Pour connaître les limites de débit de chaque opération, consultez la page Limites de débit des API.
Autorisation
Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur Resource Access Management (RAM) doit disposer des autorisations nécessaires. Le tableau ci-dessous liste les permissions à attribuer à un utilisateur RAM. Pour savoir comment accorder ces autorisations, consultez la page Politiques et exemples.
|
API |
Action |
Ressource dans une instance utilisant un namespace |
Ressource dans une instance n'utilisant pas de namespace |
|
OnsTopicStatus |
mq:QueryInstanceBaseInfo mq:QueryTopicStatus |
acs:mq:::{instanceId}%{topic} |
acs:mq:::{topic} |
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
Action |
String |
Oui |
OnsTopicStatus |
Nom de l’opération à effectuer. Définissez la valeur sur OnsTopicStatus. |
|
Topic |
String |
Oui |
test |
Nom du topic à interroger. |
|
InstanceId |
String |
Oui |
MQ_INST_188077086902****_BXSuW61e |
ID de l’instance Message Queue for Apache RocketMQ contenant le topic. |
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| RequestId | String | 427EE49D-D762-41FB-8F3D-9BAC96C3**** | ID de la requête. Le système génère un identifiant unique pour chaque requête, utile pour le dépannage. |
| Data | Object | Données renvoyées. |
|
| Perm | Integer | 6 | Opérations autorisées sur le topic. Valeurs possibles :
|
| LastTimeStamp | Long | 1570864984364 | Horodatage de la dernière publication dans le topic. |
| TotalCount | Long | 2310 | Nombre total de messages dans toutes les partitions du topic. |
Exemples
Exemple de requête
http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=OnsTopicStatus
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&Topic=test
&<Common request parameters>Exemple de réponse réussie
Format 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>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : {
"Perm" : 6,
"TotalCount" : 2310,
"LastTimeStamp" : 1570864984364
},
"RequestId" : "427EE49D-D762-41FB-8F3D-9BAC96C3****"
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.