Todos os produtos
Search
Central de documentação

IoT Platform:EnableThing

Última atualização: Jun 26, 2026

Ativa um dispositivo desativado.

Limites

Cada conta Alibaba Cloud tem limite de 500 consultas por segundo (QPS).

Nota

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

Depuração

A Alibaba Cloud oferece o OpenAPI Explorer para simplificar o uso da API. O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimEnableThing

Operação a ser executada. Defina o valor como EnableThing.

IotInstanceIdStringNãoiot_instc_pu****_c*-v64********

ID da instância. Visualize o ID da instância na página Overview do console IoT Platform.

Importante
  • Se a instância tiver um ID, configure este parâmetro. Caso contrário, a chamada falhará.
  • Se a instância não tiver página Overview ou ID, não é necessário definir este parâmetro.

Para mais informações, consulte Visão geral.

ProductKeyStringNãoa1BwAGV****

ProductKey do produto ao qual o dispositivo pertence.

Nota Ao especificar este parâmetro, especifique também o parâmetro DeviceName.
DeviceNameStringNãolight

DeviceName do dispositivo.

Nota Ao especificar este parâmetro, especifique também o parâmetro ProductKey.
IotIdStringNãoQ7uOhVRdZRRlDnTLv****00100

ID do dispositivo. Identificador exclusivo emitido pelo IoT Platform.

Nota Ao fornecer este parâmetro, não é necessário informar ProductKey ou DeviceName. Como GUID do dispositivo, IotId corresponde à combinação de ProductKey e DeviceName. Se você especificar IotId e a combinação de ProductKey e DeviceName, IotId terá precedência.

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

Parâmetros de resposta

ParâmetroTipoExemploDescrição
CodeStringiot.system.SystemException

Código de erro retornado em caso de falha na chamada. Para mais informações, consulte Códigos de erro.

ErrorMessageStringA system exception occurred.

Mensagem de erro retornada em caso de falha na chamada.

RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

ID da solicitação.

SuccessBooleantrue

Indica se a chamada foi bem-sucedida.

  • true: Chamada bem-sucedida.
  • false: Falha na chamada.

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=EnableThing
&productKey=a1BwAGV****
&DeviceName=device1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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.