QueryDeviceSubTopic - IoT Platform - Centre de documentation Alibaba Cloud

Limites QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte Alibaba Cloud.

Remarque

Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceSubTopic	L'opération à effectuer. Définissez la valeur sur QueryDeviceSubTopic.
ProductKey	String	Yes	hf768****	Clé ProductKey du produit auquel l'appareil appartient. Consultez la liste des produits de votre compte Alibaba Cloud dans la console IoT Platform ou appelez l'opération QueryProductList.
DeviceName	String	Yes	device1	Nom de l'appareil. Consultez les informations sur l'appareil dans la console IoT Platform ou appelez l'opération QueryDeviceInfo.
IotInstanceId	String	No	iot-cn-0pp1n8t****	ID de l'instance. Vous trouverez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez spécifier ce paramètre, sinon l'appel échouera. Si la page Overview ou l'ID de l'instance n'apparaît pas dans la console IoT Platform, ignorez ce paramètre. Pour plus d'informations, consultez la rubrique Overview.

Outre les paramètres de requête spécifiques à l'opération, vous devez inclure les paramètres de requête communs lors de l'appel. Pour plus d'informations, consultez la rubrique Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la rubrique Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.
TopicList	Array of topic		Sujets auxquels l'appareil est abonné. Ce champ n'est renvoyé qu'en cas de succès de l'appel.
Timestamp	Long	1662039965873	Date et heure de l'abonnement de l'appareil au sujet. Unité : millisecondes.
TopicName	String	/hf768****/device1/user/test	Nom du sujet.

Exemples

Exemple de requête

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceSubTopic
&ProductKey=hf768****
&DeviceName=device1
&<Common request parameters>

Exemple de réponse réussie

XML format

<QueryDeviceSubTopicResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <TopicList>
        <Timestamp>1662039965873</Timestamp>
        <TopicName>/hf768****/device1/user/test</TopicName>
  </TopicList>
  <TopicList>
        <Timestamp>1662039965873</Timestamp>
        <TopicName>/hf768****/device1/user/down</TopicName>
  </TopicList>
  <Success>true</Success>
</QueryDeviceSubTopicResponse>

JSON format

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "TopicList": [
    {
        "Timestamp": 1662039965873,
        "TopicName": "/hf768****/device1/user/test"
    },
    {
        "Timestamp": 1662039965873,
        "TopicName": "/hf768****/device1/user/down"
    }
    ],
    "Success": true
}

Codes d'erreur

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