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 |