DisableThing - IoT Platform: Central de Documentação do Alibaba Cloud

Limites

Após a desativação, o dispositivo não consegue se conectar ao IoT Platform. As operações específicas do dispositivo permanecem disponíveis e as informações dele são mantidas. Para reativá-lo, chame a operação EnableThing.
Cada conta Alibaba Cloud aceita no máximo 500 consultas por segundo (QPS).

Nota
Usuários RAM compartilham a cota da conta Alibaba Cloud.

Depuração

O Alibaba Cloud oferece o OpenAPI Explorer para simplificar o uso de APIs. O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos utilizar essa ferramenta para chamar a operação. Ela também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DisableThing	Operação a ser executada. Defina o valor como `DisableThing`.
IotInstanceId	String	Não	iot_instc_pu***_c-v64********	ID da instância. Consulte o ID da instância na página Overview do console IoT Platform. Importante Este parâmetro é obrigatório se a instância possuir um ID. Caso contrário, a chamada falhará. Se a instância não tiver uma página Overview ou ID, não é necessário definir este parâmetro. Para mais informações, consulte Visão geral.
ProductKey	String	Não	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence. Nota Ao especificar este parâmetro, especifique também o parâmetro DeviceName.
DeviceName	String	Não	light	DeviceName do dispositivo. Nota Ao especificar este parâmetro, especifique também o parâmetro ProductKey.
IotId	String	Não	Q7uOhVRdZRRlDnTLv****00100	ID do dispositivo, um identificador exclusivo emitido pelo IoT Platform. Nota Se você especificar este parâmetro, não será necessário informar ProductKey ou DeviceName. O IotId funciona como um identificador globalmente exclusivo (GUID) para o dispositivo, correspondendo à combinação de ProductKey e DeviceName. Caso sejam fornecidos tanto o IotId quanto a combinação de ProductKey e DeviceName, o IotId terá precedência.

Além dos parâmetros específicos desta operação, especifique os parâmetros comuns de solicitação na chamada. Para mais informações, consulte Parâmetros comuns de solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.system.SystemException	Código de erro. Para mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada teve sucesso. false: A chamada falhou.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta de sucesso

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 erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.