本文档列举调用物联网平台API出错时，返回的错误信息。入参数据格式错误、超出限定值、入参缺少必需参数等错误修改，请参见具体API文档的请求参数描述。
系统错误码
以iot.system、iot.Sre开头的错误码为系统相关错误码。
错误码 | 描述 | 解决方案 |
iot.system.SystemException | 系统异常。 | 请稍后重试。若仍不能解决，请提交工单。 |
iot.system.InstanceNotFound | 实例ID不存在。 | 请确保入参信息正确，然后重试。 |
iot.Sre.IotInstanceNotFound | ||
iot.system.UidNotFound | 阿里云账号不存在或未开通物联网服务。 | 请确保阿里云账号正确并开通物联网服务，然后重试。 |
iot.system.IllegalRequest | 非法的请求参数。 | 请确保入参信息正确，然后重试。 |
iot.system.InstanceIdSame | 源实例ID和目标实例ID相同。 | 请确保入参中的源实例ID和目标实例ID不同，然后重试。 |
Iot.system.BillIsOverDue | 当前阿里云账号已欠费。 | 请前往阿里云账号中心充值。 |
公共错误码
以iot.common、iot.check开头的错误码为公共错误码。
错误码 | 描述 | 解决方案 |
iot.common.InvalidPageParams | 分页大小或者分页的页号不合法。 | 请参见具体API文档的分页相关参数描述，如PageSize，确保入参信息正确，然后重试。 |
iot.common.InvalidTenant | 不合法的租户。 | 请确认阿里云账号信息和账号权限。 |
iot.common.QueryDeviceActionError | 查询设备失败。 | 请确保入参信息正确，然后重试。 |
iot.common.QueryDevicePropertyActionError | 查询设备属性失败。 | |
iot.common.QueryProductActionError | 查询产品失败。 | |
iot.common.QueryProductCountActionError | 查询产品总数失败。 | |
iot.common.RamActionPermissionDeny | 没有资源访问控制（RAM）权限。 | 请给调用的阿里云账号授权。具体操作，请参见RAM用户授权文档。 |
iot.common.AuthActionPermissionDeny | 鉴权失败。 原因可能是入参的设备信息不属于当前账号。 | 请确保AccessKey信息和设备信息匹配，然后重试。 |
iot.check.ParameterIsNotLessThanMax | 参数A的值必须小于参数B的值。例如，参数startTime值必须小于参数endTime值。 | 请确保入参信息符合规则，然后重试。 |
iot.check.InvalidFormattedParameter | 参数格式错误。 | 请确保入参信息正确，然后重试。 |
iot.common.APINotSupportedInInstance | 当前实例不支持该API。 公共实例尚未支持该功能。 | 请使用物联网平台企业版实例，然后调用API。 |
iot.common.InvalidFormattedParameter | 参数格式错误。 | 请确保入参信息正确，然后重试。 |
iot.common.IllegalFileBizCode | 文件业务类型无效。 | |
iot.common.IllegalFileFormat | 文件格式无效。 | |
iot.common.FileNotExist | 文件不存在。 | |
iot.common.UpdateThingModelOverLimit | 单个物模型TSL文件中，有效字符数量超出限制（256 KB，即256*1024个字符）。 | 请确保单个物模型TSL文件的有效字符数量符合API限制。 |
产品相关错误码
以iot.prod开头的错误码为产品相关错误码。
错误码 | 描述 | 解决方案 |
iot.prod.AlreadyExistedProductName | 已经存在相同的产品名称。同一个实例下的产品名称不能重复。 | 请确认同一个企业实例下，新建产品名称与已有产品名称不同，然后重试。 |
iot.prod.CreateProductFailed | 创建产品失败。 | 请确保入参信息正确，然后重试。 |
iot.prod.CreateProductTopicFailed | 创建产品的Topic类失败。 | |
iot.prod.InvalidAliyunCommodityCode | 入参AliyunCommodityCode值错误。 | AliyunCommodityCode的可选值只有iothub_senior和iothub。 请确保AliyunCommodityCode参数正确，然后重试。 |
iot.prod.InvalidFormattedCatId | 入参CategoryId（产品的设备类型）错误。 | 请确保品类相关参数正确，然后重试。 |
iot.prod.InvalidFormattedProductkey | 入参产品ProductKey格式错误。 | 请确保传入的ProductKey值正确，然后重试。 |
iot.prod.InvalidFormattedProductName | 入参产品名称格式错误。 | 请确保传入正确的产品名称格式，然后重试。 产品名称格式说明，请参见CreateProduct。 |
iot.prod.LongProductDesc | 产品描述字符数超出限定值。 | 描述信息应在100个字符以内。 请确保产品描述内容长度符合限制，然后重试。 |
iot.prod.InvalidNodeType | 产品的节点类型（NodeType）错误。 | 请确保传入的NodeType值正确，然后重试。 节点类型支持的可选值，请参见CreateProduct。 |
iot.prod.NotExistedProduct | 产品不存在。 输入的ProductKey值在当前账号下不存在。 | 请确保传入的productKey或实例ID正确，然后重试。 |
iot.prod.NotOpenID2Service | 没有开通ID²服务。 | 请开通ID²服务后重试。 该产品在创建时没有开通ID²安全认证服务。ID²安全认证服务只能在创建产品时开通，并且，产品创建成功后，不能更改是否使用ID²认证的状态。 |
iot.prod.NotSeniorProduct | 产品不支持物模型。您创建产品时，定义为不使用物模型版的产品。 | 请确保入参信息正确，然后重试。 |
iot.prod.NullProductKey | 入参产品ProductKey不能为空。 | |
iot.prod.NullProductName | 入参产品名称不能为空。 | |
iot.prod.ProductCountExceedMax | 产品总数已超过最大限制数量。 一个实例下最多可有1,000个产品。 | 请删除实例下不使用的产品，然后重试。 |
iot.prod.QueryDeviceCountActionError | 查询产品下的设备总数失败。 | 请确保入参信息正确，然后重试。 |
iot.prod.QueryProductAbilitiesFailed | 获取产品功能失败。 | 请确保入参信息正确，如Identifier值等，然后重试。 |
iot.prod.QueryProductAbilityFailed | 查询产品功能失败。 | 请确保入参信息正确，如Identifier值等，然后重试。 |
iot.prod.QueryProductListActionError | 获取产品列表数据失败。 | 请确保入参信息正确，然后重试。 |
iot.prod.UpdateProductFailed | 更新产品信息失败。 | |
iot.prod.QueryExtendPropertyFailed | 查询产品标签失败。 | |
iot.prod.InvalidScriptType | 数据解析脚本类型无效。 | 请确保入参中数据解析脚本类型正确，然后重试。 |
iot.prod.ThingScriptExisted | 产品下已存在创建或更新的数据解析脚本。 | 请确认产品下是否已存在待创建或更新数据解析脚本。若已存在，无需重复操作。 |
iot.prod.ConcurrentScriptOperation | 操作数据解析脚本失败。 | 请确保不要并发操作数据解析脚本。 |
iot.prod.ThingScriptDataFormatError | 产品的数据解析脚本类型错误。 | 请确保入参信息正确，然后重试。 |
iot.prod.BatchCreateThingModelFailed | 创建物模型失败。 | |
iot.prod.ThingModelNameDuplicated | 物模型中存在重复的功能定义名称。 | 请更换功能定义名称，然后重试。 |
iot.Prod.NotProductOwner | 当前操作者不是产品的拥有者。 | 请确保访问的产品已有授权，然后重试。 |
iot.prod.ProductDataFormatIsNull | 数据解析脚本提交失败。您创建产品时，请求参数DataFormat值为空。 | 请确保创建产品时，已设置数据格式，请参见CreateProduct。 |
设备相关错误码
以iot.device、Iot.Device、iot.devicesearch开头的错误码为设备相关错误码。
错误码 | 描述 | 解决方案 |
iot.device.DistributedProductCanNotCreateDevice | 当前待注册设备的产品为分发产品。设备分发的接收方不支持在分发产品下创建设备。 | 请在当前账号创建的产品下注册设备。 |
Iot.Device.NotDeviceOwner | 当前操作的用户不是设备的拥有者。 | 请使用主账号登录物联网平台控制台，在对应实例下查询设备，验证设备是否存在。 |
iot.device.AddTopoRelationFailed | 添加拓扑关系失败。 | 请确保入参信息正确，然后重试。 |
iot.device.AlreadyExistedDeviceName | 设备名称已经存在。 设备名称需在产品维度唯一。 | 请重新命名设备名称，然后重试。 |
iot.device.ApplyManyDevicesFailed | 申请批量创建设备失败。 | 请确保入参信息正确，然后重试。 |
iot.device.CreateDeviceFailed | 创建设备失败。 | |
iot.device.CreateDeviceTaskIsRunning | 创建设备的申请任务还在执行中。 | 批量创建设备任务执行中，请稍后重试。 |
iot.device.DeviceApplyIsNotFound | 申请设备的申请单（ApplyId）不存在。 | 请确保输入的ApplyId值，与您调用的对应接口（BatchCheckDeviceNames或BatchImportDevice）返回的ApplyId值一致，然后重试。 |
iot.device.DeviceCountExceeded | 批量申请的设备数量超过最大值。 单次调用，最多批量注册10,000个设备。 | 请减少设备数量，然后重试。 |
iot.device.DeleteDeviceFailed | 删除设备失败。 | 请确保入参信息正确，然后重试。 |
iot.device.DeleteDevicePropertyFailed | 删除设备属性失败。 | |
iot.device.DisableDeviceFailed | 禁用设备失败。 | |
iot.device.EnableDeviceFailed | 启用设备失败。 | |
iot.device.InactiveDevice | 设备未激活，即物理设备从未连接物联网平台。 | 请登录物联网平台控制台，查看设备状态，确定设备是否在线。 |
iot.device.InvalidFormattedApplyId | 创建设备的申请单（ApplyId）错误。 | 请确保输入的ApplyId值，与您调用BatchCheckDeviceNames返回的ApplyId值一致，然后重试。 |
iot.device.IncorrentDeviceApplyInfo | 设备申请信息错误。 | 请确保入参信息正确，如ApplyId等，然后重试。 |
iot.device.InvalidFormattedDeviceName | 设备名称格式错误。 | 请确保传入的设备名称格式正确，然后重试。 设备名称格式说明，请参见RegisterDevice。 |
iot.device.InvalidDeviceNickNameExisted | 设备名称列表中存在不合法的备注名称。 具体错误请查看返回的不合法备注名称列表。 | 请确认批量注册设备时，设备的备注名称是否合法。 |
iot.device.InvalidFormattedDevicePropertyKey | 设备属性标识符格式错误。 请查看相关API文档中，关于入参属性格式的描述。 | 请确认设备属性标识符格式是否合法。 |
iot.device.InvalidFormattedDevicePropertiesString | 入参设备属性格式错误。 | 请确认属性格式是否正确。 关于入参属性格式的描述，请参见相关API文档。 |
iot.device.InvalidIoTId | 设备ID错误。 | 请登录物联网平台控制台，查询对应设备信息，然后检查IotId是否合法。 可调用QueryDeviceDetail或QueryDevice查看正确的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值错误。请调用QueryDeviceDetail或QueryDevice查看正确值。 | 请登录物联网平台控制台，查询设备信息，检查设备是否存在。 |
iot.device.NullApplyId | 创建设备的申请ID（ApplyId）不能为空。 | 请确保输入ApplyId值正确，然后重试。 |
iot.device.NullDeviceName | 设备名称不能为空。 | 请确保入参信息正确，然后重试。 |
iot.device.NullDevicePropertyKey | 设备属性名称不能为空。 | |
iot.device.NullDevicePropertiesString | 入参设备属性不能为空。 | |
iot.device.QueryDeviceApplyActionError | 查询设备申请单信息出错。 | 请确保输入ApplyId值正确，然后重试 |
iot.device.QueryDeviceAttrDataHistoryFailed | 获取设备属性数据历史记录失败。 | 请确保入参信息正确，然后重试。 |
iot.device.QueryDeviceAttrStatusFailed | 获取设备属性状态信息失败。 | |
iot.device.QueryDeviceEventHistoryFailed | 获取设备事件调用记录失败。 | |
iot.device.QueryDeviceListActionError | 查询设备列表失败。 | |
iot.device.QueryDeviceServiceHistoryFailed | 获取设备服务调用记录失败。 | |
iot.device.QueryDeviceStatisticsFailed | 查询设备统计信息失败。 | |
iot.device.QueryDeviceStatusFailed | 查询设备状态信息失败。 | |
iot.device.QueryTopoRelationFailed | 查询拓扑关系失败。 请确认入参信息是否正确。如，传入的PageSize值大于限定值50会报此错误。 | |
iot.device.RemoveTopoRelationFailed | 移除拓扑关系失败。 | |
iot.device.SaveOrUpdateDevicePropertiesFailed | 新增或者修改设备属性失败。 | |
iot.device.SetDevicePropertyFailed | 设置设备属性失败。 请检查入参Items的参数值和格式是否正确，指定的属性是否是读写型。 | 请确保设备属性的入参符合产品功能定义，然后重试。 |
iot.device.TooManyDevicePropertiesPerTime | 传入的属性个数超过限定值。 请参见相关API文档限制说明。 | 请确保属性个数未超过限制，然后重试。 |
iot.device.TopoRelationCountExceeded | 拓扑关系数量过多。 请参见使用限制中网关与子设备数量限制。 | 请删除部分无用拓扑关系，然后重试。 |
iot.device.VerifyDeviceFailed | 验证设备失败。 | 请确保入参信息正确（如设备信息），然后重试。 |
iot.device.TooManyDeviceNamesPerRequest | 请求查询的设备名称数量超过最大限制。 | 请确保入参中设备名称数量不超过10,000，然后重试。 |
iot.device.InvalidDeviceParams | 请求参数不合法。 | 请确保入参信息正确（如设备信息），然后重试。 |
iot.devicesearch.InvalidSQLError | 不合法的SQL语句。 | 请确保SQL语法合法，然后重试。 |
iot.devicesearch.InvalidSQLOffsetError | 不合法的SQL偏移量。 | 请检查SQL语句，修正不合法的偏移量，然后重试。 |
iot.devicesearch.InvalidSQLFieldError | SQL包含不合法的字段名。 | 请检查SQL语句，修正不合法的字段，然后重试。 |
iot.devicesearch.InvalidSQLConditionError | SQL的连接词个数超过限制。 | 请检查SQL语句，减少连接词，然后重试。 |
iot.devicesearch.InvalidSQLOrderError | SQL的排序规则错误。 | 请检查SQL语句，修正不合法的排序，然后重试。 |
iot.devicesearch.InvalidSQLOperatorTypeError | SQL运算符和数据类型不匹配。 | 请检查SQL语句，修正不正确的运算符，然后重试。 |
iot.devicesearch.InvalidSQLParamError | 不支持的SQL语法。 | 请检查SQL语句，删除不支持的语法，然后重试。 |
iot.tsl.InvalidIdentifierInEventError | 查询指定设备的原始事件记录失败。 | 请核对传入的属性Identifier是否有效。 |
InvalidIdentifierInServiceError | 查询指定设备的原始服务记录失败。 | 请核对传入的属性Identifier是否有效。 |
InvalidIdentifierInPropertyError | 查询指定设备原始属性记录失败。 | 请核对传入的属性Identifier是否有效。 |
iot.device.PageTokenIsIllegal | 查询指定设备原始快照、属性记录、服务记录、事件记录失败。 | 请确保请求参数NextPageToken信息正确，然后重试。 |
iot.device.DeviceHasDistributed | 同名设备已被分发。 请更换设备名称，然后重试。 | 产品下存在已同名被分发的设备，请替换设备名称后重试。 |
iot.device.FuzzyRuntimeSearchMinLengthLimit | 模糊搜索的内容长度小于5个字符。 | 请增加模糊查询关键字的字符个数，然后重试。 |
iot.device.RegionNotSupportDynamicGroup | 当前地域不支持动态分组功能。 仅华东2（上海）地域支持动态分组功能。 | 请检查接口入参region信息，确保在华东2（上海）地域，然后重试。 |
设备分发相关错误码
以iot.provisioning开头的错误码为设备分发相关错误码。
错误码 | 描述 | 解决方案 |
iot.provisioning.RunningTaskExceedLimit | 当前阿里云账号的并行分发任务已超出限制。 单个阿里云账号下，产品分发和设备分发的任务总数不能超过10个。 | 请等待运行中的任务执行完成，即可继续并发执行任务。 |
iot.provisioning.TaskNotFinish | 分发任务未完成。 | 请等待当前分发任务完成。 |
iot.provisioning.TaskIsProcessing | 分发任务还在进行中。 | 请等待当前分发任务完成。 |
iot.provisioning.DeviceIsInAnotherTask | 当前设备在其它分发任务中。 | 不同分发任务同时分发相同的设备，只有一个任务会将该设备分发成功。 |
iot.provisioning.TaskNotExist | 分发任务不存在。 | 请确保分发任务存在，然后重试。 |
iot.provisioning.TaskAlreadyFinish | 分发任务已完成。 | 请确保入参信息正确，然后重试。 |
iot.provisioning.UidAndTaskNotMatch | 当前阿里云账号ID不是任务创建者的账号ID。 | |
iot.provisioning.DeviceIsDistributing | 设备分发中。 | 等待当前设备分发完成。 |
iot.provisioning.ProductIsDistributing | 产品分发中。 | 当前分发任务需等到分发该产品的任务结束，才会执行。 |
iot.provisioning.AccountNotFound | 输入的阿里云账号不存在。 | 请确保入参信息正确，然后重试。 |
iot.provisioning.TargetAccountParamsError | 账号信息不能为空。 | |
iot.provisioning.CrmServiceError | 阿里云账号服务异常。 | 请稍后重试。 |
iot.provisioning.InstanceOperationDeny | 目标实例不属于目标阿里云账号。 | 请确保入参信息正确，然后重试。 |
iot.provisioning.SourceInstanceNotFound | 源实例ID不存在。 | |
iot.provisioning.TargetInstanceNotFound | 目标实例ID不存在。 | |
iot.provisioning.CaptchaNotNull | 该操作需要填写授权码。 | |
iot.provisioning.CaptchaNotFound | 授权码错误。 | |
iot.provisioning.SendCaptchaFlowControl | 操作频繁，1分钟后重试。 | 请稍后重试。验证码发送的时间间隔必须大于1分钟。 |
iot.provisioning.LimitExceeded | 分发设备数超出限制。 | 减少分发的设备，然后重试。 |
iot.provisioning.FailGetLogLat | 获取经纬度信息失败。 | 请确保入参信息正确，然后重试。 |
iot.provisioning.NotCrossTenantId | 该操作不支持跨阿里云账号。 | 该操作不支持跨阿里云账号。 |
iot.provisioning.ErrorStrategy | 不支持该分发策略。 | 修正分发策略，然后重试。 |
iot.provisioning.InstanceRegionConflict | 每个地域只能选择一个实例ID。 | 请确保入参信息正确，然后重试。 |
iot.provisioning.NotDeviceOwner | 当前操作者不是设备的拥有者。 | 设备分发只能设备的拥有者发起。 |
iot.provisioning.NextTokenNotNull | 请求参数NextToken不能为空。详细说明，请参见ListDeviceDistributeJob。 | 请确保入参信息正确，然后重试。 |
设备安全隧道相关错误码
以iot.securetunnel开头的错误码为设备安全隧道相关错误码。
错误码 | 描述 | 解决方案 |
iot.securetunnel.InstanceIdMismatch | 实例ID不匹配。 | 请确保实例ID和设备所属实例相匹配，然后重试。 |
iot.securetunnel.TunnelNotExist | 设备安全隧道不存在。 | 请确认安全隧道ID对应的隧道是否存在。 |
iot.securetunnel.IllegalState | 设备安全隧道状态不正确。 | 请确认安全隧道的状态是否符合对应接口的要求。 |
iot.securetunnel.ParamInvalid | 设备安全隧道API参数错误。 | 请参见API参数说明，确保参数信息正确，然后重试。 |
iot.securetunnel.DescriptionTooLong | 创建设备安全隧道时，入参Description内容超出长度限制（1024个字符）。 | 请参见API参数说明，确保参数信息正确，然后重试。 |
iot.securetunnel.UdiTooLong | 创建设备安全隧道时，入参Udi内容超出长度限制（4096个字符）。 | 请参见API参数说明，确保参数信息正确，然后重试。 |
iot.securetunnel.TunnelAmountExceedByDevice | 当前设备下安全隧道数量超过限制（10个）。 | 请先关闭并删除不再使用的安全隧道，然后重试。 |
iot.securetunnel.TunnelAmountExceedByInstance | 当前实例下，安全隧道数量超过限制（1,000个）。 | 请先关闭并删除不再使用的安全隧道，然后重试。 |
iot.securetunnel.DeviceNotExist | 设备不存在。 | 请确认设备是否存在。 |
iot.securetunnel.DeviceNotOnline | 设备不在线。 | 请确保设备在线，然后重试。 |
iot.securetunnel.DeviceNotSpecified | 设备未指定。 | 请传入设备相关的入参，然后重试。 |
设备任务相关错误码
以iot.job开头的错误码为设备任务相关错误码。
错误码 | 描述 | 解决方案 |
iot.job.JobNotExist | 任务不存在。 | 请登录物联网平台控制台，查询任务是否存在，然后重试。 |
iot.job.ListTaskParamJobIdAndDeviceNull | 请求参数JobId和Device不能同时为空。 | 请确保入参信息正确，然后重试。 |
iot.job.ListTaskParamDeviceInfoInvalid | 请求参数Device中设备信息不合法。 productKey和deviceName不能同时为空。 | |
iot.job.GenerateFileUploadUrlFailed | 生成文件上传URL失败。 | |
iot.job.ParamsError | 参数异常。 | |
iot.job.JobInvokeServiceSidError | 设备批量服务调用任务中，JobDocument中serviceIdentifier参数错误。 | |
iot.job.JobSetPropertyParamsError | 设备批量属性设置任务中，JobDocument中params参数错误。 | |
iot.job.JobCountExceedLimit | 任务数量超出限制。 一个阿里云账号下，单个地域最多可添加10,000个任务。 | 删除无用的任务，然后重试。 |
iot.job.IllegalTargetDevices | 请求参数TargetConfig中的TargetDevices包含不合法的设备。 | 请确保入参信息正确，然后重试。 |
iot.job.QueryJobFailed | 查询任务信息失败。 | |
iot.job.NotJobOwner | 您不是该任务的拥有者。 | 登录物联网平台控制台，查询任务信息，检查jobId是否正确，然后重试。 |
iot.job.UpdateJobFailed | 更新任务下作业配置失败。 | 请确保入参信息正确，然后重试。 |
iot.job.JobActionForbidden | 任务当前状态，禁止该类型的操作。 | 检查任务状态，确定任务状态符合API的参数描述，然后重试。 |
iot.job.CancelJobFailed | 取消任务失败。 | 请确保入参信息正确，然后重试。 |
iot.job.DeleteJobFailed | 删除任务失败。 | |
iot.job.QueryJobStaticsFailed | 查询任务信息失败。 | |
iot.job.QueryTaskFailed | 查询指定任务下作业失败。 | |
iot.job.TaskIdIsNull | 请求参数TaskId不能为空。 | |
iot.job.TaskNotExist | 查询的任务下作业不存在。 | 请登录物联网平台控制台，查询任务，检查任务是否存在，然后重试。 |
iot.job.NotTaskOwne | 您不是该设备作业的拥有者。 | 请登录物联网平台控制台，查询任务下是否存在该设备信息，然后重试。 |
iot.job.JobFileInSecure | 创建任务中上传的文件内容不合法。 | 请检查文件信息，确保文件内容正确，然后重试。 |
iot.job.ReRunJobFailed | 任务重试失败。 因并发操作，导致接口调用发生冲突，请稍后重试。 | 请确保入参信息正确，然后重试。 |
设备分组相关错误码
以iot.group开头的错误码为设备分组相关错误码。
错误码 | 描述 | 解决方案 |
iot.group.NullGroupId | 入参分组ID没有赋值。 | 请确保入参信息正确，然后重试。 |
iot.group.DeleteGroupFailed | 删除分组失败。 | |
iot.group.SubGroupNotNull | 分组下有子分组。 当分组下有子分组时，不能删除分组，需先删除子分组。 | 请先删除子分组，然后重试删除该分组。 |
iot.group.InvalidGroupName | 分组名称不合法。 分组名称可包含中文汉字、英文字母、数字和下划线（_）。长度范围4~30个字符（一个中文汉字占二个字符）。 | 请确保入参信息正确，然后重试。 |
iot.group.GroupNameExisted | 分组名称已存在。 | 请重新命名分组名称，然后重试。 |
iot.group.QueryGroupInfoFailed | 查询分组详情失败。 | 请确保入参信息正确，然后重试。 |
iot.group.NotExistedGroup | 分组不存在。 请确认GroupId值。 | 登录物联网平台控制台，查询分组，检查分组是否存在，然后重试。 |
iot.group.QueryGroupCountFailed | 查询分组数量失败。 | 请确保入参信息正确，然后重试。 |
iot.group.QueryGroupListFailed | 查询分组列表失败。 | |
iot.group.BindGroupRelationFailed | 绑定分组关系失败。 | |
iot.group.UpdateGroupFailed | 修改分组信息失败。 | |
iot.group.QueryGroupTreeFailed | 获取分组关系结构失败。 | |
iot.group.CreateGroupFailed | 创建分组失败。 | |
iot.group.InvalidFormattedTagString | 标签格式不合法。 | 标签数据为JSON格式。由标签的tagKey和tagValue组成，tagKey和tagValue均不能为空。多个标签以英文逗号间隔。如， |
iot.group.TagCountExceedMax | 标签数量超过最大值。 每个分组最多可有100个标签。 | 删除不需要的标签，然后重试。 |
iot.group.GroupCountExceedMax | 分组数量超过最大值。
| 删除无用的子分组或者分组中无用的设备，然后重试。 |
iot.group.SetGroupTagFailed | 设置分组标签信息失败。 | 请确保入参信息正确，然后重试。 |
iot.group.QueryGroupTagFailed | 查询分组标签信息失败。 | |
iot.group.LongGroupDescError | 分组描述字段过长。 分组描述长度限制为100个字符（一个中文汉字占一个字符）。 | 请重新编辑分组描述，然后重试。 |
iot.group.QueryGroupRelationFailed | 查询分组关系失败。 | 请确保入参信息正确，然后重试。 |
iot.group.GroupLevelExceedingLimitError | 分组层级超过限制。 分组只支持三级嵌套，即分组>子分组>子子分组。 | 请登录物联网平台控制台，检查分组嵌套层级。 |
iot.group.SuperGroupUnsupport | 子分组不支持添加到当前父组。 | 请登录物联网平台控制台，检查分组是否为动态分组。动态分组不支持添加子分组。 |
消息相关错误码
大部分以iot.messagebroker开头的错误码为消息相关错误码。此类错误码主要出现在调用消息通信相关API、设备影子相关API和规则引擎相关API失败时。（规则引擎相关API调用失败错误码，请见本文档“规则引擎相关错误码”。）
错误码 | 描述 | 解决方案 |
iot.messagebroker.CreateTopicRouteFailed | 创建Topic之间消息路由失败。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.CreateTopicTemplateException | 创建Topic类过程发生异常。 | |
iot.messagebroker.CreateTopicTemplateFailed | 创建Topic类失败。 | |
Iot.MessageBroker.BatchSubTopicFailed | 批量订阅Topic失败。 | |
Iot.MessageBroker.EmptySubTopicList | 订阅的Topic列表为空。 | 请传入非空的Topic列表，然后重试。 |
iot.messagebroker.DeleteTopicTemplateException | 删除Topic类过程发生异常。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.DeleteTopicTemplateFailed | 删除Topic类失败。 | |
iot.messagebroker.DestTopicNameArraySizeIsLarge | 同一消息源Topic配置的路由目标Topic数量超过最大限制数。 | 一个源Topic最多可对应100个目标Topic，请检查相关配置，然后重试。 |
iot.messagebroker.DeleteTopicRouteFailed | 删除指定Topic间的路由失败。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.DesireInfoInShadowMessageIsNotJson | 设备影子中的desire信息不是JSON格式。 | 请传入JSON格式的desire信息，然后重试。 |
iot.messagebroker.DesireValueIsNullInShadowMessage | 设备影子中的desire信息值为空。 | 请传入非空的desire信息，然后重试。 |
iot.messagebroker.ElementKeyOrValueIsNullInDesire | desire信息包含有空的属性标识符或者属性值。 | 请确保传入的desire信息不包含空的属性标识符或者属性值，然后重试。 |
iot.messagebroker.ElementKeyOrValueIsNullInReport | report信息包含有空的属性标识符或者属性值。 | 请确保传入的report信息不包含空的属性标识符或者属性值，然后重试。 |
iot.messagebroker.HALFCONN | 由于设备为半连接状态导致失败。 | 请确保设备连接正常，然后重试。 |
iot.messagebroker.InvalidFormattedSrcTopicName | 消息源Topic名称格式错误。 | 请确保Topic名称格式正确，然后重试。 可在控制台设备详情页的Topic列表下查看设备的Topic。 |
iot.messagebroker.InvalidFormattedTopicName | Topic格式错误。 可在控制台设备详情页的Topic列表下查看设备的Topic。 | 请确保Topic格式正确，然后重试。 可在控制台设备详情页的Topic列表下查看设备的Topic。 |
iot.messagebroker.InvalidFormattedTopicTemplateId | Topic类ID格式错误。 | 请确保Topic类ID格式正确，然后重试。 可调用QueryProductTopic查看TopicId。 |
iot.messagebroker.InvalidTimeoutValue | 超时时间参数设置有误。 | 请确保时间参数设置正确，然后重试。 请参见相关API文档查看时间设置方法。 |
iot.messagebroker.InvalidTopicTemplateOperationValue | Topic类的操作权限值错误。 | 请确保Topic类的操作权限正确，然后重试。操作权限取值： SUB：订阅。 PUB：发布。 ALL：发布和订阅。 |
iot.messagebroker.InvalidVersionValueInShadowMessage | 设备影子中的version值错误。 | 请确保设备影子中的version值正确，然后重试。 |
iot.messagebroker.MethodValueIsNotUpdate | 设备影子中的method信息值不是update。 | 请确保设备影子中的method值是update，然后重试。 |
iot.messagebroker.MessageContentIsNotBase64Encode | 消息内容没有经过Base64编码。 | 请确保消息内容经过Base64编码，然后重试。 |
iot.messagebroker.NoneElementInDesire | desire信息中没有属性。 | 请确保desire信息中有属性，然后重试。 |
iot.messagebroker.NoneElementInReport | report信息中没有属性。 | 请确保report信息中有属性，然后重试。 |
iot.messagebroker.NoneElementDestTopicNameInArray | 目标Topic列表中没有元素。 | 请确保目标Topic列表中有元素，然后重试。 |
iot.messagebroker.NotFoundDesireInShadowMessage | 设备影子的state信息中没有desire信息。 | 请确保设备影子的state信息中有desire信息，然后重试。 |
iot.messagebroker.NotFoundMethodInShadowMessage | 设备影子没有method信息。 | 请确保设备影子有method信息，然后重试。 |
iot.messagebroker.NotFoundReportInShadowMessage | 设备影子中没有report信息。 | 请确保设备影子有report信息，然后重试。 |
iot.messagebroker.NotFoundStateInShadowMessage | 设备影子中没有state信息。 | 请确保设备影子有state信息，然后重试。 |
iot.messagebroker.NotFoundVersionOrNullVersionValue | 缺少version信息或者version值为空。 | 请确保version值不为空，然后重试。 |
iot.messagebroker.NotMatchedProductKeyWithSrcTopicOwner | 消息源Topic对应的产品ProductKey不属于当前用户。 | 请确保Topic对应的产品属于当前用户，然后重试。 |
iot.messagebroker.NullMessageContent | 消息内容不能为空。 | 请确保消息内容不为空，然后重试。 |
iot.messagebroker.NullShadowMessage | 设备影子内容不能为空。 | 请确保设备影子内容不为空，然后重试。 |
iot.messagebroker.NullSrcTopicName | 消息源Topic名称不能为空。 | 请确保Topic名称不为空，然后重试。 |
iot.messagebroker.NullTopicName | Topic不能为空。 | 请确保Topic不为空，然后重试。 |
iot.messagebroker.NullTopicTemplateId | Topic类ID不能为空。 | 请确保Topic类ID不为空，然后重试。 |
iot.messagebroker.NullTopicTemplateOperation | Topic类的操作权限不能为空。 | 请确保Topic类的操作权限不为空，然后重试。 |
iot.messagebroker.OFFLINE | 由于设备离线导致失败。 | 请确保设备在线，然后重试。 |
iot.messagebroker.PublishMessageException | 发送消息过程出现异常。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.PublishMessageFailed | 发送消息失败。 | |
iot.messagebroker.QueryDeviceShadowActionError | 查询设备影子失败。 | |
iot.messagebroker.QueryProductTopicListActionError | 获取Topic类列表失败。 | |
iot.messageborker.QueryTopicReverseRouteTableListActionError | 获取消息反向路由列表（即消息源Topic列表）失败。 | |
iot.messageborker.QueryTopicRouteTableListActionError | 获取消息路由列表失败。 | |
iot.messagebroker.QueryTopicTemplateActionError | 查询Topic类失败。 | |
iot.messagebroker.QueryTopicTemplateException | 获取Topic类过程发生异常。 | |
iot.messagebroker.RateLimit | 由于限流导致失败。 | 请关注API调用频率，避免触发限流。限制说明，请参见使用限制。 |
iot.messagebroker.ReportInShadowMessageIsNotJson | 设备影子中的state信息中的report信息不是JSON格式。 | 请确保设备影子中的state信息中的report信息是JSON格式，然后重试。 |
iot.messagebroker.RrpcException | RRPC发送消息过程出现异常。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.RrpcFailed | RRPC发送消息失败。 | |
iot.messagebroker.ShadowMessageIsNotJson | 设备影子不是JSON格式。 | 请确保设备影子是JSON格式，然后重试。 |
iot.messagebroker.ShadowMessageLengthIsLarge | 设备影子的长度超过最大限制。 | 请确保设备影子的长度不超过最大限制，然后重试。 设备影子文档的大小限制16 KB。 |
iot.messagebroker.TIMEOUT | 由于超时导致失败。 | 请重试。 |
iot.messagebroker.TooManyElementInDesire | desire信息中包含的属性总数超过最大限定数。 | 请确保desire信息中包含的属性总数不超过最大限定数，然后重试。 设备影子JSON文档的属性数量限制为128个。 |
iot.messagebroker.TooManyElementInReport | report信息包含的属性总数超过限定最大数。 | 请确保report信息包含的属性总数不超过限定最大数，然后重试。 设备影子JSON文档的属性数量限制为128个。 |
iot.messagebroker.TopicAlreadyFound | 同一产品下Topic类名称重复。 | 请确保同一产品下Topic类名称不重复，然后重试。 |
iot.messagebroker.TopicTemplateCountExceedMax | 产品的Topic类数量超过最大值。 | 请确保产品的Topic类数量不超过最大值，然后重试。 一个产品最多可以定义50个Topic类。 |
iot.messagebroker.TopicTemplateIsNotFound | Topic类不存在。 | 请确保Topic类存在，然后重试。 可调用QueryProductTopic查看产品的Topic类。 |
iot.messagebroker.UpdateDeviceShadowMessageFailed | 更新设备影子失败。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.UpdateTopicTemplateException | 更新Topic类过程发生异常。 | |
iot.messagebroker.UpdateTopicTemplateFailed | 更新Topic类失败。 | |
iot.messagebroker.TooManyUserProperties | MQTT 5.0协议中，用户自定义属性个数超过最大限制（20个）。 | 请确保用户自定义属性个数不超过最大限制，然后重试。 |
iot.messagebroker.UserPropertyListExceedMaxLength | MQTT 5.0协议中，用户自定义属性总长度超过最大限制（8192个字符）。 | 请确保用户自定义属性总长度不超过最大限制，然后重试。 |
iot.messagebroker.InvalidUserProperty | MQTT 5.0协议中，用户自定义属性格式不合法。 | 请确保入参信息正确，然后重试。 |
iot.messagebroker.CorrelationDataNotBase64Encode | MQTT 5.0协议中，相关数据（Correlation Data）未进行Base64编码转换。 | 请确保相关数据进行Base64编码转换，然后重试。 |
iot.messagebroker.NullCorrelationData | MQTT 5.0协议中，相关数据（Correlation Data）为空。 | 请确保相关数据不为空，然后重试。 |
iot.messagebroker.CorrelationDataExceedMaxLength | MQTT 5.0协议中，相关数据长度超过最大限制（128个字符）。 | 请确保相关数据长度不超过最大限制，然后重试。 |
iot.messagebroker.InvalidMqttResponseTopic | MQTT 5.0协议中，响应主题（Response Topic）不合法。 | 请确保响应主题合法，然后重试。 |
规则引擎相关错误码
以iot.rule、iot.ruleng开头的错误码，及少部分iot.messagebroker开头的错误码，是规则引擎相关错误码。
提示出现异常或失败时，请确保入参信息正确，然后重试。
错误码 | 描述 | 解决方案 |
iot.rule.CreateRuleException | 创建规则过程发生异常。 | 请确保入参信息正确，然后重试。 |
iot.rule.DeleteRuleFailed | 删除规则失败。 | |
iot.rule.IncorrentRuleActionId | 规则动作ID错误。 | 可调用ListRuleActions查看规则动作ID，确保入参信息正确，然后重试。 |
iot.rule.IncorrentRuleActionType | 规则动作类型错误。 | 请确保入参信息正确，然后重试。 具体要求请参见CreateRuleAction的Type请求参数说明。 |
iot.rule.NullForwardDestForRule | 转发数据目的地不能为空。 | 转发数据目的地不能为空，请查看规则配置是否关联了数据目的。 Configuration中的具体配置方法，请参见CreateRuleAction。 |
iot.rule.NullSqlForRule | 规则的SQL语句不能为空。 | 请检查规则中的SQL配置，然后重试。 |
iot.rule.NotFoundRule | 规则不存在。 | 请输入正确的规则ID （RuleId），然后重试。 可调用ListRule查看账号下所有规则的RuleId。 |
iot.rule.NotFoundRuleAction | 规则动作不存在。 | 请输入正确的规则动作ID （ActionId），然后重试。 可调用ListRuleActions查看某个规则下的所有ActionId。 |
iot.rule.EmptyScript | 解析器的脚本配置为空。 | 请确认解析器脚本已保存提交，然后重试。 |
iot.rule.EmptyScriptDraft | 脚本草稿为空。 | 请确认入参信息正确，然后重试。 |
iot.rule.scriptSyntaxError | 脚本存在语法错误。 | |
iot.rule.DataSourceNotExists | 数据源不存在。 | |
iot.rule.DataSourceItemNotExists | 数据源Topic不存在。 | |
iot.rule.DestinationNotBound | 解析器未关联数据目的。 | 请确认解析器已关联数据目的，然后重试。 |
iot.rule.destinationNotExists | 流转目的不存在。 | 请确认数据目的ID正确，然后重试。 |
iot.rule.ParseRuleActionConfigError | 无法正常解析规则动作的配置。 | 请确保入参信息正确，然后重试。 |
iot.rule.QueryRuleActionListError | 查询规则动作列表失败。 | |
iot.rule.QueryRuleFailed | 查询解析器信息失败。 | |
iot.rule.QueryRulePageActionError | 分页获取规则列表失败。 | |
iot.rule.RuleActionIsAlreadyCreated | 已存在相同的规则动作。 | |
iot.rule.RuleCountExceedMax | 规则总数超过最大限制数。 | |
iot.rule.RuleNameIsAlreadyExisted | 规则名称已经存在。 | |
iot.rule.StartRuleFailed | 启动规则失败。 | 请查看规则配置是否正确，确保入参信息正确，然后重试。 |
iot.rule.StopRuleFailed | 停止规则失败。 | 请查看规则配置是否正确，确保入参信息正确，然后重试。 |
iot.rule.TooManyRuleAction | 规则动作数量超过最大限制。 | 请确保入参信息正确，然后重试。 一条规则中转发数据的操作不能超过10个。 |
iot.rule.UpdateRuleFailed | 更新规则失败。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.CreateRuleActionFailed | 创建规则动作失败。 | |
iot.ruleng.DeleteRuleActionFailed | 删除规则动作失败。 | |
iot.ruleng.IncorrectActionTypeForError | 错误流转的规则不支持此云产品。 | |
iot.ruleng.IncorrectRegionName | 中国内地节点只能流转到中国内地，海外节点只能流转到海外同一个节点。 | |
iot.ruleng.IncorrectSysTopic | 错误的基础通信Topic或物模型通信Topic。 | 请确保入参信息正确，然后重试。 请参见CreateRule指定正确的Topic。 |
iot.ruleng.IncorrectType | 应用规则的Topic类型错误。 TopicType支持的可选值：
| 请确保入参信息正确，然后重试。 |
iot.ruleng.InvalidEndpoint | 非法的接入点。 | |
iot.ruleng.InvalidFormattedTagInConfiguration | 参数Configuration中的tag过长。 | |
iot.ruleng.InvalidRamRole | 非法的RAM角色。 | 请登录RAM控制台查看角色信息，确保入参信息正确，然后重试。 |
iot.ruleng.ListInstancesError | 获取实例列表失败。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.OnlyAllowOneErrorAction | 一个规则只能设置一个错误转发目的地。 | |
iot.ruleng.QueryInstanceError | 获取实例信息失败。 | |
iot.ruleng.QueryRuleActionFailed | 获取规则动作失败。 | |
iot.ruleng.RegionNotSupportRuleForwardCloudProduct | 此地域不支持将规则转发到该云产品。 | 请确保入参信息正确，然后重试。 各地域支持转发的目标云产品，请参见地域和可用区。 |
iot.ruleng.RuleActionConfigurationIsNotJson | 规则动作配置不是JSON格式。 参数Configuration的值必须是正确的JSON格式。具体请参见CreateRuleAction。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.RuleAlreadyIsStarted | 规则是已启动状态。 | |
iot.ruleng.NullRamRoleArn | roleArn不能为空。 | |
iot.ruleng.NullRamRoleName | roleName不能为空。 | |
iot.ruleng.NullRuleActionConfig | 规则动作配置（参数Configuration）不能为空。 | |
iot.ruleng.NullRuleActionType | 规则动作类型（参数Type）不能为空。 | |
iot.ruleng.UpdateRuleActionFailed | 更新规则动作失败。 | |
iot.messagebroker.IncorrectRuleSql | 规则的SQL配置错误。 | 请根据CreateRule说明配置SQL，确保入参信息正确，然后重试。 |
iot.messagebroker.QueryRuleConfigActionException | 获取规则配置信息过程出现异常。 | 请确保入参信息正确，然后重试。 |
以下表格分别列举消息转发目标设置失败的特有错误码。
错误码 | 描述 | 解决方案 |
iot.messagebroker.InvalidFormattedTopicName | Topic格式错误。 | 可在控制台设备详情页的Topic列表页签下查看正确的Topic格式，确保入参信息正确，然后重试。 |
iot.prod.NotExistedProduct | 产品不存在。 | 请确保输入的ProductKey正确，且该产品属于当前阿里云账号，确保入参信息正确，然后重试。 |
iot.common.QueryProductActionError | 查询产品失败。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.IncorrectSysTopic | 错误的基础通信Topic或物模型通信Topic。 请参见CreateRule指定正确的Topic。 | |
iot.messagebroker.NullTopicName | Topic名称不能为空。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.EmptySchemaNameOfTopic | 目标DataHub Topic的Schema的名称name值不能为空。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.EmptySchemaTypeOfTopic | 目标DataHub Topic的Schema的类型type值不能为空。 | |
iot.ruleng.EmptySchemaValueOfTopic | 目标DataHub Topic的Schema值value不能为空。 | |
iot.ruleng.IncorrectRegionName | regionName值错误。 | |
iot.ruleng.IncorrectSchemaValueOfTopic | 目标DataHub Topic的Schema值错误。 | |
iot.ruleng.NullOrEmptySchemaOfTopic | 目标DataHub Topic的Schema不能为空。 | |
iot.ruleng.NullProjectOfDatahub | DataHub的projectName不能为空。 | |
iot.ruleng.NullTopicInDatahubProject | DataHub产品下的project中topicName不能为空。 | |
iot.ruleng.NotFoundProjectInDataHub | DataHub中不存在此项目（project）。 请在DataHub中确认项目名称是否正确。 | |
iot.ruleng.NotFoundTopicInDataHubProject | DataHub的project中不存在此Topic。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.NullOtsInstanceName | 表格存储的实例名称不能为空。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.NullTableNameInOtsInstance | 表格存储中实例的表名不能为空。 | |
iot.ruleng.NullPrimaryKeyInOtsTable | 表格存储中表的主键不能为空。 | |
iot.ruleng.NullPrimaryKeyNameInOts | 主键的名称不能为空。 | |
iot.ruleng.NullPrimaryKeyTypeInOts | 主键的类型不能为空。 | |
iot.ruleng.NullPrimaryKeyValueInOts | 主键的值不能为空。 | |
iot.ruleng.IncorrectPrimaryKeyValueInOtsTable | 表格存储中主键值错误。 | 请在表格存储中，查看您创建数据表时定义的主键，确保入参信息正确，然后重试。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.NullTopicNameInMns | 消息服务中的Topic不能为空。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.NotFoundTopicInMns | 消息服务中不存在此Topic。 请在消息服务中，确认主题（Topic）名称。 | 请在消息服务中，确认主题（Topic）名称，确保入参信息正确，然后重试。 |
iot.ruleng.QueryMnsTopicListActionError | 获取消息服务Topic列表失败。 | 请确保入参信息正确，然后重试。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.NullServiceNameInFc | 函数计算服务名称为空。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.NullFunctionNameInFc | 函数计算函数名称为空。 | |
iot.ruleng.NotFoundServiceInFc | 函数计算服务不存在。 | 请在函数计算中，确认正确的服务名称，确保入参信息正确，然后重试。 |
错误码 | 描述 | 解决方案 |
iot.messagebroker.NullTopicName | 消息队列中接收消息的Topic不能为空。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.InstanceNotFound | 实例不存在。 | |
iot.ruleng.ListMqTopicsError | 获取消息队列Topic失败。 | |
iot.ruleng.TopicIsNotUnique | Topic不唯一。 | |
iot.ruleng.TopicNotFound | Topic不存在。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.InvalidFormattedTagNameInHitsdb | TSDB标签格式非法。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.InvalidFormattedTimestampInHitsdb | 时间戳格式非法。 | |
iot.ruleng.NotBindCustomerVpc | 当前实例未绑定用户的VPC。 | |
iot.ruleng.NullInstanceNameInHitsdb | TSDB实例名称为空。 | |
iot.ruleng.NullTagNameInHitsdb | TSDB标签名称为空。 | |
iot.ruleng.NullTagValueInHitsdb | TSDB标签值为空。 | |
iot.ruleng.NullTimestampInHitsdb | 时间戳标签为空。 | |
iot.ruleng.OnlySameRegionHitsdbSupport | 只支持转发到同节点的TSDB。 |
错误码 | 描述 | 解决方案 |
iot.ruleng.GrantVpcInstanceFailed | VPC实例授权失败。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.InvalidFormattedConnectionIp | 连接IP格式错误。 | |
iot.ruleng.InvalidFormattedConnectionPort | 连接端口格式错误。 | |
iot.ruleng.InvalidFormattedRdsDatabaseName | RDS数据库名称包含非法字符。 | |
iot.ruleng.InvalidFormattedRdsTableName | RDS表名称包含非法字符。 | |
iot.ruleng.ListRdsAccountError | 获取RDS数据库账号失败。 | |
iot.ruleng.NotFoundTable | RDS数据库表不存在。 | |
iot.ruleng.NotFoundVpcInstance | VPC实例不存在。 | |
iot.ruleng.NotFoundVpcInstanceConnection | 找不到RDS的VPC路径。 | 请确保您的RDS实例配置好了VPC网络及VPC网络交换机，然后重试。 |
iot.ruleng.NotMatchedField | RDS数据库表字段不匹配。 | 请确保入参信息正确，然后重试。 |
iot.ruleng.NullConnectionIp | 连接IP为空。 | |
iot.ruleng.NullConnectionPort | 连接端口为空。 | |
iot.ruleng.NullRdsInstanceName | RDS实例名称为空。 | |
iot.ruleng.NullRdsDatabaseName | RDS数据库名称为空。 | |
iot.ruleng.NullRdsAccountName | 账号名称为空。 | |
iot.ruleng.NullRdsPassword | 账号密码为空。 | |
iot.ruleng.NullRdsTableName | RDS表名称为空。 | |
iot.ruleng.NullRdsFieldName | RDS字段名称为空。 | |
iot.ruleng.NullRdsFieldValue | RDS字段值为空。 | |
iot.ruleng.NullVpcInstance | VPC实例不能为空。 | |
iot.ruleng.OnlySupportSameRegionRds | 只支持转发到同节点的RDS。 | |
iot.ruleng.QueryServerMappingInfoError | 获取VPC实例的mapping信息失败。 |
服务端订阅相关错误码
以iot.consumer开头的错误码为服务端订阅相关错误码。
错误码 | 描述 | 解决方案 |
iot.consumer.group.CallbackTypeEmpty | CallbackType不能全为false。 | 请确保入参信息正确，然后重试。 |
iot.consumer.group.ChangeDefaultConsumerGroupNotAllowed | 不能修改默认消费组。 | |
iot.consumer.group.ConsumerGroupExceedsLimit | 订阅关系下消费组数量超过限制。 | |
iot.consumer.group.ConsumerGroupExceedLimit | 消费组数量超过最大限制。 | |
iot.consumer.group.ConsumerGroupNameExisted | 消费组名称已存在。 | |
iot.consumer.group.ConsumerGroupNotExist | 消费组不存在。 | |
iot.consumer.group.CreateConsumerGroupFailed | 添加消费组失败。 | |
iot.consumer.group.DeleteConsumerGroupFailed | 删除消费组失败。 | |
iot.consumer.group.InvalidConsumerGroupName | 非法的消费组名称。 | |
iot.consumer.group.InvalidConsumerGroupId | 非法的消费组ID。 | |
iot.consumer.group.InvalidConsumerGroup | 消费组非法。 | |
iot.consumer.group.InvalidGroupBy | 参数groupby非法。 | |
iot.consumer.group.InvalidSubscribeType | 订阅类型非法。 | |
iot.consumer.group.MnsCheckFailed | MNS鉴权失败。 | |
iot.consumer.group.MnsNotSupport | 设备转移的产品不支持MNS订阅。 | |
iot.consumer.group.ProductKeyExceedsLimit | 消费组订阅的产品超过限制。 | |
iot.consumer.group.QueryConsumerGroupStatusFailed | 查询消费组状态失败。 | |
iot.consumer.group.UpdateConsumerGroupFailed | 更新消费组失败。 | |
iot.consumer.group.SubscribeNotExist | MNS或AMQP服务端订阅不存在。 |
OTA升级相关错误码
以iot.firmware、iot.ota开头的错误码为OTA升级相关错误码。
错误码 | 描述 | 解决方案 |
iot.firmware.AlreadyExistedFirmwareName | 同名的OTA升级包已经存在。 | 请传入新的升级包名称，然后重试。 |
iot.firmware.AlreadyExistedFirmwareVersion | 产品下已存在该OTA升级包版本。 | 请传入新的升级包版本，然后重试。 |
iot.firmware.BadlyFormattedGrayPercent | 灰度比例的格式不正确。 | 请确保入参信息正确，然后重试。 |
iot.firmware.BatchCancelDeviceUpgradeFailed | 取消设备升级失败。 | 请提交工单。 |
iot.firmware.BlankFirmwareName | OTA升级包名称只包含空格。 | 请确保入参信息正确，然后重试。 |
iot.firmware.CancelOTAStrategyByJobFailed | 取消动态批次所关联的动态升级策略失败。 | 请提交工单。 |
iot.firmware.CancelOTATaskByJobFailed | 取消批次下设备升级失败。 | |
iot.firmware.CancelOptionIsMandatory | 未指定取消参数。 | 请确保入参信息正确，然后重试。 |
iot.firmware.CancelUpgradeTaskFailed | 取消升级批次失败 | 请提交工单。 |
iot.firmware.CreateFirmwareFailure | 创建OTA升级包失败。 | |
iot.firmware.CreateOTAUpgradeJobFailure | 创建批量升级任务失败。 | |
iot.firmware.DeleteFirmwareFailure | 删除OTA升级包失败。 | |
iot.firmware.DeviceUpgradeRecordNotFound | 设备没有处在升级过程中。 | 请确认升级作业处于升级过程中，确保入参信息正确，然后重试。 |
iot.firmware.DeviceWithDestinationVersionInArray | 设备版本号与目标版本号相同。 | 请确认是否有已升级成功的设备。 |
iot.firmware.DynamicGrayNotSupported | 不支持动态灰度升级。 | 该功能目前不支持。 |
iot.firmware.DynamicSpecificNotSupported | 不支持动态定向升级。 | |
iot.firmware.EmptyFirmwareFile | OTA升级包文件大小为0。 | 请确保上传的升级包文件正确，然后重试。 |
iot.firmware.FireTimeMustLargeThanCurrentTime | 定时升级时间必须大于当前时间。 | 请确保入参信息正确，然后重试。 |
iot.firmware.FireTimeTooLate | 定时升级时间距当前时间不能大于7天。 | |
iot.firmware.FireTimeTooShort | 定时升级时间距当前时间不能小于5分钟。 | |
iot.firmware.FirmwareAndProductKeyMismatch | OTA升级包与产品ProductKey不匹配 | |
iot.firmware.FirmwareCountExceedMax | OTA升级包数量超过最大值500。 | 请删除不再使用的升级包，然后重试。 |
iot.firmware.FirmwareDescriptionExceedMaxLength | OTA升级包描述字符个数超过100。 | 请确保入参信息正确，然后重试。 |
iot.firmware.FirmwareNotFound | OTA升级包不存在。 | |
iot.firmware.FirmwareNotVerified | 未完成OTA升级包验证，无法发起升级。 | 请先验证升级包成功，然后重试。 |
iot.firmware.GenerateOTAUploadURLFailure | 生成升级包上传URL失败。 | 请确保入参信息正确，然后重试。 |
iot.firmware.GrayAppliesToStaticOnly | 只有静态升级才允许灰度升级。 | |
iot.firmware.InProgressDynamicJobExisted | 已存在执行中的动态批次。 | 一个升级包下只能发起一次动态升级，请取消已发起的动态升级批次，然后重试。 |
iot.firmware.InProgressVerifyJobExisted | 存在未完成的验证OTA升级包任务。 | 请先完成已发起的验证升级包任务，再发起升级包验证。 |
iot.firmware.IncorrectDeviceUpgradeJobStatus | 待取消的设备升级记录状态错误。 | 升级记录无法被取消，请确认升级记录是否处于升级过程中。 |
iot.firmware.IncorrectFormattedFirmwareName | OTA升级包名称格式错误。 | 请确保入参信息正确，然后重试。 |
iot.firmware.IncorrectFormattedFirmwareVersion | OTA升级包版本格式非法。 | |
iot.firmware.IncorrectFormattedModuleName | 模块名格式错误。 | |
iot.firmware.IncorrectFormattedSrcVersion | 起始版本格式非法。 | |
iot.firmware.InvalidDynamicMode | 动态升级模式不正确。 | |
iot.firmware.InvalidFirmware | 无效的OTA升级包。 | |
iot.firmware.InvalidFirmwareId | OTA升级包ID不正确。 | |
iot.firmware.InvalidFirmwareSign | 无效的OTA升级包签名值。 | |
iot.firmware.InvalidFirmwareSignMethod | 无效的OTA升级包签名方法。 | |
iot.firmware.InvalidFirmwareSize | 无效的OTA升级包大小。 | |
iot.firmware.InvalidFirmwareType | 无效的OTA升级包类型。 | |
iot.firmware.InvalidFirmwareUrl | OTA升级包资源链接地址不是合法的物联网平台OTA升级包地址。 | |
iot.firmware.InvalidGenerateOTAUploadURLParam | 生成升级包上传URL的参数非法。 | |
iot.firmware.InvalidGrayPercent | 无效的灰度比例。 | |
iot.firmware.InvalidMaximumPerMinute | 无效的推出速率。 | |
iot.firmware.InvalidOTAJobId | 批次ID不正确。 | |
iot.firmware.InvalidOTATaskId | 升级记录ID不正确。 | |
iot.firmware.InvalidOverwriteMode | 覆盖模式不正确。 | |
iot.firmware.InvalidProductKey | 无效的产品ProductKey。 | |
iot.firmware.InvalidRetryCount | 自动重试次数不正确。 | |
iot.firmware.InvalidRetryInterval | 自动重试时间间隔不正确。 | |
iot.firmware.InvalidSelectionType | 选择类型不正确。 | |
iot.firmware.InvalidTargetSelection | 目标选择不正确。 | |
iot.firmware.InvalidTaskStatus | 升级记录状态不正确。 | |
iot.firmware.InvalidTimeoutSetting | 无效的超时设置 | |
iot.firmware.JobAlreadyCanceled | 批次已经取消。 | |
iot.firmware.JobHasNoScheduleTime | 批次不是定时批次。 | |
iot.firmware.ListOTAFirmwareFailed | 获取OTA升级包列表失败。 | |
iot.firmware.ListOTAJobFailed | 查询升级批次列表失败。 | |
iot.firmware.ListOTAModuleFailed | 查询模块列表失败。 | |
iot.firmware.ListOTAModuleNameByProductFailed | 查询产品下模块列表失败。 | |
iot.firmware.ListOTATaskByDeviceFailed | 查询设备下的升级记录失败。 | |
iot.firmware.ListOTATaskByJobFailed | 查询批次下的升级记录失败。 | |
iot.firmware.MalformedFirmwareUrl | OTA升级包资源链接地址不是合法的URL。 | |
iot.firmware.ModuleCountLimitExceeded | 模块数量超过了最大限制。 | |
iot.firmware.ModuleNameReserved | 使用了被保留的模块名，请选择其它模块名。 | |
iot.firmware.MoreThanOneSrcVersion | 差分OTA升级包批量升级只允许指定一个源版本。 | |
iot.firmware.NoDeviceCanUpgrade | 未找到可升级的设备。 | 请确认设备是否已升级成功。 |
iot.firmware.NonVersionedDeviceInArray | 设备数组参数中存在未上报或上报非法版本号的设备。 | 请确保入参信息正确，然后重试。 |
iot.firmware.NotDynamicJob | 只允许取消动态批次所关联的动态升级策略。 | |
iot.firmware.NullFirmwareId | OTA升级包ID为空。 | |
iot.firmware.NullFirmwareName | OTA升级包名称为空。 | |
iot.firmware.NullFirmwareUrl | OTA升级包资源链接地址为空。 | |
iot.firmware.NullFirmwareVersion | OTA升级包版本为空。 | |
iot.firmware.NullGrayPercent | 灰度升级的灰度比例为空。 | |
iot.firmware.NullOTAJobId | 批次ID为空。 | |
iot.firmware.NullSelectionType | 选择类型为空。 | |
iot.firmware.NullSrcVersions | 待升级版本号列表为空。 | |
iot.firmware.NullTargetDeviceNames | 静态定向升级的设备范围为空。 | |
iot.firmware.NullTargetSelection | 目标选择为空。 | |
iot.firmware.NullTaskId | 批次ID为空。 | |
iot.firmware.ParameterSizeExceedMax | 列表个数超过最大数量。 | |
iot.firmware.ReUpgradeFailedFirmwareNotVerified | 未完成OTA升级包验证，无法发起重升级。 | |
iot.firmware.ScheduleFinishTimeEarlierThanStartTime | 指定定时结束时间必须晚于定时开始时间。 | |
iot.firmware.ScheduleFinishTimeTooEarly | 定时升级结束时间距开始时间不能小于60分钟。 | |
iot.firmware.ScheduleFinishTimeTooLate | 定时升级结束时间距开始时间不能大于30天。 | |
iot.firmware.ScheduleFinishTimeWithoutStartTime | 指定定时结束时间必须同时指定定时开始时间。 | |
iot.firmware.SrcDestVersionMatched | 起始版本与目标版本相同。 | |
iot.firmware.SrcVersionIsMandatory | 差分包未指定起始版本。 | |
iot.firmware.SrcVersionMismatch | 设备当前的版本与OTA升级包待升级版本不一致。 | |
iot.firmware.SrcVersionsNotAllowed | 不允许指定源版本列表。 | |
iot.firmware.SrcVersionsSizeExceedMax | 源版本列表大小超过最大数量。 | |
iot.firmware.SystemBusy | 系统繁忙，请稍后重试。 | 若重试仍不能解决，请提交工单。 |
iot.firmware.SystemBusyForScheduleTime | 系统繁忙，请修改定时升级时间。 | |
iot.firmware.TargetDeviceNamesNotAllowed | 不允许指定静态定向升级的设备。 | 请确保入参信息正确，然后重试。 |
iot.firmware.TooManyDeviceUpgrade | 发起升级的设备数量过多，请稍后重试。 | 请确保入参信息正确，间隔一分钟后重试。 |
iot.firmware.TooManyDeviceUpgradeForScheduleTime | 指定的定时升级时间发起升级的设备数量过多，请修改定时升级时间。 | |
iot.firmware.UpgradeSrcVersionMismatch | 升级源版本与差分OTA升级包源版本不一致。 | 请确保入参信息正确，然后重试。 |
iot.firmware.VerifyFirmwareFailed | 验证OTA升级包失败。 | 请提交工单。 |
iot.firmware.InvalidOTATaskId | 请求参数中的TaskId不存在。 | 请确保入参信息正确，然后重试。 |
iot.firmware.InvalidTaskStatus | TaskId对应的设备升级作业，不处于未确认状态。 | |
iot.firmware.JobTagIsTooLong | 创建升级批次任务中，标签字符总数超出限制（4096个字符）。 | |
iot.firmware.JobTagKeyInvalid | 创建升级批次任务中，标签Key不合法。 | |
iot.firmware.JobTagValueInvalid | 创建升级批次任务中，标签Value不合法。 | |
iot.firmware.JobTagTooMany | 创建升级批次任务中，标签 | |
iot.ota.PackageFileAmountExceed | 创建升级包请求中，升级包文件数量超过限制（20个）。 | |
iot.ota.PackageFileParamConflict | 创建升级包请求中，升级包文件相关参数有冲突。即单个文件和多文件相关参数不能同时设置。 | |
iot.ota.PackageFileNameDuplicated | 创建升级包请求中，多个升级包文件的名称重复。 | |
iot.ota.PackageFileUrlDuplicated | 创建升级包请求中，多个升级包文件的URL重复。 | |
iot.ota.PackageFileSignDuplicated | 创建升级包请求中，多个升级包文件的签名值重复。 | |
iot.ota.tag.KeyDuplicated | 标签列表的Key重复。 | |
iot.ota.CreateOTAModuleFailure | 创建OTA模块的过程中产生异常。 | 请提交工单。 |
iot.ota.CreateOTAModuleParamError | 创建OTA模块的请求中参数错误。 | 请确保入参信息正确，然后重试。 |
iot.ota.CreateOTAModuleExceedLimit | 产品下的OTA模块数超过了限制。 | 请删除不用的模块，然后重试。 |
iot.ota.CreateOTAModuleNameExist | 创建OTA模块的名称重复。 | 请确保传入的模块名称与已有模块名称不重复，然后重试。 |
iot.ota.UpdateOTAModuleFailure | 更新OTA模块的过程中产生异常。 | 请提交工单。 |
iot.ota.UpdateOTAModuleParamError | 更新OTA模块的请求中参数错误。 | 请确保入参信息正确，然后重试。 |
iot.ota.DeleteOTAModuleParamError | 删除OTA模块的请求中参数错误。 | |
iot.ota.DeleteOTAModuleFailure | 删除OTA模块的过程中产生异常。 | |
iot.ota.DeleteOTAModulePackageExist | 有升级包的OTA模块不能被删除。 | |
iot.ota.DeleteOtaDefaultModule | 默认模块不能被删除。 | |
iot.ota.ListOTAModuleParamError | 查询OTA模块列表的请求中参数错误。 | |
iot.ota.ListOTAModuleFailure | 查询OTA模块列表的过程中产生异常。 | |
iot.ota.OTAModuleNotExist | 删除或更新OTA模块时报错：产品下的OTA模块不存在。 | |
iot.ota.TooManyOtaTask | 请求参数TaskId.N的TaskId个数，已超出最大限制。 | |
iot.ota.TaskIdIsNull | 请求参数TaskId.N不能为空。 | |
iot.ota.ConfirmNotAllowedNow | 当前时间，设备不可升级，不能对待确认状态的设备升级作业，进行确认。 | |
iot.ota.EmptyDeviceInfoParams | 请求参数中，设备信息不能为空。 | |
iot.ota.InvalidOtaModuleName | 请求参数中，OTA模块名称的格式不合法。 | |
iot.ota.GroupNotExist | 设备分组不存在。 请确保入参信息正确，然后重试。 | |
iot.ota.DynamicGroupExpressionInvalid | 发起OTA升级时，动态分组对应的规则中模块名称和模块版本必须同时存在。 | |
iot.ota.DynamicGroupTaskCountExceedLimit | 动态分组对应的升级批次数超过限制（5个）。 | |
iot.ota.UpgradeDeviceCountExceedLimit | 发起的升级设备数超过限制。 限制说明，请参见使用限制的OTA升级。 | 请提交工单。 |
iot.ota.GroupUpgradeTenantInvalid | 当前阿里云账号发起的分组升级不合法。 请确保入参信息正确，然后重试。 | 请确保入参信息正确，然后重试 |
iot.ota.GroupTypeInvalid | 分组升级中，传入的分组类型无效。 请确保入参信息正确，然后重试。 | |
iot.firmware.VerifyFirmwareNoNeed | 当前升级包不需要验证。 | |
iot.ota.DownloadProtocolInvalid | 当前批次任务中的升级包下载协议不合法。 | |
iot.ota.DownloadProtocolMqttNotSuitable | 当前批次任务不支持使用MQTT协议下载升级包。 | |
iot.ota.DynamicGroupConflict | 基于动态分组发起的新升级批次与该分组对应的存量动态升级批次相比，OverwriteMode和MultiModuleMode的设置不一致。 | |
iot.ota.OverWriteAndMultiModuleConflict | OverwriteMode为2和MultiModuleMode为true，不能同时生效。 | |
iot.ota.dynamicGroupForbiddenInDefaultInstance | 旧版公共实例下设备不支持动态分组升级。 | 旧版公共实例不支持动态分组功能。 |
iot.ota.multiModuleModeForbiddenInDefaultInstance | 旧版公共实例下设备不支持多模块同时升级功能。 | 旧版公共实例不支持多模块同时升级功能。 |
iot.ota.InvalidTaskExist | 升级作业列表中至少包含了一个不是升级失败或取消的升级作业。 | 请确保入参信息正确，然后重试。 |
iot.ota.UnmatchedJob | 升级批次ID和升级作业ID不匹配。 | |
iot.ota.JobCanceled | 升级批次任务已被取消。 | |
iot.ota.InvalidJobId | 升级批次ID不存在。 | |
iot.ota.InvalidFirmwareUid | 升级包不存在。 | |
iot.ota.InvalidTaskId | 升级作业ID不存在。 | |
iot.ota.FailedTaskNotFound | 升级批次下没有升级失败或取消的升级作业。 | |
iot.ota.DeviceNotReUpgraded | 没有可以重新升级的设备。 | |
iot.ota.DeviceNotExist | 设备不存在。 | 请确保传入的设备信息正确，然后重试。 |
iot.ota.FirmwareNotVerified | 升级包未验证完成，无法发起重新升级。 | 请先进行升级包验证完成，然后重试。 |
iot.ota.NotFirmwareOwner | 当前用户不是升级包拥有者。 | 该用户没有权限操作该接口。 请确保入参信息正确，然后重试。 |
寄雁传书服务相关错误码
以iot.deviceprint开头的错误码为寄雁传书服务相关错误码。
错误码 | 描述 | 解决方案 |
iot.deviceprint.ProjectNotFound | 项目不存在。 | 请确保设备已关联到寄雁传书项目，然后重试。 |
iot.deviceprint.ProjectHasStopped | 项目已停用。 | 请确保设备所属的项目状态为启用，然后重试。 |
iot.deviceprint.InvalidDevice | 无效的打印设备。 | 请确保入参IotId、ProductKey、DeviceName正确，然后重试。 |
iot.deviceprint.DeviceNotActived | 打印设备未激活。 | 请确保设备连接过物联网平台，然后重试。 |
iot.deviceprint.DeviceOffline | 打印设备已离线。 | 请确保设备已连接到物联网平台，然后重试。 |
iot.deviceprint.RequestLimit | 请求次数过多被限流，请稍后重试。 | 请确保开通服务的打印服务调用TPS规格大于实际的用量，然后重试。 |
iot.printservice.NotSigned | 寄雁传书服务未开通。 | 请确保开通寄雁传书服务，然后重试。 |
iot.deviceprint.PrintingTemplateNotExists | 打印模板不存在。 | 请确保入参TemplateBizCode正确，然后重试。 |
iot.deviceprint.PrintingParamsError | 打印参数错误。 | 请确保入参ParamsJsonString正确，然后重试。 |
iot.deviceprint.UnknownResponse | 未知的打印设备响应。 | 请确保设备回复的打印响应格式正确，然后重试。 |
iot.deviceprint.MismatchingPrintId | 打印ID不匹配。 | 请确保设备回复的打印ID正确，然后重试。 |
数据服务相关错误码
错误码 | 描述 | 解决方案 |
iot.dap.noServeJobExit | 数据服务API对应的任务不存在。 | 请确保入参信息正确，然后重试。 |
iot.dap.serveApiPathRepetition | 服务API接口地址重复，即传入ApiPath已存在。 | |
iot.dap.serveApiInvalidParam | 调用服务API的参数检查不通过。 | |
iot.dap.serveApiPublishStatusError | 请先通过测试后，再发布任务。 | |
iot.dap.serveApiDeleteStatusError | 已发布的任务不可删除。 | |
iot.dap.serveApiPublishedNotEditable | 已发布的任务不可编辑。 | |
iot.dap.folderHasServeApiPublished | 存在已发布的服务API，不可删除文件夹。 | |
iot.dap.serveApiNoPublished | 服务API不在发布状态，无法回滚。 | |
iot.dap.duplicateTableNameError | 资源表名称重复。 | |
iot.dap.serveApiAlreadyPublished | 服务API已发布。 | |
iot.dap.serveApiPathIsEmpty | 服务API接口地址不能为空。 | |
iot.dap.serveApiSqlTemplateError | SQL模板信息异常，请校验并更新后，再尝试调用服务。 | |
iot.dap.serveApiSqlInvokeParamError | SQL参数错误，类型与值不匹配。 | |
iot.dap.syncStartPipelineError | 任务启动失败。 | |
iot.dap.methodTimeout | 接口调用超时。 |