ResetThing - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Lorsqu'un appareil connecté directement a obtenu ses informations de certificat (ProductKey, DeviceName et DeviceSecret) via l'enregistrement dynamique et qu'il est activé, appelez cette opération pour réinitialiser son statut d'enregistrement dynamique à « non enregistré ». L'appareil peut alors utiliser à nouveau l'enregistrement dynamique pour obtenir de nouvelles informations de certificat.

Remarque
Cette opération réinitialise uniquement le statut d'enregistrement dynamique, et non le statut d'activation. Le statut de l'appareil dans la console IoT Platform n'est pas réinitialisé à « inactif ».
Si une passerelle compte plus de 2 000 sous-appareils, cette opération crée une tâche d'appareil pour supprimer les relations topologiques de manière asynchrone et renvoie le paramètre JobId.

Appelez l'opération

QueryJob

pour consulter les résultats d'exécution de la tâche.

Limites QPS

Chaque compte Alibaba Cloud peut effectuer jusqu'à 500 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ResetThing	Opération à effectuer. Définissez la valeur sur ResetThing.
IotInstanceId	String	No	iot-cn-0pp1n8t****	ID de l'instance. Vous pouvez afficher l'ID sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier pour ce paramètre. Sinon, l'appel échouera. Si aucune page Overview ni aucun ID n'est généré pour votre instance, vous n'avez pas besoin de spécifier ce paramètre. Pour plus d'informations, consultez Présentation des instances.
ProductKey	String	No	a1KiV******	ProductKey du produit auquel l'appareil appartient. Remarque Si vous spécifiez une valeur pour ce paramètre, vous devez également spécifier une valeur pour le paramètre DeviceName.
DeviceName	String	No	device1	DeviceName de l'appareil. Remarque Si vous spécifiez une valeur pour ce paramètre, vous devez également spécifier une valeur pour le paramètre ProductKey.
IotId	String	No	SR8FiTu1R9tlUR2V1bmi0010a5****	ID de l'appareil. Remarque Si vous spécifiez ce paramètre, vous n'avez pas besoin de spécifier ProductKey ni DeviceName. IotId est un identifiant global unique (GUID) pour l'appareil, correspondant à une combinaison de ProductKey et de DeviceName. Si vous spécifiez IotId ainsi que ProductKey et DeviceName, IotId est prioritaire.

En plus des paramètres de requête spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lors de l'appel à cette opération. Pour plus d'informations, consultez les Paramètres de requête 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 les Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
JobId	String	450407b***	ID de la tâche d'appareil.
RequestId	String	57b144cf-09fc-4916-a272-a62902d5b207	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é.

Exemples

Exemples de requêtes

https://iot.cn-shanghai.aliyuncs.com/?Action=ResetThing
&IotId=MpEKNuEUJzIORNANAWJX0010929900*****
&<Common request parameters>

Exemples de réponses réussies

Format XML

<ResetThingResponse>
      <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
      <Success>true</Success>
</ResetThingResponse>

Format JSON

{
  "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
  "Success": true
}

Codes d'erreur

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