Коды ошибок API распознавания лиц Azure

Распространенные коды ошибок

Эти коды ошибок могут быть возвращены вызовами API распознавания лиц.

Код состояния HTTP Error code Error message 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 МБ.
Unauthorized (401) 401 Доступ запрещен из-за недопустимого ключа подписки или неправильной конечной точки API. Обязательно укажите допустимый ключ для активной подписки и используйте правильную региональную конечную точку API для ресурса.
Forbidden (403) UnsupportedFeature Функция не поддерживается, отсутствует утверждение для одной или нескольких следующих функций: идентификация, проверка. Зарегистрируйтесь для доступа, отправив форму регистрации.
Conflict (409) ConcurrentOperationConflict Существует конфликтная операция с ресурсом <resourceName>, попробуйте позже.
Слишком много запросов (429) 429 превышено ограничение скорости.

Коды ошибок обнаружения лиц

Эти коды ошибок могут быть возвращены операцией обнаружения лиц.

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый аргумент returnFaceAttributes.
Недопустимый запрос (400) BadArgument 'returnFaceAttributes' не поддерживается detection_02.
Недопустимый запрос (400) BadArgument 'returnLandmarks' не поддерживается detection_02.
Forbidden (403) UnsupportedFeature Возвращаемые атрибуты (эмоции, пол, возраст, улыбка, волосы, волосы и макияж) устарели и больше не поддерживаются. Отправьте электронное письмо команде Azure Face, если у вас есть обоснованный случай использования, который может воспользоваться любой из ограниченных возможностей.

Коды ошибок сеанса liveness для лиц

Эти коды ошибок могут быть возвращены операциями сеанса liveness face.

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый параметр start. Укажите поле "Идентификатор" последней записи, чтобы продолжить процесс перечисления.
Недопустимый запрос (400) BadArgument Недопустимый верхний параметр. Допустимый диапазон составляет от 1 до 1000 включительно.
Недопустимый запрос (400) InvalidRequestBody Неверный текст запроса, предоставленный. Проверьте схему операции и повторите попытку.
Недопустимый запрос (400) InvalidTokenLifetime Указан недопустимый authTokenTimeToLiveInSeconds. Должно быть в пределах от 60 до 86400.
Недопустимый запрос (400) InvalidLivenessOperationMode Недопустимый параметр livenessOperationMode. Должен быть пассивным.
Недопустимый запрос (400) InvalidDeviceCorrelationId Идентификатор корреляции устройств требуется в тексте запроса во время создания сеанса или запуска сеанса. Не должно быть пустым или пустым и не должно превышать 64 символов.
Не найдено (404) SessionNotFound Идентификатор сеанса не найден. Срок действия идентификатора сеанса истек или не существует.

Коды ошибок обнаружения лиц

Эти коды ошибок могут быть возвращены операцией распознавания лиц.

Код состояния HTTP Error code Error message 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 В запросе присутствуют несовместимые параметры области идентификации.
Conflict (409) PersonGroupTrainingNotFinished Группа пользователей находится под обучением.
Conflict (409) LargePersonGroupTrainingNotFinished Группа большого человека находится под обучением.

Коды ошибок проверки лиц

Эти коды ошибок могут быть возвращены операцией проверки лиц.

Код состояния HTTP Error code Error message 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 Error code Error message 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 Список лиц пуст.
Conflict (409) LargeFaceListTrainingNotFinished Большой список лиц находится под обучением.

Коды ошибок группы лиц

Эти коды ошибок могут быть возвращены операцией "Группа лиц".

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument "recognitionModel" несовместим.
Недопустимый запрос (400) BadArgument Длина faceIds не находится в допустимом диапазоне. Допустимый диапазон составляет от [2, 1000].

Операции группы пользователей

Эти коды ошибок могут быть возвращены операциями группы пользователей.

Коды ошибок группы пользователей

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый идентификатор группы пользователей. Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64.
Forbidden (403) QuotaExceeded Число групп пользователей достигло предельного уровня подписки.
Forbidden (403) QuotaExceeded Число пользователей достигло предельного уровня группы пользователей.
Forbidden (403) QuotaExceeded Число пользователей достигло предельного уровня подписки.
Forbidden (403) QuotaExceeded Достигнуто ограничение для сохраняемого числа лиц.
Не найдено (404) PersonGroupNotFound Группа пользователей не найдена.
Не найдено (404) PersonGroupNotFound Недопустимый идентификатор группы пользователей.
Не найдено (404) PersonNotFound Пользователь <personId> не найден.
Не найдено (404) PersonNotFound Недопустимый идентификатор пользователя.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо не найдено.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо <faceId> не найдено.
Не найдено (404) PersistedFaceNotFound Сохраненный идентификатор лица недопустим.
Не найдено (404) PersonGroupNotTrained Группа пользователей не обучена. Эта ошибка возникает при получении состояния обучения группы, которая никогда не была обучена.
Conflict (409) PersonGroupExists Группа пользователей уже существует.
Conflict (409) PersonGroupTrainingNotFinished Группа пользователей находится под обучением. Повторите попытку после завершения обучения.

Коды ошибок группы больших пользователей

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый идентификатор группы больших пользователей. Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64.
Недопустимый запрос (400) BadArgument Имя и userData пусты.
Forbidden (403) QuotaExceeded Число групп больших пользователей достигло ограничения уровня подписки.
Forbidden (403) QuotaExceeded Число пользователей достигло предельного уровня группы больших пользователей.
Forbidden (403) QuotaExceeded Число пользователей достигло предельного уровня подписки.
Forbidden (403) QuotaExceeded Достигнуто ограничение для сохраняемого числа лиц.
Не найдено (404) LargePersonGroupNotFound Группа больших пользователей не найдена.
Не найдено (404) LargePersonGroupNotFound Недопустимый идентификатор группы больших пользователей.
Не найдено (404) PersonNotFound Пользователь <personId> не найден.
Не найдено (404) PersonNotFound Недопустимый идентификатор пользователя.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо не найдено.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо <faceId> не найдено.
Не найдено (404) PersistedFaceNotFound Сохраненный идентификатор лица недопустим.
Не найдено (404) LargePersonGroupNotTrained Группа крупных пользователей не обучена. Эта ошибка возникает при получении состояния обучения группы, которая никогда не была обучена.
Conflict (409) LargePersonGroupExists Группа крупных пользователей уже существует.
Conflict (409) LargePersonGroupTrainingNotFinished Группа большого человека находится под обучением. Повторите попытку после завершения обучения.

Операции списка лиц

Эти коды ошибок могут быть возвращены операциями списка лиц.

Коды ошибок списка лиц

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый идентификатор списка лиц. Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64.
Forbidden (403) QuotaExceeded Достигнуто ограничение для сохраняемого числа лиц.
Не найдено (404) FaceListNotFound Список лиц не найден.
Не найдено (404) FaceListNotFound Недопустимый идентификатор списка лиц.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо не найдено.
Не найдено (404) PersistedFaceNotFound Сохраненный идентификатор лица недопустим.
Conflict (409) FaceListExists Список лиц уже существует.

Коды ошибок большого списка лиц

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Недопустимый идентификатор большого списка лиц. Допустимый символ — это буква английского языка в нижнем регистре, цифры, "-" или "_". Максимальная длина — 64.
Недопустимый запрос (400) BadArgument Имя и userData пусты.
Forbidden (403) QuotaExceeded Достигнуто ограничение большого списка лиц.
Forbidden (403) QuotaExceeded Достигнуто ограничение для сохраняемого числа лиц.
Не найдено (404) LargeFaceListNotFound Большой список лиц не найден.
Не найдено (404) LargeFaceListNotFound Недопустимый идентификатор большого списка лиц.
Не найдено (404) PersistedFaceNotFound Лицо с большим списком лиц <faceId> не найдено.
Не найдено (404) PersistedFaceNotFound Сохраненный идентификатор лица недопустим.
Не найдено (404) LargeFaceListNotTrained Большой список лиц не обучен. Эта ошибка отображается при получении состояния обучения большого списка лиц, который никогда не был обучен.
Conflict (409) LargeFaceListExists Большой список лиц уже существует.
Conflict (409) LargeFaceListTrainingNotFinished Большой список лиц находится под обучением. Повторите попытку после завершения обучения.

Операции каталога person

Эти коды ошибок могут быть возвращены операциями каталога Person.

Коды ошибок каталога пользователя

Код состояния HTTP Error code Error message Description
Недопустимый запрос (400) BadArgument Модель распознавания не поддерживается для этой функции.
Недопустимый запрос (400) BadArgument Недопустимый идентификатор пользователя start.
Недопустимый запрос (400) BadArgument Имя и userData пусты.
Недопустимый запрос (400) DynamicPersonGroupNotFound Недопустимый идентификатор группы динамических пользователей.
Forbidden (403) QuotaExceeded Число пользователей достигло предельного уровня подписки.
Forbidden (403) QuotaExceeded Достигнуто ограничение для сохраняемого числа лиц.
Не найдено (404) DynamicPersonGroupNotFound Группа динамических пользователей не найдена.
Не найдено (404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> не найден.
Не найдено (404) PersonNotFound Пользователь не найден.
Не найдено (404) PersonNotFound Недопустимый идентификатор пользователя.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо не найдено.
Не найдено (404) PersistedFaceNotFound Сохраняемое лицо <faceId> не найдено.
Не найдено (404) PersistedFaceNotFound Сохраненный идентификатор лица недопустим.
Conflict (409) DynamicPersonGroupExists Идентификатор <groupId> группы динамических пользователей уже существует.

Next steps

  • Last updated on