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

Define valores para várias propriedades de dispositivo simultaneamente.

Observações de uso

Se os dados do TSL forem do tipo float ou double, os valores dos parâmetros correspondentes deverão conter pelo menos uma casa decimal. Exemplos: 10,0 e 11,1.

Limites de QPS

É possível chamar esta API até 10 vezes por segundo por conta.

Nota

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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para facilitar o processo. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SetDevicesProperty	Operação a ser executada. Defina o valor como SetDevicesProperty.
DeviceName.N	RepeatList	Sim	light	Nomes dos dispositivos cujas propriedades serão configuradas. Valores válidos: 1 a 100.
Items	String	Sim	{"Switch":1,"Color":"blue"}	Propriedades a configurar. Devem estar no formato JSON. Cada propriedade consiste em um identificador e um valor no formato chave:valor. Separe múltiplas propriedades com vírgulas (,). Por exemplo, configure as seguintes propriedades para uma lâmpada inteligente: Propriedade de interruptor com chave Switch e tipo de dados BOOLEAN. Valor: 1. O valor 1 indica que a luz está ligada. Propriedade de cor com chave Color e tipo de dados STRING. Valor: blue. Nesse caso, configure as seguintes propriedades no formato JSON: `Items={"Switch":1,"Color":"blue"}` Nota Para configurar propriedades do módulo personalizado testFb, especifique `Items={"testFb:Switch":1,"testFb:Color":"blue"}`. O módulo testFb não é o padrão.
ProductKey	String	Sim	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence.
IotInstanceId	String	Não	iot_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, especifique-o neste parâmetro. Caso contrário, a chamada falhará. Se não houver página Overview ou ID gerado para a instância, não configure este parâmetro. Para mais informações, consulte Visão geral.
Qos	Integer	Não	1	Nível de qualidade de serviço (QoS) da mensagem. Valores válidos: 0 (padrão): O sistema envia a mensagem no máximo uma vez. 1: O sistema envia a mensagem pelo menos uma vez. Se nenhuma resposta PUBACK for retornada após publicar uma mensagem QoS 1, o sistema reenviará a mensagem ao dispositivo quando ele se reconectar ao IoT Platform.

Além dos parâmetros específicos da operação listados acima, configure também os parâmetros comuns da solicitação. Para mais informações sobre parâmetros comuns, consulte Parâmetros comuns.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=SetDevicesProperty
&DeviceName.1=1102andriod02
&DeviceName.2=1102android01
&Items=%7B%20%20%20%20%20%22Data%22%3A%221372060916%22%2C%20%20%20%20%20%22Status%22%3A1%20%7D
&ProductKey=a1hWjHD****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<SetDevicesPropertyResponse>
  <RequestId>2E19BDAF-0FD0-4608-9F41-82D230CFEE38</RequestId>
  <Success>true</Success>
</SetDevicesPropertyResponse>

Formato JSON

{
  "RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
  "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.