BatchUpdateDeviceNickname

调用该接口批量修改设备备注名称。当修改设备数量过多时请使用post请求。

使用说明

单次调用，最多可修改50个设备。DeviceNicknameInfo.N 表示第N个设备，N从1开始按照顺序超出50则抛弃。

请求参数

请求方式1

名称	类型	是否必选	示例值	描述
Action	String	是	BatchUpdateDeviceNickname	系统规定参数。取值：BatchUpdateDeviceNickname。
IotInstanceId	String	是	70255861902711****	实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。
DeviceNicknameInfo.N.ProductKey	String	是	a1BwAGV****	要修改备注名称的设备所隶属的产品ProductKey。
DeviceNicknameInfo.N.DeviceName	String	是	light	要修改备注名称的设备名称。
DeviceNicknameInfo.N.Nickname	String	否	AliyunDataCenter	新的设备备注名称。备注名称长度为2~64个字符，可包含中文汉字、英文字母、数字和下划线（_）。说明若不传入该参数，则删除该设备原有的备注名称。

请求方式2

名称	类型	是否必选	示例值	描述
Action	String	是	BatchUpdateDeviceNickname	系统规定参数。取值：BatchUpdateDeviceNickname。
IotInstanceId	String	是	70255861902711****	实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。
DeviceNicknameInfo.N.Nickname	String	否	AliyunDataCenter	新的设备备注名称。备注名称长度为2~64个字符，可包含中文汉字、英文字母、数字和下划线（_）。说明若不传入该参数，则删除该设备原有的备注名称。
DeviceNicknameInfo.N.IotId	String	是	702902075****00100	要修改备注名称的设备ID。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	TIr4jHMxg5d8Dm2t5VGDx6vKheRbqJHO	平台为该请求生成的唯一标识符。
Success	Boolean	true	表示是否调用成功。true：调用成功。false：调用失败。

示例

请求示例

http://open.${区域}.fenydata.com/fenydata-java-open/?Action=BatchUpdateDeviceNickname
&IotInstanceId=70255861902711****
&DeviceNicknameInfo.1.ProductKey=a1rYuVF****
&DeviceNicknameInfo.1.DeviceName=SR8FiTu1R9tlUR2V1bmi
&DeviceNicknameInfo.1.Nickname=airconditioning_type1
&DeviceNicknameInfo.2.IotId=702902075****00100
&DeviceNicknameInfo.2.Nickname=airconditioning_type2
&<公共请求参数>

正常返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
    <RequestId>TIr4jHMxg5d8Dm2t5VGDx6vKheRbqJHO</RequestId>
    <Success>true</Success>
</xml>

JSON格式

{
  "RequestId": "TIr4jHMxg5d8Dm2t5VGDx6vKheRbqJHO",
  "Success": true
}