Error codes

Updated at:

This topic lists the error codes that are returned when an API call to Alibaba Cloud Link WAN fails. The error codes are organized by category. Common error codes can be returned by any API operation.

Some rows in the following tables list more than one error code, with the last one in bold. The bold error codes are not used in the current public preview of the platform but will replace the other error codes in the future. You must handle all listed error codes to ensure compatibility.

Error code Description
MissingParameter A required parameter is missing.
InvalidName, IllegalName The name is invalid. Some API operations require you to pass in name fields. This code is returned if the name is invalid.
InvalidParameter, IllegalParameter The parameter is invalid.
NotResourceOwner, NonExistent, Nonexistent The resource that you want to operate on does not exist, or the current account does not own the resource.
ForbiddenByRam, UnqualifiedRamAccount The current account is a RAM user and is not granted the RAM permissions to call this API operation.
Abandoned The API operation that you called is delisted and no longer supported.
InternalError An internal error or exception occurred in Alibaba Cloud Link WAN.
CloudProductNotActivated, UnqualifiedAccount The Alibaba Cloud Link WAN service is not activated for the current account.
FeatureNotActivated, UnactivatedFeature The platform feature involved in the current operation is not activated for the user account.
ResourceLocked, LockedResource The resource is locked by a special mechanism and the operation cannot be performed.
InvalidFreqBandPlan, InvalidFrequencyBandPlan The parameters contain an invalid frequency band ID.

Gateway management error codes

Error code Description
GwEuiDuplicated, DuplicatedGwEui A gateway with the same GwEUI already exists.
GatewayTupleAlreadyAbandoned, IotHubTripleMissing, InvalidGwEui The GwEUI is invalid.
InvalidPinCode The gateway PIN code authentication failed.
TooManyPinCodeVerificationFailures, FrequentInvalidPinCode The current operation failed because the frequency of PIN code authentication failures is too high.
GatewayAlreadyBoundToOthers, OwnedByOther The gateway has been added by another Alibaba Cloud user.
ExceedGatewayLimit, ReachedGatewayLimit The number of added gateways has reached the upper limit.

Join permission management error codes

Error code Description
JoinPermissionNameDuplicated, DuplicatedJoinPermissionName Failed to create the dedicated join permission because the specified name is the same as that of an existing permission.
ExceedLocalJoinPermissionLimit, ReachedLocalJoinPermissionLimit The number of created dedicated join permissions has reached the upper limit.
JoinPermissionAlreadyAuthorized, AuthorizedJoinPermission The operation failed because the dedicated join permission has been granted to a tenant.
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission The operation failed because the join permission has been associated with a node group.

Error codes related to join permission authorization, acceptance, and requests

Error code Description
JoinPermissionNameDuplicated, DuplicatedJoinPermissionName Failed to request the universal join permission because the specified name is the same as that of an existing permission.
ExceedRoamingJoinPermissionLimit, ReachedRoamingJoinPermissionLimit The number of requested universal join permissions has reached the upper limit.
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission The operation failed because the join permission has been associated with a node group.
JoinPermissionAlreadyAuthorized, AuthorizedJoinPermission The operation failed because the join permission has been granted.
RenterDoesNotExist, InvalidJoinPermissionRenter The operation failed because the tenant account for the join permission is invalid.
TooManyRenterNonExistentFailures, FrequentInvalidJoinPermissionRenter The current operation was denied due to frequent "invalid tenant account for the permission" errors. Try again later.
IllegalOrderStateTransition Illegal state transition for the join permission authorization ticket.

Node group management error codes

Error code Description
NodeGroupNameDuplicated, DuplicatedNodeGroupName The node group name already exists.
ExceedNodeLimit, ReachedNodeLimit The operation failed because the number of added nodes has reached the service limit for the current user.
NodeGroupDoesNotExist, NonexistentNodeGroup The specified node group does not exist.
NodeGroupAlreadyBoundJoinPermission, PermittedToJoinAlready The operation failed because the node group has been associated with a join permission.
JoinPermissionDoesNotExist, NonexistentJoinPermission The operation failed because the specified join permission does not exist.
JoinPermissionAlreadyBoundNodeGroup, EngagedJoinPermission The operation failed because the join permission has been associated with a node group.
NodeDoesNotExist, InvalidDevEui The DevEUI is invalid.
DevEuiDuplicated, ExistentNode The target node is already in the current group.
NodeAlreadyAdded, DuplicatedDevEui A node with the same DevEUI already exists in another group.
OwnedByOther The node has been added by another Alibaba Cloud user.
InvalidPinCode The node PIN code authentication failed.
TooManyPinCodeVerificationFailures, FrequentInvalidPinCode The current operation failed because the frequency of PIN code authentication failures is too high.

Multicast management error codes

Error code Description
MulticastAddressAssignmentFailed Failed to assign the multicast address.
MulticastKeyGenerationFailed Failed to generate the multicast key.
MulticastGroupBoundNodesIsNotEmpty, NonemptyMulticastGroup The operation failed because the multicast group contains nodes.
ExceedMaxMulticastNodesBoundCount, ReachedMulticastGroupCapacity The number of nodes in the group has reached the capacity limit.

Lab gateway management error codes

Error code Description
ExceedLabGatewayLimit, ReachedLabGatewayLimit The operation failed because the number of lab gateways in use has reached the upper limit.
BoundLabNodesIsNotEmpty, AssociatedWithNodes The operation failed because the lab gateway is associated with lab nodes.

Lab node management error codes

Error code Description
ExceedLabNodeLimit, ReachedLabNodeLimit The operation failed because the number of lab nodes in use has reached the upper limit.
LabGatewayDoesNotExist, NonexistentLabGateway The operation failed because the specified lab gateway does not exist.

Gateway security tuple error codes

Error code Description
ExceedGatewayTupleLimit, ReachedGatewayTupleLimit The number of requested gateway security tuples has reached the upper limit.

Node security tuple error codes

Error code Description
ExceedNodeTupleLimit, ReachedNodeTupleLimit The operation failed because the number of requested node security tuples has reached the upper limit.
ExceedMaxNodeTuplesRequiredCount, ReachedMaximumTuplesForRequest The number of requested node security tuples exceeds the limit for a single request.
IllegalStateTransition, IllegalOrderStateTransition Illegal state transition for the node security tuple ticket.
KpmPublicKeyUnregistered, MissingProductLineKey The public key for the secure production line service is not registered.
KpmKeysGenerationFailed, ProductLineServiceError An error occurred when the secure production line service generated the security tuples.
KpmOrderNotReady, KpmNodeTupleOrderNotReady, PendingTupleOrder The operation failed because the secure production line ticket is still being processed.