Azure Face API-hibakódok

Gyakori hibakódok

Ezeket a hibakódokat bármely Face API-hívás visszaadhatja.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A kérelem törzse érvénytelen.
Hibás kérés (400) BadArgument JSON-elemzési hiba. Hibás vagy felismerhetetlen kérelem JSON-törzse.
Hibás kérés (400) BadArgument A "recognitionModel" érvénytelen.
Hibás kérés (400) BadArgument A "detectionModel" érvénytelen.
Hibás kérés (400) BadArgument A "név" üres.
Hibás kérés (400) BadArgument A "név" túl hosszú.
Hibás kérés (400) BadArgument A "userData" túl hosszú.
Hibás kérés (400) BadArgument A "start" túl hosszú.
Hibás kérés (400) BadArgument A "top" érvénytelen.
Hibás kérés (400) BadArgument Argumentum targetFace kívül esik a tartományon.
Hibás kérés (400) BadArgument Érvénytelen argumentum targetFace. Érvénytelen sztringformátum vagy érvénytelen bal/felső/magasság/szélesség érték okozta.
Hibás kérés (400) InvalidURL Érvénytelen kép URL-címe. A támogatott formátumok közé tartozik a JPEG, a PNG, a GIF (az első képkocka) és a BMP.
Hibás kérés (400) InvalidURL Érvénytelen kép URL-címe vagy a célkiszolgálóról való letöltési hiba. A távoli kiszolgáló a következő hibaüzenetet adja vissza: "Hiba történt a kérés elküldése közben."
Hibás kérés (400) InvalidImage Dekódolási hiba, a képformátum nem támogatott.
Hibás kérés (400) InvalidImage A képen nem látható arc.
Hibás kérés (400) InvalidImage A kép több mint 1 arcot ábrázol.
Hibás kérés (400) InvalidImageSize A kép mérete túl kicsi. Az érvényes képfájl méretének 1 KB-nál nagyobbnak vagy egyenlőnek kell lennie.
Hibás kérés (400) InvalidImageSize A kép mérete túl nagy. Az érvényes képfájl mérete legfeljebb 6 MB lehet.
Unauthorized (401) 401 A hozzáférés érvénytelen előfizetési kulcs vagy hibás API-végpont miatt megtagadva. Adjon meg érvényes kulcsot egy aktív előfizetéshez, és használjon megfelelő regionális API-végpontot az erőforráshoz.
Forbidden (403) UnsupportedFeature A funkció nem támogatott, hiányzik a jóváhagyás az alábbi funkciók közül egy vagy több esetében: Azonosítás, Ellenőrzés. Regisztráljon a hozzáférésre egy regisztrációs űrlap elküldésével.
Conflict (409) ConcurrentOperationConflict Ütközési művelet van az erőforráson <resourceName>, próbálkozzon később.
Túl sok kérés (429) 429 Költési korlát túllépve.

Arcfelismerési hibakódok

Ezeket a hibakódokat a Face Detection művelettel lehet visszaadni.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument Érvénytelen argumentum: ReturnFaceAttributes.
Hibás kérés (400) BadArgument A "returnFaceAttributes" nem támogatott a detection_02 által.
Hibás kérés (400) BadArgument A "returnLandmarks" értéket a detection_02 nem támogatja.
Forbidden (403) UnsupportedFeature A return attribútumok (érzelem, nem, életkor, mosoly, arcszőrzet, haj és smink) elavultak, és már nem támogatottak. Küldjön e-mailt az Azure Face csapatának , ha olyan felelősségteljes használati esete van, amely a korlátozott képességek bármelyikének előnyeit élvezné.

Face Liveness Session hibakódjai

Ezeket a hibakódokat a Face Liveness-munkamenet műveletei adhatják vissza.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A start paraméter érvénytelen. A listakészítés folytatásához adja meg az utolsó bejegyzés Azonosító mezőjét.
Hibás kérés (400) BadArgument A felső paraméter érvénytelen. Az érvényes tartomány 1 és 1000 közötti lehet.
Hibás kérés (400) InvalidRequestBody Helytelen kérelemtörzs van megadva. Ellenőrizze a műveleti sémát, és próbálkozzon újra.
Hibás kérés (400) InvalidTokenLifetime Érvénytelen authTokenTimeToLiveInSeconds van megadva. 60-86400-on belül kell lennie.
Hibás kérés (400) InvalidLivenessOperationMode Érvénytelen livenessOperationMode van megadva. Passzívnak kell lennie.
Hibás kérés (400) InvalidDeviceCorrelationId A munkamenet létrehozása vagy a munkamenet indítása során eszköz korrelációs azonosítóra van szükség a kérelem törzsében. Nem lehet null vagy üres, és legfeljebb 64 karakter hosszúságú lehet.
Nem található (404) SessionNotFound A munkamenet-azonosító nem található. A munkamenet-azonosító lejárt vagy nem létezik.

Face Identify hibakódok

Ezeket a hibakódokat a Face Identify művelettel lehet visszaadni.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A "recognitionModel" nem kompatibilis.
Hibás kérés (400) BadArgument A személycsoport azonosítója érvénytelen.
Hibás kérés (400) BadArgument A nagy méretű személycsoport azonosítója érvénytelen.
Hibás kérés (400) BadArgument A dinamikus személycsoport azonosítója érvénytelen.
Hibás kérés (400) BadArgument A maxNumOfCandidatesReturned argumentum érvénytelen. Az érvényes tartomány [1, 100] között van.
Hibás kérés (400) BadArgument Az argumentum megbízhatósága Érvénytelen. Az érvényes tartomány [0, 1] között van.
Hibás kérés (400) BadArgument A faceIds hossza nem érvényes tartományban van. Az érvényes tartomány [1, 10] között van.
Hibás kérés (400) FaceNotFound Az arc nem található.
Hibás kérés (400) PersonGroupNotFound A személycsoport nem található.
Hibás kérés (400) LargePersonGroupNotFound A nagyméretű személycsoport nem található.
Hibás kérés (400) DynamicPersonGroupNotFound A dinamikus személycsoport nem található.
Hibás kérés (400) PersonGroupNotTrained A személycsoport nincs betanítve.
Hibás kérés (400) LargePersonGroupNotTrained A nagy személycsoport nincs betanítve.
Hibás kérés (400) PersonGroupIdAndLargePersonGroupIdBothNotNull A nagy méretű személycsoport azonosítója és a személycsoport azonosítója nem null értékű.
Hibás kérés (400) PersonGroupIdAndLargePersonGroupIdBothNull A nagy méretű személycsoport azonosítója és a személycsoport azonosítója egyaránt null értékű.
Hibás kérés (400) MissingIdentificationScopeParameters A kérelemben nincs azonosító hatókörparaméter.
Hibás kérés (400) IncompatibleIdentificationScopeParametersCombination Nem kompatibilis azonosítási hatókör paraméterei szerepelnek a kérelemben.
Conflict (409) PersonGroupTrainingNotFinished A személycsoport képzés alatt áll.
Conflict (409) LargePersonGroupTrainingNotFinished A nagy személycsoport betanítás alatt áll.

Face Verify hibakódok

Ezeket a hibakódokat a Face Verify művelettel lehet visszaadni.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A "recognitionModel" nem kompatibilis.
Hibás kérés (400) BadArgument Az arcazonosító érvénytelen. Az érvényes faceId a Face – Detect fájlból származik.
Hibás kérés (400) BadArgument A személyazonosító érvénytelen. A rendszer létrehoz egy érvényes personId azonosítót a Személycsoport létrehozása, a Nagy személy csoporttag vagy a Személy könyvtár létrehozása – Személy létrehozása szolgáltatásból.
Hibás kérés (400) BadArgument A személycsoport azonosítója érvénytelen.
Hibás kérés (400) BadArgument A nagy méretű személycsoport azonosítója érvénytelen.
Hibás kérés (400) PersonNotFound A személy nem található.
Hibás kérés (400) PersonGroupNotFound A személycsoport nem található.
Hibás kérés (400) LargePersonGroupNotFound A nagyméretű személycsoport nem található.
Nem található (404) FaceNotFound Az arc nem található.
Nem található (404) PersonNotFound A személy nem található.
Nem található (404) PersistedFaceNotFound A személy nem található megőrzött arcán.

Hasonló hibakódok keresése

Ezeket a hibakódokat a Face Find Hasonló művelettel lehet visszaadni.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A "recognitionModel" nem kompatibilis.
Hibás kérés (400) BadArgument A mód érvénytelen.
Hibás kérés (400) BadArgument Az arclista azonosítója érvénytelen.
Hibás kérés (400) BadArgument A nagyméretű arclista azonosítója érvénytelen.
Hibás kérés (400) BadArgument A LargeFaceListId, a faceListId és a faceId azonosítók nem érvényesek.
Hibás kérés (400) BadArgument A LargeFaceListId, a faceListId és a faceId értékek mind null értékűek.
Hibás kérés (400) BadArgument 2 vagy több nagyméretűFaceListId, faceListId és faceId nem null értékű.
Hibás kérés (400) BadArgument A maxNumOfCandidatesReturned argumentum érvénytelen. Az érvényes tartomány [1, 1000] között van.
Hibás kérés (400) BadArgument A faceIds hossza nem érvényes tartományban van. Az érvényes tartomány [1, 1000] között van.
Hibás kérés (400) FaceNotFound Az arc nem található.
Hibás kérés (400) FaceListNotFound Az arclista nem található.
Hibás kérés (400) LargeFaceListNotFound A nagyméretű arclista nem található.
Hibás kérés (400) LargeFaceListNotTrained A nagyméretű arclista nincs betanítve.
Hibás kérés (400) FaceListNotReady Az arclista üres.
Conflict (409) LargeFaceListTrainingNotFinished A nagy arclista betanítás alatt áll.

Arccsoport hibakódjai

Ezeket a hibakódokat a Face Group művelettel lehet visszaadni.

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A "recognitionModel" nem kompatibilis.
Hibás kérés (400) BadArgument A faceIds hossza nem érvényes tartományban van. Az érvényes tartomány [2, 1000] között van.

Személycsoport műveletei

Ezeket a hibakódokat a személycsoport műveletei adhatják vissza.

Személycsoport hibakódjai

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A személycsoport azonosítója érvénytelen. Az érvényes karakter angol betű kisbetűs, számjegy, "-" vagy "_". A maximális hossz 64.
Forbidden (403) QuotaExceeded A személycsoport száma elérte az előfizetési szint korlátját.
Forbidden (403) QuotaExceeded A személyszám elérte a csoportszintű korlátot.
Forbidden (403) QuotaExceeded A személyszám elérte az előfizetési szint korlátját.
Forbidden (403) QuotaExceeded A megőrzött arcszám elérte a korlátot.
Nem található (404) PersonGroupNotFound A személycsoport nem található.
Nem található (404) PersonGroupNotFound A személycsoport azonosítója érvénytelen.
Nem található (404) PersonNotFound A személy <personId> nem található.
Nem található (404) PersonNotFound A személyazonosító érvénytelen.
Nem található (404) PersistedFaceNotFound A megőrzött arc nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arc <faceId> nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arcazonosító érvénytelen.
Nem található (404) PersonGroupNotTrained A személycsoport nincs betanítve. Ez a hiba egy olyan csoport betanítási állapotának lekérésekor jelenik meg, amely soha nem lett betanított.
Conflict (409) PersonGroupExists A személycsoport már létezik.
Conflict (409) PersonGroupTrainingNotFinished A személycsoport képzés alatt áll. Próbálkozzon újra a betanítás befejezése után.

Nagy méretű személycsoport hibakódjai

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A nagy méretű személycsoport azonosítója érvénytelen. Az érvényes karakter angol betű kisbetűs, számjegy, "-" vagy "_". A maximális hossz 64.
Hibás kérés (400) BadArgument A "name" és a "userData" is üres.
Forbidden (403) QuotaExceeded A nagy számú személycsoport elérte az előfizetési szint korlátját.
Forbidden (403) QuotaExceeded A személyszám elérte a nagy létszámú csoportszintű korlátot.
Forbidden (403) QuotaExceeded A személyszám elérte az előfizetési szint korlátját.
Forbidden (403) QuotaExceeded A megőrzött arcszám elérte a korlátot.
Nem található (404) LargePersonGroupNotFound A nagyméretű személycsoport nem található.
Nem található (404) LargePersonGroupNotFound A nagy méretű személycsoport azonosítója érvénytelen.
Nem található (404) PersonNotFound A személy <personId> nem található.
Nem található (404) PersonNotFound A személyazonosító érvénytelen.
Nem található (404) PersistedFaceNotFound A megőrzött arc nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arc <faceId> nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arcazonosító érvénytelen.
Nem található (404) LargePersonGroupNotTrained A nagy személycsoport nincs betanítve. Ez a hiba egy olyan csoport betanítási állapotának lekérésekor jelenik meg, amely soha nem lett betanított.
Conflict (409) LargePersonGroupExists A nagy méretű személycsoport már létezik.
Conflict (409) LargePersonGroupTrainingNotFinished A nagy személycsoport betanítás alatt áll. Próbálkozzon újra a betanítás befejezése után.

Face List-műveletek

Ezeket a hibakódokat a Face List-műveletek visszaadhatják.

Arclista hibakódjai

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument Az arclista azonosítója érvénytelen. Az érvényes karakter angol betű kisbetűs, számjegy, "-" vagy "_". A maximális hossz 64.
Forbidden (403) QuotaExceeded A megőrzött arcszám elérte a korlátot.
Nem található (404) FaceListNotFound Az arclista nem található.
Nem található (404) FaceListNotFound Az arclista azonosítója érvénytelen.
Nem található (404) PersistedFaceNotFound A megőrzött arc nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arcazonosító érvénytelen.
Conflict (409) FaceListExists Az arclista már létezik.

Nagy arclista hibakódjai

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A nagyméretű arclista azonosítója érvénytelen. Az érvényes karakter angol betű kisbetűs, számjegy, "-" vagy "_". A maximális hossz 64.
Hibás kérés (400) BadArgument A "name" és a "userData" is üres.
Forbidden (403) QuotaExceeded A nagy arclista száma elérte a korlátot.
Forbidden (403) QuotaExceeded A megőrzött arcszám elérte a korlátot.
Nem található (404) LargeFaceListNotFound A nagyméretű arclista nem található.
Nem található (404) LargeFaceListNotFound A nagyméretű arclista azonosítója érvénytelen.
Nem található (404) PersistedFaceNotFound A nagyméretű arclista nem <faceId> található.
Nem található (404) PersistedFaceNotFound A megőrzött arcazonosító érvénytelen.
Nem található (404) LargeFaceListNotTrained A nagy arclista nincs betanítve. Ez a hiba egy olyan nagy arclista betanítási állapotának lekérésekor jelenik meg, amely soha nem lett betanítve.
Conflict (409) LargeFaceListExists Már létezik nagy arclista.
Conflict (409) LargeFaceListTrainingNotFinished A nagy arclista betanítás alatt áll. Próbálkozzon újra a betanítás befejezése után.

Person Directory-műveletek

Ezeket a hibakódokat a Person Directory-műveletek visszaadhatják.

Person Directory hibakódok

Http-állapotkód Error code Error message Description
Hibás kérés (400) BadArgument A felismerésmodell nem támogatott ehhez a funkcióhoz.
Hibás kérés (400) BadArgument A "start" érvénytelen személyazonosító.
Hibás kérés (400) BadArgument A "name" és a "userData" is üres.
Hibás kérés (400) DynamicPersonGroupNotFound A dinamikus személycsoport azonosítója érvénytelen.
Forbidden (403) QuotaExceeded A személyszám elérte az előfizetési szint korlátját.
Forbidden (403) QuotaExceeded A megőrzött arcszám elérte a korlátot.
Nem található (404) DynamicPersonGroupNotFound A dinamikus személycsoport nem található.
Nem található (404) DynamicPersonGroupNotFound A DynamicPersonGroupPersonReference <groupId> nem található.
Nem található (404) PersonNotFound A személy nem található.
Nem található (404) PersonNotFound A személyazonosító érvénytelen.
Nem található (404) PersistedFaceNotFound A megőrzött arc nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arc <faceId> nem található.
Nem található (404) PersistedFaceNotFound A megőrzött arcazonosító érvénytelen.
Conflict (409) DynamicPersonGroupExists A dinamikus személycsoport azonosítója <groupId> már létezik.

Next steps