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

系统错误码

iot.system开头的错误码为系统相关错误码。

错误码(Code) 描述
iot.system.SystemException 系统异常。

请稍后重试。

公共错误码

iot.common开头的错误码为公共错误码。

错误码(Code) 描述
iot.common.InvalidTenant 不合法的租户。

请确认阿里云账号信息和账号权限。

iot.common.InvalidParam 请求参数异常。

请确认入参信息是否正确,然后重试。

iot.common.AuthActionPermissionDeny 鉴权失败。

原因可能是入参的资源信息不属于当前账号。请确认AccessKey信息和资源信息。

iot.common.RamActionPermissionDeny 没有资源访问控制(RAM)权限。

请参见子账号授权文档

iot.common.HighFrequentDeny 请求太频繁。

请稍后重试。

iot.common.ParameterSizeLimit 请求参数大小超过限制。

请确认入参信息是否正确,然后重试。

边缘实例(Instance)相关错误码

iot.edge.Instance开头的错误码为边缘实例相关错误码。

错误码(Code) 描述
iot.edge.InstanceNotExist 边缘实例不存在。

请确认边缘实例ID或名称,然后重试。

iot.edge.InstanceNameExist 边缘实例名称已存在。

边缘实例名称不能重复。请重新设置边缘实例名称。

iot.edge.InstanceNumLimitation 边缘实例数量超过限制。

一个阿里云账号下最多可有10万个边缘实例。

iot.edge.InstanceAlreadyBindGateway 边缘实例已绑定网关。
iot.edge.InstanceIsRunning 边缘实例正在运行。
iot.edge.InstanceHasDevice 边缘实例中还有设备。

当边缘实例中有子设备时,不能删除边缘实例,需先移除子设备。

iot.edge.InstanceHasNoGateway 边缘实例缺少网关。

请调用BindGatewayToEdgeInstance接口,为边缘实例绑定网关。

iot.edge.InstanceDeviceLimitation 边缘实例子设备数量超过限制。

每个边缘实例中最多可以分配1000个子设备。

iot.edge.InstanceGatewayLimitation 边缘实例网关数量超过限制。
  • 产品规格为专业版或轻量版的边缘实例中,只可绑定1个网关。
  • 产品规格为标准版的边缘实例中,最多可绑定2个网关。
iot.edge.InstanceDriverLimitation 边缘实例驱动数量超过限制。

每个边缘实例最多可以分配30个驱动。

iot.edge.InstanceHasDriver 边缘实例中还有驱动。

当边缘实例中有驱动时,不能删除边缘实例,需先移除驱动。

iot.edge.InstanceHasSameNameDriver 边缘实例中已有同名驱动。

边缘实例中分配的驱动,不允许重名。

iot.edge.InstanceAuthorized 该边缘实例已授权给其他用户,不支持删除或修改。

网关(Gateway)相关错误码

iot.edge.Gateway开头的错误码为网关相关错误码。

错误码(Code) 描述
iot.edge.GatewayNotExist 网关不存在。

请确认网关是否已被删除。

iot.edge.GatewayDisable 网关已禁用。

请确认网关当前的运行状态。

iot.edge.GatewayInactive 网关未激活。

请先激活网关,然后重试。

iot.edge.GatewayOffline 网关已下线。

请确认网关当前的运行状态。

iot.edge.GatewayNotBindToInstance 网关不在边缘实例中。

请确认网关名称是否正确,或者请先将该网关绑定到边缘实例中。

iot.edge.GatewayAlreadyBindToInstance 网关已绑定到边缘实例。
iot.device.DeviceNotGateway 设备不是网关类型。

请替换为网关类型的设备。

子设备(Device)相关错误码

iot.edge.Device开头的错误码为网关下子设备相关错误码。

错误码(Code) 描述
iot.edge.DeviceAlreadyBindToInstance 设备已绑定到边缘实例。
iot.edge.DeviceNotBindToInstance 设备不在边缘实例中。

请确认设备名称是否正确,或者请先将该设备分配到边缘实例中。

iot.edge.DeviceNumLimitation 边缘实例中子设备数量超过限制。

一个边缘实例中最多可以分配1000个子设备。

iot.edge.DeviceInactive 设备未激活。
iot.edge.DeviceDebugDisable 设备不在线,无法调试。

请上线设备后,重新调试。

iot.edge.DeviceNotMatchDriverProtocol 设备和驱动协议不匹配。

请确认设备的接入网关协议是否与驱动通信协议匹配。

iot.edge.DeviceAlreadyAttachOtherDriver 设备已关联其它驱动。

同一个网关下的设备只能关联同一个驱动。

iot.edge.DeviceNotAttachDriver 必须先给设备关联驱动。

设备必须关联驱动后才可以分配到边缘实例。

iot.edge.DeviceNotAttachSameDriver 批量设置设备配置时,设备不在同一个驱动下。

同一个驱动下的设备,才允许批量设置设备配置。

iot.edge.DeviceConfigIllegal 设备配置中的参数设置不符合要求。

请确认入参信息是否正确,然后重试。

iot.device.NotExistedDevice 设备不存在。

请确认设备名称,或者替换为物联网平台中已有的设备,然后重试。

iot.device.DeviceAlreadyBindToOtherInstance 设备已绑定到其它边缘实例。

请替换为其它未绑定到边缘实例的网关子设备。

iot.device.DeviceNotSubDevice 设备不是子设备类型。

请替换设备,或者新建一个节点类型网关子设备的产品并添加设备。详细说明请参见CreateProduct

iot.device.Disabled 设备已禁用。

驱动(Driver)相关错误码

iot.driveriot.edge.driveriot.edge.Driver开头的错误码为驱动相关错误码。

错误码(Code) 描述
iot.edge.DriverNotExist 驱动不存在。

请确认入参信息是否正确,然后重试。

iot.edge.DriverNumLimitation 自研驱动数量超过限制。

一个阿里云账号下,在物联网平台边缘计算 > 驱动管理中最多可以存在50个自定义驱动。

iot.edge.DriverNameProtocolRuntimeCpuArchMustBeUnique 驱动的名称、通信协议类型、驱动语言、CPU架构该四项参数全部与已有的驱动参数一致。

两个驱动之间,驱动名称、通信协议类型、驱动语言、CPU架构该四项参数中至少必须有一项参数是不同值。例如,两个驱动的名称相同、驱动语言都为C语言、通信协议类型都为modbus,那么CPU架构不可以相同。

iot.edge.DriverVersionNotExist 驱动版本不存在。

请确认驱动版本,然后重试。

iot.edge.DriverVersionAlreadyExist 驱动版本已存在。

请设置其他驱动版本,然后重试。

iot.edge.DriverOssContentNotExist 根据传入的OSS存储地址未找到该驱动代码。

OSS链接对应的内容不存在,请检查是否已经将文件上传至OSS。

iot.edge.DriverVersionLimitation 驱动版本数量超出限制。

一个驱动最多允许添加10个版本。

iot.edge.DriverHasReleasedVersion 驱动有已发布的版本。

删除驱动时,若驱动下存在已发布的版本,则该驱动不允许删除。

iot.edge.DriverVersionAlreadyBindToInstance 驱动版本已绑定到边缘实例中。

删除驱动时,若驱动版本已绑定到边缘实例中,则该驱动不允许删除。

iot.edge.DriverVersionHasBeenReleased 驱动版本已发布,无法重复发布。
iot.edge.DriverAlreadyBindToInstance 驱动已经和实例绑定。
iot.edge.DriverNotBindToInstance 驱动不在边缘实例中。

请先绑定驱动到边缘实例,然后重试。

iot.edge.DriverHasDevice 驱动下还有子设备。

边缘实例中的驱动若已关联子设备,则无法解绑驱动和当前边缘实例。请移除子设备后重试。

iot.edge.DriverConfigIllegal 驱动配置格式不符合要求。

请调整格式后重试。

iot.edge.ReleasedVersionCannotBeDeletedOrModified 已发布的驱动版本无法被删除或修改。
iot.edge.PurchasedDriverCannotAccessUnreleasedVersion 无法查看已购驱动未发布的版本。

请先发布驱动版本,然后重试。

部署边缘实例相关错误码

iot.edge.deploy开头的错误码为部署边缘实例相关错误码。

错误码(Code) 描述
iot.edge.deploySheetAlreadyExist 当前边缘实例部署单尚未完成。

部署该边缘实例的指令还在执行中,请稍后重试。

iot.edge.deploySheetAlreadyFinish 当前不存在未完成的边缘实例部署单。
iot.edge.deploySheetNotExist 边缘实例部署单不存在。

请确认入参信息是否正确,然后重试。