API errors#
The section describes errors, returned by the API service. Each of the errors has a unique code.
The errors can have different reasons.
In case of 'Internal server error' or any other unexpected error occurrence, it is recommended to check service logs to find out more information about the error. If any additional trace is provided and the error continues to appear, send the trace to VisionLabs technical support.
General errors#
Error code | Error Message | Error Description |
---|---|---|
0 | Success | This code is returned when there are no errors and the request is successfully processed. Note that the result may still contain images filtered according to the parameters defined in the request. |
1 | Internal server error Unknown error | Internal error. An unexpected error occurred. If any additional trace is provided and the error continues to appear, send the trace to VisionLabs technical support. |
2 | Queue request timeout Request timeout to routing key {value} | MQ connection limit exceeded (Request timeout parameter). Check MQ availability. |
3 | Invalid url {value} | Invalid URL was specified in the request. |
4 | Client payload error {value} | Client payload error. Possible causes: the response object was closed before the response received all data, transfer encoding error occurred. |
5 | Server fingerprint mismatch {value} | Server fingerprint error. Attempt to connect to an invalid server was performed or invalid key was used. |
6 | Socket read timeout Request timeout on {value} method {value} | Socket reading error. Request completion time limit exceeded. |
7 | Socket connect timeout Request timeout on {value} method {value} | Socket connection error. Request completion time limit exceeded. |
8 | Connect timeout on {value} method {value} | Connection error. The connection time limit exceeded. |
9 | Request timeout on {value} method {value} | Connection error. Request completion time limit exceeded. |
10 | Server disconnected {value} | The connection with the server is lost. |
11 | Server connection error {value} | Server connection error. |
12 | Client proxy connection error {value} | Client proxy connection error. |
13 | Client connector SSL error {value} | Client connection via SSL error. Check SSL certificate. |
14 | Client connector certificate error {value} | Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version. Check SSL certificate. |
15 | Client SSL error {value} | Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version. Check SSL certificate. |
16 | Client connector error {value} | Client connection error. |
17 | Client OS error {value} | The error in the operating system has occurred. |
18 | Client connection error {value} | Client connection error. |
19 | Client HTTP proxy error {value} | The HTTP proxy server error has occurred on the client-side. |
20 | WS server handshake error {value} | The connection through web sockets failed. |
21 | Content-Type error {value} | Request content error. Invalid value in Content-Type field of request header parameters. See "HEADER PARAMETERS" in the API documentation. |
22 | Client response error {value} | The client response error has occurred. |
23 | HTTP client error {value} | Client HTTP error. |
24 | HTTP client error {value} | Client HTTP error. The response was received in incorrect JSON format. |
11055 | Forbidden License problem: ‘{value}’ | License error. The license has expired or is unavailable. |
CORE errors, returned in API responses#
Error code | Error Message | Error Description |
---|---|---|
100 | Bad/incomplete configuration {value} | Cannot read the configuration file. The error may occur due to invalid donfiguration file name or format. Check the configuration file of the service. |
101 | Bad/incomplete query {value} | Invalid request parameters or mandatory parameters are absent. One or several query parameters are misspelled or missed. Invalid values may be set to the query parameters. See "QUERY PARAMETERS" in the API documentation and compare them with the specified parameters. |
102 | Bad/incomplete body {value} | Invalid request body. There is an error in the request body or it does not match the required schema. See "REQUEST BODY SCHEMA" in the API documentation and compare it with the specified one. |
105 | Out of memory {value} | Not enough memory for the request processing. Check the server memory usage. |
106 | Invalid http request {value} | Invalid HTTP request. Make sure the request URL and method are correct. |
200 | Generic error {value} | Generic error: invalid parameter, logical errors. |
Message subsystem#
Error code | Error Message | Error Description |
---|---|---|
2000 | Bad/incomplete message package {value} | Empty or unreadable message was received from MQ. |
2001 | Bad/unsupported message content type {value} | Invalid MQ message content type. The body is not in the JSON format. |
2002 | Failed to call a remote worker {value} | The connection to MQ worker failed. |
2003 | Failed to call a driver method {value} | The connection to MQ failed. |
2004 | Generic MQ error {value} | MQ error. |
2101 | Data not ready {value} | The task result has not yet returned to MQ. |
2102 | Driver is stopped {value} | The MQ driver has stopped. |
2103 | Max amount of messages in a queue exceeded {value} | MQ limit exceeded. |
2104 | Queue driver call failed {value} | Failed to call the MQ driver. |
4003 | No faces found | There are no faces found. |
Descriptor Match#
Error code | Error Message | Error Description |
---|---|---|
5003 | Failed to match descriptors {value} | Failed to perform matching due to invalid descriptor. The descriptor is provided in wrong format or the descriptor is broken. |
5004 | Bad/incomplete input data {value} | Invalid request content. Request does not contain the required input data (e. g. images) or they cannot be processed. Check, that the input data is correct. |
5005 | Invalid config {value} | Matcher error. Invalid Matcher configuration file. Check the configuration file of the service. |
5101 | Reference uuid is missing | Matcher error. Reference UUID not found. |
5102 | Reference uuid has no extracted descriptor | Matcher error. The extracted descriptor for Reference UUID not found. Failed to match the descriptor. The descriptor was extracted with an outdated neural network version. |
7001 | Bad/unsupported API version {value} | Invalid API version of the service was specified in the request. Check the current version in the API documentation of the service. |
Database Errors#
Error code | Error Message | Error Description |
---|---|---|
10015 | SQL error SQL request execution failed | SQL request failed. A database error has occurred. The database is not available for an unknown reason, or the required tables are missing. You should request the status of the database, check the availability of the database over the network, check the existence of the required tables in the database. |
10016 | Database error Could not connect to database | The connection to the database failed. Check that the database is available. There may be errors during database launch or it is not available in the current network (due to server restrictions or network problems). Check the database settings in services parameters. They may be incorrect. |
10017 | Database error Database connection timeout error | Database connection timeout error. Check that the database is available. There may be errors during database launch or it is not available in the current network (due to server restrictions or network problems). Check the database settings in services parameters. They may be incorrect. |
10018 | Database error {value} | An error occurred in the database. |
API errors#
Error code | Error Message | Error Description |
---|---|---|
11002 | Authorization failed Account corresponding login/password not found | The account was not found for Backport 3. There is no account with the provided login/password in the system. |
11004 | Account is suspended | The account is not active in Backport 3. |
11009 | Internal server error | The error occurs when an unknown exception comes to the REST resource handler level. |
11011 | Unique constraint error An account with given email already exists | The account with given email already exists. |
11012 | Extract policy error {value} | An error occurred during extraction. There are several faces in the image (Backport 3). |
11018 | Object not found Face descriptor of version {value} is not found for object with id ‘{value}’. | The descriptor with the given ID was not found (Backport 3). |
11020 | Object not found One or more {value} not found | One or more of the specified objects were not found. You should check their existence. |
11022 | Object not found Token not found | The token was not found for Backport 3. |
11027 | External request failed Failed to download image by url {value} | An external request has failed. Failed to get the image by the URL specified in the request body. |
11028 | Bad/incomplete input data Bad content type of image {value} | Invalid image content-type in the request. Check the content-type field in the request. |
11029 | Bad/incomplete input data Bad content type of image in multipart body | There is an invalid image content-type in the request, which contains several images. One or several images have an invalid format or size. |
11030 | Bad/incomplete input data Image size is not equal to 250x250 | The size of the normalized image in the request is not equal to 250x250. The image is not a sample. |
11031 | Bad/incomplete input data Sample with id {value} not found | The sample with the specified ID was not found. You should check the ID in the request. |
11032 | Object not found Face with id {value} does not have attributes yet | The Face with the specified ID has no attributes. The error occurs when matching is performed for a Face without linked descriptor. |
11034 | Bad/incomplete input data Descriptor for {value} ‘{value}’ was not extracted | The descriptor for the specified object was not extracted. You should verify the correctness of the object ID in the request. |
11035 | Service name not found Service name {value} not found | The specified service name was not found. |
11036 | Forbidden Luna-Account-Id header is required for requests which change the state of system | It is required to specify the correct "Luna-Account-Id" header in the request. The header defines a user who changes the state of the system. Perhaps, the user without access to the database was specified. |
11037 | Bad/incomplete input data Luna-Account-Id header is not UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | The "Luna-Account-Id" header in the request is not in UUID format, the required format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx. |
11038 | Multiple faces found Multiple faces found in image {value} detect {value} | There is more than one face in the image. The policy of processing images with a single face only is specified in handler parameters. |
11039 | Forbidden Luna Tasks service is disabled | A request to the Tasks service cannot be processed. Using the Tasks service is disabled in the API configuration. Check the ADDITIONAL_SERVICES_USAGE parameter in the Configurator service or the configuration file. |
11040 | Forbidden Luna Events service is disabled | The request to the Events service cannot be processed. The use of the Events service is disabled in the API configuration. Check the ADDITIONAL_SERVICES_USAGE parameter in the Configurator service or the configuration file. |
11041 | Object not found No one face found with external id {value} | The face object with the specified external ID was not found. Check the external ID. |
11042 | Internal server error Unhandled exception: {value} | An unhandled exception occurred. |
11043 | Bad/incomplete input data | Bad or incomplete input data is provided for the sample in the request. |
11044 | Forbidden {value} turned off on luna-api instance | The process is turned off for the API instance. Check API configurations. |
11045 | Forbidden Only one detection rect for each image available at the moment | Only one detection rectangle is available for each image at the moment. |
11046 | Bad/incomplete input data More than one file named {value} found | Several images with the same name were sent in the request. The images must have unique names. |
11047 | Bad/incomplete input data Bounding box not available for warp images | The bounding box is not available for samples. |
11048 | Bad/incomplete input data Multiplie bounding boxes lists in request | There is more than a single bounding box specified in the request. A single bounding box can be specified for an image. |
11049 | Bad/incomplete input data {value} | Bad or incomplete input data is provided in the multipart request. Not enough information about the image is given in the request. |
11050 | Bad/incomplete input data More than one bounding box for image named {value} found | The image has several bounding boxes. |
11051 | Internal server error Service ‘static’ folder not being loaded | The service static directory was not loaded. |
11052 | Bad/incomplete input data No one attributes was settled for the extract | No attribute was specified for extraction. You should specify at least one attribute ID in the request. |
11053 | Multiple human bodies found on image {value} detect {value} | There are several human bodies found in the image. |
11054 | Forbidden Liveness service is disabled | The Liveness request cannot be processed as Liveness feature is not available. Check your license. |
11056 | Bad/incomplete input data {value} | The request is invalid. The request data is incomplete. Check the input data in the request. |
11057 | Object not found No one event found with external id {value} | No event was found with the specified "external_id". Check the specified references for matching in the request body. |
11058 | Object not found No one event found with track id {value} | No event was found with the specified "track_id". Check the specified references for matching in the request body. |
REST API common errors#
Error code | Error Message | Error Description |
---|---|---|
12001 | Bad/incomplete input data Object in query is not UUID4 format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx | The provided ID for the object is not in UUID4 format. |
12002 | Bad/incomplete input data Request does not contain json | The request does not contain JSON. Check the JSON syntax in the request body: there are extra symbols, the JSON structure was broken, or important syntax elements were missed. |
12003 | Bad/incomplete input data Field {value} not found in json | The specified field was not found in the JSON body. Check that all required fields were added to the request. |
12005 | Bad/incomplete input data Request contain empty json | The request contains an empty JSON body. A body is required to execute the request. |
12010 | Bad/incomplete input data This resource needs “Authorization” authorization headers | You should specify the "Authorization" header in the request. |
12012 | Bad/incomplete input data Bad query parameters {value} | The specified query parameters are set incorrectly. |
12013 | Resource not found Page not found | The HTTP resource was not found. The URL specified in the request was not found. For example, the request contains the path "/6/sample" instead of "/6/samples". Compare the specified path with the path in the documentation. |
12014 | Bad/incomplete input data Required parameters {value} not found | The required query parameters were not found in the request. These parameters are listed in the error. |
12016 | Bad/incomplete input data No one parameters {value} not found | Listed query parameters were not found in the request. Check, which parameters are required, in the documentation "APIReferenceManual.html". |
12017 | Bad/incomplete input data Bad content type | Invalid "Content-Type" header value transmitted in the request. No header was specified, an invalid header value was specified, or there is a mistake in the header. |
12018 | Bad/incomplete input data Unsupported param ‘{value}’ | The query parameter is unsupported. |
12021 | Method not allowed Method not allowed | The HTTP resource does not support this method. Check the HTTP method specified to send the request. |
12022 | Bad/incomplete input data Failed to validate input json. Path: ‘{value}’ message: ‘{value}’ | There is an error in JSON syntax at the specified path. The request body contains invalid fields.Check the request for compliance with the template specified in the documentation "APIReferenceManual.html". The detailed description of the error is given in the field "message". |
12023 | Bad/incomplete input data Content type is unacceptable allowed types: ‘{value}’ | The request contains invalid data. Most likely, there is a typo in the request. |
12024 | Bad/incomplete input data Unsupported media type | The data type transmitted in the request is not supported. |
12025 | Bad/incomplete input data Specified content type does not match data type | The content-type specified in the "Content-Type" header does not match the data type. |
12027 | Bad/incomplete input data Failed to validate input json. Message: {value} | The request body parameters are incorrect. Check the JSON body for compliance with the request requirements. Details are listed in the "Message:" field. |
12028 | Bad/incomplete input data Failed to parse Flatbuf | Internal error. Failed to deserialize Flatbuf. |
12029 | Functionality is not implemented Required server functionality is not implemented | The requested server functionality is not implemented. |
12030 | Bad/incomplete input data Request does not contain data | The request contains no data. The request body is empty. |
12031 | Bad/incomplete input data {value} | The input data is incomplete or wrong. |
12032 | Internal server error Document file not found | The document with the specified name was not found. |
12033 | Forbidden Access to this resource on the server is denied | The access to the resource on the server is denied. Check the resource availability. The access may be restricted in the server settings. |
12034 | Bad/incomplete input data Descriptor has incorrect length {value} | The descriptor has an incorrect length. |
12035 | Bad/incomplete input data Failed to parse xpk file | Failed to parse the sescriptor XPK file. Check that the file is correct. |
12036 | Bad/incomplete input data Descriptor version {value} is not registered in the system | The specified descriptor version is not registered in the system. A wrong version is set or an incompatible service version is used that cannot process this descriptor version. |
12037 | Bad/incomplete input data XPK file does not contain descriptor | The input data XPK does not contain a descriptor. Check the file. |
12038 | Bad/incomplete input data SDK descriptor is not valid | SDK descriptor is not valid. Check the provided descriptor data. |
12039 | Bad/incomplete input data Unknown multipart name ‘{value}’ | There is an unknown multipart name in the request. |
12040 | Bad/incomplete input data Duplicate multipart name ‘{value}’ | There is a duplicated multipart name in the request. |
12041 | Bad/incomplete input data Multipart with name ‘{value}’ has bad Content-Type | The input data with the specified name has bad Content-Type in the multipart request. |
12042 | Gone Access to this resource on the server is no longer available | The access to the resource on the server is not available. Check that the corresponding service is working and available. Check that the resource is correct. |
12043 | Unknown error Service ‘{value}’ unknown error method: ‘{value}’ url: ‘{value}’ | Unknown service error has occurred. Check the provided method and URL. |
12044 | Bad/incomplete input data Failed to decompress input body using gzip encoder | Failed to decompress input body using GZIP encoder. |
12045 | Bad/incomplete input data Failed to decompress input body using deflate encoder | Failed to decompress input body using deflate encoder. |
Image Store service errors#
Error code | Error Message | Error Description |
---|---|---|
13003 | Object not found Image with id {value} not found | The image with the specified ID was not found in the storage. |
13004 | Bad/incomplete input data Image count exceeded limit 1000 | The number of images in the deletion request exceeded the limit of 1000. |
13005 | Object not found Bucket with name {value} not found | The specified bucket was not found. You should check the existence of the bucket. The path to the bucket is specified in the Image Store configuration file or Configurator service in the "LOCAL_STORAGE" variable. If there is no bucket, you should manually create it using the command specified in the LUNA PLATFORM installation manual in section "Buckets creation". |
13006 | Unique constraint error Bucket with name {value} already exist | A bucket with the specified name already exists. The error occurs when trying to create two buckets with the same name. |
13007 | Object not found Object with id {value} not found | The object with the specified ID was not found in the bucket. The object does not exist or there is a typo in the ID. |
13008 | Unique constraint error Object with id {value} already exist | An object with the specified ID already exists in the bucket. |
13009 | Bad/incomplete input data Object count exceeded limit 1000 | The number of objects transferred to the bucket in the request exceeded the limit of 1000. |
Admin service errors#
Error code | Error Message | Error Description |
---|---|---|
15012 | Object not found Account with id ‘{value}’ not found | There is no account in the Admin service with the specified ID. |
15013 | Unique constraint error Account with same email or id already exist | The e-mail with the specified ID already exists. |
15014 | Bad/incomplete input data Login or password is incorrect | Bad input. The login or the password for the account is incorrect. |
Image Processing Errors#
Error code | Error Message | Error Description |
---|---|---|
18001 | Bad/incomplete input data Failed convert data from base64 to bytes | Failed to convert BASE64 string to bytes. The provided BASE64 string is broken. |
18002 | Bad/incomplete input data Failed convert bytes to {value} | Failed to convert bytes to the specified image format. The request does not include a photo image. |
18003 | Bad/incomplete input data Failed read bytes as image | The image bytes cannot be read. The provided image is broken or in invalid format. |
Image Store Service Errors (Hard Disk)#
Error code | Error Message | Error Description |
---|---|---|
19001 | Internal server error Failed to save image in the storage | Image Store could not save an image to the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19002 | Internal server error Failed to remove image from the storage | Image Store could not delete an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19003 | Internal server error Failed to remove image from the storage | Image Store could not delete images from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19004 | Internal server error Failed to create bucket | Image Store could not create a bucket from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19005 | Internal server error Failed to get bucket list | Image Store could not get a list of buckets on the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19006 | Internal server error Failed to get image from the storage | Image Store could not get an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19007 | Internal server error Failed to save object in the storage | Image Store could not get an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19008 | Internal server error Failed to remove object from the storage | Image Store could not delete an object from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19009 | Internal server error Failed to remove objects from the storage | Image Store could not delete objects from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19010 | Internal server error Failed to get object from the storage | Image Store could not get an object from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19011 | Internal server error Failed to get objects from the storage | Image Store could not get objects from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
19012 | Internal server error Failed to delete bucket | Image Store could not delete a bucket from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store. |
Image Store Service Errors (S3 storage)#
Error code | Error Message | Error Description |
---|---|---|
20001 | Internal server error Failed to save image in the storage | Image Store could not save an image to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20002 | Internal server error Failed to remove image from the storage | Image Store could not delete an image from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20003 | Internal server error Failed to remove image from the storage | Image Store could not delete images from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20004 | Internal server error Failed to create bucket | Image Store could not create a bucket in the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20005 | Internal server error Request to S3 Failed | Failed to complete the request to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20006 | Internal server error Request to S3 Forbidden | Failed to get access to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20007 | Internal server error Request time to S3 is longer than the established time | Request time to the S3 storage exceeded the specified limit. Check the storage availability. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20008 | Internal server error S3 Connection Refused | Connection to the Image Store (S3) was refused. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20009 | Internal server error Connect time to S3 is longer than the established time | Connection time to the S3 storage has exceeded the specified limit. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20010 | Internal server error Unknown s3 error | An unknown S3 storage error occurred. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20011 | Internal server error Failed to get bucket list | Image Store could not get a list of buckets from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20012 | Internal server error Failed to get image from the storage | Image Store could not get an image from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20013 | Internal server error Failed to save object in the storage | Image Store could not save an object to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20014 | Internal server error Failed to remove object from the storage | Image Store could not delete an object from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20015 | Internal server error Failed to remove object list from the storage | Image Store could not delete a list of objects from theS3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20016 | Internal server error Failed to get object from the storage | Image Store could not get an object from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20017 | Internal server error Failed to get object list from the storage | Image Store could not get objects from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20018 | Internal server error Failed to delete bucket | Image Store could not delete a bucket form the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store. |
20019 | Bad/incomplete query Failed to create bucket with specified name | The bucket with the given name cannot be created. |
Faces service errors#
Error code | Error Message | Error Description |
---|---|---|
22001 | Unique constraint error Face with the same attribute_id already exists | A Face with the provided attribute_id already exists. An attribute can be attached to a single face only. |
22002 | Object not found Face with id ‘{value}’ not found | The Face with the specified "face_id" was not found. A typo was made in the "face_id" field or a Face with such an ID does not exist. |
22003 | Object not found List with id ‘{value}’ not found | The List with the given ID was not found. You should specify an existing List in the request. |
22004 | Object not found One or more faces not found including face with id ‘{value}’ | One or more Faces were not found, including the Face with the specified ID. A typo was made in the "face_id" field or a Face with such an ID does not exist. |
22005 | Object not found One or more lists not found including list with id ‘{value}’ | One or more Lists were not found, including the List with the specified ID. The specified Lists do not exist. You should specify an existing list in the request. |
22007 | Object not found Person with id ‘{value}’ not found | The person with the given ID was not found in the database. |
22008 | Unique constraint error This face is already attached to the person | The face is already attached to a person. |
22009 | Bad/incomplete configuration Face avatar url is not correct | The URL in the "avatar" field in the request is incorrect. Check the provided URL. |
22010 | Object not found Attributes with id ‘{value}’ for update not found | An error occurred while updating the fields of the existing Face. The "attribute_id" field in the request is invalid. The attribute with the specified ID was not found. |
22011 | Object not found Attributes with id {value} not found | Attributes with the specified ID were not found in the database. You should specify an existing "attribute_id" in the request. |
22012 | Bad/incomplete input data Failed to decode descriptor from base64 | Failed to decode the descriptor from the BASE64 format. A software error occurred. |
22013 | Bad/incomplete input data Failed to encode descriptor to base64 | Failed to encode the descriptor to the BASE64 format. A software error occurred. |
22015 | Conflict input data Attribute ‘{value}’ generation should be ‘{value}’ but ‘{value}’ was provided | The attribute generation does not match the provided one. The error occurs upon the extraction of the descriptor of a new version. The source descriptor was updated, so the descriptor of a new version cannot be added to the database. It is required to reextract the descriptor using source image and the required NN version. |
22016 | Bad input data ‘{value}’ is not valid target to get faces. Valid target should be one of {value}. | Invalid «target» to get Faces. The valid "target" should be one of the specified in this error. Check the OpenAPI documentation of the Faces service for additional information about targets. |
22017 | Bad/incomplete input data Match reference must be specified either as (descriptor) or (attribute_id) or (face_id) | The reference for matching must be specified as a descriptor, an attribute ID, or a face ID. |
22018 | Object not found Descriptor of version {value} is not found for object with id ‘{value}’. | There is no descriptor with the specified version for the object with the specified ID. |
22020 | Internal server error Corrupted attribute with id ‘{value}’ | The attribute with this ID is corrupted due to unknown reasons. |
22021 | Integrity error Attribute with id ‘{value}’ already exist | The attribute with the specified ID already exists. |
22022 | Bad input data Attribute does not contain ‘descriptors’ and ‘basic_attributes’ | The input attribute does not contain any data: 'descriptors' and 'basic_attributes'. |
22023 | Bad input data Attribute contains ‘{value}’ samples but corresponding attributes is empty | The attribute contains samples without data. |
22024 | Bad input data Attribute contains descriptors of identical versions: ‘{value}’ | The attribute contains descriptors of the same version. |
22025 | Conflict input data Attribute samples of face (face_id ‘{value}’) do not match specified ones | The attribute samples of the face with the specified face_id do not match specified samples. |
22026 | Unique constraint error List with id ‘{value}’ already exist | The list with the specified ID already exists and cannot be created. |
Events service errors#
Error code | Error Message | Error Description |
---|---|---|
23001 | Object not found Event with id {value} not found | The event with the specified ID was not found by Events service. The event does not exist. |
23002 | Object not found One or more events not found including event with id {value} | One or more events were not found by the Events service, including the specified event. These events were deleted or there is an error in their IDs. |
23003 | Unique constraint error One or more event id from {value} already exist | One or more event IDs from the list already exist and cannot be created. |
23004 | Unique constraint error One or more attribute id from ‘{value}’ already exist | One or more listed Attribute IDs already exist. |
23005 | Bad input data ‘{value}’ is not valid target to get events. Valid events should be one of {value} | The specified target is not valid. Specify one of the available targets. |
23006 | Internal server error Timeout ({value} seconds) for saving events into history database has been expired | The timeout for saving events into the database has been expired. The request took too long due to massive provided data or problems with connection to the Database. |
23007 | Object not found Human descriptor of version {value} is not found for object with id ‘{value}’. | Human descriptor was not found for the object. |
23008 | Internal server error Copywriter queue is full | Copywriter queue is full. |
23009 | Internal server error Events are shutting down | Events are shutting down. Check the Events service. |
23010 | Internal server error Events saving failed reason: {value} | The saving of an event failed due to an internal server error. |
Index services error#
Error code | Error Message | Error Description |
---|---|---|
26001 | Object not found Index task not found | Index task was not found. |
26002 | Internal server error Generation not found in indexer | The generation was not found in the Indexer service |
26003 | Internal server error Not expected status of indexer | Indexer has an unexpected status. |
26004 | Internal server error Failed start upload generation {value} on daemon {value} reason: {value} | The generation was not uploaded on the specified daemon. The reason is given. |
26005 | Internal server error Failed start reload generation {value} on daemon {value} reason: {value} | The generation was not reloaded on the specified daemon. The reason is given. |
26007 | Internal server error Not expected status of upload task. Status: {value} daemon: {value} generation: {value} | An unexpected status of the upload task was returned. |
26008 | Internal server error Not expected status of restart task. Status: {value} daemon: {value} generation: {value} | An unexpected status of the restart task was returned. |
26009 | Bad/incomplete input data List does not satisfy to the indexation condition | The list does not match the specified indexation conditions. |
Configurator service errors#
Error code | Error Message | Error Description |
---|---|---|
27001 | Object not found Setting with id ‘{value}’ not found | The setting with the specified ID was not found. Check that the specified ID is correct and the setting exists in the Configurator. |
27002 | Integrity error Setting with the following fields already exists: name: {value} tag: {value} | The setting with the specified fields exists. The name and tag pair should be unique in the database. |
27003 | Bad/incomplete input data Connection check to service is failed | The request for the specified service URL failed. Check that the service is running and available through network. |
27004 | Bad/incomplete input data Not allowed to change tags for default setting | You cannot create a tag for the default setting. The default setting can't have a tag. Duplicate the setting to change it and apply a tag. |
27005 | Bad/incomplete input data Tag ‘{value}’ for setting ‘{value}’ not found | There is no specified tag for the specified setting. |
27006 | Object not found Limitation named ‘{value}’ not found | The newly created setting should match the configuration template (limitation) that is set for it. A description of the configuration template is provided in the user interface and dump-file (the file can be received using the corresponding request). |
27007 | Integrity error Limitation named ‘{value}’ already exists | When creating a new template for the settings (limitation) you used the name of an existing template. The name should be unique. |
27008 | Object not found Group named ‘{value}’ not found | The Group object with the specified name was not found. |
27009 | Object not found One or more groups not found including group named ‘{value}’ | One or several Group objects were not found, including the object with the specified name. |
27010 | Integrity error Group named ‘{value}’ already exists | The Group object with the specified name already exists. |
27011 | Bad/incomplete input data Cannot remove default setting ‘{value}’ | It is unavailable to delete the default setting from the Configurator. |
27012 | Bad/incomplete input data Not allowed to change default setting name | Error when trying to change the default setting name. It is not allowed to change the default setting name. Duplicate the setting to change it and apply a new name. |
Tasks service errors#
Error code | Error Message | Error Description |
---|---|---|
28000 | Network error Cannot send subtasks to task_workers. Reason: ‘{value}’ | Failed to send subtasks to Tasks service workers. The reason is shown in the "Reason" field. |
28001 | Object not found Task with id ‘{value}’ not found | The task with the specified ID was not found by Tasks service. The identifier was set incorrectly or the task with the specified identifier was deleted. |
28002 | Object not found One or more tasks not found including task with id {value} | The Tasks service did not found the specified tasks, including the task with the specified ID. The ID is set incorrectly or the task was deleted. |
28003 | Object not found Task error with id ‘{value}’ not found | An error with the ID specified in the request was not found by the Tasks service. The error does not exist. |
28004 | Object not found One or more tasks not found including task with id ‘{value}’ | One or more errors were not found by Tasks service, including the error with the specified ID. The ID is incorrect or the error has been deleted. |
28005 | Stop tasks worker On worker shutdown all active tasks on the worker are failed all active subtasks are cancelled | The task execution process was interrupted because Tasks handler was stopped. All active subtasks have been canceled. You should check the status of all Tasks service handlers. Some of the handlers became unavailable for some reason. |
28006 | Internal server error Failed to update task {value} status. Desired status: {value} | Tasks service failed to update the specified task status. The expected status is shown. |
28007 | Internal server error Failed to update subtask {value} status. Desired status: {value} | Tasks service failed to update the subtask status. |
28008 | Internal server error Failed to update task {value} progress. Desired progress: {value} | Tasks service failed to update the progress of the task. |
28009 | Attribute is not equal Event ({value}) attribute is not equal {value} corresponding face attribute | The event attribute ID and the corresponding Face attribute ID did not match (Linker task). |
28010 | Objects not found Objects for clustering not found (empty set) | The objects specified for clustering were not found by the Tasks service. |
28011 | Internal server error Failed to save report to a csv-file | Tasks service failed to create a CSV file for the report. |
28012 | Internal server error Failed to create archive from a report | Tasks service failed to create the archive for the report. |
28013 | Bad/incomplete input data Tasks with type ‘{value}’ does not support a build report | You cannot create the report (reporter task) for this type of task. |
28014 | Bad/incomplete input data Column ‘{value}’ not allowed in report by {value} | The specified column cannot be added to the report (reporter task). The column is not available in the reporter task. |
28015 | Bad/incomplete input data Tasks with status ‘{value}’ does not support a build report | A report cannot be created for tasks with the specified status (reporter's task). You should wait for the task to complete to get a report. |
28016 | Bad/incomplete input data Clusterization task without result does not support a build report | A report cannot be generated for a clusterization task without results. |
28017 | Object not found Result of the task ‘{value}’ not found | The result of the specified task was not found. |
28018 | Object not found Task ‘{value}’ does not have result yet | The task has no result yet. You should wait for the task to complete. |
28019 | Bad/incomplete input data Task ‘{value}’ with status {value} cannot be canceled | A task with the specified status cannot be canceled. Depending on the status, the task may have been stopped, completed with an error, or completed. |
28020 | Object not found Impossible get a result of task {value} with status {value} | It is unable to get the result of the Tasks service task with the specified status. |
28021 | Forbidden Service does not support Luna Events as source for tasks | The service does not support Luna Events as a data source for tasks. You should enable the Events service usage in the ADDITIONAL_SERVICES_USAGE setting in the configuration file of the Tasks service or in the Configurator service. |
28022 | Objects not found {value} for cross-matching not found (empty set) | The specified object for cross-matching was not found. |
28023 | Reference uuid is missing: {value} | The object with the ID specified for the cross-matching task was not found. |
28024 | Reference uuid has no extracted descriptor: {value} | There is no extracted descriptor for the object with UUID specified for the cross-matching task. |
28025 | Task ‘{value}’ has been cancelled | The task was canceled. |
Sender service errors#
Error code | Error Message | Error Description |
---|---|---|
29001 | Forbidden Cannot subscribe for events without ‘Luna-Account-Id’ header set | The request does not include the Luna-Account-Id header required to subscribe to the events of the Events service. |
29002 | Internal server error Failed to subscribe to chanel {value} | Sender could not subscribe to the Reddit channel. |
29003 | Internal server error Failed to process input message | Sender could not process the incoming image. |
29004 | Internal server error Failed to publish message to ws | Sender could not publish a message by web socket. |
29005 | Service Unavailable Redis disconnected | The Sender service is unavailable. Redis DB was disconnected. |
Python Matcher service errors#
Error code | Error Message | Error Description |
---|---|---|
31000 | Bad/incomplete input data Account id from query parameters does not match the one from {value} filters | The account ID specified in the query parameters does not match the account ID from the specified filters. The data belongs to different Account IDs. |
31001 | Bad/incomplete input data Descriptor has the version ({value}) which does not match with version ({value}) which is supposed to use for the matching | The version of the processed descriptor does not match the version, currently used for the matching. |
31002 | Bad/incomplete input data Cross match filters presume too many received objects. Current general limit - {value} | Too many objects were sent for the cross-matching task. The available limit is shown in the error. |
31003 | Internal server error Unknown cross matching error | An unknown cross-matching error occurred. |
31005 | Bad/incomplete input data Matching between different versions {value} is not allowed | Matching between different versions is not allowed |
31006 | Internal server error Unexpected behavior of the ‘{value}’ matcher: {value} | Unexpected behavior of the given matcher. The error occurs when using plugins.A plugin error is displayed, which occurs because the plugin author did not take into account the requirements for using plugins. |
Liveness service errors#
Error code | Error Message | Error Description |
---|---|---|
32000 | Internal server error Failed to predict liveness | An internal server error. Liveness prediction failed due to unknown reason. |
32001 | A distance between face and camera is too small {value} | The distance between the face and the camera is too small. |
32002 | Face is too close to one or more borders. {value} | The face is too close to one or more edges of the frame. It is recommended that the face does not go out of the frame and there is some distance from the edges of the frame. |
32003 | Face is cropped {value} | One or several face sides are cropped and not inside the frame. It is highly recommended that no part of the face extends beyond the frame |
32004 | Face detector can’t find face on image {value} | The system cannot find a face in the image. There is no face in the image or it is not distinguishable |
32005 | Facial area is not big enough for analysis. {value} | The face is not large enough for processing. Either interpupillary distance or face size is below the required value. |
32006 | Facial out-of-plane rotation angle is extremely large {value} | Out-of-plane rotation (face pitch and yaw) angles are greater than 20 degrees in either direction. |
32007 | Landmarks prediction error {value} | Facial landmarks were not found. |
32008 | Face detection error {value} | An error occurred during face detection for liveness check. |
32009 | Liveness prediction error {value} | An error occurred during liveness prediction. |
32010 | File decoding error {value} | File decoding error. Check the image file. |
32011 | Model deserializing error {value} | Model deserializing error. The model cannot be read. |
32012 | File encoding error {value} | File decoding error. Cannot write the image. |
32014 | Invalid fuse mode provided {value} | Invalid fuse mode provided |
32015 | Engine or backend is not supported by the build {value} | Engine or backend is not supported by the build |
32017 | Too many faces detected {value} | Too many faces detected. The number of detected faces exceeds the maximum number of faces in the configuration. One face is set by default. |
Licenses service errors#
Error code | Error Message | Error Description |
---|---|---|
33001 | License problem Failed to check HASP License feature {value} | A license problem occurred. The request for the feature availability failed. Check your license. Possible reasons: the license was not applied, you use a wrong license, connection to the license server could not be established. |
33002 | License problem Failed to get value of HASP License feature {value} | A license problem occurred. The request for the feature value failed. Check your license. Possible reasons: the license was not applied, you use a wrong license, connection to the license server could not be established. |
33003 | License problem No value found for required HASP License feature {value} | A license problem occurred. The request for expiration date and faces limit failed. The license does not include this data. Possible reasons: the license was not applied, you use a wrong license, connection to the license server could not be established. |
33004 | License problem Failed to consume {value} | The specified licensed LP feature cannot be used because the limit on the number of transactions was exceeded. Check your license. |
33005 | License problem Failed to consume : license expired | The specified licensed LP feature cannot be used because the license has expired. Check your license. |
Handlers service errors#
Error code | Error Message | Error Description |
---|---|---|
34000 | Object not found Handler with id {value} not found | The handler with the specified ID was not found. |
34001 | Forbidden Descriptor version {value} is not supported | The descriptor with the specified version is not supported. |
34002 | Internal server error Cannot load handler with id ‘{value}’. Handler is corrupted | The system cannot load the handler with the specified ID. The handler is corrupted. |
34003 | Bad/incomplete input data Aggregation is not supported for raw descriptors | Aggregation is not supported for raw descriptors. The error occurs when you specify aggregation and provide descriptors instead of images. |
34004 | Object not found Verifier with id {value} not found | Verifier with the specified ID is not found. |
34005 | Bad/incomplete input data Candidates limit exceeded: {value} > {value} | Candidates limit exceeded. A limited number of candidates can be specified. |
34006 | Bad/incomplete input data No candidates specified | No candidates were specified. |
34007 | Forbidden Allowed use only dynamic handler | It is allowed to use a dynamic handler only. |
35000 | Bad/incomplete input data Attributes gc is not available | Attributes gc is not available. |
35001 | Forbidden Luna Sender service is disabled | Sender service is disabled. Check the ADDITIONAL_SERVICES_USAGE settings in the Configurator service or in the configuration file. |
35002 | Handler is not supported Invalid handler with id ‘{value}’ | The handler is not supported in Backport 4. |
36001 | Bad/incomplete input data Expected list of {value}. Got list of {value}. List id ‘{value}’ | Wrong list type is provided. |
36002 | Bad/incomplete input data Bad format basic authorization header format: Basic base64(login:password) | Bad format of basic authorization header. |
36003 | Face does not satisfy thresholds limits No faces found. | No faces that satisfy the specified threshold limits were found. |
36004 | Bad/incomplete input data Face was not linked to the person | The face was not linked to the person. |
37001 | Internal server error Service did not process the request within {value} seconds | The service did not process the request within the specified period. The error may occur due to high system load, lack of server resources or network problems. |
37002 | Request timeout Service did not receive the complete request message within {value} seconds | The service did not receive a complete request message within the specified period. The error may occure due to high system load, lack of server resources, network problems. |
37003 | Request payload is too large | Request payload is too high. |
37004 | Internal server error Unknown web application error: {value} | Unknown web application error. |
37005 | Client closed request | The client-side was disconnected. |
Healthcheck error#
Error code | Error Message | Error Description |
---|---|---|
38001 | Health check error {value} | Service health check error. |
Cached Matcher error#
Error code | Error Message | Error Description |
---|---|---|
40001 | Object not found List with id ‘{value}’ not found in the cache | The list with the given ID was not found in the cache. |
SDK errors#
Error code | Error Message | Error Description |
---|---|---|
100001 | Buffer is empty {value} | The buffer is empty. |
100002 | Buffer is null {value} | The buffer is null. |
100003 | Buffer is full {value} | The buffer in full. |
100004 | Descriptors are incompatible {value} | The specified descriptors are incompatible. |
100005 | Internal error {value} | An internal error occurred. |
100006 | Invalid buffer size {value} | Invalid buffer size. |
100007 | Invalid descriptor {value} | Invalid descriptor. Check the descriptor file. |
100008 | Invalid descriptor batch {value} | Invalid descriptors batch. Check the descriptors batch. |
100009 | Invalid detection {value} | Invalid detection. |
100010 | Invalid image {value} | Invalid image. Check that the image file is not corrupted and can be processed by the system. |
100011 | Invalid image format {value} | Invalid image format. |
100012 | Invalid image size {value} | Invalid image size. |
100013 | Invalid input {value} | Invalid input. |
100014 | Invalid landmarks 5 {value} | Invalid landmarks5. |
100015 | Invalid landmarks 68 {value} | Invalid landmarks68. |
100016 | Invalid rectangle {value} | Invalid rectangle. |
100017 | Invalid settings provider {value} | Invalid settings provider. |
100018 | Licensing issue {value} | Licensing issue. |
100019 | Module is not initialized {value} | Module is not initialized. |
100020 | Module is not ready {value} | Module is not ready. |
100021 | Error during initialization fdsk image {value} | FSDK image initialization error. |
100022 | Error during image loadin {value} | Image loading error. |
100023 | Error during image saving {value} | Image saving error. |
100024 | Archive image error {value} | Archive image error. |
100025 | Invalid detection {value} | Invalid detection. |
100026 | Image conversion not implemented {value} | Image conversion not implemented. |
100027 | Bad input image data pointer {value} | Bad input image data pointer. |
100028 | Bad input image data size {value} | Bad input image data size. |
100029 | Unsupported image format {value} | Unsupported image format. |
100030 | Invalid image height {value} | Invalid image height. |
100031 | Bad path for image saving / loading {value} | Bad path for image saving/loading. |
100032 | Error at image memory opening {value} | Error at image memory opening. |
100033 | Unsupported image type {value} | Unsupported image type. |
100034 | Invalid image width {value} | Invalid image width. |
100035 | Batching error {value} | Batching error. |
110001 | Creation descriptor error {value} | Descriptor creation error. |
110002 | Creation descriptor error {value} | Descriptors batch creation error. |
110003 | Creation core image error {value} | Core image creation error. |
110004 | Estimation descriptor error {value} | Descriptor estimation error. |
110005 | Estimation descriptor error {value} | Descriptors batch estimation error. |
110006 | Estimation basic attributes error {value} | Basic attributes estimation error. |
110007 | Batch estimation basic attributes error {value} | Basic attributes batch estimation error. |
110008 | Estimation AGS error {value} | AGS estimation error. |
110009 | Estimation head pose error {value} | Head pose estimation error. |
110011 | Estimation eyes gase error {value} | Gaze estimation error. |
110012 | Estimation emotions error {value} | Emotions estimation error. |
110013 | Estimation warp quality error {value} | Sample quality estimation error. |
110014 | Estimation mouth state error {value} | Mouth state estimation error. |
110015 | Estimation eyes error {value} | Eyes estimation error. |
110016 | Creation warped image error {value} | Sample creation error. |
110017 | Landmarks transformation error {value} | Landmarks transformation error. |
110018 | Detect one face error {value} | Single face detection error. |
110019 | Detect faces error {value} | Several faces detection error. |
110020 | High memory usage {value} | High memory usage error. |
110021 | Detect one human body error {value} | Single human body detection error. |
110022 | Detect humans bodies error {value} | Humans bodies detection error. |
110023 | Estimation mask error {value} | Mask estimation error has occurred. |
110024 | Filtered aggregation error {value} | Aggregation error related to the specified threshold. |
120004 | The command does not exist {value} | The command does not exist. |
120005 | Internal RPC error {value} | Internal RPC error. |
120006 | The command is not valid {value} | The command is not valid. |
1100010 | Estimation ethnities error {value} | Ethnicity estimation error. |