错误码
更新时间：2024-09-13 08:44:58下载pdf
系统错误码
以iot.system、iot.Sre开头的错误码为系统相关错误码。
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| iot.system.SystemException | 系统异常。 | 请稍后重试。 |
| iot.system.IllegalRequest | 非法的请求参数。 | 请确保入参信息正确，然后重试。 |
公共错误码
以iot.common、iot.check开头的错误码为公共错误码。
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| iot.common.InvalidPageParams | 分页大小或者分页的页号不合法。 | 请参见具体API文档的分页相关参数描述，如PageSize，确保入参信息正确，然后重试。 |
| iot.common.QueryDeviceActionError | 查询设备失败。 | 请确保入参信息正确，然后重试。 |
| iot.common.QueryDevicePropertyActionError | 查询设备属性失败。 | 请确保入参信息正确，然后重试。 |
| iot.common.QueryProductActionError | 查询产品失败。 | 请确保入参信息正确，然后重试。 |
| iot.common.QueryProductCountActionError | 查询产品总数失败。 | 请确保入参信息正确，然后重试。 |
| iot.check.ParameterIsNotLessThanMax | 参数A的值必须小于参数B的值。例如，startTime值必须小于endTime值。 | 请确保入参信息符合规则，然后重试。 |
| iot.check.InvalidFormattedParameter | 参数格式错误。 | 请确保入参信息正确，然后重试。 |
产品相关错误码
以iot.prod开头的错误码为产品相关错误码。
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| iot.prod.InvalidFormattedProductkey | 入参产品ProductKey格式错误。 | 请确保传入的ProductKey值正确，然后重试。 |
| iot.prod.NotExistedProduct | 产品不存在。输入的ProductKey值在当前账号下不存在。 |
请确保传入的productKey或实例ID正确，然后重试。 |
| iot.prod.NullProductKey | 入参产品ProductKey不能为空。 |
请确保入参信息正确，然后重试。 |
| iot.prod.QueryDeviceCountActionError | 查询产品下的设备总数失败。 | 请确保入参信息正确，然后重试。 |
| iot.prod.QueryProductAbilitiesFailed | 获取产品功能失败。 | 请确保入参信息正确，如Identifier值等，然后重试。 |
| iot.prod.QueryProductAbilityFailed | 查询产品功能失败。 | 请确保入参信息正确，如Identifier值等，然后重试。 |
| iot.prod.QueryProductListActionError | 获取产品列表数据失败。 | 请确保入参信息正确，然后重试。 |
| iot.prod.UpdateProductFailed | 更新产品信息失败。 | 请确保入参信息正确，然后重试。 |
| iot.prod.QueryExtendPropertyFailed | 查询产品标签失败。 | 请确保入参信息正确，然后重试。 |
设备相关错误码
以 iot.device、Iot.Device、iot.devicesearch 开头的错误码为设备相关错误码。
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| iot.device.AlreadyExistedDeviceName | 设备名称已经存在。 设备名称需在产品维度唯一。 |
请重新命名设备名称，然后重试。 |
| iot.device.ApplyManyDevicesFailed | 申请批量创建设备失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.CreateDeviceFailed | 创建设备失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.CreateDeviceTaskIsRunning | 创建设备的申请任务还在执行中。 | 批量创建设备任务执行中，请稍后重试。 |
| iot.device.DeviceCountExceeded | 批量申请的设备数量超过最大值。 单次调用，最多批量注册10,000个设备。 |
请减少设备数量，然后重试。 |
| iot.device.DeleteDevicePropertyFailed | 删除设备属性失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.InactiveDevice | 设备未激活，即物理设备从未连接物联网平台。 | 请登录物联网平台控制台，查看设备状态，确定设备是否在线。 |
| iot.device.IncorrentDeviceApplyInfo | 设备申请信息错误。 | 请确保入参信息正确，如ApplyId等，然后重试。 |
| iot.device.InvalidFormattedDeviceName | 设备名称格式错误。 | 请确保传入的设备名称格式正确，然后重试。 设备名称格式说明，请参见。 |
| iot.device.InvalidDeviceNickNameExisted | 设备名称列表中存在不合法的备注名称。 | 具体错误请查看返回的不合法备注名称列表。 请确认批量注册设备时，设备的备注名称是否合法。 |
| iot.device.InvalidFormattedDevicePropertyKey | 设备属性标识符格式错误。 | 请查看相关API文档中，关于入参属性格式的描述。 请确认设备属性标识符格式是否合法。 |
| iot.device.InvalidFormattedDevicePropertiesString | 入参设备属性格式错误。 | 请确认属性格式是否正确。 关于入参属性格式的描述，请参见相关API文档。 |
| iot.device.InvalidIoTId | 设备ID错误。 | 请登录物联网平台控制台，查询对应设备信息，然后检查IotId是否合法。 可调用或查看正确的IotId值，或用ProductKey与DeviceName组合代替IotId。 |
| iot.device.InvalidTimeBucket | 指定的时间区间不合法。 | 请查看相关API文档的参数描述，输入正确的参数。 请确认入参开始时间和结束时间值，是否符合API描述要求。 |
| iot.device.InvokeThingServiceFailed | 调用设备服务失败。 | 请检查输入参数是否正确，如Args的参数格式和取值等。 首先确定入参是否符合产品功能定义；然后登录物联网平台，查询对应设备状态；确定设备在线后，进行重试。 |
| iot.device.LongDevicePropertiesString | 入参设备属性长度超过最大值。 | 请查看相关API文档的限制说明。 请减少传参数量，然后重试。 |
| iot.device.NoneDeviceNameElement | 设备名称列表为空。 | 请确保入参均合法，然后重试。 |
| iot.device.NoneDeviceProperties | 无有效的设备属性。 | 请核对传入的属性Identifier是否与TSL中定义的一致。 请确保入参符合API参数描述，然后重试。 |
| iot.device.NotExistedDevice | 设备不存在。 | 传入的设备IotId、ProductKey或DeviceName值错误。请调用或查看正确值。 请登录物联网平台控制台，查询设备信息，检查设备是否存在。 |
| iot.device.NullDeviceName | 设备名称不能为空。 | 请确保入参信息正确，然后重试。 |
| iot.device.NullDevicePropertyKey | 设备属性名称不能为空。 | 请确保入参信息正确，然后重试。 |
| iot.device.NullDevicePropertiesString | 入参设备属性不能为空。 | 请确保入参信息正确，然后重试。 |
| iot.device.QueryDeviceListActionError | 查询设备列表失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.QueryDeviceStatusFailed | 查询设备状态信息失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.QueryTopoRelationFailed | 查询拓扑关系失败。 | 请确认入参信息是否正确。如，传入的PageSize值大于限定值50会报此错误。 请确保入参信息正确，然后重试。 |
| iot.device.RemoveTopoRelationFailed | 移除拓扑关系失败。 | 请确保入参信息正确，然后重试。 |
| iot.device.SetDevicePropertyFailed | 设置设备属性失败。 | 请检查入参Items的参数值和格式是否正确，指定的属性是否是读写型。 请确保设备属性的入参符合产品功能定义，然后重试。 |
| iot.device.TooManyDevicePropertiesPerTime | 传入的属性个数超过限定值。请参见相关API文档限制说明。 | 请确保属性个数未超过限制，然后重试。 |
| iot.device.TopoRelationCountExceeded | 拓扑关系数量过多。请参见使用限制中网关与子设备数量限制。 | 请删除部分无用拓扑关系，然后重试。 |
| iot.device.VerifyDeviceFailed | 验证设备失败。 | 请确保入参信息正确（如设备信息），然后重试。 |
| iot.device.TooManyDeviceNamesPerRequest | 请求查询的设备名称数量超过最大限制。 | 请确保入参中设备名称数量不超过10,000，然后重试。 |
| iot.device.InvalidDeviceParams | 请求参数不合法。 | 请确保入参信息正确（如设备信息），然后重试。 |
| iot.device.FuzzyRuntimeSearchMinLengthLimit | 模糊搜索的内容长度小于5个字符。 | 请增加模糊查询关键字的字符个数，然后重试。 |
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“全球智能商业”
第一时间获取物联网资讯
