错误码

本文分类型列举调用物联网络管理平台 API 出错时，返回的错误码。其中公共错误码为所有 API 方法都有可能返回的错误。

以下表格中的某些行包含一个以上错误码，其中最后一个为粗体。粗体的错误码在目前公测版的平台不存在，但今后会取代非粗体的错误码。对于云端开发者而言，建议的合理做法是同时处理这些错误码。

错误码	描述
MissingParameter	缺少必要的参数。
InvalidName, IllegalName	名称不合法（部分 API 方法需要调用者传入某些“名称”字段，若这些名称字段不合法，则会返回此码）。
InvalidParameter, IllegalParameter	存在非法参数。
NotResourceOwner, NonExistent, Nonexistent	操作的资源不存在，或当前账号不是所要操作的资源的拥有者。
ForbiddenByRam, UnqualifiedRamAccount	当前账号是子账号，但没有获得调用此 API 方法的 RAM 授权。
Abandoned	调用的 API 方法已经下架，不再支持。
InternalError	物联网络管理平台内部错误或异常。
CloudProductNotActivated, UnqualifiedAccount	当前账号没有开通物联网络管理平台服务。
FeatureNotActivated, UnactivatedFeature	用户账号没有开通当前操作所涉及的平台功能。
ResourceLocked, LockedResource	操作的资源被某种特殊机制锁定，操作无法进行。
InvalidFreqBandPlan, InvalidFrequencyBandPlan	参数中出现了无效的频段（频段 Id）。

网关管理错误码

错误码	描述
GwEuiDuplicated, DuplicatedGwEui	相同 GwEUI 的网关已经存在。
GatewayTupleAlreadyAbandoned, IotHubTripleMissing, InvalidGwEui	无效的 GwEUI。
InvalidPinCode	网关 PIN Code 验证失败。
TooManyPinCodeVerificationFailures, FrequentInvalidPinCode	由于 PIN Code 验证失败的频率过高，导致当前操作失败。
GatewayAlreadyBoundToOthers, OwnedByOther	该网关已经被其他阿里云用户录入。
ExceedGatewayLimit, ReachedGatewayLimit	录入的网关数量已经到达接入上限。

入网凭证管理错误码

错误码	描述
JoinPermissionNameDuplicated, DuplicatedJoinPermissionName	创建专用入网凭证时，使用的凭证名称与现有的凭证重复，创建失败。
ExceedLocalJoinPermissionLimit, ReachedLocalJoinPermissionLimit	创建的专用入网凭证数量已经到达上限。
JoinPermissionAlreadyAuthorized, AuthorizedJoinPermission	由于当前操作涉及的专用入网凭证已经授权给某个租户，导致操作失败。
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission	由于操作的入网凭证已经与某个节点分组建立了关联，导致当前操作失败。

入网凭证授权、受权、申请相关错误码

错误码	描述
JoinPermissionNameDuplicated, DuplicatedJoinPermissionName	申请泛在入网凭证时，使用的凭证名称与现有的凭证重复，申请失败。
ExceedRoamingJoinPermissionLimit, ReachedRoamingJoinPermissionLimit	申请的泛在入网凭证数量已经到达上限。
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission	由于操作的入网凭证已经与某个节点分组建立了关联，导致当前操作失败。
JoinPermissionAlreadyAuthorized, AuthorizedJoinPermission	由于入网凭证已经被授权，导致当前操作失败。
RenterDoesNotExist, InvalidJoinPermissionRenter	由于当前操作涉及的入网凭证租户账号无效，导致操作失败。
TooManyRenterNonExistentFailures, FrequentInvalidJoinPermissionRenter	因为过于频繁的触发“凭证租户账号无效”错误，导致当前操作被拒绝，请过一段时间再尝试。
IllegalOrderStateTransition	非法的入网凭证授权工单状态迁移。

节点分组管理错误码

错误码	描述
NodeGroupNameDuplicated, DuplicatedNodeGroupName	节点分组名称已经存在。
ExceedNodeLimit, ReachedNodeLimit	由于录入的节点数量已经到达当前用户的服务上限，导致操作失败。
NodeGroupDoesNotExist, NonexistentNodeGroup	操作涉及的节点分组不存在。
NodeGroupAlreadyBoundJoinPermission, PermittedToJoinAlready	由于当前操作涉及的节点分组已经与某个入网凭证建立了关联，导致操作失败。
JoinPermissionDoesNotExist, NonexistentJoinPermission	由于当前操作涉及的入网凭证不存在，导致操作失败。
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission	由于当前操作涉及的入网凭证已经与某个节点分组建立了关联，导致操作失败。
NodeDoesNotExist, InvalidDevEui	无效的 DevEUI。
DevEuiDuplicated, ExistentNode	当前分组已经包含了目标节点。
NodeAlreadyAdded, DuplicatedDevEui	相同 DevEUI 的节点已经存在于其他分组。
OwnedByOther	该节点已经被其他阿里云用户录入。
InvalidPinCode	节点 PIN Code 验证失败。
TooManyPinCodeVerificationFailures, FrequentInvalidPinCode	由于 PIN Code 验证失败的频率过高，导致当前操作失败。

组播管理错误码

错误码	描述
MulticastAddressAssignmentFailed	组播地址分配失败。
MulticastKeyGenerationFailed	组播密钥生成失败。
MulticastGroupBoundNodesIsNotEmpty, NonemptyMulticastGroup	由于当前操作涉及的组中存在节点，导致操作失败。
ExceedMaxMulticastNodesBoundCount, ReachedMulticastGroupCapacity	组中的节点数量达到组容量上限。

实验室网关管理错误码

错误码	描述
ExceedLabGatewayLimit, ReachedLabGatewayLimit	由于使用的实验室网关数量已经到达上限，当前操作失败。
BoundLabNodesIsNotEmpty, AssociatedWithNodes	由于当前操作涉及的实验室网关绑定了一些实验节点，导致操作失败。

实验室节点管理错误码

错误码	描述
ExceedLabNodeLimit, ReachedLabNodeLimit	由于使用的实验室节点数量已经到达上限，当前操作失败。
LabGatewayDoesNotExist, NonexistentLabGateway	由于当前操作涉及的实验网关不存在，导致操作失败。

网关安全元组错误码

错误码	描述
ExceedGatewayTupleLimit, ReachedGatewayTupleLimit	申请的网关安全元组数量已经到达上限。

节点安全元组错误码

错误码	描述
ExceedNodeTupleLimit, ReachedNodeTupleLimit	由于申请的节点安全元组数量已经到达上限，导致当前操作失败。
ExceedMaxNodeTuplesRequiredCount, ReachedMaximumTuplesForRequest	请求的节点安全元组数量超过单次请求的上限。
IllegalStateTransition, IllegalOrderStateTransition	非法的节点安全元组工单状态迁移。
KpmPublicKeyUnregistered, MissingProductLineKey	安全产线服务的公钥未注册。
KpmKeysGenerationFailed, ProductLineServiceError	安全产线服务在生成安全元组时发生错误。
KpmOrderNotReady, KpmNodeTupleOrderNotReady, PendingTupleOrder	由于当前操作涉及的安全产线工单尚在处理中，导致操作失败。