DisableThing - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Une fois désactivé, l'appareil ne peut plus se connecter à IoT Platform. Vous pouvez toujours effectuer des opérations spécifiques à l'appareil et ses informations sont conservées. Pour réactiver l'appareil, appelez l'opération EnableThing .
Chaque compte Alibaba Cloud est limité à 500 requêtes par seconde (QPS).

Remarque
Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

Débogage

Alibaba Cloud met à disposition OpenAPI Explorer pour simplifier l'utilisation des API. Cet outil calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer. Celui-ci 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	DisableThing	Opération à effectuer. Définissez la valeur sur `DisableThing`.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	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, ce paramètre est obligatoire. Sinon, l'appel échoue. Si votre instance ne dispose pas de page Overview ou d'ID, ne définissez pas ce paramètre. Pour plus d'informations, consultez Overview.
ProductKey	String	No	a1BwAGV****	ProductKey du produit auquel l'appareil appartient. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceName	String	No	light	DeviceName de l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ProductKey.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID de l'appareil, identifiant unique attribué par IoT Platform. Remarque Si vous spécifiez ce paramètre, inutile de spécifier ProductKey ni DeviceName. IotId est un identifiant global unique (GUID) pour l'appareil, correspondant à la combinaison de ProductKey et de DeviceName. Si vous spécifiez à la fois IotId et la combinaison de ProductKey et de DeviceName, IotId est prioritaire.

Outre les 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. Pour plus d'informations, consultez Paramètres de requête communs .

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur. Pour plus d'informations, consultez Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=DisableThing
&ProductKey=a1rYuVF****
&DeviceName=device1
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

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

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 de l'API .