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.

...

Error Code Definition
ErrorCode
SERIALIZATION_EXCEPTION1
INTERRUPTED_EXCEPTION2
ILLEGAL_ARGUMNET_EXCEPTION3
ILLEGAL_STATE_EXCEPTION4
TIMEOUT_EXCEPTION5
LEASE_EXPIRED_EXCEPTION6
FUNCTION_NOT_FOUND_EXCEPTION7
FUNCTION_ATTRIBUTE_MISMATCH_EXCEPTION8
FUNCTION_EXECUTION_EXCEPTION9
UNKNOWN_EXCEPTION10
CLASS_CAST_EXCEPTION11
GEODE_IO_EXCEPTION12
NULL_POINTER_EXCEPTION13
DISK_ACCESS_EXCEPTION14
QUERY_EXCEPTION15
CACHE_CLOSED_EXCEPTION16
MESSAGE_FORMAT_EXCEPTION17
CQ_EXCEPTION18
CQ_CLOSED_EXCEPTION19
CQ_QUERY_EXCEPTION20
CQ_EXIST_EXCEPTION21
CQ_INVALID_EXCEPTION22
INVALID_DELTA_EXCEPTION23
TRANSACTION_EXCEPTION24
TRANSACTION_DATA_NODE_DEPARTED_EXCEPTION25
TRANSACTION_REBALANCED_EXCEPTION26
COMMIT_CONFLICT_EXCEPTION27

...

Error DescriptionError Code
PUTALL_PARTIAL_RESULT_EXCEPTION1
REGION_EXIST_EXCEPTION2
REGION_NOT_EXIST_EXCEPTION3
REGION_DESTROYED_EXCEPTION4
ENTRY_DESTROYED_EXCEPTION5
ENTRY_NOT_FOUND_EXCEPTION6
ENTRY_EXIST_EXCEPTION7
CACHE_WRITER_EXCEPTION8
CACHE_LISTENER_EXCEPTION9
CACHE_LOADER_EXCEPTION10
BUCKET_MOVED_EXCEPTION11
CONCURRENT_MODIFICATION_EXCEPTION12

...

3
Description
Error Code
AUTHENICATION_REQUIRED_EXCEPTION1
AUTHORIZATION_FAILED_EXCEPTION2
AUTHETICATIONFAILED_EXCEPTION