public enum ServerError extends java.lang.Enum<ServerError> implements com.google.protobuf.ProtocolMessageEnum
The canonical server error codes for the Kurrent Platform gRPC APIs. These errors represent common failure modes across all Kurrent services.Protobuf enum
kurrent.rpc.ServerError| Enum Constant and Description |
|---|
SERVER_ERROR_ACCESS_DENIED
Authentication or authorization failure.
|
SERVER_ERROR_BAD_REQUEST
The request is malformed or contains invalid data.
|
SERVER_ERROR_NOT_LEADER_NODE
The server is not the cluster leader and cannot process write operations.
|
SERVER_ERROR_OPERATION_TIMEOUT
The operation did not complete within the configured timeout period.
|
SERVER_ERROR_SERVER_MALFUNCTION
An internal server error occurred.
|
SERVER_ERROR_SERVER_NOT_READY
The server is starting up or shutting down and cannot process requests.
|
SERVER_ERROR_SERVER_OVERLOADED
The server is temporarily overloaded and cannot accept more requests.
|
UNRECOGNIZED |
UNSPECIFIED
Default value.
|
| Modifier and Type | Field and Description |
|---|---|
static int |
SERVER_ERROR_ACCESS_DENIED_VALUE
Authentication or authorization failure.
|
static int |
SERVER_ERROR_BAD_REQUEST_VALUE
The request is malformed or contains invalid data.
|
static int |
SERVER_ERROR_NOT_LEADER_NODE_VALUE
The server is not the cluster leader and cannot process write operations.
|
static int |
SERVER_ERROR_OPERATION_TIMEOUT_VALUE
The operation did not complete within the configured timeout period.
|
static int |
SERVER_ERROR_SERVER_MALFUNCTION_VALUE
An internal server error occurred.
|
static int |
SERVER_ERROR_SERVER_NOT_READY_VALUE
The server is starting up or shutting down and cannot process requests.
|
static int |
SERVER_ERROR_SERVER_OVERLOADED_VALUE
The server is temporarily overloaded and cannot accept more requests.
|
static int |
UNSPECIFIED_VALUE
Default value.
|
| Modifier and Type | Method and Description |
|---|---|
static ServerError |
forNumber(int value) |
static com.google.protobuf.Descriptors.EnumDescriptor |
getDescriptor() |
com.google.protobuf.Descriptors.EnumDescriptor |
getDescriptorForType() |
int |
getNumber() |
com.google.protobuf.Descriptors.EnumValueDescriptor |
getValueDescriptor() |
static com.google.protobuf.Internal.EnumLiteMap<ServerError> |
internalGetValueMap() |
static ServerError |
valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) |
static ServerError |
valueOf(int value)
Deprecated.
Use
forNumber(int) instead. |
static ServerError |
valueOf(java.lang.String name)
Returns the enum constant of this type with the specified name.
|
static ServerError[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final ServerError UNSPECIFIED
Default value. This value is not used. An error code MUST always be set to a non-zero value. If an error code is not explicitly set, it MUST be treated as an internal server error (INTERNAL).
UNSPECIFIED = 0;public static final ServerError SERVER_ERROR_ACCESS_DENIED
Authentication or authorization failure. The client lacks valid credentials or sufficient permissions to perform the requested operation. Common causes: - Missing or invalid authentication tokens - Insufficient permissions for the operation - Expired credentials Client action: Check credentials, verify permissions, and re-authenticate if necessary. Not retriable without fixing the underlying authorization issue.
SERVER_ERROR_ACCESS_DENIED = 1 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_BAD_REQUEST
The request is malformed or contains invalid data. The server cannot process the request due to client error. Common causes: - Invalid field values (e.g., empty required fields, out-of-range numbers) - Malformed data formats - Validation failures Client action: Fix the request data and retry. Not retriable without modifying the request.
SERVER_ERROR_BAD_REQUEST = 2 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_NOT_LEADER_NODE
The server is not the cluster leader and cannot process write operations. In a clustered deployment, only the leader node can accept write operations. Common causes: - Client connected to a follower node - Leader election in progress - Network partition Client action: Redirect the request to the leader node indicated in the error details. Retriable after redirecting to the correct leader node.
SERVER_ERROR_NOT_LEADER_NODE = 5 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_OPERATION_TIMEOUT
The operation did not complete within the configured timeout period. Common causes: - Slow disk I/O during writes - Cluster consensus delays - Network latency - Heavy server load Client action: Retry with exponential backoff. Consider increasing timeout values. Retriable - the operation may succeed on retry.
SERVER_ERROR_OPERATION_TIMEOUT = 6 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_SERVER_NOT_READY
The server is starting up or shutting down and cannot process requests. Common causes: - Server is initializing (loading indexes, recovering state) - Server is performing graceful shutdown - Server is performing maintenance operations Client action: Retry with exponential backoff. Wait for server to become ready. Retriable - the server will become available after initialization completes.
SERVER_ERROR_SERVER_NOT_READY = 7 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_SERVER_OVERLOADED
The server is temporarily overloaded and cannot accept more requests. This is a backpressure mechanism to prevent server overload. Common causes: - Too many concurrent requests - Resource exhaustion (CPU, memory, disk I/O) - Rate limiting triggered Client action: Retry with exponential backoff. Reduce request rate. Retriable - the server may accept requests after load decreases.
SERVER_ERROR_SERVER_OVERLOADED = 8 [(.kurrent.rpc.error) = { ... }public static final ServerError SERVER_ERROR_SERVER_MALFUNCTION
An internal server error occurred. This indicates a bug or unexpected condition in the server. Common causes: - Unhandled exceptions - Assertion failures - Corrupted internal state - Programming errors Client action: Report to server administrators with request details. May be retriable, but likely indicates a server-side issue requiring investigation.
SERVER_ERROR_SERVER_MALFUNCTION = 9 [(.kurrent.rpc.error) = { ... }public static final ServerError UNRECOGNIZED
public static final int UNSPECIFIED_VALUE
Default value. This value is not used. An error code MUST always be set to a non-zero value. If an error code is not explicitly set, it MUST be treated as an internal server error (INTERNAL).
UNSPECIFIED = 0;public static final int SERVER_ERROR_ACCESS_DENIED_VALUE
Authentication or authorization failure. The client lacks valid credentials or sufficient permissions to perform the requested operation. Common causes: - Missing or invalid authentication tokens - Insufficient permissions for the operation - Expired credentials Client action: Check credentials, verify permissions, and re-authenticate if necessary. Not retriable without fixing the underlying authorization issue.
SERVER_ERROR_ACCESS_DENIED = 1 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_BAD_REQUEST_VALUE
The request is malformed or contains invalid data. The server cannot process the request due to client error. Common causes: - Invalid field values (e.g., empty required fields, out-of-range numbers) - Malformed data formats - Validation failures Client action: Fix the request data and retry. Not retriable without modifying the request.
SERVER_ERROR_BAD_REQUEST = 2 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_NOT_LEADER_NODE_VALUE
The server is not the cluster leader and cannot process write operations. In a clustered deployment, only the leader node can accept write operations. Common causes: - Client connected to a follower node - Leader election in progress - Network partition Client action: Redirect the request to the leader node indicated in the error details. Retriable after redirecting to the correct leader node.
SERVER_ERROR_NOT_LEADER_NODE = 5 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_OPERATION_TIMEOUT_VALUE
The operation did not complete within the configured timeout period. Common causes: - Slow disk I/O during writes - Cluster consensus delays - Network latency - Heavy server load Client action: Retry with exponential backoff. Consider increasing timeout values. Retriable - the operation may succeed on retry.
SERVER_ERROR_OPERATION_TIMEOUT = 6 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_SERVER_NOT_READY_VALUE
The server is starting up or shutting down and cannot process requests. Common causes: - Server is initializing (loading indexes, recovering state) - Server is performing graceful shutdown - Server is performing maintenance operations Client action: Retry with exponential backoff. Wait for server to become ready. Retriable - the server will become available after initialization completes.
SERVER_ERROR_SERVER_NOT_READY = 7 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_SERVER_OVERLOADED_VALUE
The server is temporarily overloaded and cannot accept more requests. This is a backpressure mechanism to prevent server overload. Common causes: - Too many concurrent requests - Resource exhaustion (CPU, memory, disk I/O) - Rate limiting triggered Client action: Retry with exponential backoff. Reduce request rate. Retriable - the server may accept requests after load decreases.
SERVER_ERROR_SERVER_OVERLOADED = 8 [(.kurrent.rpc.error) = { ... }public static final int SERVER_ERROR_SERVER_MALFUNCTION_VALUE
An internal server error occurred. This indicates a bug or unexpected condition in the server. Common causes: - Unhandled exceptions - Assertion failures - Corrupted internal state - Programming errors Client action: Report to server administrators with request details. May be retriable, but likely indicates a server-side issue requiring investigation.
SERVER_ERROR_SERVER_MALFUNCTION = 9 [(.kurrent.rpc.error) = { ... }public static ServerError[] values()
for (ServerError c : ServerError.values()) System.out.println(c);
public static ServerError valueOf(java.lang.String name)
name - the name of the enum constant to be returned.java.lang.IllegalArgumentException - if this enum type has no constant with the specified namejava.lang.NullPointerException - if the argument is nullpublic final int getNumber()
getNumber in interface com.google.protobuf.Internal.EnumLitegetNumber in interface com.google.protobuf.ProtocolMessageEnum@Deprecated public static ServerError valueOf(int value)
forNumber(int) instead.value - The numeric wire value of the corresponding enum entry.public static ServerError forNumber(int value)
value - The numeric wire value of the corresponding enum entry.public static com.google.protobuf.Internal.EnumLiteMap<ServerError> internalGetValueMap()
public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()
getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnumpublic final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()
getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnumpublic static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()
public static ServerError valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)