Codici di errore dell'API Viso di Intelligenza artificiale di Azure
Articolo
Codici errore comuni
Questi codici di errore possono essere restituiti da qualsiasi chiamata API Viso.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
Corpo della richiesta non valido.
Richiesta non valida (400)
BadArgument
Errore di analisi JSON.
Corpo JSON della richiesta non riconosciuto o non riconosciuto.
Richiesta non valida (400)
BadArgument
'recognitionModel' non è valido.
Richiesta non valida (400)
BadArgument
'detectionModel' non è valido.
Richiesta non valida (400)
BadArgument
'name' è vuoto.
Richiesta non valida (400)
BadArgument
'name' è troppo lungo.
Richiesta non valida (400)
BadArgument
'userData' è troppo lungo.
Richiesta non valida (400)
BadArgument
'start' è troppo lungo.
Richiesta non valida (400)
BadArgument
'top' non è valido.
Richiesta non valida (400)
BadArgument
TargetFace dell'argomento non compreso nell'intervallo.
Richiesta non valida (400)
BadArgument
TargetFace dell'argomento non valido.
Causato da un formato di stringa non valido o da un valore di sinistra/altezza/altezza/larghezza non valido.
Richiesta non valida (400)
InvalidURL
URL dell'immagine non valido.
I formati supportati includono JPEG, PNG, GIF (il primo frame), BMP.
Richiesta non valida (400)
InvalidURL
URL immagine non valido o errore durante il download dal server di destinazione. Errore del server remoto restituito: "Si è verificato un errore durante l'invio della richiesta".
Richiesta non valida (400)
InvalidImage
Errore di decodifica, formato immagine non supportato.
Richiesta non valida (400)
InvalidImage
Nessun viso rilevato nell'immagine.
Richiesta non valida (400)
InvalidImage
Nell'immagine sono presenti più di 1 viso.
Richiesta non valida (400)
InvalidImageSize
Le dimensioni dell'immagine sono troppo piccole.
Le dimensioni del file di immagine valide devono essere maggiori o uguali a 1 KB.
Richiesta non valida (400)
InvalidImageSize
Le dimensioni dell'immagine sono troppo grandi.
Le dimensioni del file di immagine valide non devono essere superiori a 6 MB.
Non autorizzato (401)
401
Accesso negato a causa di una chiave di sottoscrizione non valida o di un endpoint API errato. Assicurarsi di fornire una chiave valida per una sottoscrizione attiva e di usare un endpoint API a livello di area corretto per la risorsa.
Non consentito (403)
UnsupportedFeature
La funzionalità non è supportata, manca l'approvazione per una o più delle funzionalità seguenti: Identificazione, Verifica.
Registrarsi per l'accesso inviando un modulo di registrazione.
Conflitto (409)
ConcurrentOperationConflict
È presente un'operazione di conflitto sulla risorsa <resourceName>. Riprovare più tardi.
Troppe richieste (429)
429
Il limite di velocità è stato superato.
Codici di errore di rilevamento dei volti
Questi codici di errore possono essere restituiti dall'operazione di rilevamento viso.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
Argomento returnFaceAttributes non valido.
Richiesta non valida (400)
BadArgument
'returnFaceAttributes' non è supportato da detection_02.
Richiesta non valida (400)
BadArgument
'returnLandmarks' non è supportato da detection_02.
Non consentito (403)
UnsupportedFeature
Gli attributi restituiti (emozione, sesso, età, sorriso, capelli, capelli e trucco) sono stati deprecati e non sono più supportati.
Inviare un messaggio di posta elettronica al team di Viso di Azure se si ha un caso d'uso responsabile che trarrà vantaggio dall'uso di una delle funzionalità limitate.
Codici di errore di Face Liveness Session
Questi codici di errore possono essere restituiti dalle operazioni face liveness Session.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
Il parametro Start non è valido. Specificare il campo "Id" dell'ultima voce per continuare il processo di presentazione.
Richiesta non valida (400)
BadArgument
Parametro top non valido. L'intervallo valido è compreso tra 1 e 1000 inclusi.
Richiesta non valida (400)
InvalidRequestBody
Corpo della richiesta non corretto specificato. Controllare lo schema dell'operazione e riprovare.
Richiesta non valida (400)
InvalidTokenLifetime
Specificato authTokenTimeToLiveInSeconds non valido. Deve essere compreso tra 60 e 86400.
Richiesta non valida (400)
InvalidLivenessOperationMode
LivenessOperationMode non valido specificato. Deve essere "Passivo".
Richiesta non valida (400)
InvalidDeviceCorrelationId
Nel corpo della richiesta durante la creazione o l'avvio della sessione è necessario un ID di correlazione del dispositivo. Non deve essere null o vuoto e non deve contenere più di 64 caratteri.
Non trovato (404)
SessionNotFound
ID sessione non trovato. L'ID sessione è scaduto o non esiste.
Codici di errore di Identificazione viso
Questi codici di errore possono essere restituiti dall'operazione Face Identify.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
'recognitionModel' non è compatibile.
Richiesta non valida (400)
BadArgument
ID gruppo di persone non valido.
Richiesta non valida (400)
BadArgument
ID gruppo di persone di grandi dimensioni non valido.
Richiesta non valida (400)
BadArgument
ID gruppo di persone dinamiche non valido.
Richiesta non valida (400)
BadArgument
L'argomento maxNumOfCandidatesReturned non è valido.
L'intervallo valido è compreso tra [1, 100].
Richiesta non valida (400)
BadArgument
L'argomento confidenceThreshold non è valido.
L'intervallo valido è compreso tra [0, 1].
Richiesta non valida (400)
BadArgument
La lunghezza di faceIds non è in un intervallo valido.
L'intervallo valido è compreso tra [1, 10].
Richiesta non valida (400)
FaceNotFound
Il viso non viene trovato.
Richiesta non valida (400)
PersonGroupNotFound
Gruppo di persone non trovato.
Richiesta non valida (400)
LargePersonGroupNotFound
Impossibile trovare un gruppo di persone di grandi dimensioni.
Richiesta non valida (400)
DynamicPersonGroupNotFound
Il gruppo di persone dinamiche non viene trovato.
Richiesta non valida (400)
PersonGroupNotTrained
Gruppo di persone non sottoposto a training.
Richiesta non valida (400)
LargePersonGroupNotTrained
Gruppo di persone di grandi dimensioni non addestrato.
Richiesta non valida (400)
PersonGroupIdAndLargePersonGroupIdBothNotNull
L'ID gruppo di persone di grandi dimensioni e l'ID gruppo di persone non sono entrambi Null.
Richiesta non valida (400)
PersonGroupIdAndLargePersonGroupIdBothNull
L'ID gruppo di persone di grandi dimensioni e l'ID gruppo di persone sono entrambi Null.
Richiesta non valida (400)
MissingIdentificationScopeParameters
Nella richiesta non è presente alcun parametro di ambito di identificazione.
I parametri dell'ambito di identificazione non compatibili sono presenti nella richiesta.
Conflitto (409)
PersonGroupTrainingNotFinished
Il gruppo di persone è sottoposto a training.
Conflitto (409)
LargePersonGroupTrainingNotFinished
Il gruppo di persone di grandi dimensioni è in formazione.
Codici di errore di Verifica viso
Questi codici di errore possono essere restituiti dall'operazione Verifica viso.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
'recognitionModel' non è compatibile.
Richiesta non valida (400)
BadArgument
L'ID viso non è valido.
Un faceId valido proviene da Face - Detect.
Richiesta non valida (400)
BadArgument
ID persona non valido.
Un personId valido viene generato da Create Person Group Person Person, Create Large Person Group Person Person person (Crea persona di grandi dimensioni) o Person Directory -Create Person (Crea persona).
Richiesta non valida (400)
BadArgument
ID gruppo di persone non valido.
Richiesta non valida (400)
BadArgument
ID gruppo di persone di grandi dimensioni non valido.
Richiesta non valida (400)
PersonNotFound
La persona non viene trovata.
Richiesta non valida (400)
PersonGroupNotFound
Il gruppo di persone non viene trovato.
Richiesta non valida (400)
LargePersonGroupNotFound
Impossibile trovare un gruppo di persone di grandi dimensioni.
Non trovato (404)
FaceNotFound
Il viso non viene trovato.
Non trovato (404)
PersonNotFound
La persona non viene trovata.
Non trovato (404)
PersistedFaceNotFound
Non viene trovato alcun viso persistente della persona.
Trovare codici di errore simili
Questi codici di errore possono essere restituiti dall'operazione Face Find Similar.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
'recognitionModel' non è compatibile.
Richiesta non valida (400)
BadArgument
La modalità non è valida.
Richiesta non valida (400)
BadArgument
ID elenco visi non valido.
Richiesta non valida (400)
BadArgument
ID elenco visi di grandi dimensioni non valido.
Richiesta non valida (400)
BadArgument
LargeFaceListId, faceListId e faceIds, non esattamente uno di essi è valido.
Richiesta non valida (400)
BadArgument
LargeFaceListId, faceListId e faceId sono tutti Null.
Richiesta non valida (400)
BadArgument
2 o più di largeFaceListId, faceListId e faceId non sono Null.
Richiesta non valida (400)
BadArgument
L'argomento maxNumOfCandidatesReturned non è valido.
L'intervallo valido è compreso tra [1, 1000].
Richiesta non valida (400)
BadArgument
La lunghezza di faceIds non è in un intervallo valido.
L'intervallo valido è compreso tra [1, 1000].
Richiesta non valida (400)
FaceNotFound
Il viso non viene trovato.
Richiesta non valida (400)
FaceListNotFound
Impossibile trovare l'elenco dei visi.
Richiesta non valida (400)
LargeFaceListNotFound
Impossibile trovare un elenco di visi di grandi dimensioni.
Richiesta non valida (400)
LargeFaceListNotTrained
Elenco di visi di grandi dimensioni non sottoposto a training.
Richiesta non valida (400)
FaceListNotReady
L'elenco dei visi è vuoto.
Conflitto (409)
LargeFaceListTrainingNotFinished
L'elenco dei volti di grandi dimensioni è sottoposto a training.
Codici di errore di Face Group
Questi codici di errore possono essere restituiti dall'operazione Face Group.
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
'recognitionModel' non è compatibile.
Richiesta non valida (400)
BadArgument
La lunghezza di faceIds non è in un intervallo valido.
L'intervallo valido è compreso tra [2, 1000].
Operazioni del gruppo di persone
Questi codici di errore possono essere restituiti dalle operazioni di Person Group.
Codici di errore del gruppo di persone
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
ID gruppo di persone non valido.
Il carattere valido è la lettera inglese in lettere minuscole, cifre, '-' o '_'. La lunghezza massima è 64.
Non consentito (403)
QuotaExceeded
Il numero del gruppo di persone ha raggiunto il limite del livello di sottoscrizione.
Non consentito (403)
QuotaExceeded
Il numero di persona ha raggiunto il limite a livello di gruppo delle persone.
Non consentito (403)
QuotaExceeded
Il numero di persona ha raggiunto il limite del livello di sottoscrizione.
Non consentito (403)
QuotaExceeded
Il numero di viso persistente ha raggiunto il limite.
Non trovato (404)
PersonGroupNotFound
Gruppo di persone non trovato.
Non trovato (404)
PersonGroupNotFound
ID gruppo di persone non valido.
Non trovato (404)
PersonNotFound
La persona <personId> non viene trovata.
Non trovato (404)
PersonNotFound
ID persona non valido.
Non trovato (404)
PersistedFaceNotFound
Il viso persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
Il viso <faceId> persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
L'ID viso persistente non è valido.
Non trovato (404)
PersonGroupNotTrained
Gruppo di persone non sottoposto a training.
Questo errore viene visualizzato quando viene visualizzato lo stato di training di un gruppo che non è mai stato sottoposto a training.
Conflitto (409)
PersonGroupExists
Il gruppo di persone esiste già.
Conflitto (409)
PersonGroupTrainingNotFinished
Il gruppo di persone è sottoposto a training.
Riprovare dopo il completamento del training.
Codici di errore del gruppo di persone di grandi dimensioni
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
ID gruppo di persone di grandi dimensioni non valido.
Il carattere valido è la lettera inglese in lettere minuscole, cifre, '-' o '_'. La lunghezza massima è 64.
Richiesta non valida (400)
BadArgument
Sia 'name' che 'userData' sono vuoti.
Non consentito (403)
QuotaExceeded
Il numero di gruppo di persone di grandi dimensioni ha raggiunto il limite del livello di sottoscrizione.
Non consentito (403)
QuotaExceeded
Il numero di persona ha raggiunto un limite a livello di gruppo di persone di grandi dimensioni.
Non consentito (403)
QuotaExceeded
Il numero di persona ha raggiunto il limite del livello di sottoscrizione.
Non consentito (403)
QuotaExceeded
Il numero di viso persistente ha raggiunto il limite.
Non trovato (404)
LargePersonGroupNotFound
Impossibile trovare un gruppo di persone di grandi dimensioni.
Non trovato (404)
LargePersonGroupNotFound
ID gruppo di persone di grandi dimensioni non valido.
Non trovato (404)
PersonNotFound
La persona <personId> non viene trovata.
Non trovato (404)
PersonNotFound
ID persona non valido.
Non trovato (404)
PersistedFaceNotFound
Il viso persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
Il viso <faceId> persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
L'ID viso persistente non è valido.
Non trovato (404)
LargePersonGroupNotTrained
Gruppo di persone di grandi dimensioni non addestrato.
Questo errore viene visualizzato quando viene visualizzato lo stato di training di un gruppo che non è mai stato sottoposto a training.
Conflitto (409)
LargePersonGroupExists
Esiste già un gruppo di persone di grandi dimensioni.
Conflitto (409)
LargePersonGroupTrainingNotFinished
Il gruppo di persone di grandi dimensioni è in formazione.
Riprovare dopo il completamento del training.
Operazioni dell'elenco dei visi
Questi codici di errore possono essere restituiti dalle operazioni Face List.
Codici di errore dell'elenco dei visi
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
ID elenco visi non valido.
Il carattere valido è la lettera inglese in lettere minuscole, cifre, '-' o '_'. La lunghezza massima è 64.
Non consentito (403)
QuotaExceeded
Il numero di viso persistente ha raggiunto il limite.
Non trovato (404)
FaceListNotFound
Impossibile trovare l'elenco dei visi.
Non trovato (404)
FaceListNotFound
ID elenco visi non valido.
Non trovato (404)
PersistedFaceNotFound
Il viso persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
L'ID viso persistente non è valido.
Conflitto (409)
FaceListExists
L'elenco dei visi esiste già.
Codici di errore elenco volti di grandi dimensioni
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
ID elenco visi di grandi dimensioni non valido.
Il carattere valido è la lettera inglese in lettere minuscole, cifre, '-' o '_'. La lunghezza massima è 64.
Richiesta non valida (400)
BadArgument
Sia 'name' che 'userData' sono vuoti.
Non consentito (403)
QuotaExceeded
È stato raggiunto un numero elevato di elenchi di volti.
Non consentito (403)
QuotaExceeded
Il numero di viso persistente ha raggiunto il limite.
Non trovato (404)
LargeFaceListNotFound
Impossibile trovare un elenco di visi di grandi dimensioni.
Non trovato (404)
LargeFaceListNotFound
ID elenco visi di grandi dimensioni non valido.
Non trovato (404)
PersistedFaceNotFound
Viso <faceId> elenco viso di grandi dimensioni non trovato.
Non trovato (404)
PersistedFaceNotFound
L'ID viso persistente non è valido.
Non trovato (404)
LargeFaceListNotTrained
Elenco di visi di grandi dimensioni non sottoposto a training.
Questo errore viene visualizzato quando viene visualizzato lo stato di training di un elenco di visi di grandi dimensioni che non è mai stato sottoposto a training.
Conflitto (409)
LargeFaceListExists
Esiste già un elenco di visi di grandi dimensioni.
Conflitto (409)
LargeFaceListTrainingNotFinished
L'elenco dei volti di grandi dimensioni è sottoposto a training.
Riprovare dopo il completamento del training.
Operazioni della directory delle persone
Questi codici di errore possono essere restituiti dalle operazioni di Person Directory.
Codici di errore di Person Directory
Codice di stato HTTP
Codice di errore
Error message
Descrizione
Richiesta non valida (400)
BadArgument
Il modello di riconoscimento non è supportato per questa funzionalità.
Richiesta non valida (400)
BadArgument
'start' non è un ID persona valido.
Richiesta non valida (400)
BadArgument
Sia 'name' che 'userData' sono vuoti.
Richiesta non valida (400)
DynamicPersonGroupNotFound
ID gruppo di persone dinamiche non valido.
Non consentito (403)
QuotaExceeded
Il numero di persona ha raggiunto il limite del livello di sottoscrizione.
Non consentito (403)
QuotaExceeded
Il numero di viso persistente ha raggiunto il limite.
Non trovato (404)
DynamicPersonGroupNotFound
Impossibile trovare il gruppo di persone dinamiche.
Non trovato (404)
DynamicPersonGroupNotFound
DynamicPersonGroupPersonReference <groupId> non viene trovato.
Non trovato (404)
PersonNotFound
La persona non viene trovata.
Non trovato (404)
PersonNotFound
ID persona non valido.
Non trovato (404)
PersistedFaceNotFound
Il viso persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
Il viso <faceId> persistente non viene trovato.
Non trovato (404)
PersistedFaceNotFound
L'ID viso persistente non è valido.
Conflitto (409)
DynamicPersonGroupExists
L'ID <groupId> gruppo di persone dinamiche esiste già.