SetDevicesProperty - IoT Platform - Centre de documentation Alibaba Cloud

Définit simultanément les valeurs de plusieurs propriétés d'appareil.

Remarques sur l'utilisation

Si les données TSL sont de type float ou double, les valeurs de paramètre correspondantes doivent comporter au moins une décimale. Exemples : 10,0 et 11,1.

Limites de QPS

Vous pouvez appeler cette opération d'API jusqu'à 10 fois par seconde par compte.

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SetDevicesProperty	L'opération à effectuer. Définissez la valeur sur SetDevicesProperty.
DeviceName.N	RepeatList	Yes	light	Les noms des appareils dont vous souhaitez configurer les propriétés. Valeurs possibles : 1 à 100.
Items	String	Yes	{"Switch":1,"Color":"blue"}	Les propriétés à configurer. Elles doivent être au format JSON. Chaque propriété se compose d'un identifiant et d'une valeur au format clé:valeur. Séparez les propriétés par des virgules (,). Par exemple, configurez les propriétés suivantes pour une lampe intelligente : Une propriété de commutateur dont la clé est Switch et le type de données est BOOLEAN. La valeur est 1. La valeur 1 indique que la lumière est allumée. Une propriété de couleur dont la clé est Color et le type de données est STRING. La valeur est blue. Dans ce cas, configurez les propriétés suivantes au format JSON : `Items={"Switch":1,"Color":"blue"}` Remarque Si vous configurez des propriétés pour le module personnalisé testFb, spécifiez `Items={"testFb:Switch":1,"testFb:Color":"blue"}`. Le module testFb n'est pas le module par défaut.
ProductKey	String	Yes	a1BwAGV****	La ProductKey du produit auquel l'appareil appartient.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID de l'instance. Consultez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier pour ce paramètre. Sinon, l'appel échoue. Si aucune page Overview ni aucun ID n'a été généré pour votre instance, ne configurez pas ce paramètre. Pour plus d'informations, consultez Vue d'ensemble.
Qos	Integer	No	1	Le niveau de qualité de service (QoS) du message. Valeurs possibles : 0 (par défaut) : Le système envoie le message au plus une fois. 1 : Le système envoie le message au moins une fois. Si aucune réponse PUBACK n'est renvoyée après la publication d'un message QoS 1, le message est renvoyé à l'appareil lors de sa reconnexion à IoT Platform.

Outre les paramètres de requête spécifiques à l'opération, vous devez configurer les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

XML format

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

JSON format

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.