Error Handling

All python-arango exceptions inherit arango.exceptions.ArangoError, which splits into subclasses arango.exceptions.ArangoServerError and arango.exceptions.ArangoClientError.

Server Errors

arango.exceptions.ArangoServerError exceptions lightly wrap non-2xx HTTP responses coming from ArangoDB. Each exception object contains the error message, error code and HTTP request response details.

Example:

from arango import ArangoClient, ArangoServerError, DocumentInsertError

# Initialize the ArangoDB client.
client = ArangoClient()

# Connect to "test" database as root user.
db = client.db('test', username='root', password='passwd')

# Get the API wrapper for "students" collection.
students = db.collection('students')

try:
    students.insert({'_key': 'John'})
    students.insert({'_key': 'John'})  # duplicate key error

except DocumentInsertError as exc:

    assert isinstance(exc, ArangoServerError)
    assert exc.source == 'server'

    exc.message           # Exception message usually from ArangoDB
    exc.error_message     # Raw error message from ArangoDB
    exc.error_code        # Error code from ArangoDB
    exc.url               # URL (API endpoint)
    exc.http_method       # HTTP method (e.g. "POST")
    exc.http_headers      # Response headers
    exc.http_code         # Status code (e.g. 200)

    # You can inspect the ArangoDB response directly.
    response = exc.response
    response.method       # HTTP method (e.g. "POST")
    response.headers      # Response headers
    response.url          # Full request URL
    response.is_success   # Set to True if HTTP code is 2XX
    response.body         # JSON-deserialized response body
    response.raw_body     # Raw string response body
    response.status_text  # Status text (e.g "OK")
    response.status_code  # Status code (e.g. 200)
    response.error_code   # Error code from ArangoDB

    # You can also inspect the request sent to ArangoDB.
    request = exc.request
    request.method        # HTTP method (e.g. "post")
    request.endpoint      # API endpoint starting with "/_api"
    request.headers       # Request headers
    request.params        # URL parameters
    request.data          # Request payload

See Response and Request for reference.

Client Errors

arango.exceptions.ArangoClientError exceptions originate from python-arango client itself. They do not contain error codes nor HTTP request response details.

Example:

from arango import ArangoClient, ArangoClientError, DocumentParseError

# Initialize the ArangoDB client.
client = ArangoClient()

# Connect to "test" database as root user.
db = client.db('test', username='root', password='passwd')

# Get the API wrapper for "students" collection.
students = db.collection('students')

try:
    students.get({'_id': 'invalid_id'})  # malformed document

except DocumentParseError as exc:

    assert isinstance(exc, ArangoClientError)
    assert exc.source == 'client'

    # Only the error message is set.
    error_message = exc.message
    assert exc.error_code is None
    assert exc.error_message is None
    assert exc.url is None
    assert exc.http_method is None
    assert exc.http_code is None
    assert exc.http_headers is None
    assert exc.response is None
    assert exc.request is None

Exceptions

Below are all exceptions from python-arango.

exception arango.exceptions.ArangoError

Base class for all exceptions in python-arango.

exception arango.exceptions.ArangoClientError(msg: str)

Base class for errors originating from python-arango client.

Parameters:

msg (str) – Error message.

Variables:

• source (str) – Source of the error (always set to “client”).

• message (str) – Error message.

exception arango.exceptions.ArangoServerError(resp: Response, request: Request, msg: str | None = None)

Base class for errors originating from ArangoDB server.

Parameters:

• resp (arango.response.Response) – HTTP response.

• msg (str) – Error message override.

Variables:

• source (str) – Source of the error (always set to “server”).

• message (str) – Exception message.

• url (str) – API URL.

• response (arango.response.Response) – HTTP response object.

• request (arango.request.Request) – HTTP request object.

• http_method (str) – HTTP method in lowercase (e.g. “post”).

• http_code (int) – HTTP status code.

• http_headers (dict) – Response headers.

• error_code (int) – Error code from ArangoDB server.

• error_message (str) – Raw error message from ArangoDB server.

exception arango.exceptions.AQLQueryListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve running AQL queries.

exception arango.exceptions.AQLQueryExplainError(resp: Response, request: Request, msg: str | None = None)

Failed to parse and explain query.

exception arango.exceptions.AQLQueryValidateError(resp: Response, request: Request, msg: str | None = None)

Failed to parse and validate query.

exception arango.exceptions.AQLQueryExecuteError(resp: Response, request: Request, msg: str | None = None)

Failed to execute query.

exception arango.exceptions.AQLQueryKillError(resp: Response, request: Request, msg: str | None = None)

Failed to kill the query.

exception arango.exceptions.AQLQueryClearError(resp: Response, request: Request, msg: str | None = None)

Failed to clear slow AQL queries.

exception arango.exceptions.AQLQueryTrackingGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve AQL tracking properties.

exception arango.exceptions.AQLQueryTrackingSetError(resp: Response, request: Request, msg: str | None = None)

Failed to configure AQL tracking properties.

exception arango.exceptions.AQLCachePropertiesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve query cache properties.

exception arango.exceptions.AQLCacheConfigureError(resp: Response, request: Request, msg: str | None = None)

Failed to configure query cache properties.

exception arango.exceptions.AQLCacheEntriesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve AQL cache entries.

exception arango.exceptions.AQLCacheClearError(resp: Response, request: Request, msg: str | None = None)

Failed to clear the query cache.

exception arango.exceptions.AQLFunctionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve AQL user functions.

exception arango.exceptions.AQLFunctionCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create AQL user function.

exception arango.exceptions.AQLFunctionDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete AQL user function.

exception arango.exceptions.AQLQueryRulesGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve AQL query rules.

exception arango.exceptions.AsyncExecuteError(resp: Response, request: Request, msg: str | None = None)

Failed to execute async API request.

exception arango.exceptions.AsyncJobListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve async jobs.

exception arango.exceptions.AsyncJobCancelError(resp: Response, request: Request, msg: str | None = None)

Failed to cancel async job.

exception arango.exceptions.AsyncJobStatusError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve async job status.

exception arango.exceptions.AsyncJobResultError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve async job result.

exception arango.exceptions.AsyncJobClearError(resp: Response, request: Request, msg: str | None = None)

Failed to clear async job results.

exception arango.exceptions.BackupCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create a backup.

exception arango.exceptions.BackupDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete a backup.

exception arango.exceptions.BackupDownloadError(resp: Response, request: Request, msg: str | None = None)

Failed to download a backup from remote repository.

exception arango.exceptions.BackupGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve backup details.

exception arango.exceptions.BackupRestoreError(resp: Response, request: Request, msg: str | None = None)

Failed to restore from backup.

exception arango.exceptions.BackupUploadError(resp: Response, request: Request, msg: str | None = None)

Failed to upload a backup to remote repository.

exception arango.exceptions.BatchStateError(msg: str)

The batch object was in a bad state.

exception arango.exceptions.BatchJobResultError(msg: str)

Failed to retrieve batch job result.

exception arango.exceptions.BatchExecuteError(resp: Response, request: Request, msg: str | None = None)

Failed to execute batch API request.

exception arango.exceptions.OverloadControlExecutorError(resp: Response, request: Request, msg: str | None = None)

Failed to execute overload controlled API request.

exception arango.exceptions.CollectionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collections.

exception arango.exceptions.CollectionInformationError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection information.

exception arango.exceptions.CollectionPropertiesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection properties.

exception arango.exceptions.CollectionConfigureError(resp: Response, request: Request, msg: str | None = None)

Failed to configure collection properties.

exception arango.exceptions.CollectionShardsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection shards.

exception arango.exceptions.CollectionStatisticsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection statistics.

exception arango.exceptions.CollectionRevisionError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection revision.

exception arango.exceptions.CollectionChecksumError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection checksum.

exception arango.exceptions.CollectionCompactError(resp: Response, request: Request, msg: str | None = None)

Failed to compact collection.

exception arango.exceptions.CollectionCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create collection.

exception arango.exceptions.CollectionDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete collection.

exception arango.exceptions.CollectionRenameError(resp: Response, request: Request, msg: str | None = None)

Failed to rename collection.

exception arango.exceptions.CollectionTruncateError(resp: Response, request: Request, msg: str | None = None)

Failed to truncate collection.

exception arango.exceptions.CollectionLoadError(resp: Response, request: Request, msg: str | None = None)

Failed to load collection.

exception arango.exceptions.CollectionUnloadError(resp: Response, request: Request, msg: str | None = None)

Failed to unload collection.

exception arango.exceptions.CollectionRecalculateCountError(resp: Response, request: Request, msg: str | None = None)

Failed to recalculate document count.

exception arango.exceptions.CollectionResponsibleShardError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve responsible shard.

exception arango.exceptions.CursorStateError(msg: str)

The cursor object was in a bad state.

exception arango.exceptions.CursorCountError(msg: str)

The cursor count was not enabled.

exception arango.exceptions.CursorEmptyError(msg: str)

The current batch in cursor was empty.

exception arango.exceptions.CursorNextError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve the next result batch from server.

exception arango.exceptions.CursorCloseError(resp: Response, request: Request, msg: str | None = None)

Failed to delete the cursor result from server.

exception arango.exceptions.DatabaseListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve databases.

exception arango.exceptions.DatabasePropertiesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve database properties.

exception arango.exceptions.DatabaseCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create database.

exception arango.exceptions.DatabaseDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete database.

exception arango.exceptions.DatabaseSupportInfoError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve support info for deployment.

exception arango.exceptions.DatabaseCompactError(resp: Response, request: Request, msg: str | None = None)

Failed to compact databases.

exception arango.exceptions.DocumentParseError(msg: str)

Failed to parse document input.

exception arango.exceptions.DocumentCountError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve document count.

exception arango.exceptions.DocumentInError(resp: Response, request: Request, msg: str | None = None)

Failed to check whether document exists.

exception arango.exceptions.DocumentGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve document.

exception arango.exceptions.DocumentKeysError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve document keys.

exception arango.exceptions.DocumentIDsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve document IDs.

exception arango.exceptions.DocumentInsertError(resp: Response, request: Request, msg: str | None = None)

Failed to insert document.

exception arango.exceptions.DocumentReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace document.

exception arango.exceptions.DocumentUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update document.

exception arango.exceptions.DocumentDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete document.

exception arango.exceptions.DocumentRevisionError(resp: Response, request: Request, msg: str | None = None)

The expected and actual document revisions mismatched.

exception arango.exceptions.FoxxServiceListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx services.

exception arango.exceptions.FoxxServiceGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service metadata.

exception arango.exceptions.FoxxServiceCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create Foxx service.

exception arango.exceptions.FoxxServiceUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update Foxx service.

exception arango.exceptions.FoxxServiceReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace Foxx service.

exception arango.exceptions.FoxxServiceDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete Foxx services.

exception arango.exceptions.FoxxConfigGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service configuration.

exception arango.exceptions.FoxxConfigUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update Foxx service configuration.

exception arango.exceptions.FoxxConfigReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace Foxx service configuration.

exception arango.exceptions.FoxxDependencyGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service dependencies.

exception arango.exceptions.FoxxDependencyUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update Foxx service dependencies.

exception arango.exceptions.FoxxDependencyReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace Foxx service dependencies.

exception arango.exceptions.FoxxScriptListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service scripts.

exception arango.exceptions.FoxxScriptRunError(resp: Response, request: Request, msg: str | None = None)

Failed to run Foxx service script.

exception arango.exceptions.FoxxTestRunError(resp: Response, request: Request, msg: str | None = None)

Failed to run Foxx service tests.

exception arango.exceptions.FoxxDevModeEnableError(resp: Response, request: Request, msg: str | None = None)

Failed to enable development mode for Foxx service.

exception arango.exceptions.FoxxDevModeDisableError(resp: Response, request: Request, msg: str | None = None)

Failed to disable development mode for Foxx service.

exception arango.exceptions.FoxxReadmeGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service readme.

exception arango.exceptions.FoxxSwaggerGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Foxx service swagger.

exception arango.exceptions.FoxxDownloadError(resp: Response, request: Request, msg: str | None = None)

Failed to download Foxx service bundle.

exception arango.exceptions.FoxxCommitError(resp: Response, request: Request, msg: str | None = None)

Failed to commit local Foxx service state.

exception arango.exceptions.GraphListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve graphs.

exception arango.exceptions.GraphCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create the graph.

exception arango.exceptions.GraphDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete the graph.

exception arango.exceptions.GraphPropertiesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve graph properties.

exception arango.exceptions.GraphTraverseError(resp: Response, request: Request, msg: str | None = None)

Failed to execute graph traversal.

exception arango.exceptions.VertexCollectionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve vertex collections.

exception arango.exceptions.VertexCollectionCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create vertex collection.

exception arango.exceptions.VertexCollectionDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete vertex collection.

exception arango.exceptions.EdgeDefinitionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve edge definitions.

exception arango.exceptions.EdgeDefinitionCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create edge definition.

exception arango.exceptions.EdgeDefinitionReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace edge definition.

exception arango.exceptions.EdgeDefinitionDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete edge definition.

exception arango.exceptions.EdgeListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve edges coming in and out of a vertex.

exception arango.exceptions.IndexListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection indexes.

exception arango.exceptions.IndexCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create collection index.

exception arango.exceptions.IndexGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection index.

exception arango.exceptions.IndexMissingError(msg: str)

Failed to find collection index.

exception arango.exceptions.IndexDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete collection index.

exception arango.exceptions.IndexLoadError(resp: Response, request: Request, msg: str | None = None)

Failed to load indexes into memory.

exception arango.exceptions.PregelJobCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create Pregel job.

exception arango.exceptions.PregelJobGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve Pregel job details.

exception arango.exceptions.PregelJobDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete Pregel job.

exception arango.exceptions.ServerConnectionError(resp: Response, request: Request, msg: str | None = None)

Failed to connect to ArangoDB server.

exception arango.exceptions.ServerEngineError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve database engine.

exception arango.exceptions.ServerVersionError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server version.

exception arango.exceptions.ServerDetailsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server details.

exception arango.exceptions.ServerLicenseGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server license.

exception arango.exceptions.ServerLicenseSetError(resp: Response, request: Request, msg: str | None = None)

Failed to set server license.

exception arango.exceptions.ServerStatusError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server status.

exception arango.exceptions.ServerTimeError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server system time.

exception arango.exceptions.ServerEchoError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve details on last request.

exception arango.exceptions.ServerShutdownError(resp: Response, request: Request, msg: str | None = None)

Failed to initiate shutdown sequence.

exception arango.exceptions.ServerShutdownProgressError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve soft shutdown progress.

exception arango.exceptions.ServerRunTestsError(resp: Response, request: Request, msg: str | None = None)

Failed to execute server tests.

exception arango.exceptions.ServerRequiredDBVersionError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server target version.

exception arango.exceptions.ServerReadLogError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve global log.

exception arango.exceptions.ServerLogLevelError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server log levels.

exception arango.exceptions.ServerLogLevelResetError(resp: Response, request: Request, msg: str | None = None)

Failed to reset server log levels.

exception arango.exceptions.ServerLogSettingError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server log settings.

exception arango.exceptions.ServerLogLevelSetError(resp: Response, request: Request, msg: str | None = None)

Failed to set server log levels.

exception arango.exceptions.ServerLogSettingSetError(resp: Response, request: Request, msg: str | None = None)

Failed to set server log settings.

exception arango.exceptions.ServerReloadRoutingError(resp: Response, request: Request, msg: str | None = None)

Failed to reload routing details.

exception arango.exceptions.ServerStatisticsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server statistics.

exception arango.exceptions.ServerMetricsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server metrics.

exception arango.exceptions.ServerRoleError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server role.

exception arango.exceptions.ServerModeError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server mode.

exception arango.exceptions.ServerModeSetError(resp: Response, request: Request, msg: str | None = None)

Failed to set server mode.

exception arango.exceptions.ServerTLSError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve TLS data.

exception arango.exceptions.ServerTLSReloadError(resp: Response, request: Request, msg: str | None = None)

Failed to reload TLS.

exception arango.exceptions.ServerEncryptionError(resp: Response, request: Request, msg: str | None = None)

Failed to reload user-defined encryption keys.

exception arango.exceptions.ServerCurrentOptionsGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve currently-set server options.

exception arango.exceptions.ServerAvailableOptionsGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve available server options.

exception arango.exceptions.ServerExecuteError(resp: Response, request: Request, msg: str | None = None)

Failed to execute raw JavaScript command.

exception arango.exceptions.TaskListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server tasks.

exception arango.exceptions.TaskGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server task details.

exception arango.exceptions.TaskCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create server task.

exception arango.exceptions.TaskDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete server task.

exception arango.exceptions.TransactionExecuteError(resp: Response, request: Request, msg: str | None = None)

Failed to execute raw transaction.

exception arango.exceptions.TransactionInitError(resp: Response, request: Request, msg: str | None = None)

Failed to initialize transaction.

exception arango.exceptions.TransactionStatusError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve transaction status.

exception arango.exceptions.TransactionCommitError(resp: Response, request: Request, msg: str | None = None)

Failed to commit transaction.

exception arango.exceptions.TransactionAbortError(resp: Response, request: Request, msg: str | None = None)

Failed to abort transaction.

exception arango.exceptions.TransactionFetchError(resp: Response, request: Request, msg: str | None = None)

Failed to fetch existing transaction.

exception arango.exceptions.TransactionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve transactions.

exception arango.exceptions.UserListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve users.

exception arango.exceptions.UserGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve user details.

exception arango.exceptions.UserCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create user.

exception arango.exceptions.UserUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update user.

exception arango.exceptions.UserReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace user.

exception arango.exceptions.UserDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete user.

exception arango.exceptions.ViewListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve views.

exception arango.exceptions.ViewGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve view details.

exception arango.exceptions.ViewCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create view.

exception arango.exceptions.ViewUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update view.

exception arango.exceptions.ViewReplaceError(resp: Response, request: Request, msg: str | None = None)

Failed to replace view.

exception arango.exceptions.ViewDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete view.

exception arango.exceptions.ViewRenameError(resp: Response, request: Request, msg: str | None = None)

Failed to rename view.

exception arango.exceptions.AnalyzerListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve analyzers.

exception arango.exceptions.AnalyzerGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve analyzer details.

exception arango.exceptions.AnalyzerCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create analyzer.

exception arango.exceptions.AnalyzerDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete analyzer.

exception arango.exceptions.PermissionListError(resp: Response, request: Request, msg: str | None = None)

Failed to list user permissions.

exception arango.exceptions.PermissionGetError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve user permission.

exception arango.exceptions.PermissionUpdateError(resp: Response, request: Request, msg: str | None = None)

Failed to update user permission.

exception arango.exceptions.PermissionResetError(resp: Response, request: Request, msg: str | None = None)

Failed to reset user permission.

exception arango.exceptions.WALPropertiesError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve WAL properties.

exception arango.exceptions.WALConfigureError(resp: Response, request: Request, msg: str | None = None)

Failed to configure WAL properties.

exception arango.exceptions.WALTransactionListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve running WAL transactions.

exception arango.exceptions.WALFlushError(resp: Response, request: Request, msg: str | None = None)

Failed to flush WAL.

exception arango.exceptions.WALTickRangesError(resp: Response, request: Request, msg: str | None = None)

Failed to return WAL tick ranges.

exception arango.exceptions.WALLastTickError(resp: Response, request: Request, msg: str | None = None)

Failed to return WAL tick ranges.

exception arango.exceptions.WALTailError(resp: Response, request: Request, msg: str | None = None)

Failed to return WAL tick ranges.

exception arango.exceptions.ReplicationInventoryError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve inventory of collection and indexes.

exception arango.exceptions.ReplicationDumpBatchCreateError(resp: Response, request: Request, msg: str | None = None)

Failed to create dump batch.

exception arango.exceptions.ReplicationDumpBatchDeleteError(resp: Response, request: Request, msg: str | None = None)

Failed to delete a dump batch.

exception arango.exceptions.ReplicationDumpBatchExtendError(resp: Response, request: Request, msg: str | None = None)

Failed to extend a dump batch.

exception arango.exceptions.ReplicationDumpError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve collection content.

exception arango.exceptions.ReplicationSyncError(resp: Response, request: Request, msg: str | None = None)

Failed to synchronize data from remote.

exception arango.exceptions.ReplicationClusterInventoryError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve overview of collection and indexes in a cluster.

exception arango.exceptions.ReplicationLoggerStateError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve logger state.

exception arango.exceptions.ReplicationLoggerFirstTickError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve logger first tick.

exception arango.exceptions.ReplicationApplierConfigError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve replication applier configuration.

exception arango.exceptions.ReplicationApplierConfigSetError(resp: Response, request: Request, msg: str | None = None)

Failed to update replication applier configuration.

exception arango.exceptions.ReplicationApplierStartError(resp: Response, request: Request, msg: str | None = None)

Failed to start replication applier.

exception arango.exceptions.ReplicationApplierStopError(resp: Response, request: Request, msg: str | None = None)

Failed to stop replication applier.

exception arango.exceptions.ReplicationApplierStateError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve replication applier state.

exception arango.exceptions.ReplicationMakeSlaveError(resp: Response, request: Request, msg: str | None = None)

Failed to change role to slave.

exception arango.exceptions.ReplicationServerIDError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server ID.

exception arango.exceptions.ClusterHealthError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve DBServer health.

exception arango.exceptions.ClusterServerIDError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server ID.

exception arango.exceptions.ClusterServerRoleError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server role in a cluster.

exception arango.exceptions.ClusterServerModeError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server mode in a cluster.

exception arango.exceptions.ClusterServerStatisticsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve DBServer statistics.

exception arango.exceptions.ClusterServerVersionError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server node version.

exception arango.exceptions.ClusterServerEngineError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve server node engine.

exception arango.exceptions.ClusterMaintenanceModeError(resp: Response, request: Request, msg: str | None = None)

Failed to enable/disable cluster supervision maintenance mode.

exception arango.exceptions.ClusterEndpointsError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve cluster endpoints.

exception arango.exceptions.ClusterServerCountError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve cluster server count.

exception arango.exceptions.ClusterRebalanceError(resp: Response, request: Request, msg: str | None = None)

Failed to execute cluster re-balancing operation (load/set).

exception arango.exceptions.ClusterVpackSortMigrationError(resp: Response, request: Request, msg: str | None = None)

Failed to execute vpack sort migration request.

exception arango.exceptions.JWTAuthError(resp: Response, request: Request, msg: str | None = None)

Failed to get a new JWT token from ArangoDB.

exception arango.exceptions.JWTSecretListError(resp: Response, request: Request, msg: str | None = None)

Failed to retrieve information on currently loaded JWT secrets.

exception arango.exceptions.JWTSecretReloadError(resp: Response, request: Request, msg: str | None = None)

Failed to reload JWT secrets.

exception arango.exceptions.JWTRefreshError(msg: str)

Failed to refresh JWT token.

exception arango.exceptions.JWTExpiredError(msg: str)

JWT token has expired.

exception arango.exceptions.SortValidationError(msg: str)

Invalid sort parameters.

Error Codes

The errno module contains a constant mapping to ArangoDB’s error codes.