文档

错误码

更新时间:

本文档列举调用物联网平台API出错时,返回的错误信息。入参数据格式错误、超出限定值、入参缺少必需参数等错误修改,请参见具体API文档的请求参数描述。

系统错误码

iot.systemiot.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.commoniot.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_senioriothub

请确保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.deviceIot.Deviceiot.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值,与您调用的对应接口(BatchCheckDeviceNamesBatchImportDevice)返回的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是否合法。

可调用QueryDeviceDetailQueryDevice查看正确的IotId值,或用ProductKeyDeviceName组合代替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

设备不存在。

传入的设备IotIdProductKeyDeviceName值错误。请调用QueryDeviceDetailQueryDevice查看正确值。

请登录物联网平台控制台,查询设备信息,检查设备是否存在。

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

请求参数JobIdDevice不能同时为空。

请确保入参信息正确,然后重试。

iot.job.ListTaskParamDeviceInfoInvalid

请求参数Device中设备信息不合法。

productKeydeviceName不能同时为空。

iot.job.GenerateFileUploadUrlFailed

生成文件上传URL失败。

iot.job.ParamsError

参数异常。

iot.job.JobInvokeServiceSidError

设备批量服务调用任务中,JobDocumentserviceIdentifier参数错误。

iot.job.JobSetPropertyParamsError

设备批量属性设置任务中,JobDocumentparams参数错误。

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均不能为空。多个标签以英文逗号间隔。如,[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]

iot.group.TagCountExceedMax

标签数量超过最大值。

每个分组最多可有100个标签。

删除不需要的标签,然后重试。

iot.group.GroupCountExceedMax

分组数量超过最大值。

  • 一个分组最多可包含100个子分组。

  • 一个设备最多可以被添加到10个分组中。

删除无用的子分组或者分组中无用的设备,然后重试。

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.ruleiot.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支持的可选值:

  • 0:基础通信Topic或物模型通信Topic。

  • 1:自定义Topic。

  • 2:设备状态消息Topic。

请确保入参信息正确,然后重试。

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.firmwareiot.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

创建升级批次任务中,标签Key:Value对个数超出限制(10个)。

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

基于动态分组发起的新升级批次与该分组对应的存量动态升级批次相比,OverwriteModeMultiModuleMode的设置不一致。

iot.ota.OverWriteAndMultiModuleConflict

OverwriteMode2MultiModuleModetrue,不能同时生效。

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

无效的打印设备。

请确保入参IotIdProductKeyDeviceName正确,然后重试。

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

接口调用超时。