华为云用户手册

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 200 100428 The device is not online. 设备不在线。 处理建议：请检查设备与 物联网平台 的连接是否正常。 200 100431 The serviceType is not exist. 服务类型不存在。 处理建议： 请检查该设备的Profile文件是否已上传到物联网平台。 请检查请求参数是否正确，或者serviceId在Profile文件中是否存在。 400 100022 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 400 100223 Command counts has reached the upLimit. 缓存的命令数已到达限制。处于PENDING状态的命令条数不超过限定值。默认限定值为20。 处理建议：如当前平台缓存的命令还需执行，请让设备上报数据触发缓存命令的下发；如当前平台缓存的命令有不需要执行的命令，请调用“修改设备命令V4”接口，将命令的状态从PENDING修改未CANCELED。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 100612 Device is zombie. 设备为僵尸设备。（距离设备上次上线时间超过阈值，默认7天） 处理建议：请把设备上线后再重新下发命令。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100023 The data in dataBase is abnomal. 数据库异常。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100220 Get AppKey from header failed. 获取appKey失败。 处理建议 : 请检查接口请求的header中是否携带appId。 500 101016 Get iotws address failed. 获取iotws地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 101017 Get newCallbackUrl from oss failed. 从oss获取新的回调地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞，当前的网络已经被流控。 处理建议：请稍后重新再尝试下发命令。

典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的ACK）才会下发后一个命令，保证串行性，不保证实时性。 此接口适用于使用LWM2M/CoAP协议接入的设备，例如NB-IoT设备。

错误码 Http状态码 错误码 错误描述 说明 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。

示例 1 2 3 HW_BYTES bstrBody; ………… IOTA_MqttDataPub (1211, "/huawei/v1/devices/336d9bac-9ebf-44e9-95cf-efac5f05da3a/services/Storage", 1, bstrBody); 数据上报结果接收。 1 2 3 4 5 6 7 8 9 10 11 12 //开发者注册该函数进行设备服务数据上报后的处理 HW_iNT Device_DataPubResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { uiResult = HW_MsgGetUint(pstMsg, EN_IOTA_DATATRANS_IE_RESULT); if (HW_SUC CES S != uiResult) { // retry with uiCookie return 0; } return 0; } //在设备添加成功后立即注册服务数据上报结果接收广播 HW_BroadCastReg(“IOTA_TOPIC_MQTT_DATA_PUB_RSP”, Device_AddResultHandler);

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 400 100022 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 400 100440 The isSecure is invalid. isSecure参数值有误。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 403 500004 The amount of frozen devices has reached the limit. 被冻结设备已达到上限。 404 100403 The device is not existed. 设备不存在。 处理建议：物联网平台未找到deviceId对应的设备，请检查deviceId是否有误。 404 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 100441 The amount of nonSecure device has reached the limit. 非安全设备数量已达到上限。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 qbsInDTO 必选 QueryBatchSubInDTO query 见下表QueryBatchSubInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryBatchSubInDTO 参数 必选/可选 类型 位置 描述 appId 可选 String(256) query 设备或者规则等订阅内容主体所属的appId。 notifyType 可选 String(256) query 通知类型，第三方应用可以根据通知类型对消息分别进行处理。 bindDevice（绑定设备） deviceAdded（添加新设备） deviceInfoChanged（设备信息变化） deviceDataChanged（设备数据变化） deviceDatasChanged（设备数据批量变化） deviceCapabilitiesChanged（设备服务能力变化，订阅后推送设备服务能力变化通知） deviceCapabilitiesAdded（设备服务能力增加，订阅后推送设备服务能力增加通知） deviceCapabilitiesDeleted（设备服务能力删除，订阅后推送设备服务能力删除通知） deviceDeleted（删除设备） messageConfirm（消息确认） commandRsp（命令响应） deviceDesiredPropertiesModifyStatusChanged（修改设备影子状态变更） swUpgradeStateChangeNotify（软件升级状态变更通知） swUpgradeResultNotify（软件升级结果通知） fwUpgradeStateChangeNotify（固件升级状态变更通知） fwUpgradeResultNotify（固件升级结果通知） pageNo 可选 Integer query 分页查询参数。 值为空时，查询内容不分页 值大于等于0的时分页查询 值等于0时查询第一页 pageSize 可选 Integer query 分页查询参数，取值大于等于1的整数，缺省值：“10”。

错误码 Http状态码 错误码 错误描述 说明 400 100224 The resource exceeds 1000, please refinement query conditions. 查到端资源超出1000条，请重新设定查询条件。 处理建议：请缩小查询条件范围。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。

错误码 Http状态码 错误码 错误描述 说明 200 100601 The number of device in the group has reach the max. 设备组内设备达到最大值。 处理建议：请确认当前设备组内的设备数量在maxDevNum设置值的范围内。 200 100603 The device group is not existed. 设备组不存在。 处理建议：请检查设备组ID是否正确。 400 100604 The device group request parameter is invalid. 请求参数不合法。 处理建议: 请检查接口请求中的设备ID是否有误。 请检查设备组是否达到最大设备数量限制。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的Token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

示例 开发者调用数据发布接口。 1 DataTransService. mqttDataPub（1211, "/huawei/v1/devices/336d9bac-9ebf-44e9-95cf-efac5f05da3a/services/Storage", 1, bstrBody); 开发者调用数据发布接口前需要实现AgentLite提供的观察者接口。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 public class Subscribe implements MyObserver { public Subscribe (Observable dataTransService) { dataTransService. registerObserver (this); } @Override public void update(IotaMessage arg0) { // TODO Auto-generated method stub System.out.println("AgentLiteDataTrans收到通知:" + arg0); int mMsgType = arg0.getMsgType(); switch(mMsgType) { //数据上报应答 case IodevService.IODEV_MSG_DATA_REPORT_RSP: getDataReportAnswer(arg0); break; //被动接收命令 case IodevService.IODEV_MSG_RECEIVE_CMD: getCmdReceive(arg0); break; //MQTT消息推送 case IodevService.IODEV_MSG_MQTT_PUB_RSP: //logoutResultAction(iotaMsg); break; case IodevService.IODEV_MSG_MQTT_SUB_RSP: //TopicSubcribeResultAction(iotaMsg); break; case IodevService.IODEV_MSG_MQTT_DATA_RECV_RSP: //DataRecvAction(iotaMsg); break; default: break; } }

参数说明 字段 必选/可选 类型 描述 cookie 可选 int Cookie有效值1-65535。 requstId 必选 String 请求ID，匹配之前平台下发的服务命令。可以从接收设备命令的广播中获取requestId。 主动数据上报：requestId为NULL。 命令结果上报：当上报的数据匹配到某一次命令请求时，需要填写此次命令请求的请求ID。 deviceId 必选 String 设备ID。 serviceId 必选 String 服务ID。 serviceProperties 必选 String 服务属性。

示例 用户根据Profile格式使用Json组件拼装服务属性的内容(serviceProperties)。 1 DataTransService.dataReport(1211, NULL, "xxxx_xxxx_xxxx_xxxx", "DoorWindow", “{\“status\”:\“OPEN\”}”); 数据上报结果接收： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 //开发者注册广播接收器对设备服务数据上报结果进行相应的的处理 BroadcastReceiver mReportDataRsp; mReportDataRsp = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { //Do Something IotaMessage iotaMsg = (IotaMessage)intent.getSerializableExtra(DataTransService. DATATRANS_BROADCAST_IE_IOTAMSG); int cookie = iotaMsg.getUint(DataTransService.DATATRANS_IE_COOKIE, 0); int ret = iotaMsg.getUint(DataTransService.DATATRANS_IE_RESULT, 0); return; } }; mLocalBroadcastManager = LocalBroadcastManager.getInstance(this); IntentFilter filterReportData = new IntentFilter(DataTransService.TOPIC_DATA_REPORT_RSP); mLocalBroadcastManager.registerReceiver(mReportDataRsp, filterReportData);

返回结果 广播名称 广播参数 成员 描述 TOPIC_DATA_REPORT_RSP IotaMessage （使用intent.getSerializableExtra(DataTransService.DATATRANS_BROADCAST_IE_IOTAMSG)方法获取） DATATRANS_IE_RESULT 数据上报结果。 DATATRANS_IE_COOKIE Cookie有效值为1-65535。

示例 开发者需要实现Agent Lite提供的观察者接口。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 public class AgentLiteDataTrans implements MyObserver { public AgentLiteDataTrans (Observable dataTransService) { dataTransService. registerObserver (this); } @Override public void update(IotaMessage arg0) { // TODO Auto-generated method stub System.out.println("AgentLiteDataTrans收到通知:" + arg0); int mMsgType = arg0.getMsgType(); switch(mMsgType) { //数据上报应答 case IodevService.IODEV_MSG_DATA_REPORT_RSP: getDataReportAnswer(arg0); break; //被动接收命令 case IodevService.IODEV_MSG_RECEIVE_CMD: getCmdReceive(arg0); break; //MQTT消息推送 case IodevService.IODEV_MSG_MQTT_PUB_RSP: //logoutResultAction(iotaMsg); break; default: break; } }

示例 用户根据Profile格式使用Json组件拼装服务属性的内容(pcServiceProperties)。 1 2 3 HW_UINT *uiLen; IOTA_ServiceDataReport(1211, NULL, "xxxx_xxxx_xxxx_xxxx" , "DoorWindow", “{\“status\”:\“OPEN\”}”); 数据上报结果接收。 1 2 3 4 5 6 7 8 9 10 11 12 //开发者注册该函数进行设备服务数据上报后的处理 HW_iNT Device_DataReportResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { uiResult = HW_MsgGetUint(pstMsg, EN_IOTA_DATATRANS_IE_RESULT); if (HW_SUCCESS != uiResult) { // retry with uiCookie return 0; } return 0; } //在设备添加成功后立即注册服务数据上报结果接收广播 HW_BroadCastReg(“IOTA_TOPIC_DATATRANS_REPORT_RSP/XXXX_XXXX_XXXX_XXXX”, Device_AddResultHandler);

参数说明 字段 必选/可选 类型 描述 uiCookie 可选 unsign int Cookie有效值1-65535。 pcRequstId 必选 String 请求ID，用来匹配之前平台下发的服务命令。当该次数据上报为此前某一次命令请求的响应时，需要填写此次命令请求的请求ID，该参数必须带结束符‘\0’。 pcDeviceId 必选 String 设备ID，该参数必须带结束符‘\0’。 pcServiceId 必选 String 服务ID，该参数必须带结束符‘\0’。 pcServiceProperties 必选 String 服务属性，该参数必须带结束符‘\0’。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100602 The device group name has been used. 设备组名字已经存在。 处理建议：请修改接口请求中的设备组名称。 200 100607 The devGroup has reached the limit. 设备组数目达到限制。 处理建议：请检查已创建的设备组数量是否已达到License限定的数量上限。 400 100609 Too much devices to add. 添加太多设备至设备组。 处理建议：请确认deviceIds中的设备ID数量在maxDevNum设置值的范围内。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 200 100428 The device is not online. 设备不在线。 处理建议：请检查设备与物联网平台的连接是否正常。 200 100431 The serviceType is not exist. 服务类型不存在。 处理建议： 请检查该设备的Profile文件是否已上传到物联网平台。 请检查请求参数是否正确，或者serviceId在Profile文件中是否存在。 400 100022 The input is invalid. 输入参数无效。 处理建议： 请确认startTime和endTime都不为空，且endTime比startTime晚。 请确认pageNo不为空，且pageNo大于0。 请检查pageSize不为空，且pageSize大于1。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100023 The data in dataBase is abnomal. 数据库异常。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100220 Get AppKey from header failed. 获取appKey失败。 处理建议 : 请检查接口请求的header中是否携带appId。 500 101016 Get iotws address failed. 获取iotws地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 101017 Get newCallbackUrl from oss failed. 从oss获取新的回调地址失败。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞，当前的网络已经被流控。

错误码 Http状态码 错误码 错误描述 说明 400 120015 Bad request error. 请求错误。 处理建议：请检查接口请求中fileId的格式是否正确。 400 123029 pageNo or pageSize beyond the limit. pageNo或pageSize超出上限。 处理建议：修改pageNo或pageSize为合法取值。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 123009 The requested task does not exist. 查询的任务不存在。 处理建议：请检查接口请求中的operationId内容是否正确。

参数说明 参数 必选/可选 类型 位置 描述 qutlInDTO 必选 QueryUpgradeTaskListInDTO query 见下表QueryUpgradeTaskListInDTO的描述。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 QueryUpgradeTaskListInDTO 参数 必选/可选 类型 位置 描述 operationType 可选 String(256) query 操作类型。 firmware_upgrade software_upgrade operationStatus 可选 String(256) query 操作任务的状态。 wait：等待 processing：正在执行 failed：失败 success：成功 stop：停止 deviceType 可选 String(256) query 操作任务针对的设备类型。 model 可选 String(256) query 操作任务针对的设备型号。 manufacturerName 可选 String(256) query 操作任务针对的设备厂家名称。 deviceId 可选 String(256) query 操作任务针对的设备ID。 pageNo 可选 Integer query 分页查询参数，默认值0。 值为空时，查询内容不分页。 值为大于等于0的整数时，分页查询。 值为0时查询第一页。 pageSize 可选 Integer query 查询结果分页时的每页结果数量，取值范围1-100，默认值10。

错误码 Http状态码 错误码 错误描述 说明 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 400 100003 Invalid verify code. 验证码无效。 处理建议：请检查接口请求中的verifyCode是否有误。若请求参数中未带verifyCode，请联系物联网平台维护人员处理。 400 100007 Bad request message. 参数不合法。 处理建议：deviceId未赋值，请参考请求参数说明填写请求。 400 100426 The nodeId is duplicated. nodeId重复。 处理建议：请检查接口请求中nodeId是否有误。 400 100610 Device is not active. 设备未激活。 处理建议：请检查该设备是否已接入物联网平台并激活。 400 100611 Device is online. 设备在线。 处理建议：请下线该设备或者断开设备与物联网平台的连接。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 401 100025 AppId for auth not exist. 获取不到appId鉴权信息。 处理建议： 请检查请求结构体的Header头域中是否给字段app_key赋值。 若通过HTTP调用，请联系物联网平台维护人员确认Header头域中放置appId的字段名是app_key还是x-app-key。 403 100203 The application is not existed. 授权应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 100403 The device is not existed. 设备不存在。 处理建议：物联网平台未找到deviceId对应的设备，请检查deviceId是否有误。 404 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

返回值 RefreshDeviceKeyOutDTO 参数 类型 描述 verifyCode String(256） 设备验证码，设备可以通过验证码完成物联网平台的接入认证。若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。 timeout Integer 验证码有效时间，单位秒，设备需要在有效时间内接入物联网平台。

参数说明 参数 必选/可选 类型 位置 描述 deviceId 必选 String(256) path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 rdkInDTO 必选 RefreshDeviceKeyInDTO body 具体参见RefreshDeviceKeyInDTO结构体的描述。 RefreshDeviceKeyInDTO结构体： 参数 必选/可选 类型 位置 描述 verifyCode 可选 String(256) body 备验证码，若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。建议和nodeId设置成一样。 nodeId 可选 String(256) body 设备的唯一标识，通常使用MAC，MAC地址，Serial No或IMEI作为nodeId。 值空时，nodeId不变。 值不为空时，更新nodeId。 说明： 若使用IMEI作为nodeId，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。 timeout 可选 Integer body 验证码超时时间，单位秒，取值大于等于0的整数。 值为空时，使用默认值（180s）。 值为0时，永不过期。 值为非0，指定时间。

错误码 Http状态码 错误码 错误描述 说明 400 107001 The serviceId is not exist. 服务ID不存在。 处理建议：请检查接口请求中的serviceId是否有误。 400 107002 The properties is empty in database. 设备属性不存在。 处理建议：请检查接口请求中的serviceId是否有误。 400 107003 The request properties is unknown. 设备状态为未知。 处理建议：请检查设备与平台的连接是否正常。 403 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的Token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

参数说明 参数 必选/可选 类型 位置 描述 qdgmInDTO 必选 QueryDeviceGroupMembersInDTO query 见下表QueryDeviceGroupMembersI...的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryDeviceGroupMembersInDTO 参数 必选/可选 类型 位置 描述 devGroupId 必选 String query 设备组ID，在增加设备组后由物联网平台返回获得。 accessAppId 可选 String query 如果是本应用的设备组，此参数值可以填写None，否则填写授权应用的appId。 pageNo 可选 Integer query 分页查询参数，默认值为“0”。 值为空时，查询内容不分页。 值为大于等于0的整数时，分页查询。 值为0时查询第一页。 pageSize 可选 Integer(1000) query 每页设备记录数量，默认值为“10”。

错误码 Http状态码 错误码 错误描述 说明 403 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 pp_key or access_token is invalid. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议: 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100601 The number of device in the group has reach the max. 设备组内设备达到最大值。 处理建议：请确认当前设备组内的设备数量在maxDevNum设置值的范围内。 200 100602 The device group name has been used. 设备组的名字已经存在。 处理建议：请修改接口请求中的设备组名称。 200 100603 The device group is not existed. 设备组不存在。 处理建议：请检查设备组ID是否正确。 400 50400 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

管理群组 登录物联网平台控制台，点击右上角“进入设备管理服务”。 单击左下角，选择“群组”。 点击相关按钮，进行添加群组、解绑群组、移动群组、删除群组操作，相关说明如下表所示。 图标 图标说明 单击可增加根群组，用户自定义群组名称、群组的描述。 单击可添加子群组，需要填写群组名称和群组描述。 单击后可将子群组从父级群组中解绑。 单击可将子群组从现有父群组移动到选择的父群组中。 单击可删除当前选择的群组，并且删除操作不可撤回。默认群组不可删除。 删除分为“级联删除”和“删除当前”： “级联删除”：删除群组时，该群组下的子群组会同时删除。 “删除当前”：删除群组后，该群组下的子群组会升级为根群组。当存在多个子群组时，会产生相应数量的根群组。例如根群组A，其子群组为B和C，若删除A，则B和C都将成为独立的根群组。 选择“所有群组”后在界面右边呈现，单击可导出所有群组的拓扑结构。

给群组绑定/解绑设备 当创建完群组后，可以进行设备和群组的绑定和解绑，也可以进行设备在不同群组之间的移动。 登录物联网平台控制台，点击右上角“进入设备管理服务”。 单击左下角，选择“群组”。 选择某个群组，进入"设备"页面，单击相关按钮，进行设备绑定、设备解绑、设备移动操作，相关说明如下表所示。 图标 图标说明 单击可绑定设备。 选中设备后，单击后可将选中的设备从群组中解绑。 说明： 具有权限的SP帐户或者全局用户（普通用户无法进行设备解绑）进行解绑操作，如果该群组下已绑定若干设备，解绑后，该用户无权限查看该群组和其下的设备，对于该用户来说，解绑后的群组及设备会消失。 选择一个设备，单击该图标可以移动选择的设备至其他群组。

概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制。 物联网平台有两种命令下发机制，如下表所示。 命令下发机制 定义 适用场景 LWM2M/CoAP协议设备 集成Agent Lite SDK设备/原生MQTT设备 立即下发 不管设备是否在线，平台收到命令后立即下发给设备。如果设备不在线或者设备没收到指令则下发失败。支持给本应用的设备和被授予权限的其它应用的设备下发命令。 立即下发适合对命令实时性有要求的场景，比如路灯开关灯，燃气表开关阀。使用立即下发时，命令下发的时机需要由应用服务器来保证。 建议用户使用缓存下发模式，工作模式设置为PSM模式（系统默认值）。 如需使用立即下发模式（工作模式设置为DRX或eDRX模式），需要在设备上报数据后立即下发命令才能成功。 适用 缓存下发 物联网平台在收到命令后先缓存，等设备上线或者设备上报数据时再下发给设备，如果单个设备存在多条缓存命令，则进行排队串行下发。支持给本应用的设备和被授予权限的其它应用的设备下发命令。 缓存下发适合对命令实时性要求不高的场景，比如配置水表的参数。 适用。工作模式设置为PSM模式（系统默认值）。 不适用

命令执行状态说明 命令执行状态以及状态变化机制如下所示。 命令执行状态 说明 等待（PENDING） NB-IoT设备采用缓存下发模式下发命令时，如果设备未上报数据，物联网平台会将命令进行缓存，此时任务状态为“等待”状态。 NB-IoT设备采用立即下发模式下发命令时，无此状态。 MQTT设备下发命令时，无此状态。 超期（EXPIRED） NB-IoT设备采用缓存下发模式下发命令时，如果在设置的超期时间内，物联网平台未将命令下发给设备，则状态变更为“超期”。超期时间会根据应用侧接口中携带的expireTime为准，如果未携带，默认48h。 NB-IoT设备采用立即下发模式下发命令时，无此状态。 MQTT设备下发命令时，无此状态。 取消（CANCELED） 如果命令下发任务为“等待”状态时，用户人工取消了命令下发任务，则任务状态变更为“取消”。 已发送（SENT） NB-IoT设备采用缓存下发模式下发命令时，设备上报数据，物联网平台会将缓存的命令发送给设备，此时状态会由“等待”变为“已发送”。 NB-IoT设备采用立即下发模式下发命令时，如果设备在线，状态为“已发送”。 MQTT设备下发命令时，如果设备在线，状态为“已发送”。 超时（TIMEOUT） NB-IoT设备收到命令后，物联网平台在180秒内未收到设备反馈的收到命令响应，此时状态会变为“超时”。MQTT设备无此状态。 已送达（DELIVERED） 物联网平台收到设备反馈的已收到下发命令响应后，状态变为“已送达”。 成功（SUCCESSFUL） 如果设备在执行完命令后，会给物联网平台反馈命令执行成功的结果，将任务状态变更为“成功”。 失败（FAIL） 如果设备在执行完命令后，会给物联网平台反馈命令执行失败的结果，将任务状态变更为“失败”。 NB-IoT设备采用立即下发模式下发命令时，如果设备离线，状态为“失败”。 MQTT设备下发命令时，如果设备离线，状态为“失败”。