BatchUpdateDeviceNickname - IoT Platform - Centre de documentation Alibaba Cloud

Modifie les alias de plusieurs appareils.

Limites

Chaque compte Alibaba Cloud accepte un maximum de 10 requêtes par seconde (QPS).

Remarque

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

Débogage

Alibaba Cloud met à votre disposition OpenAPI Explorer pour simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de signature. 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	BatchUpdateDeviceNickname	Opération à exécuter. Définissez la valeur sur BatchUpdateDeviceNickname.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	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 configurer ce paramètre. Sinon, l'appel échoue. Si votre instance ne dispose pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre. Pour plus d'informations, consultez la rubrique Overview.
DeviceNicknameInfo.N.ProductKey	String	No	a1BwAGV****	ProductKey du produit auquel appartient l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceNicknameInfo.N.DeviceName	String	No	light	DeviceName de l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ProductKey.
DeviceNicknameInfo.N.Nickname	String	No	AliyunDataCenter	Nouvel alias de l'appareil. L'alias doit comporter entre 4 et 32 caractères et peut contenir des lettres, des chiffres et des traits de soulignement (_). Chaque caractère chinois compte pour deux caractères. Remarque Si vous ne spécifiez pas ce paramètre, l'alias d'origine de l'appareil est supprimé.
DeviceNicknameInfo.N.IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID de l'appareil. Remarque Si vous spécifiez ce paramètre, il n'est pas nécessaire de spécifier les paramètres ProductKey ou DeviceName. Le paramètre IotId correspond à l'identifiant global unique (GUID) de l'appareil, qui associe les paramètres ProductKey et DeviceName. Si vous spécifiez à la fois le paramètre IotId et la combinaison des paramètres ProductKey et DeviceName, le paramètre IotId est prioritaire.

Outre les paramètres de requête spécifiques à l'opération présentés ci-dessus, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la rubrique Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchUpdateDeviceNickname
&DeviceNicknameInfo.1.ProductKey=a1rYuVF****
&DeviceNicknameInfo.1.DeviceName=SR8FiTu1R9tlUR2V1bmi
&DeviceNicknameInfo.1.Nickname=airconditioning_type1
&DeviceNicknameInfo.2.ProductKey=a1yrZMH****
&DeviceNicknameInfo.2.DeviceName=RkQ8CFtNpDok4BEunymt
&DeviceNicknameInfo.2.Nickname=airconditioning_type2
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

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

Format JSON

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.