SaveDeviceProp - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Un appareil peut comporter au maximum 100 tags.
Vous pouvez modifier ou ajouter jusqu'à 100 tags à la fois.

Limites de QPS

Chaque compte Alibaba Cloud peut exécuter jusqu'à 50 requêtes par seconde (QPS).

Remarque

Les utilisateurs Resource Access Management (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	SaveDeviceProp	L'opération que vous souhaitez effectuer. Définissez la valeur sur SaveDeviceProp.
Props	String	Yes	{"color":"red"}	Le tag que vous souhaitez spécifier pour l'appareil. Vous pouvez spécifier plusieurs tags. Les tags doivent être des données JSON au format Key:Value. Key indique le nom du tag et Value indique la valeur du tag. Séparez plusieurs tags par des virgules (,). Exemple : Props={"color":"red","shape":"round"} Important La taille maximale du paramètre Props est de 5 Ko. `abc` est une key réservée par IoT Platform. Vous ne pouvez pas définir Key sur abc. Si vous définissez `Key` sur abc, le tag abc est automatiquement filtré lorsque vous consultez les tags.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID de l'instance. Sur la page Overview de la console IoT Platform, vous pouvez consulter l'ID de l'instance. Important Si votre instance possède un ID, vous devez spécifier l'ID pour ce paramètre. Sinon, l'appel échoue. Si la page Overview ou l'ID d'instance n'est pas affiché dans la console IoT Platform, vous n'avez pas besoin de configurer ce paramètre. Pour plus d'informations sur l'instance, consultez Overview.
ProductKey	String	No	a1BwAGV****	Le ProductKey du produit auquel l'appareil appartient. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceName	String	No	light	Le DeviceName de l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ProductKey.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	L'ID de l'appareil. L'ID est un identifiant unique émis par IoT Platform pour l'appareil. Remarque Si vous spécifiez ce paramètre, vous n'avez pas besoin de spécifier les paramètres ProductKey ou DeviceName. Le paramètre IotId spécifie un identifiant global unique (GUID) pour l'appareil. La valeur du paramètre IotId correspond à une combinaison des valeurs des paramètres ProductKey et DeviceName. Si vous spécifiez les paramètres IotId, ProductKey et DeviceName, la valeur du paramètre IotId est prioritaire.

En plus des paramètres de requête spécifiques à l'opération précédents, vous devez spécifier 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 Common parameters.

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 sur les codes d'erreur, consultez Error codes.
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. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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

JSON format

{
    "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
    "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le API Error Center.