as_status.h

Go to the documentation of this file.

/*
 * Copyright 2008-2025 Aerospike, Inc.
 *
 * Portions may be licensed to Aerospike, Inc. under one or more contributor
 * license agreements.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
//---------------------------------
// Types
//---------------------------------
 
/**
 * Status codes used as return values as as_error.code values.
 */
typedef enum as_status_e {
    //---------------------------------
    // Client Errors
    //---------------------------------
 
    /**
     * Transaction commit called, but the transaction was already aborted.
     */
    AEROSPIKE_TXN_ALREADY_ABORTED = -19,
 
    /**
     * Transaction abort called, but the transaction was already committed.
     */
    AEROSPIKE_TXN_ALREADY_COMMITTED = -18,
 
    /**
     * Transaction failed.
     */
    AEROSPIKE_TXN_FAILED = -17,
 
    /**
     * One or more keys failed in a batch.
     */
    AEROSPIKE_BATCH_FAILED = -16,
 
    /**
     * No response received from server.
     */
    AEROSPIKE_NO_RESPONSE = -15,
 
    /**
     * Max errors limit reached.
     */
    AEROSPIKE_MAX_ERROR_RATE = -14,
 
    /**
     * Abort split batch retry and use normal node retry instead.
     * Used internally and should not be returned to user.
     */
    AEROSPIKE_USE_NORMAL_RETRY = -13,
 
    /**
     * Max retries limit reached.
     */
    AEROSPIKE_ERR_MAX_RETRIES_EXCEEDED = -12,
 
    /**
     * Async command delay queue is full.
     */
    AEROSPIKE_ERR_ASYNC_QUEUE_FULL = -11,
 
    /**
     * Synchronous connection error.
     */
    AEROSPIKE_ERR_CONNECTION = -10,
 
    /**
     * Node invalid or could not be found.
     */
    AEROSPIKE_ERR_TLS_ERROR = -9,
    
    /**
     * Node invalid or could not be found.
     */
    AEROSPIKE_ERR_INVALID_NODE = -8,
    
    /**
     * Max connections would be exceeded.
     */
    AEROSPIKE_ERR_NO_MORE_CONNECTIONS = -7,
 
    /**
     * Asynchronous connection error.
     */
    AEROSPIKE_ERR_ASYNC_CONNECTION = -6,
    
    /**
     * Query or scan was aborted in user's callback.
     */
    AEROSPIKE_ERR_CLIENT_ABORT = -5,
 
    /**
     * Host name could not be found in DNS lookup.
     */
    AEROSPIKE_ERR_INVALID_HOST = -4,
 
    /**
     * No more records available when parsing batch, scan or query records.
     */
    AEROSPIKE_NO_MORE_RECORDS = -3,
    
    /**
     * Invalid client API parameter.
     */
    AEROSPIKE_ERR_PARAM = -2,
    
    /**
     * Generic client API usage error.
     */
    AEROSPIKE_ERR_CLIENT = -1,
    
    /**
     * Deprecated.  Generic client error.  Keep for legacy reasons.
     */
    AEROSPIKE_ERR = -1,
 
    //---------------------------------
    // Success
    //---------------------------------
 
    /**
     * Generic success.
     */
    AEROSPIKE_OK = 0,
    
    //---------------------------------
    // Server Errors
    //---------------------------------
 
    /**
     * Generic error returned by server.
     */
    AEROSPIKE_ERR_SERVER = 1,
    
    /**
     * Record does not exist in database. May be returned by read, or write
     * with policy AS_POLICY_EXISTS_UPDATE.
     */
    AEROSPIKE_ERR_RECORD_NOT_FOUND = 2,
    
    /**
     * Generation of record in database does not satisfy write policy.
     */
    AEROSPIKE_ERR_RECORD_GENERATION = 3,
    
    /**
     * Request protocol invalid, or invalid protocol field.
     */
    AEROSPIKE_ERR_REQUEST_INVALID = 4,
    
    /**
     * Record already exists. May be returned by write with policy
     * AS_POLICY_EXISTS_CREATE.
     */
    AEROSPIKE_ERR_RECORD_EXISTS = 5,
 
    /**
     * Bin already exists on a create-only operation.
     */
    AEROSPIKE_ERR_BIN_EXISTS = 6,
 
    /**
     * A cluster state change occurred during the request. This may also be
     * returned by scan operations with the fail_on_cluster_change flag set.
     */
    AEROSPIKE_ERR_CLUSTER_CHANGE = 7,
    
    /**
     * The server node is running out of memory and/or storage device space
     * reserved for the specified namespace.
     */
    AEROSPIKE_ERR_SERVER_FULL = 8,
    
    /**
     * Request timed out.  Can be triggered by client or server.
     */
    AEROSPIKE_ERR_TIMEOUT = 9,
    
    /**
     * Operation not allowed in current configuration.
     */
    AEROSPIKE_ERR_ALWAYS_FORBIDDEN = 10,
    
    /**
     * Partition is unavailable.
     */
    AEROSPIKE_ERR_CLUSTER = 11,
    
    /**
     * Bin modification operation can't be done on an existing bin due to its
     * value type.
     */
    AEROSPIKE_ERR_BIN_INCOMPATIBLE_TYPE = 12,
    
    /**
     * Record being (re-)written can't fit in a storage write block.
     */
    AEROSPIKE_ERR_RECORD_TOO_BIG = 13,
    
    /**
     * Too may concurrent requests for one record - a "hot-key" situation.
     */
    AEROSPIKE_ERR_RECORD_BUSY = 14,
    
    /**
     * Scan aborted by user.
     */
    AEROSPIKE_ERR_SCAN_ABORTED = 15,
    
    /**
     * Sometimes our doc, or our customers wishes, get ahead of us.  We may have
     * processed something that the server is not ready for (unsupported feature).
     */
    AEROSPIKE_ERR_UNSUPPORTED_FEATURE = 16,
 
    /**
     * Bin not found on update-only operation.
     */
    AEROSPIKE_ERR_BIN_NOT_FOUND = 17,
 
    /**
     * The server node's storage device(s) can't keep up with the write load.
     */
    AEROSPIKE_ERR_DEVICE_OVERLOAD = 18,
    
    /**
     * Record key sent with command did not match key stored on server.
     */
    AEROSPIKE_ERR_RECORD_KEY_MISMATCH = 19,
    
    /**
     * Namespace in request not found on server.
     */
    AEROSPIKE_ERR_NAMESPACE_NOT_FOUND = 20,
    
    /**
     * Sent too-long bin name (should be impossible in this client) or exceeded
     * namespace's bin name quota.
     */
    AEROSPIKE_ERR_BIN_NAME = 21,
    
    /**
     * Operation not allowed at this time.
     */
    AEROSPIKE_ERR_FAIL_FORBIDDEN = 22,
 
    /**
     * Map element not found in UPDATE_ONLY write mode.
     */
    AEROSPIKE_ERR_FAIL_ELEMENT_NOT_FOUND = 23,
 
    /**
     * Map element exists in CREATE_ONLY write mode.
     */
    AEROSPIKE_ERR_FAIL_ELEMENT_EXISTS = 24,
 
    /**
     * Attempt to use an Enterprise feature on a Community server or a server
     * without the applicable feature key.
     */
    AEROSPIKE_ERR_ENTERPRISE_ONLY = 25,
 
    /**
     * The operation cannot be applied to the current bin value on the server.
     */
    AEROSPIKE_ERR_OP_NOT_APPLICABLE = 26,
 
    /**
     * The command was not performed because the filter expression was
     * false.
     */
    AEROSPIKE_FILTERED_OUT = 27,
 
    /**
     * Write command loses conflict to XDR.
     */
    AEROSPIKE_LOST_CONFLICT = 28,
 
    /**
     * Write can't complete until XDR finishes shipping.
     */
    AEROSPIKE_XDR_KEY_BUSY = 32,
 
    /**
     * There are no more records left for query.
     */
    AEROSPIKE_QUERY_END = 50,
    
    /**
     * Security functionality not supported by connected server.
     */
    AEROSPIKE_SECURITY_NOT_SUPPORTED = 51,
    
    /**
     * Security functionality not enabled by connected server.
     */
    AEROSPIKE_SECURITY_NOT_ENABLED = 52,
        
    /**
     * Security scheme not supported
     */
    AEROSPIKE_SECURITY_SCHEME_NOT_SUPPORTED = 53,
    
    /**
     * Administration command is invalid.
     */
    AEROSPIKE_INVALID_COMMAND = 54,
    
    /**
     * Administration field is invalid.
     */
    AEROSPIKE_INVALID_FIELD = 55,
    
    /**
     * Security protocol not followed.
     */
    AEROSPIKE_ILLEGAL_STATE = 56,
    
    /**
     * User name is invalid.
     */
    AEROSPIKE_INVALID_USER = 60,
    
    /**
     * User was previously created.
     */
    AEROSPIKE_USER_ALREADY_EXISTS = 61,
    
    /**
     * Password is invalid.
     */
    AEROSPIKE_INVALID_PASSWORD = 62,
    
    /**
     * Password has expired.
     */
    AEROSPIKE_EXPIRED_PASSWORD = 63,
    
    /**
     * Forbidden password (e.g. recently used).
     */
    AEROSPIKE_FORBIDDEN_PASSWORD = 64,
    
    /**
     * Security credential is invalid.
     */
    AEROSPIKE_INVALID_CREDENTIAL = 65,
 
    /**
     * Login session expired.
     */
    AEROSPIKE_EXPIRED_SESSION = 66,
 
    /**
     * Role name is invalid.
     */
    AEROSPIKE_INVALID_ROLE = 70,
    
    /**
     * Role already exists.
     */
    AEROSPIKE_ROLE_ALREADY_EXISTS = 71,
 
    /**
     * Privilege is invalid.
     */
    AEROSPIKE_INVALID_PRIVILEGE = 72,
    
    /**
     * Invalid IP whitelist.
     */
    AEROSPIKE_INVALID_WHITELIST = 73,
 
    /**
     * Quotas not enabled on server.
     */
    AEROSPIKE_QUOTAS_NOT_ENABLED = 74,
 
    /**
     * Invalid quota.
     */
    AEROSPIKE_INVALID_QUOTA = 75,
 
    /**
     * User must be authenticated before performing database operations.
     */
    AEROSPIKE_NOT_AUTHENTICATED = 80,
    
    /**
     * User does not possess the required role to perform the database operation.
     */
    AEROSPIKE_ROLE_VIOLATION = 81,
    
    /**
     * Command not allowed because sender IP not whitelisted.
     */
    AEROSPIKE_NOT_WHITELISTED = 82,
 
    /**
     * Quota exceeded.
     */
    AEROSPIKE_QUOTA_EXCEEDED = 83,
 
    /**
     * Generic UDF error.
     */
    AEROSPIKE_ERR_UDF = 100,
 
    /**
     * Transaction record blocked by a different transaction.
     */
    AEROSPIKE_MRT_BLOCKED = 120,
 
    /**
     * Transaction read version mismatch identified during commit.
     * Some other command changed the record outside of the transaction.
     */
    AEROSPIKE_MRT_VERSION_MISMATCH = 121,
 
    /**
     * Transaction deadline reached without a successful commit or abort.
     */
    AEROSPIKE_MRT_EXPIRED = 122,
 
    /**
     * Transaction write command limit (4096) exceeded.
     */
    AEROSPIKE_MRT_TOO_MANY_WRITES = 123,
 
    /**
     * Transaction was already committed.
     */
    AEROSPIKE_MRT_COMMITTED = 124,
 
    /**
     * Transaction was already aborted.
     */
    AEROSPIKE_MRT_ABORTED = 125,
 
    /**
     * This record has been locked by a previous update in this transaction.
     */
    AEROSPIKE_MRT_ALREADY_LOCKED = 126,
 
    /**
     * This transaction has already started. Writing to the same transaction with independent threads is unsafe.
     */
    AEROSPIKE_MRT_MONITOR_EXISTS = 127,
 
    /**
     * Batch functionality has been disabled.
     */
    AEROSPIKE_ERR_BATCH_DISABLED = 150,
 
    /**
     * Batch max requests have been exceeded.
     */
    AEROSPIKE_ERR_BATCH_MAX_REQUESTS_EXCEEDED = 151,
 
    /**
     * All batch queues are full.
     */
    AEROSPIKE_ERR_BATCH_QUEUES_FULL = 152,
 
    /**
     * Invalid/Unsupported GeoJSON.
     */
    AEROSPIKE_ERR_GEO_INVALID_GEOJSON = 160,
 
    /**
     * Index found.
     */
    AEROSPIKE_ERR_INDEX_FOUND = 200,
    
    /**
     * Index not found.
     */
    AEROSPIKE_ERR_INDEX_NOT_FOUND = 201,
    
    /**
     * Index is out of memory.
     */
    AEROSPIKE_ERR_INDEX_OOM = 202,
    
    /**
     * Unable to read the index.
     */
    AEROSPIKE_ERR_INDEX_NOT_READABLE = 203,
    
    /**
     * Generic secondary index error.
     */
    AEROSPIKE_ERR_INDEX = 204,
    
    /**
     * Index name is too long.
     */
    AEROSPIKE_ERR_INDEX_NAME_MAXLEN = 205,
    
    /**
     * System already has maximum allowed indices.
     */
    AEROSPIKE_ERR_INDEX_MAXCOUNT = 206,
    
    /**
     * Query was aborted.
     */
    AEROSPIKE_ERR_QUERY_ABORTED = 210,
    
    /**
     * Query processing queue is full.
     */
    AEROSPIKE_ERR_QUERY_QUEUE_FULL = 211,
 
    /**
     * Secondary index query timed out on server.
     */
    AEROSPIKE_ERR_QUERY_TIMEOUT = 212,
 
    /**
     * Generic query error.
     */
    AEROSPIKE_ERR_QUERY = 213,
    
    //---------------------------------
    // UDF Operations
    //---------------------------------
 
    /**
     * UDF does not exist.
     */
    AEROSPIKE_ERR_UDF_NOT_FOUND             = 1301,
    /**
     * LUA file does not exist.
     */
    AEROSPIKE_ERR_LUA_FILE_NOT_FOUND        = 1302,
 
} as_status;
typedef enum as_status_e {…};
 
#ifdef __cplusplus
} // end extern "C"
#endif