Коды ошибок API распознавания лиц Azure
Коды распространенных ошибок
Эти коды ошибок могут быть возвращены вызовами API распознавания лиц.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Текст запроса недопустим. | |
| Недопустимый запрос (400) | BadArgument | Ошибка синтаксического анализа JSON. | Недопустимый или неузнаваемый текст запроса JSON. |
| Недопустимый запрос (400) | BadArgument | "recognitionModel" недопустим. | |
| Недопустимый запрос (400) | BadArgument | "detectionModel" недопустим. | |
| Недопустимый запрос (400) | BadArgument | "name" пуст. | |
| Недопустимый запрос (400) | BadArgument | "name" слишком длинный. | |
| Недопустимый запрос (400) | BadArgument | "userData" слишком длинный. | |
| Недопустимый запрос (400) | BadArgument | "пуск" слишком длинный. | |
| Недопустимый запрос (400) | BadArgument | "Top" недопустим. | |
| Недопустимый запрос (400) | BadArgument | Аргумент targetFace вне диапазона. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый аргумент targetFace. | Вызвано недопустимым форматом строки или недопустимым левым или верхним, высотой или шириной. |
| Недопустимый запрос (400) | InvalidURL | Недопустимый URL-адрес изображения. | Поддерживаемые форматы: JPEG, PNG, GIF (первый кадр) и BMP. |
| Недопустимый запрос (400) | InvalidURL | Недопустимый URL-адрес изображения или ошибка скачивания с целевого сервера. Возвращена ошибка удаленного сервера: "Произошла ошибка при отправке запроса". | |
| Недопустимый запрос (400) | InvalidImage | Ошибка декодирования, формат изображения не поддерживается. | |
| Недопустимый запрос (400) | InvalidImage | Лицо не обнаружено на изображении. | |
| Недопустимый запрос (400) | InvalidImage | В изображении более 1 лица. | |
| Недопустимый запрос (400) | InvalidImageSize | Размер изображения слишком мал. | Допустимый размер файла изображения должен быть больше или равен 1 КБ. |
| Недопустимый запрос (400) | InvalidImageSize | Размер изображения слишком велик. | Допустимый размер файла изображения не должен превышать 6 МБ. |
| Не авторизовано (401) | 401 | Доступ запрещен из-за недопустимого ключа подписки или неправильной конечной точки API. Обязательно укажите допустимый ключ для активной подписки и используйте правильную региональную конечную точку API для ресурса. | |
| Запрещено (403) | Неподдерживаемоеfeature | Функция не поддерживается, отсутствует утверждение для одной или нескольких следующих функций: идентификация, проверка. | Зарегистрируйтесь для доступа, отправив форму регистрации. |
| Конфликт (409) | ConcurrentOperationConflict | Существует конфликтная операция с ресурсом <resourceName>, попробуйте позже. |
|
| Слишком много запросов (429) | 429 | превышено ограничение скорости. |
Коды ошибок обнаружения лиц
Эти коды ошибок могут быть возвращены операцией обнаружения лиц.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый аргумент returnFaceAttributes. | |
| Недопустимый запрос (400) | BadArgument | 'returnFaceAttributes' не поддерживается detection_02. | |
| Недопустимый запрос (400) | BadArgument | 'returnLandmarks' не поддерживается detection_02. | |
| Запрещено (403) | Неподдерживаемоеfeature | Возвращаемые атрибуты (эмоции, пол, возраст, улыбка, волосы, волосы и макияж) устарели и больше не поддерживаются. | Команда распознавания лиц Azure, если у вас есть ответственный вариант использования, который будет использовать любую из ограниченных возможностей. |
Коды ошибок сеанса liveness для лиц
Эти коды ошибок могут быть возвращены операциями сеанса liveness face.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый параметр start. Укажите поле "Идентификатор" последней записи, чтобы продолжить процесс перечисления. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый верхний параметр. Допустимый диапазон составляет от 1 до 1000 включительно. | |
| Недопустимый запрос (400) | InvalidRequestBody | Неверный текст запроса, предоставленный. Проверьте схему операции и повторите попытку. | |
| Недопустимый запрос (400) | InvalidTokenLifetime | Указан недопустимый authTokenTimeToLiveInSeconds. Должно быть в пределах от 60 до 86400. | |
| Недопустимый запрос (400) | InvalidLivenessOperationMode | Недопустимый параметр livenessOperationMode. Должен быть пассивным. | |
| Недопустимый запрос (400) | InvalidDeviceCorrelationId | Идентификатор корреляции устройств требуется в тексте запроса во время создания сеанса или запуска сеанса. Не должно быть пустым или пустым и не должно превышать 64 символов. | |
| Не найдено (404) | SessionNotFound | Идентификатор сеанса не найден. Срок действия идентификатора сеанса истек или не существует. |
Коды ошибок обнаружения лиц
Эти коды ошибок могут быть возвращены операцией распознавания лиц.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | "recognitionModel" несовместим. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы пользователей. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы больших пользователей. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы динамических пользователей. | |
| Недопустимый запрос (400) | BadArgument | Аргумент maxNumOfCandidatesReturned недопустим. | Допустимый диапазон составляет от [1, 100]. |
| Недопустимый запрос (400) | BadArgument | Недопустимая достоверность аргумента. | Допустимый диапазон составляет от [0, 1]. |
| Недопустимый запрос (400) | BadArgument | Длина faceIds не находится в допустимом диапазоне. | Допустимый диапазон составляет от [1, 10]. |
| Недопустимый запрос (400) | FaceNotFound | Лицо не найдено. | |
| Недопустимый запрос (400) | PersonGroupNotFound | Группа пользователей не найдена. | |
| Недопустимый запрос (400) | LargePersonGroupNotFound | Группа больших пользователей не найдена. | |
| Недопустимый запрос (400) | DynamicPersonGroupNotFound | Группа динамических пользователей не найдена. | |
| Недопустимый запрос (400) | PersonGroupNotTrained | Группа пользователей не обучена. | |
| Недопустимый запрос (400) | LargePersonGroupNotTrained | Группа крупных пользователей не обучена. | |
| Недопустимый запрос (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | Идентификатор группы больших пользователей и идентификатор группы пользователей не имеют значения NULL. | |
| Недопустимый запрос (400) | PersonGroupIdAndLargePersonGroupIdBothNull | Идентификатор группы больших пользователей и идентификатор группы пользователей имеют значение NULL. | |
| Недопустимый запрос (400) | MissingIdentificationScopeParameters | Параметр области идентификации отсутствует в запросе. | |
| Недопустимый запрос (400) | IncompatibleIdentificationScopeParametersCombination | В запросе присутствуют несовместимые параметры области идентификации. | |
| Конфликт (409) | PersonGroupTrainingNotFinished | Группа пользователей находится под обучением. | |
| Конфликт (409) | LargePersonGroupTrainingNotFinished | Группа большого человека находится под обучением. |
Коды ошибок проверки лиц
Эти коды ошибок могут быть возвращены операцией проверки лиц.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | "recognitionModel" несовместим. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор лица. | Допустимый faceId поставляется из Face — Detect. |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор пользователя. | Допустимый идентификатор personId создается из создания пользователя группы", создания пользователя группы больших пользователей или каталога person — create Person. |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы пользователей. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы больших пользователей. | |
| Недопустимый запрос (400) | PersonNotFound | Пользователь не найден. | |
| Недопустимый запрос (400) | PersonGroupNotFound | Группа пользователей не найдена. | |
| Недопустимый запрос (400) | LargePersonGroupNotFound | Группа больших пользователей не найдена. | |
| Не найдено (404) | FaceNotFound | Лицо не найдено. | |
| Не найдено (404) | PersonNotFound | Пользователь не найден. | |
| Не найдено (404) | PersistedFaceNotFound | Не найдена сохраняемая лицо человека. |
Поиск аналогичных кодов ошибок
Эти коды ошибок можно вернуть с помощью операции "Поиск лиц" аналогичной операции.
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | "recognitionModel" несовместим. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый режим. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор списка лиц. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор большого списка лиц. | |
| Недопустимый запрос (400) | BadArgument | LargeFaceListId, faceListId и faceIds, а не является допустимым. | |
| Недопустимый запрос (400) | BadArgument | LargeFaceListId, faceListId и faceId имеют значение NULL. | |
| Недопустимый запрос (400) | BadArgument | 2 или более больших значенийFaceListId, faceListId и faceId не имеют значения NULL. | |
| Недопустимый запрос (400) | BadArgument | Аргумент maxNumOfCandidatesReturned недопустим. | Допустимый диапазон составляет от [1, 1000]. |
| Недопустимый запрос (400) | BadArgument | Длина faceIds не находится в допустимом диапазоне. | Допустимый диапазон составляет от [1, 1000]. |
| Недопустимый запрос (400) | FaceNotFound | Лицо не найдено. | |
| Недопустимый запрос (400) | FaceListNotFound | Список лиц не найден. | |
| Недопустимый запрос (400) | LargeFaceListNotFound | Большой список лиц не найден. | |
| Недопустимый запрос (400) | LargeFaceListNotTrained | Большой список лиц не обучен. | |
| Недопустимый запрос (400) | FaceListNotReady | Список лиц пуст. | |
| Конфликт (409) | LargeFaceListTrainingNotFinished | Большой список лиц находится под обучением. |
Коды ошибок группы лиц
Эти коды ошибок могут быть возвращены операцией "Группа лиц".
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | "recognitionModel" несовместим. | |
| Недопустимый запрос (400) | BadArgument | Длина faceIds не находится в допустимом диапазоне. | Допустимый диапазон составляет от [2, 1000]. |
Операции группы пользователей
Эти коды ошибок могут быть возвращены операциями группы пользователей.
Коды ошибок группы пользователей
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы пользователей. | Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64. |
| Запрещено (403) | QuotaExceeded | Число групп пользователей достигло предельного уровня подписки. | |
| Запрещено (403) | QuotaExceeded | Число пользователей достигло предельного уровня группы пользователей. | |
| Запрещено (403) | QuotaExceeded | Число пользователей достигло предельного уровня подписки. | |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение для сохраняемого числа лиц. | |
| Не найдено (404) | PersonGroupNotFound | Группа пользователей не найдена. | |
| Не найдено (404) | PersonGroupNotFound | Недопустимый идентификатор группы пользователей. | |
| Не найдено (404) | PersonNotFound | Пользователь <personId> не найден. |
|
| Не найдено (404) | PersonNotFound | Недопустимый идентификатор пользователя. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо не найдено. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо <faceId> не найдено. |
|
| Не найдено (404) | PersistedFaceNotFound | Сохраненный идентификатор лица недопустим. | |
| Не найдено (404) | PersonGroupNotTrained | Группа пользователей не обучена. | Эта ошибка возникает при получении состояния обучения группы, которая никогда не была обучена. |
| Конфликт (409) | PersonGroupExists | Группа пользователей уже существует. | |
| Конфликт (409) | PersonGroupTrainingNotFinished | Группа пользователей находится под обучением. | Повторите попытку после завершения обучения. |
Коды ошибок группы больших пользователей
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор группы больших пользователей. | Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64. |
| Недопустимый запрос (400) | BadArgument | Имя и userData пусты. | |
| Запрещено (403) | QuotaExceeded | Число групп больших пользователей достигло ограничения уровня подписки. | |
| Запрещено (403) | QuotaExceeded | Число пользователей достигло предельного уровня группы больших пользователей. | |
| Запрещено (403) | QuotaExceeded | Число пользователей достигло предельного уровня подписки. | |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение для сохраняемого числа лиц. | |
| Не найдено (404) | LargePersonGroupNotFound | Группа больших пользователей не найдена. | |
| Не найдено (404) | LargePersonGroupNotFound | Недопустимый идентификатор группы больших пользователей. | |
| Не найдено (404) | PersonNotFound | Пользователь <personId> не найден. |
|
| Не найдено (404) | PersonNotFound | Недопустимый идентификатор пользователя. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо не найдено. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо <faceId> не найдено. |
|
| Не найдено (404) | PersistedFaceNotFound | Сохраненный идентификатор лица недопустим. | |
| Не найдено (404) | LargePersonGroupNotTrained | Группа крупных пользователей не обучена. | Эта ошибка возникает при получении состояния обучения группы, которая никогда не была обучена. |
| Конфликт (409) | LargePersonGroupExists | Группа крупных пользователей уже существует. | |
| Конфликт (409) | LargePersonGroupTrainingNotFinished | Группа большого человека находится под обучением. | Повторите попытку после завершения обучения. |
Операции списка лиц
Эти коды ошибок могут быть возвращены операциями списка лиц.
Коды ошибок списка лиц
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор списка лиц. | Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64. |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение для сохраняемого числа лиц. | |
| Не найдено (404) | FaceListNotFound | Список лиц не найден. | |
| Не найдено (404) | FaceListNotFound | Недопустимый идентификатор списка лиц. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо не найдено. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраненный идентификатор лица недопустим. | |
| Конфликт (409) | FaceListExists | Список лиц уже существует. |
Коды ошибок большого списка лиц
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор большого списка лиц. | Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64. |
| Недопустимый запрос (400) | BadArgument | Имя и userData пусты. | |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение большого списка лиц. | |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение для сохраняемого числа лиц. | |
| Не найдено (404) | LargeFaceListNotFound | Большой список лиц не найден. | |
| Не найдено (404) | LargeFaceListNotFound | Недопустимый идентификатор большого списка лиц. | |
| Не найдено (404) | PersistedFaceNotFound | Лицо с большим списком лиц <faceId> не найдено. |
|
| Не найдено (404) | PersistedFaceNotFound | Сохраненный идентификатор лица недопустим. | |
| Не найдено (404) | LargeFaceListNotTrained | Большой список лиц не обучен. | Эта ошибка отображается при получении состояния обучения большого списка лиц, который никогда не был обучен. |
| Конфликт (409) | LargeFaceListExists | Большой список лиц уже существует. | |
| Конфликт (409) | LargeFaceListTrainingNotFinished | Большой список лиц находится под обучением. | Повторите попытку после завершения обучения. |
Операции каталога person
Эти коды ошибок могут быть возвращены операциями каталога Person.
Коды ошибок каталога пользователя
| Код состояния HTTP | Код ошибки | Сообщение об ошибке | Description |
|---|---|---|---|
| Недопустимый запрос (400) | BadArgument | Модель распознавания не поддерживается для этой функции. | |
| Недопустимый запрос (400) | BadArgument | Недопустимый идентификатор пользователя start. | |
| Недопустимый запрос (400) | BadArgument | Имя и userData пусты. | |
| Недопустимый запрос (400) | DynamicPersonGroupNotFound | Недопустимый идентификатор группы динамических пользователей. | |
| Запрещено (403) | QuotaExceeded | Число пользователей достигло предельного уровня подписки. | |
| Запрещено (403) | QuotaExceeded | Достигнуто ограничение для сохраняемого числа лиц. | |
| Не найдено (404) | DynamicPersonGroupNotFound | Группа динамических пользователей не найдена. | |
| Не найдено (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> не найден. |
|
| Не найдено (404) | PersonNotFound | Пользователь не найден. | |
| Не найдено (404) | PersonNotFound | Недопустимый идентификатор пользователя. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо не найдено. | |
| Не найдено (404) | PersistedFaceNotFound | Сохраняемое лицо <faceId> не найдено. |
|
| Не найдено (404) | PersistedFaceNotFound | Сохраненный идентификатор лица недопустим. | |
| Конфликт (409) | DynamicPersonGroupExists | Идентификатор <groupId> группы динамических пользователей уже существует. |
Следующие шаги