zookeeper
Apache ZooKeeper Errors
Error codes returned by Apache ZooKeeper. Each code corresponds to a KeeperException subclass thrown when a ZooKeeper operation fails.
23 codes
references zookeeper.apache.org/doc/current/apidocs/zookeeper-server/org/apache/zookeeper/KeeperException.Code.htmlgithub.com/apache/zookeeper/blob/master/zookeeper-server/src/main/java/org/apache/zookeeper/KeeperException.java
· All codes 23 codes
- AUTHFAILED Auth Failed Authentication failed. The authentication scheme was found but the supplied credentials were rejected by the server. The connection is closed after this error.
- BADARGUMENTS Bad Arguments Invalid arguments were passed to the operation, such as a null path, a path that does not start with a slash, or an empty string where a non-empty value is required.
- BADVERSION Bad Version The version specified in the request does not match the current version of the node. This optimistic-locking error is returned by setData and delete when the expected version number does not match the node's actual version.
- CLOSING Closing The ZooKeeper client is in the process of closing. This is returned for operations submitted after close() has been called.
- CONNECTIONLOSS Connection Loss The client's connection to the ZooKeeper ensemble was lost before the operation could complete. The operation may or may not have been applied; clients should check the node state before retrying.
- DATAINCONSISTENCY Data Inconsistency A data inconsistency was detected. This is an internal server error indicating the server's data may be in an inconsistent state.
- INVALIDACL Invalid ACL The supplied ACL list is invalid or malformed. Check that each ACL entry specifies a valid scheme, valid credentials for that scheme, and a valid permission bit mask.
- INVALIDCALLBACK Invalid Callback The callback object provided to an asynchronous operation is invalid or null.
- MARSHALLINGERROR Marshalling Error An error occurred while serialising or deserialising data. This typically indicates a bug in the client library or incompatible versions between client and server.
- NOAUTH No Auth The client is not authenticated and the requested operation requires authentication. Add authentication credentials to the ZooKeeper session using addAuthInfo before attempting the operation.
- NOCHILDRENFOREPHEMERALS No Children for Ephemerals Ephemeral znodes cannot have children. Attempting to create a child node under an ephemeral node returns this error; restructure the data model to use persistent parent nodes.
- NODEEXISTS Node Exists A node already exists at the specified path. Returned when attempting to create a znode that already exists (without the PERSISTENT_SEQUENTIAL or EPHEMERAL_SEQUENTIAL flags).
- NONODE No Node The specified node does not exist. Returned by read, delete, or set-data operations when the target znode path has not been created.
- NOTEMPTY Not Empty The node has children and cannot be deleted. Use a recursive delete operation or remove all children first.
- NOTREADONLY Not Read Only A state-changing request was sent to a server that is operating in read-only mode. This occurs when the ensemble has lost quorum and a server is serving reads only.
- OPERATIONTIMEOUT Operation Timeout The operation did not complete within the configured timeout period. This is a client-side error indicating the response was not received in time; the operation may have been applied on the server.
- RECONFIGDISABLED Reconfig Disabled Dynamic reconfiguration is disabled on this ensemble. Enable it via the reconfigEnabled=true option in the ZooKeeper configuration before issuing reconfig commands.
- RUNTIMEINCONSISTENCY Runtime Inconsistency A runtime inconsistency was detected within the ZooKeeper server. This is an internal error that usually requires investigation of server logs.
- SESSIONEXPIRED Session Expired The client session has been expired by the server, typically because the client failed to send a heartbeat within the session timeout window. The client must create a new ZooKeeper handle to reconnect; ephemeral nodes owned by the expired session have been deleted.
- SESSIONMOVED Session Moved The client session has moved to a different server. This can happen during a ZooKeeper ensemble reconfiguration; the client should reconnect and retry.
- SYSTEMERROR System Error A system-level error occurred in the ZooKeeper server. This is a catch-all for internal server errors and usually indicates a problem on the server side rather than with the client request.
- THROTTLEDOP Throttled Op The request was throttled by the server because the server is under heavy load. The client should back off and retry after a delay.
- UNIMPLEMENTED Unimplemented The requested operation is not implemented by this server version. This is typically returned when a newer client attempts an operation against an older ZooKeeper ensemble.