Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Códigos de erro comuns
Esses códigos de erro podem ser retornados por qualquer chamada de API de Detecção Facial.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | O corpo da solicitação é inválido. | |
| Solicitação incorreta (400) | BadArgument | Erro de análise JSON. | Corpo JSON de solicitação inválida ou irreconhecível. |
| Solicitação incorreta (400) | BadArgument | O modelo “recognitionModel” é inválido. | |
| Solicitação incorreta (400) | BadArgument | O modelo “detectionModel” é inválido. | |
| Solicitação incorreta (400) | BadArgument | 'name' está vazio. | |
| Solicitação incorreta (400) | BadArgument | 'nome' é muito longo. | |
| Solicitação incorreta (400) | BadArgument | 'userData' é muito longo. | |
| Solicitação incorreta (400) | BadArgument | 'start' é muito longo. | |
| Solicitação incorreta (400) | BadArgument | 'top' é inválido. | |
| Solicitação incorreta (400) | BadArgument | Alvo do argumentoFace fora do intervalo. | |
| Solicitação incorreta (400) | BadArgument | Argumento inválido targetFace. | Causado por formato de cadeia de caracteres inválido ou valor inválido de esquerda/topo/altura/largura. |
| Solicitação incorreta (400) | InvalidURL | URL de imagem inválida. | Os formatos compatíveis incluem JPEG, PNG, GIF (o primeiro quadro) e BMP. |
| Solicitação incorreta (400) | InvalidURL | URL de imagem inválida ou erro ao baixar do servidor de destino. Erro do servidor remoto retornado: "Ocorreu um erro ao enviar a solicitação". | |
| Solicitação incorreta (400) | InvalidImage | Erro de decodificação. Formato da imagem não compatível. | |
| Solicitação incorreta (400) | InvalidImage | Nenhum rosto detectado na imagem. | |
| Solicitação incorreta (400) | InvalidImage | Há mais de 1 rosto na imagem. | |
| Solicitação incorreta (400) | InvalidImageSize | O dimensionamento da imagem está muito pequeno. | O tamanho do arquivo de imagem válido deve ser maior ou igual a 1 KB. |
| Solicitação incorreta (400) | InvalidImageSize | O dimensionamento da imagem está muito grande. | O tamanho do arquivo de imagem válido não deve ser maior que 6 MB. |
| Não autorizado (401) | 401 | Acesso negado devido a chave de assinatura inválida ou ponto de extremidade de API incorreto. Certifique-se de fornecer uma chave válida para uma assinatura ativa e use um endpoint de API regional correto para seu recurso. | |
| Proibido (403) | UnsupportedFeature | O recurso não é suportado, faltando aprovação para um ou mais dos seguintes recursos: Identificação, Verificação. | Registre-se para acesso enviando um formulário de registro. |
| Conflito (409) | Conflito de Operação Simultânea | Há uma operação de conflito no recurso <resourceName>, tente mais tarde. |
|
| Muitos pedidos (429) | 429 | O limite da taxa é excedido. |
Códigos de erro de detecção de rosto
Esses códigos de erro podem ser retornados pela operação de detecção de rosto.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | O argumento returnFaceAttributes é inválido. | |
| Solicitação incorreta (400) | BadArgument | “returnFaceAttributes” não é compatível com detection_02. | |
| Solicitação incorreta (400) | BadArgument | “returnLandmarks” não é compatível com detection_02. | |
| Proibido (403) | UnsupportedFeature | Os atributos de retorno (emoção, sexo, idade, sorriso, pelos faciais, cabelo e maquiagem) foram descontinuados e não são mais suportados. | Envie um email para Equipe de Detecção Facial do Azure, se tiver um caso de uso responsável que se beneficiaria do uso de qualquer uma das funcionalidades limitadas. |
Códigos de erro da Face Liveness Session
Esses códigos de erro podem ser retornados por operações de sessão de vivacidade facial.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | Start é inválido. Por favor, especifique o campo 'Id' da última entrada para continuar o processo de listagem. | |
| Solicitação incorreta (400) | BadArgument | O parâmetro Top é inválido. O intervalo válido está entre 1 e 1000 inclusive. | |
| Solicitação incorreta (400) | InvalidRequestBody | Corpo da solicitação incorreto fornecido. Verifique o esquema de operação e tente novamente. | |
| Solicitação incorreta (400) | InvalidTokenLifetime | AuthTokenTimeToLiveInSeconds inválido especificado. Deve estar entre 60 e 86400. | |
| Solicitação incorreta (400) | InvalidLivenessOperationMode | LivenessOperationMode inválido especificado. Deve ser 'Passivo'. | |
| Solicitação incorreta (400) | InvalidDeviceCorrelationId | Uma ID de correlação de dispositivo é necessária no corpo da solicitação durante a criação ou o início da sessão. Não deve ser nulo ou vazio e não deve ter mais de 64 caracteres. | |
| Não encontrado (404) | SessionNotFound | O ID da sessão não foi encontrado. O ID da sessão expirou ou não existe. |
Códigos de erro de identificação facial
Esses códigos de erro podem ser retornados pela operação de identificação facial.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | 'recognitionModel' é incompatível. | |
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas é inválida. | |
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas grandes é inválida. | |
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas dinâmicas é inválida. | |
| Solicitação incorreta (400) | BadArgument | O argumento maxNumOfCandidatesReturned não é válido. | O intervalo válido está entre [1, 100]. |
| Solicitação incorreta (400) | BadArgument | O argumento confidenceThreshold não é válido. | O intervalo válido está entre [0, 1]. |
| Solicitação incorreta (400) | BadArgument | O comprimento dos faceIds não está em um intervalo válido. | O intervalo válido está entre [1, 10]. |
| Solicitação incorreta (400) | FaceNotFound | O rosto não foi encontrado. | |
| Solicitação incorreta (400) | PersonGroupNotFound | O grupo de pessoas não foi encontrado. | |
| Solicitação incorreta (400) | LargePersonGroupNotFound | O grupo de pessoas grandes não é encontrado. | |
| Solicitação incorreta (400) | DynamicPersonGroupNotFound | O grupo dinâmico de pessoas não foi encontrado. | |
| Solicitação incorreta (400) | PersonGroupNotTrained | Grupo de pessoas não treinado. | |
| Solicitação incorreta (400) | LargePersonGroupNotTrained | Grande grupo de pessoas não treinado. | |
| Solicitação incorreta (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | A ID do grupo de pessoas grandes e a ID do grupo de pessoas não são nulas. | |
| Solicitação incorreta (400) | PersonGroupIdAndLargePersonGroupIdBothNull | A ID do grupo de pessoas grandes e a ID do grupo de pessoas são nulas. | |
| Solicitação incorreta (400) | MissingIdentificationScopeParameters | Nenhum parâmetro de escopo de identificação está presente na solicitação. | |
| Solicitação incorreta (400) | IncompatívelIdentificaçãoEscopoParâmetrosCombinação | Parâmetros de escopo de identificação incompatíveis estão presentes na solicitação. | |
| Conflito (409) | PersonGroupTrainingNotFinished | O grupo de pessoas está em treinamento. | |
| Conflito (409) | LargePersonGroupTrainingNotFinished | Um grande grupo de pessoas está em treinamento. |
Códigos de erro do Face Verify
Esses códigos de erro podem ser retornados pela operação Face Verify.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | 'recognitionModel' é incompatível. | |
| Solicitação incorreta (400) | BadArgument | O Face ID é inválido. | Um faceId válido vem de Face - Detect. |
| Solicitação incorreta (400) | BadArgument | A ID da pessoa é inválida. | Um personId válido é gerado a partir de Criar Pessoa Grupo de Pessoas, Criar Pessoa de Grupo de Pessoas Grandes ou Diretório de Pessoas - Criar Pessoa. |
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas é inválida. | |
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas grandes é inválida. | |
| Solicitação incorreta (400) | PessoaNãoEncontrada | A pessoa não foi encontrada. | |
| Solicitação incorreta (400) | PersonGroupNotFound | O grupo de pessoas não foi encontrado. | |
| Solicitação incorreta (400) | LargePersonGroupNotFound | Grupo de pessoas grandes não foi encontrado. | |
| Não encontrado (404) | FaceNotFound | O rosto não foi encontrado. | |
| Não encontrado (404) | PessoaNãoEncontrada | A pessoa não foi encontrada. | |
| Não encontrado (404) | PersistedFaceNotFound | Nenhum rosto persistente da pessoa é encontrado. |
Encontrar códigos de erro semelhantes
Esses códigos de erro podem ser retornados pela operação Face Find Similar.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | 'recognitionModel' é incompatível. | |
| Solicitação incorreta (400) | BadArgument | O modo é inválido. | |
| Solicitação incorreta (400) | BadArgument | O ID da lista de rostos é inválido. | |
| Solicitação incorreta (400) | BadArgument | O ID da lista de rostos grandes é inválido. | |
| Solicitação incorreta (400) | BadArgument | LargeFaceListId, faceListId e faceIds, nenhum deles é exatamente válido. | |
| Solicitação incorreta (400) | BadArgument | LargeFaceListId, faceListId e faceIds são todos nulos. | |
| Solicitação incorreta (400) | BadArgument | 2 ou mais de largeFaceListId, faceListId e faceIds não são nulos. | |
| Solicitação incorreta (400) | BadArgument | O argumento maxNumOfCandidatesReturned não é válido. | O intervalo válido está entre [1, 1000]. |
| Solicitação incorreta (400) | BadArgument | O comprimento dos faceIds não está em um intervalo válido. | O intervalo válido está entre [1, 1000]. |
| Solicitação incorreta (400) | FaceNotFound | O rosto não foi encontrado. | |
| Solicitação incorreta (400) | FaceListNotFound | A lista de rostos não foi encontrada. | |
| Solicitação incorreta (400) | LargeFaceListNotFound | A lista de rostos grande não foi encontrada. | |
| Solicitação incorreta (400) | LargeFaceListNotTrained | A lista de rostos grande não é treinada. | |
| Solicitação incorreta (400) | FaceListNotReady | A lista de rostos está vazia. | |
| Conflito (409) | LargeFaceListTrainingNotFinished | Uma grande lista de rostos está em treinamento. |
Códigos de erro do Grupo de Rostos
Esses códigos de erro podem ser retornados pela operação de grupo de rostos.
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | 'recognitionModel' é incompatível. | |
| Solicitação incorreta (400) | BadArgument | O comprimento dos faceIds não está em um intervalo válido. | O intervalo válido está entre [2, 1000]. |
Operações do grupo de pessoas
Esses códigos de erro podem ser retornados por operações de grupo de pessoas.
Códigos de erro do grupo de pessoas
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas é inválida. | O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64. |
| Proibido (403) | QuotaExceeded | O número do grupo de pessoas atingiu o limite do nível de assinatura. | |
| Proibido (403) | QuotaExceeded | O número de pessoas atingiu o limite de nível de grupo de pessoas. | |
| Proibido (403) | QuotaExceeded | O número de pessoas atingiu o limite do nível de assinatura. | |
| Proibido (403) | QuotaExceeded | O número de rostos persistentes atingiu o limite. | |
| Não encontrado (404) | PersonGroupNotFound | O grupo de pessoas não foi encontrado. | |
| Não encontrado (404) | PersonGroupNotFound | A ID do grupo de pessoas é inválida. | |
| Não encontrado (404) | PessoaNãoEncontrada | A pessoa <personId> não foi encontrada. |
|
| Não encontrado (404) | PessoaNãoEncontrada | A ID da pessoa é inválida. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto persistente não foi encontrado. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto <faceId> persistente não foi encontrado. |
|
| Não encontrado (404) | PersistedFaceNotFound | O ID facial persistente é inválido. | |
| Não encontrado (404) | PersonGroupNotTrained | Grupo de pessoas não treinado. | Este erro aparece ao obter o status de treinamento de um grupo que nunca foi treinado. |
| Conflito (409) | PersonGroupExists | O grupo de pessoas já existe. | |
| Conflito (409) | PersonGroupTrainingNotFinished | O grupo de pessoas está em treinamento. | Tente novamente após a conclusão do treinamento. |
Códigos de erro de grupo de pessoas grandes
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | A ID do grupo de pessoas grandes é inválida. | O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64. |
| Solicitação incorreta (400) | BadArgument | Tanto 'name' quanto 'userData' estão vazios. | |
| Proibido (403) | QuotaExceeded | O número de grupos de pessoas grandes atingiu o limite do nível de assinatura. | |
| Proibido (403) | QuotaExceeded | O número de pessoas atingiu o limite de nível de grupo de pessoas grandes. | |
| Proibido (403) | QuotaExceeded | O número de pessoas atingiu o limite do nível de assinatura. | |
| Proibido (403) | QuotaExceeded | O número de rostos persistentes atingiu o limite. | |
| Não encontrado (404) | LargePersonGroupNotFound | O grupo de pessoas grandes não é encontrado. | |
| Não encontrado (404) | LargePersonGroupNotFound | A ID do grupo de pessoas grandes é inválida. | |
| Não encontrado (404) | PessoaNãoEncontrada | A pessoa <personId> não foi encontrada. |
|
| Não encontrado (404) | PessoaNãoEncontrada | A ID da pessoa é inválida. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto persistente não foi encontrado. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto <faceId> persistente não foi encontrado. |
|
| Não encontrado (404) | PersistedFaceNotFound | O ID facial persistente é inválido. | |
| Não encontrado (404) | LargePersonGroupNotTrained | Grande grupo de pessoas não treinado. | Este erro aparece ao obter o status de treinamento de um grupo que nunca foi treinado. |
| Conflito (409) | LargePersonGroupExists | Já existe um grande grupo de pessoas. | |
| Conflito (409) | LargePersonGroupTrainingNotFinished | Um grande grupo de pessoas está em treinamento. | Tente novamente após a conclusão do treinamento. |
Operações de lista de faces
Esses códigos de erro podem ser retornados por operações de Lista de Faces.
Códigos de erro da lista de rostos
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | O ID da lista de rostos é inválido. | O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64. |
| Proibido (403) | QuotaExceeded | O número de rostos persistentes atingiu o limite. | |
| Não encontrado (404) | FaceListNotFound | A lista de rostos não foi encontrada. | |
| Não encontrado (404) | FaceListNotFound | O ID da lista de rostos é inválido. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto persistente não foi encontrado. | |
| Não encontrado (404) | PersistedFaceNotFound | O ID facial persistente é inválido. | |
| Conflito (409) | FaceListExists | A lista de rostos já existe. |
Códigos de erro da lista de rostos grandes
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | O ID da lista de rostos grandes é inválido. | O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64. |
| Solicitação incorreta (400) | BadArgument | Tanto 'name' quanto 'userData' estão vazios. | |
| Proibido (403) | QuotaExceeded | O número de rostos grandes atingiu o limite. | |
| Proibido (403) | QuotaExceeded | O número de rostos persistentes atingiu o limite. | |
| Não encontrado (404) | LargeFaceListNotFound | A lista de rostos grande não foi encontrada. | |
| Não encontrado (404) | LargeFaceListNotFound | O ID da lista de rostos grandes é inválido. | |
| Não encontrado (404) | PersistedFaceNotFound | Lista de faces grandes A face <faceId> não foi encontrada. |
|
| Não encontrado (404) | PersistedFaceNotFound | O ID facial persistente é inválido. | |
| Não encontrado (404) | LargeFaceListNotTrained | Lista de rostos grande não treinada. | Este erro aparece ao obter o status de treinamento de uma lista de rostos grande que nunca foi treinada. |
| Conflito (409) | LargeFaceListExists | Já existe uma grande lista de rostos. | |
| Conflito (409) | LargeFaceListTrainingNotFinished | Uma grande lista de rostos está em treinamento. | Tente novamente após a conclusão do treinamento. |
Operações do Diretório de Pessoas
Esses códigos de erro podem ser retornados por operações do Diretório de Pessoas.
Códigos de erro do Diretório de Pessoas
| Código de status HTTP | Código de erro | Mensagem de erro | Descrição |
|---|---|---|---|
| Solicitação incorreta (400) | BadArgument | O modelo de reconhecimento não é suportado para esse recurso. | |
| Solicitação incorreta (400) | BadArgument | 'start' não é um ID de pessoa válido. | |
| Solicitação incorreta (400) | BadArgument | Tanto 'name' quanto 'userData' estão vazios. | |
| Solicitação incorreta (400) | DynamicPersonGroupNotFound | A ID do grupo de pessoas dinâmicas é inválida. | |
| Proibido (403) | QuotaExceeded | O número de pessoas atingiu o limite do nível de assinatura. | |
| Proibido (403) | QuotaExceeded | O número de rostos persistentes atingiu o limite. | |
| Não encontrado (404) | DynamicPersonGroupNotFound | O grupo dinâmico de pessoas não foi encontrado. | |
| Não encontrado (404) | DynamicPersonGroupNotFound | DynamicPersonGroupPersonReference <groupId> não foi encontrado. |
|
| Não encontrado (404) | PessoaNãoEncontrada | A pessoa não foi encontrada. | |
| Não encontrado (404) | PessoaNãoEncontrada | A ID da pessoa é inválida. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto persistente não foi encontrado. | |
| Não encontrado (404) | PersistedFaceNotFound | O rosto <faceId> persistente não foi encontrado. |
|
| Não encontrado (404) | PersistedFaceNotFound | O Face ID persistente é inválido. | |
| Conflito (409) | DynamicPersonGroupExists | A ID <groupId> dinâmica do grupo de pessoas já existe. |
Próximas etapas