DisableThing - IoT Platform - Centro de documentación de Alibaba Cloud

Deshabilita un dispositivo específico en IoT Platform.

Límites

Cuando se deshabilita un dispositivo, este no puede conectarse a IoT Platform. Aun así, es posible ejecutar operaciones específicas sobre él y su información se conserva. Para volver a habilitarlo, llame a la operación EnableThing.
Cada cuenta de Alibaba Cloud puede enviar un máximo de 500 consultas por segundo (QPS).

Nota
Los usuarios de RAM comparten la cuota de la cuenta de Alibaba Cloud.

Depuración

Alibaba Cloud proporciona OpenAPI Explorer para simplificar el uso de las API. OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera de forma dinámica el código de ejemplo correspondiente a distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DisableThing	Operación que desea ejecutar. Establezca el valor en `DisableThing`.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	ID de la instancia. Consulte el ID de la instancia en la página Descripción general de la consola de IoT Platform. Importante Si la instancia tiene un ID, este parámetro es obligatorio. De lo contrario, la llamada falla. Si la instancia no tiene una página Descripción general ni un ID, no es necesario especificar este parámetro. Para obtener más información, consulte Descripción general.
ProductKey	String	No	a1BwAGV****	ProductKey del producto al que pertenece el dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro DeviceName.
DeviceName	String	No	light	DeviceName del dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro ProductKey.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID del dispositivo. Es un identificador único que IoT Platform asigna al dispositivo. Nota Si especifica este parámetro, no es necesario indicar ProductKey ni DeviceName. IotId funciona como un identificador único global (GUID) del dispositivo y equivale a la combinación de ProductKey y DeviceName. Si indica tanto IotId como la combinación de ProductKey y DeviceName, IotId tiene prioridad.

Además de los parámetros específicos de esta operación, debe especificar los parámetros de solicitud comunes al llamarla. Para obtener más información, consulte Parámetros de solicitud comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.system.SystemException	Código de error. Para obtener más información, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	Mensaje de error.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la solicitud.
Success	Boolean	true	Indica si la llamada se completó correctamente. true: la llamada se completó correctamente. false: la llamada finalizó con errores.

Ejemplos

Solicitudes de ejemplo

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

Respuestas de ejemplo exitosas

Formato XML

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

Formato JSON

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

Códigos de error

Para consultar la lista de códigos de error, visite el centro de errores de API.