API errors#
The section describes errors, returned by the API service. Each of the errors has a unique code. This section also includes a description of CORE errors returned by the API service. The errors can have different reasons and appear in several different CORE services. In this case, it is recommended to check service logs to find out where the error occurs.
General connection errors#
| Error code | Error Message | Error Description |
|---|---|---|
| 0 | Success Success | This code is returned when there are no errors and the request is successfully processed. |
| 1 | Internal server error Unknown error | Internal error. Cause unknown. |
| 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. |
| 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, or invalid key 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 Connect timeout on {value} method {value} | Connection error. The connection time limit exceeded. |
| 9 | Request timeout 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. |
| 14 | Client connector certificate error {value} | Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version. |
| 15 | Client SSL error {value} | Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version. |
| 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 received in the incorrect JSON format. |
CORE errors, returned in API responses#
| Error code | Error Message | Error Description |
|---|---|---|
| 100 | Bad/incomplete configuration {value} | Cannot read the configuration file, or invalid file name. |
| 101 | Bad/incomplete query {value} | Invalid request parameters or mandatory parameters are absent. See "QUERY PARAMETERS" in the API documentation. |
| 102 | Bad/incomplete body {value} | Invalid request body. See "REQUEST BODY SCHEMA" in the API documentation. |
| 105 | Out of memory {value} | Not enough memory. |
| 106 | Invalid http request {value} | Invalid HTTP request. Make sure the request URL is 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 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 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. Matcher error. |
| 5004 | Bad/incomplete input data {value} | Invalid request content. Matcher error. |
| 5005 | Invalid config {value} | Invalid Matcher configuration file. Matcher error. |
| 5101 | Reference UUID is missing Reference uuid is missing | Reference UUID not found. Matcher error. |
| 5102 | Reference UUID has no extracted descriptor Reference uuid has no extracted descriptor | The extracted descriptor for Reference UUID not found. Failed to match the descriptor. The descriptor was extracted with an outdated neural network version. Matcher error. |
| 7001 | Bad/unsupported API version {value} | Invalid API version specified in the request. |
Database Errors#
| Error code | Error Message | Error Description |
|---|---|---|
| 10015 | 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. |
| 10017 | DataBaseConnectionTimeoutError | Database connection timeout error. |
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. |
| 11004 | Account is suspended Account is suspended | The account is not active (Backport 3). |
| 11009 | Internal server error 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 Descriptor with id ‘{value}’ not found | 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} | The 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. |
| 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 attributes. |
| 11034 | Bad/incomplete input data Descriptor for attribute {value} was not extracted | The descriptor for the specified attribute was not extracted. You should verify the correctness of the "attribute_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 UUID4 format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx | The "Luna-Account-Id" header in the request is not in UUID4 format, the required format is xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxxxx. |
| 11038 | Multiple faces found Multiple faces found in image {value} detect {value} | There is more than one person in the image. The policy of processing images with a single face 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 LUNA_TASKS_SUPPORT parameter in "/var/lib/luna/current/luna-api/luna_api/configs/config.conf". |
| 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 LUNA_EVENTS_SUPPORT parameter in "/var/lib/luna/current/luna-api/luna_api/configs/config.conf". |
| 11041 | Object not found No one face found with external id {value} | The face object with the specified external ID was not found. |
| 11042 | Unhandled exception: {value} | An unhandled exception occurred |
| 11043 | Bad/incomplete input data | Bad or incomplete input data is provided for the warped image in the request |
| 11044 | turned off for LUNA API instance | The process is turned off for the API instance. Check API configurations. |
| 11045 | Only one detection rectangle is available for each image at the moment | Only one detection rectangle is available for each image at the moment |
| 11046 | Several files with name {value} were 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 is not available for warped images | The bounding box is not available for warped images |
| 11048 | There is more than a single bounding box specified in the 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 | More than one bounding box for image named {value} was found | The image has several bounding boxes. |
| 11051 | Service static folder was not loaded | The service static directory was not loaded |
| 11052 | No attribute was specified for the extraction | No attribute was specified for extraction. You should specify at least one attribute ID in the request. |
| 11053 | Multiple human bodies found Multiple human bodies found in 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. |
| 11055 | Forbidden License problem: ‘{value}’ | License error. The license has expired or is unavailable. |
| 11056 | Bad/incomplete input data {value} | The request in invalid. The request data is incomplete. |
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. You should 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. You should 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 "/ 5 / sample" instead of "/ 5 / samples". You should 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. You should 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. You should 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. You should 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 The input data content type is not acceptable the allowed content types: | The request contains invalid data. Most likely, there is a typo in the request. |
| 12024 | Bad/incomplete input data Unsopported 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. You should 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 with name ‘{value}’ 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 |
| 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 XPK file |
| 12036 | Bad/incomplete input data Descriptor version {value} is not registered in the system | The specified descriptor version is not registered in the system. You set a wrong version or use an incompatable service version. |
| 12037 | Bad/incomplete input data XPK file does not contain descriptor | The input data XPK does not contain a descriptor |
| 12038 | Bad/incomplete input data SDK descriptor is not valid | SDK descriptor is not valid. |
| 12039 | Bad/incomplete input data Unknown multipart name ‘{value}’ | There is an unknown name in the multipart request |
| 12040 | Bad/incomplete input data Duplicate multipart name ‘{value}’ | There is a duplicated name in the multipart 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 |
| 12043 | Unknown error Service ‘{value}’ unknown error method: ‘{value}’ url: ‘{value}’ | Unknown service error has occurred. See 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. |
| 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 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. " |
| 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 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 with the specified «Luna-Account-Id» |
| 15013 | Unique constraint error Account with same email or id already exist | The e-mail with the specified «Luna-Account-Id» already exists. |
| 15014 | Bad/incomplete input data Login or password is incorrect | Bad input. The login or the password 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 error is in BASE64. |
| 18002 | Bad/incomplete input data Failed convert bytes to jpg | Failed to convert bytes to JPG image. The request does not include a photo image. |
| 18003 | Bad/incomplete input data Failed read bytes as image | The image bytes cannot be read |
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 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. |
| 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 | It is unable to create a Face based on the attribute specified in the "attribute_id" field in the request. A Face with this attribute already exists. An attribute can be attached to only one face. |
| 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 the 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. |
| 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. It is a software Error. |
| 22013 | Bad/incomplete input data Failed to encode descriptor to base64 | Failed to encode the descriptor to the BASE64 format. It is a software Error. |
| 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. |
| 22016 | Bad input data ‘{value}’ is not valid target to get faces. Valid target should be one of {value}. | The invalid value is specified in the «target» request parameter. |
| 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. |
| 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 attribute does not contain any data: ‘descriptors’ or ‘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 existing face (with face_id {value}) do not match specified samples | 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 Events service, including the specified event. The events do not exist. |
| 23003 | Unique constraint error One or more event id from {value} already exist | One or more event IDs from the list already exist. |
| 23004 | Unique constraint error One or more attribute id from ‘{value}’ already exist | One or more listed Attribute ID already exists. |
| 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 save events into history database has been expired | The timeout for saving events into the database has been expired |
| 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 |
| 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 Indexer service |
| 26003 | Internal server error Not expected status of indexer | Indexer has 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. |
| 27002 | Integrity error Setting with the following fields already exists: name: {value} tag: {value} | The setting with the specified fields does not exist. 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. |
| 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. |
| 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 documentation. |
| 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. |
| 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 settings. |
| 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 |
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 handlers. 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 Tasks service. The error does not exist. |
| 28004 | Object not found One or more task errors not found including task error 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 (a 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 (the task of the reporter). The column is not correct. |
| 28015 | Bad/incomplete input data Tasks with status {value} does not support a build report | For a task with the specified status, you cannot create a report (a 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 | The clustering task that was not completed does not support report generation. |
| 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 set the value of the parameter "LUNA_EVENTS_SUPPORT = 1" in the configuration file of the Tasks 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 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 Reference uuid has no extracted descriptor: {value} | There is no extracted descriptor for the UUID specified for the cross-matching task. |
| 28025 | Task has been cancelled 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 |
Liveness service errors#
| Error code | Error Message | Error Description |
|---|---|---|
| 32000 | Internal server error Failed to predict liveness | An internal server error occurs. Liveness prediction failed. |
| 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 borders. It is highly recommended that no part of the face extends beyond the frame and there is a distance left between the face and each of the frame sides. |
| 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 the 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 the 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 the wrong license, connection to the license server could not be established. |
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 | Descriptor version {value} is not supported | The descriptor with the specified version is not supported. |
| 34002 | 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 ID is not found. |
| 34005 | Bad/incomplete input data Candidates limit exceeded: {value} > {value} | Candidates limit exceeded |
| 34006 | Bad/incomplete input data No candidates specified | No candidates were specified |
| 35000 | Bad/incomplete input data Attributes gc is not available | Attributes gc is not available |
| 35001 | Forbidden Luna Sender service is disabled | Luna Sender service is disabled |
| 35002 | Handler is not supported Invalid handler with id ‘{value}’ | The handler is not supported (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 basic authorization header, |
| 36003 | Face does not satisfy thresholds limits No faces found. | Face does not satisfy threshold limits. No faces found |
| 36004 | Bad/incomplete input data Face was not linked to the person | Face was not linked to the person |
SDK errors#
| Error code | Error Message | Error Description |
|---|---|---|
| 100001 | Buffer is empty | The buffer is empty |
| 100002 | Buffer is null | The buffer is null |
| 100003 | Buffer is full | The buffer in full |
| 100004 | Descriptors are incompatible | The specified descriptors are incompatible |
| 100005 | Internal error | An internal error occurred |
| 100006 | Invalid buffer size | Invalid buffer size |
| 100007 | Invalid descriptor | Invalid descriptor |
| 100008 | Invalid descriptor batch | Invalid descriptor batch |
| 100009 | Invalid detection | Invalid detection |
| 100010 | Invalid image | Invalid image |
| 100011 | Invalid image format | Invalid image format |
| 100012 | Invalid image size | Invalid image size |
| 100013 | Invalid input | Invalid input |
| 100014 | Invalid landmarks 5 | Invalid landmarks 5 |
| 100015 | Invalid landmarks 68 | Invalid landmarks 68 |
| 100016 | Invalid rectangle | Invalid rectangle |
| 100017 | Invalid settings provider | Invalid settings provider |
| 100018 | Licensing issue | Licensing issue |
| 100019 | Module is not initialized | Module is not initialized |
| 100020 | Module is not ready | Module is not ready |
| 100021 | FSDK image initialization error | FSDK image initialization error |
| 100022 | Image loading error | Image loading error |
| 100023 | Image saving error | Image saving error |
| 100024 | Archive image error | Archive image error |
| 100025 | Invalid detection | Invalid detection |
| 100026 | Image conversion not implemented | Image conversion not implemented |
| 100027 | Bad input image data pointer | Bad input image data pointer |
| 100028 | Bad input image data size | Bad input image data size |
| 100029 | Unsupported image format | Unsupported image format |
| 100030 | Invalid image height | Invalid image height |
| 100031 | Bad path for image saving / loading | Bad path for image saving / loading |
| 100032 | Error at image memory opening | Error at image memory opening |
| 100033 | Unsupported image type | Unsupported image type |
| 100034 | Invalid image width | Invalid image width |
| 100035 | Batching error | Batching error |
| 110001 | Descriptor creation error | Descriptor creation error |
| 110002 | Descriptors batch creation error | Descriptors batch creation error |
| 110003 | Core image creation error | Core image creation error |
| 110004 | Descriptor estimation error | Descriptor estimation error |
| 110005 | Descriptors batch estimation error | Descriptors batch estimation error |
| 110006 | Basic attributes estimation error | Basic attributes estimation error |
| 110007 | Basic attributes batch estimation error | Basic attributes batch estimation error |
| 110008 | AGS estimation error | AGS estimation error |
| 110009 | Head pose estimation error | Head pose estimation error |
| 110011 | Eyes gaze estimation error | Eyes gaze estimation error |
| 110012 | Emotions estimation error | Emotions estimation error |
| 110013 | Warp quality estimation error | Warp quality estimation error |
| 110014 | Mouth state estimation error | Mouth state estimation error |
| 110015 | Eyes estimation error | Eyes estimation error |
| 110016 | Warped image creation error | Warped image creation error |
| 110017 | Landmarks transformation error | Landmarks transformation error |
| 110018 | Single face detection error | Single face detection error |
| 110019 | Several faces detection error | Several faces detection error |
| 110020 | High memory usage error | High memory usage error |
| 110021 | Single human body detection error | Single human body detection error |
| 110022 | Humans bodies detection error | 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 |
| 1100010 | Estimation ethnities error {value} | Ethnities estimation error |