本文档列举调用物联网边缘计算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 | 边缘实例网关数量超过限制。
|
| 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.driver、iot.edge.driver和iot.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 | 边缘实例部署单不存在。
请确认入参信息是否正确，然后重试。 |