Partilhar via


Códigos de erro da API do Azure AI Face

Códigos de erro comuns

Esses códigos de erro podem ser retornados por qualquer chamada de API do Face.

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument O corpo da solicitação é inválido.
Mau pedido (400) BadArgument Erro de análise JSON. Corpo JSON de solicitação ruim ou irreconhecível.
Mau pedido (400) BadArgument 'recognitionModel' é inválido.
Mau pedido (400) BadArgument 'detectionModel' é inválido.
Mau pedido (400) BadArgument 'nome' está vazio.
Mau pedido (400) BadArgument "nome" é demasiado longo.
Mau pedido (400) BadArgument 'userData' é demasiado longo.
Mau pedido (400) BadArgument O "arranque" é demasiado longo.
Mau pedido (400) BadArgument 'top' é inválido.
Mau pedido (400) BadArgument Argumento alvoFace fora do intervalo.
Mau pedido (400) BadArgument Argumento inválido targetFace. Causado por um formato de cadeia de caracteres inválido ou um valor inválido esquerda/superior/altura/largura.
Mau pedido (400) URLinválido URL de imagem inválido. Os formatos suportados incluem JPEG, PNG, GIF (o primeiro quadro) e BMP.
Mau pedido (400) URLinválido URL de imagem inválida ou erro ao baixar do servidor de destino. Erro de servidor remoto retornado: "Ocorreu um erro ao enviar a solicitação."
Mau pedido (400) Imageminválida Erro de decodificação, formato de imagem não suportado.
Mau pedido (400) Imageminválida Nenhum rosto detetado na imagem.
Mau pedido (400) Imageminválida Há mais de 1 rosto na imagem.
Mau pedido (400) Tamanhodeimageminválido O tamanho da imagem é muito pequeno. O tamanho do arquivo de imagem válido deve ser maior ou igual a 1 KB.
Mau pedido (400) Tamanhodeimageminválido O tamanho da imagem é muito grande. O tamanho do ficheiro de imagem válido não deve ser superior a 6 MB.
Não Autorizado (401) 401 Acesso negado devido a chave de assinatura inválida ou ponto de extremidade de API errado. Certifique-se de fornecer uma chave válida para uma assinatura ativa e use um ponto de extremidade 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. Registe-se para aceder submetendo um formulário de registo.
Conflito (409) ConcurrentOperationConflict Há uma operação de conflito no recurso <resourceName>, por favor, tente mais tarde.
Demasiados pedidos (429) 429 O limite de taxa foi excedido.

Códigos de erro de deteção de rosto

Esses códigos de erro podem ser retornados pela operação de deteção de rosto.

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument Argumento inválido returnFaceAttributes.
Mau pedido (400) BadArgument 'returnFaceAttributes' não é suportado pelo detection_02.
Mau pedido (400) BadArgument 'returnLandmarks' não é suportado por detection_02.
Proibido (403) UnsupportedFeature Os atributos de retorno (emoção, sexo, idade, sorriso, pelos faciais, cabelo e maquiagem) foram preteridos e não são mais suportados. Envie um e-mail para a equipe do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados.

Códigos de erro do Face Liveness Session

Esses códigos de erro podem ser retornados por operações do Face Liveness Session.

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument O parâmetro Start é inválido. Por favor, especifique o campo 'Id' da última entrada para continuar o processo de listagem.
Mau pedido (400) BadArgument O parâmetro Top é inválido. O intervalo válido é entre 1 e 1000, inclusive.
Mau pedido (400) InvalidRequestBody Corpo de solicitação incorreto fornecido. Verifique o esquema de operação e tente novamente.
Mau pedido (400) InvalidTokenLifetime Invalid authTokenTimeToLiveInSeconds especificado. Deve estar entre 60 e 86400.
Mau pedido (400) InvalidLivenessOperationMode LivenessOperationMode inválido especificado. Deve ser 'passivo'.
Mau pedido (400) InvalidDeviceCorrelationId Um ID de correlação de dispositivo é necessário no corpo da solicitação durante a criação da sessã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 A ID da sessão não foi encontrada. O ID da sessão expirou ou não existe.

Face Identificar códigos de erro

Esses códigos de erro podem ser retornados pela operação Face Identifique.

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument 'recognitionModel' é incompatível.
Mau pedido (400) BadArgument O ID do grupo de pessoas é inválido.
Mau pedido (400) BadArgument O ID de grupo de pessoas grandes é inválido.
Mau pedido (400) BadArgument O ID de grupo dinâmico de pessoas é inválido.
Mau pedido (400) BadArgument O argumento maxNumOfCandidatesReturned não é válido. O intervalo válido situa-se entre [1, 100].
Mau pedido (400) BadArgument O argumento confidenceThreshold não é válido. O intervalo válido está entre [0, 1].
Mau pedido (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido está entre [1, 10].
Mau pedido (400) FaceNotFound O rosto não foi encontrado.
Mau pedido (400) PersonGroupNotFound O grupo de pessoas não foi encontrado.
Mau pedido (400) LargePersonGroupNotFound Não foi encontrado um grupo de pessoas grande.
Mau pedido (400) DynamicPersonGroupNotFound O grupo dinâmico de pessoas não foi encontrado.
Mau pedido (400) PersonGroupNotTrained Grupo de pessoas não treinadas.
Mau pedido (400) LargePersonGroupNotTrained Grupo de pessoas grandes não treinado.
Mau pedido (400) PersonGroupIdAndLargePersonGroupIdBothNotNull O ID do grupo de pessoas grandes e o ID do grupo de pessoas não são nulos.
Mau pedido (400) PersonGroupIdAndLargePersonGroupIdBothNull O ID do grupo de pessoas grandes e o ID do grupo de pessoas são nulos.
Mau pedido (400) MissingIdentificationScopeParameters Nenhum parâmetro de escopo de identificação está presente na solicitação.
Mau pedido (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 formação.
Conflito (409) LargePersonGroupTrainingNotFinished 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 Description
Mau pedido (400) BadArgument 'recognitionModel' é incompatível.
Mau pedido (400) BadArgument O Face ID é inválido. Um faceId válido vem de Face - Detect.
Mau pedido (400) BadArgument A identificação da pessoa é inválida. Um personId válido é gerado a partir de Criar Pessoa, Grupo, Pessoa, Pessoa, Criar Pessoa, Grupo de Pessoas, Pessoa ou Diretório de Pessoas - Criar Pessoa.
Mau pedido (400) BadArgument O ID do grupo de pessoas é inválido.
Mau pedido (400) BadArgument O ID de grupo de pessoas grandes é inválido.
Mau pedido (400) PessoaNotFound Pessoa não encontrada.
Mau pedido (400) PersonGroupNotFound O Grupo de Pessoas não foi encontrado.
Mau pedido (400) LargePersonGroupNotFound O Grupo de Pessoas Grandes não foi encontrado.
Não encontrado (404) FaceNotFound O rosto não foi encontrado.
Não encontrado (404) PessoaNotFound Pessoa não 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 Description
Mau pedido (400) BadArgument 'recognitionModel' é incompatível.
Mau pedido (400) BadArgument O modo é inválido.
Mau pedido (400) BadArgument O ID da lista de rostos é inválido.
Mau pedido (400) BadArgument O ID da lista de rostos grandes é inválido.
Mau pedido (400) BadArgument LargeFaceListId, faceListId e faceIds, não exatamente um deles é válido.
Mau pedido (400) BadArgument LargeFaceListId, faceListId e faceIds são todos nulos.
Mau pedido (400) BadArgument 2 ou mais de largeFaceListId, faceListId e faceIds não são nulos.
Mau pedido (400) BadArgument O argumento maxNumOfCandidatesReturned não é válido. O intervalo válido situa-se entre [1, 1000].
Mau pedido (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido situa-se entre [1, 1000].
Mau pedido (400) FaceNotFound O rosto não foi encontrado.
Mau pedido (400) FaceListNotFound A lista de rostos não foi encontrada.
Mau pedido (400) LargeFaceListNotFound Lista de rostos grande não foi encontrada.
Mau pedido (400) LargeFaceListNotTrained Lista de rostos grandes não é treinada.
Mau pedido (400) FaceListNotReady A lista de rostos está vazia.
Conflito (409) LargeFaceListTrainingNotFinished Grande lista de rostos está em treinamento.

Códigos de erro do Face Group

Esses códigos de erro podem ser retornados pela operação Face Group.

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument 'recognitionModel' é incompatível.
Mau pedido (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido situa-se 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 Description
Mau pedido (400) BadArgument O ID do grupo de pessoas é inválido. Caractere válido é 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 subscrição.
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 subscrição.
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 O ID do grupo de pessoas é inválido.
Não encontrado (404) PessoaNotFound Pessoa <personId> não encontrada.
Não encontrado (404) PessoaNotFound A identificação 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 de rosto persistente é inválido.
Não encontrado (404) PersonGroupNotTrained Grupo de pessoas não treinadas. 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 formação. 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 Description
Mau pedido (400) BadArgument O ID de grupo de pessoas grandes é inválido. Caractere válido é letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Mau pedido (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Proibido (403) QuotaExceeded O número de grupos de pessoas grandes atingiu o limite de nível de assinatura.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite de grupo de pessoas grandes.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite do nível de subscrição.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) LargePersonGroupNotFound Não foi encontrado um grupo de pessoas grande.
Não encontrado (404) LargePersonGroupNotFound O ID de grupo de pessoas grandes é inválido.
Não encontrado (404) PessoaNotFound Pessoa <personId> não encontrada.
Não encontrado (404) PessoaNotFound A identificação 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 de rosto persistente é inválido.
Não encontrado (404) LargePersonGroupNotTrained Grupo de pessoas grandes não treinado. Este erro aparece ao obter o status de treinamento de um grupo que nunca foi treinado.
Conflito (409) LargePersonGroupExiste Já existe um grande grupo de pessoas.
Conflito (409) LargePersonGroupTrainingNotFinished Grande grupo de pessoas está em treinamento. Tente novamente após a conclusão do treinamento.

Operações da Face List

Esses códigos de erro podem ser retornados por operações de Face List.

Códigos de erro da Lista de Rostos

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument O ID da lista de rostos é inválido. Caractere válido é 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 de rosto persistente é inválido.
Conflito (409) FaceListExiste A lista de rostos já existe.

Códigos de erro de lista de rostos grandes

Código de status Http Código de erro Mensagem de erro Description
Mau pedido (400) BadArgument O ID da lista de rostos grandes é inválido. Caractere válido é letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Mau pedido (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Proibido (403) QuotaExceeded O número da Lista de Rostos Grandes atingiu o limite.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) LargeFaceListNotFound 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 O rosto <faceId> da lista de rostos grandes não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O ID de rosto persistente é inválido.
Não encontrado (404) LargeFaceListNotTrained Grande lista de rostos não treinados. Este erro aparece ao obter o status de treinamento de uma grande lista de rostos que nunca foi treinada.
Conflito (409) LargeFaceListExists Já existe uma grande lista de rostos.
Conflito (409) LargeFaceListTrainingNotFinished 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 de 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 Description
Mau pedido (400) BadArgument O modelo de reconhecimento não é suportado para este recurso.
Mau pedido (400) BadArgument 'start' não é um ID de pessoa válido.
Mau pedido (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Mau pedido (400) DynamicPersonGroupNotFound O ID de grupo dinâmico de pessoas é inválido.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite do nível de subscrição.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) DynamicPersonGroupNotFound Não foi encontrado um grupo dinâmico de pessoas.
Não encontrado (404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> não foi encontrado.
Não encontrado (404) PessoaNotFound Pessoa não encontrada.
Não encontrado (404) PessoaNotFound A identificação 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 O ID <groupId> de grupo dinâmico de pessoas já existe.

Próximos passos