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 Code | Description | Numeric Value |
---|---|---|
General Errors | ||
Unknown Cause | ||
GENERIC_ERROR | Unable to match error to a more specific error code | 1000 |
Protocol Errors | ||
VALUE_ENCODING_ERROR | Request data can not be decoded, or unable to encode response | 1100 |
UNSUPPORTED_VERSION | Server is unable to process the given protocol version | 1101 |
UNSUPPORTED_OPERATION | Target is unable to handle the given operation type | 1102 |
UNSUPPORTED_AUTHENTICATION_MODE | Server doesn't support the requested authentication mode | 1103 |
HANDSHAKE_REQUIRED | Protocol handshake has not yet been performed for this connection | 1104 |
Authentication Errors | ||
AUTHENTICATION_FAILED | Unable to authenticate the client | 1200 |
AUTHORIZATION_FAILED | Client isn't authorized to run the attempted request | 1201 |
ALREADY_AUTHENTICATED | Client is trying to authenticate after already having done so | 1202 |
AUTHENTICATION_NOT_SUPPORTED | Client is trying to authenticate on a server that doesn't support authentication | 1203 |
Server Errors | ||
LOW_MEMORY | Server did not have enough memory to run the request | 1300 |
DATA_UNREACHABLE | Server was unable to access the system containing the requested data | 1301 |
OPERATION_TIMEOUT | Server was unable to complete the operation quickly enough | 1302 |
Operation Failures | ||
Generic Operation Errors | ||
CONSTRAINT_VIOLATION | Request parameters did not match system requirements | 2000 |
BAD_QUERY | Request is malformed or is of an unknown type | 2001 |
Region Errors | ||
REGION_NOT_FOUND | Request is attempting to access a region which doesn't exist on the server | 2100 |
Query Specific Errors | ||
QUERY_PARAMETER_MISMATCH | Query request does not match the expected number of parameters | 2200 |
QUERY_BIND_FAILURE | Parameters are not of the correct type | 2201 |
QUERY_NOT_PERMITTED | Query is not allowed on the target region | 2202 |
QUERY_TIMEOUT | Query did not complete in time | 2203 |
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 Codes for Functional Area |
---|
Authentication Specific Error Codes |
...
Error Code Definition | ErrorCode |
---|---|
SERIALIZATION_EXCEPTION | 1 |
INTERRUPTED_EXCEPTION | 2 |
ILLEGAL_ARGUMNET_EXCEPTION | 3 |
ILLEGAL_STATE_EXCEPTION | 4 |
TIMEOUT_EXCEPTION | 5 |
LEASE_EXPIRED_EXCEPTION | 6 |
FUNCTION_NOT_FOUND_EXCEPTION | 7 |
FUNCTION_ATTRIBUTE_MISMATCH_EXCEPTION | 8 |
FUNCTION_EXECUTION_EXCEPTION | 9 |
UNKNOWN_EXCEPTION | 10 |
CLASS_CAST_EXCEPTION | 11 |
GEODE_IO_EXCEPTION | 12 |
NULL_POINTER_EXCEPTION | 13 |
DISK_ACCESS_EXCEPTION | 14 |
QUERY_EXCEPTION | 15 |
CACHE_CLOSED_EXCEPTION | 16 |
MESSAGE_FORMAT_EXCEPTION | 17 |
CQ_EXCEPTION | 18 |
CQ_CLOSED_EXCEPTION | 19 |
CQ_QUERY_EXCEPTION | 20 |
CQ_EXIST_EXCEPTION | 21 |
CQ_INVALID_EXCEPTION | 22 |
INVALID_DELTA_EXCEPTION | 23 |
TRANSACTION_EXCEPTION | 24 |
TRANSACTION_DATA_NODE_DEPARTED_EXCEPTION | 25 |
TRANSACTION_REBALANCED_EXCEPTION | 26 |
COMMIT_CONFLICT_EXCEPTION | 27 |
...
Error Description | Error Code |
---|---|
PUTALL_PARTIAL_RESULT_EXCEPTION | 1 |
REGION_EXIST_EXCEPTION | 2 |
REGION_NOT_EXIST_EXCEPTION | 3 |
REGION_DESTROYED_EXCEPTION | 4 |
ENTRY_DESTROYED_EXCEPTION | 5 |
ENTRY_NOT_FOUND_EXCEPTION | 6 |
ENTRY_EXIST_EXCEPTION | 7 |
CACHE_WRITER_EXCEPTION | 8 |
CACHE_LISTENER_EXCEPTION | 9 |
CACHE_LOADER_EXCEPTION | 10 |
BUCKET_MOVED_EXCEPTION | 11 |
CONCURRENT_MODIFICATION_EXCEPTION | 12 |
...
Description | Error Code |
---|---|
AUTHENICATION_REQUIRED_EXCEPTION | 1 |
AUTHORIZATION_FAILED_EXCEPTION | 2 |
AUTHETICATIONFAILED_EXCEPTION | 3