Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Error responses will contain a human readable message about what happened, but will also contain a numeric code describing the type of error.  The following list provides an enumeration of these values with a bit of detail about the error type they represent.

Error code grouping and enumeration

Error CodeDescriptionNumeric Value

General Errors

Unknown Cause
GENERIC_ERRORUnable to match error to a more specific error code

1000

Protocol Errors
VALUE_ENCODING_ERRORRequest data can not be decoded, or unable to encode response1100
UNSUPPORTED_VERSIONServer is unable to process the given protocol version1101
UNSUPPORTED_OPERATIONTarget is unable to handle the given operation type1102
UNSUPPORTED_AUTHENTICATION_MODEServer doesn't support the requested authentication mode1103
HANDSHAKE_REQUIREDProtocol handshake has not yet been performed for this connection1104
Authentication Errors
AUTHENTICATION_FAILEDUnable to authenticate the client1200
AUTHORIZATION_FAILEDClient isn't authorized to run the attempted request1201
ALREADY_AUTHENTICATEDClient is trying to authenticate after already having done so1202
AUTHENTICATION_NOT_SUPPORTEDClient is trying to authenticate on a server that doesn't support authentication1203
Server Errors
LOW_MEMORYServer did not have enough memory to run the request1300
DATA_UNREACHABLEServer was unable to access the system containing the requested data1301
OPERATION_TIMEOUTServer was unable to complete the operation quickly enough1302

Operation Failures

Generic Operation Errors
CONSTRAINT_VIOLATIONRequest parameters did not match system requirements2000
BAD_QUERYRequest is malformed or is of an unknown type2001
Region Errors
REGION_NOT_FOUNDRequest is attempting to access a region which doesn't exist on the server2100
Query Specific Errors
QUERY_PARAMETER_MISMATCHQuery request does not match the expected number of parameters2200
QUERY_BIND_FAILUREParameters are not of the correct type2201
QUERY_NOT_PERMITTEDQuery is not allowed on the target region2202
QUERY_TIMEOUTQuery did not complete in time2203

The client will receive error codes from the server. The following definitions will provide more details to the error code and its relating server component.

Error codes will be split according to functional area. This means that error codes that are specific to a functional area will be defined by its API.

The functional area codes are defined on the API's page.

Error codes defined per functional area

Exception Type
ErrorCode
AUTHENICATION_REQUIRED_EXCEPTION1
AUTHORIZATION_FAILED_EXCEPTION2
AUTHETICATIONFAILED_EXCEPTION3
BUCKET_MOVED_EXCEPTION4
SERIALIZATION_EXCEPTION5
INTERRUPTED_EXCEPTION6
ILLEGAL_ARGUMNET_EXCEPTION7
ILLEGAL_STATE_EXCEPTION8
TIMEOUT_EXCEPTION9
CACHE_WRITER_EXCEPTION10
REGION_EXIST_EXCEPTION11
REGION_NOT_EXIST_EXCEPTION12
LEASE_EXPIRED_EXCEPTION13
CACHE_LOADER_EXCEPTION14
REGION_DESTROYED_EXCEPTION15
ENTRY_DESTROYED_EXCEPTION16
ENTRY_NOT_FOUND_EXCEPTION17
FUNCTION_NOT_FOUND_EXCEPTION18
FUNCTION_ATTRIBUTE_MISMATCH_EXCEPTION19
FUNCTION_EXECUTION_EXCEPTION20
CONCURRENT_MODIFICATION_EXCEPTION21
UNKNOWN_EXCEPTION22
CLASS_CAST_EXCEPTION23
GEODE_IO_EXCEPTION24
NULL_POINTER_EXCEPTION25
ENTRY_EXIST_EXCEPTION26
DISK_ACCESS_EXCEPTION27
QUERY_EXCEPTION28
CACHE_CLOSED_EXCEPTION29
MESSAGE_FORMAT_EXCEPTION30
CACHE_LISTENER_EXCEPTION31
CQ_EXCEPTION32
CQ_CLOSED_EXCEPTION33
CQ_QUERY_EXCEPTION34
CQ_EXIST_EXCEPTION35
CQ_INVALID_EXCEPTION36
INVALID_DELTA_EXCEPTION37
TRANSACTION_EXCEPTION38
TRANSACTION_DATA_NODE_DEPARTED_EXCEPTION39
TRANSACTION_REBALANCED_EXCEPTION40
COMMIT_CONFLICT_EXCEPTION41
PUTALL_PARTIAL_RESULT_EXCEPTION42