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

Observações de uso

Um dispositivo pode ter no máximo 100 tags.
É possível modifique ou adicionar até 100 tags por vez.

Limites de QPS

Cada conta Alibaba Cloud pode execute até 50 consultas por segundo (QPS).

Nota

Os usuários do Resource Access Management (RAM) de uma conta Alibaba Cloud compartilham a cota dessa conta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	SaveDeviceProp	A operação a ser executada. Defina o valor como SaveDeviceProp.
Props	String	Sim	{"color":"red"}	A tag a ser defina para o dispositivo. É possível especifique várias tags. As tags devem ser dados JSON no formato Key:Value. Key indica o nome da tag e Value indica o valor da tag. Separe múltiplas tags com vírgulas (,). Exemplo: Props={"color":"red","shape":"round"} Importante O tamanho máximo do parâmetro Props é de 5 KB. `abc` é uma chave reservada pelo IoT Platform. Não defina Key como abc. Se você defina `Key` como abc, a tag abc será filtrada automaticamente durante a consulta de tags.
IotInstanceId	String	Não	iot_instc_pu***_c-v64********	O ID da instância. Na página Overview do console IoT Platform, visualize o ID da instância. Importante Se sua instância tiver um ID, especifique-o neste parâmetro. Caso contrário, a chamada falhará. Se a página Overview ou o ID da instância não estiverem visíveis no console IoT Platform, não configure este parâmetro. Para mais informações sobre a instância, consulte Visão geral.
ProductKey	String	Não	a1BwAGV****	O ProductKey do produto ao qual o dispositivo pertence. Nota Se você especifique este parâmetro, também deverá especifique o parâmetro DeviceName.
DeviceName	String	Não	light	O DeviceName do dispositivo. Nota Se você especifique este parâmetro, também deverá especifique o parâmetro ProductKey.
IotId	String	Não	Q7uOhVRdZRRlDnTLv****00100	O ID do dispositivo. Trata-se de um identificador exclusivo emitido pelo IoT Platform para o dispositivo. Nota Se você especifique este parâmetro, não precisará informar os parâmetros ProductKey ou DeviceName. O parâmetro IotId defina um identificador globalmente exclusivo (GUID) para o dispositivo. O valor do parâmetro IotId corresponde à combinação dos valores dos parâmetros ProductKey e DeviceName. Se os parâmetros IotId, ProductKey e DeviceName forem especifique simultaneamente, o valor de IotId terá precedência.

Além dos parâmetros específicos da operação listados acima, especifique os parâmetros comuns de solicitação ao chamar esta operação. Para mais detalhes sobre os parâmetros comuns, consulte Parâmetros comuns.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=SaveDeviceProp
&ProductKey=a1BwAGV****
&DeviceName=device1
&Props=%7B%22color%22%3A%22red%22%7D
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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 API Error Center.