Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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