io.kurrentdb.protocol.v2.common.errors

Enum ServerError

java.lang.Object

java.lang.Enum<ServerError>

io.kurrentdb.protocol.v2.common.errors.ServerError

All Implemented Interfaces:

com.google.protobuf.Internal.EnumLite, com.google.protobuf.ProtocolMessageEnum, java.io.Serializable, java.lang.Comparable<ServerError>

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 Summary

Enum Constants

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.

Field Summary

Fields

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.

Method Summary

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.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

UNSPECIFIED

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;

SERVER_ERROR_ACCESS_DENIED

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) = { ... }

SERVER_ERROR_BAD_REQUEST

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) = { ... }

SERVER_ERROR_NOT_LEADER_NODE

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) = { ... }

SERVER_ERROR_OPERATION_TIMEOUT

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) = { ... }

SERVER_ERROR_SERVER_NOT_READY

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) = { ... }

SERVER_ERROR_SERVER_OVERLOADED

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) = { ... }

SERVER_ERROR_SERVER_MALFUNCTION

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) = { ... }

UNRECOGNIZED

public static final ServerError UNRECOGNIZED

Field Detail

UNSPECIFIED_VALUE

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;

See Also:

Constant Field Values

SERVER_ERROR_ACCESS_DENIED_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_BAD_REQUEST_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_NOT_LEADER_NODE_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_OPERATION_TIMEOUT_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_SERVER_NOT_READY_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_SERVER_OVERLOADED_VALUE

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) = { ... }

See Also:

Constant Field Values

SERVER_ERROR_SERVER_MALFUNCTION_VALUE

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) = { ... }

See Also:

Constant Field Values

Method Detail

values

public static ServerError[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ServerError c : ServerError.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ServerError valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getNumber

public final int getNumber()

Specified by:

getNumber in interface com.google.protobuf.Internal.EnumLite

Specified by:

getNumber in interface com.google.protobuf.ProtocolMessageEnum

valueOf

@Deprecated
public static ServerError valueOf(int value)

Deprecated. Use forNumber(int) instead.

Parameters:

value - The numeric wire value of the corresponding enum entry.

Returns:

The enum associated with the given numeric wire value.

forNumber

public static ServerError forNumber(int value)

Parameters:

value - The numeric wire value of the corresponding enum entry.

Returns:

The enum associated with the given numeric wire value.

internalGetValueMap

public static com.google.protobuf.Internal.EnumLiteMap<ServerError> internalGetValueMap()

getValueDescriptor

public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor()

Specified by:

getValueDescriptor in interface com.google.protobuf.ProtocolMessageEnum

getDescriptorForType

public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType()

Specified by:

getDescriptorForType in interface com.google.protobuf.ProtocolMessageEnum

getDescriptor

public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor()

valueOf

public static ServerError valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc)