Kódy chyb rozhraní API pro rozpoznávání tváře Azure
Článek
Běžné kódy chyb
Tyto kódy chyb mohou být vráceny všemi voláními rozhraní API pro rozpoznávání tváře.
Stavový kód HTTP
Kód chyby
Chybová zpráva
Popis
Chybný požadavek (400)
BadArgument
Text požadavku je neplatný.
Chybný požadavek (400)
BadArgument
Chyba analýzy JSON
Chybný nebo nerozpoznaný text JSON požadavku
Chybný požadavek (400)
BadArgument
„recognitionModel“ je neplatný.
Chybný požadavek (400)
BadArgument
„detectionModel“ je neplatný.
Chybný požadavek (400)
BadArgument
Název je prázdný.
Chybný požadavek (400)
BadArgument
Název je příliš dlouhý.
Chybný požadavek (400)
BadArgument
UserData je příliš dlouhá.
Chybný požadavek (400)
BadArgument
Start je příliš dlouhý.
Chybný požadavek (400)
BadArgument
Horní hodnota je neplatná.
Chybný požadavek (400)
BadArgument
Argument targetFace je mimo rozsah.
Chybný požadavek (400)
BadArgument
Neplatný argument targetFace.
Příčinou je neplatný formát řetězce nebo neplatná hodnota vlevo, nahoře, výška/šířka.
Chybný požadavek (400)
InvalidURL
Neplatná adresa URL obrázku
Mezi podporované formáty patří JPEG, PNG, GIF (první snímek) a BMP.
Chybný požadavek (400)
InvalidURL
Neplatná adresa URL obrázku nebo chyba při stahování z cílového serveru Vrátila se chyba vzdáleného serveru: Při odesílání požadavku došlo k chybě.
Chybný požadavek (400)
InvalidImage
Chyba dekódování, nepodporovaný formát obrázku.
Chybný požadavek (400)
InvalidImage
Na obrázku nebyla zjištěna žádná tvář.
Chybný požadavek (400)
InvalidImage
Na obrázku je více než 1 obličej.
Chybný požadavek (400)
InvalidImageSize
Velikost obrázku je příliš malá.
Platná velikost souboru obrázku by měla být větší nebo rovna 1 kB.
Chybný požadavek (400)
InvalidImageSize
Velikost obrázku je příliš velká.
Platná velikost souboru obrázku by neměla být větší než 6 MB.
Neautorizováno (401)
401
Přístup byl odepřen kvůli neplatnému klíči předplatného nebo nesprávnému koncovému bodu rozhraní API. Ujistěte se, že pro aktivní předplatné zadáte platný klíč a pro prostředek použijete správný koncový bod místního rozhraní API.
Zakázáno (403)
UnsupportedFeature
Funkce není podporována, chybí schválení jedné nebo více následujících funkcí: Identifikace, Ověření.
Zaregistrujte se k přístupu odesláním registračního formuláře.
Konflikt (409)
ConcurrentOperationConflict
U prostředku <resourceName>existuje konfliktní operace, zkuste to prosím později.
Příliš mnoho požadavků (429)
429
Překročení limitu přenosové rychlosti.
Kódy chyb detekce tváří
Tyto kódy chyb mohou být vráceny operací rozpoznávání tváře.
Stavový kód HTTP
Kód chyby
Chybová zpráva
Popis
Chybný požadavek (400)
BadArgument
Neplatný argument returnFaceAttributes.
Chybný požadavek (400)
BadArgument
detection_02 nepodporuje „returnFaceAttributes“.
Chybný požadavek (400)
BadArgument
detection_02 nepodporuje „returnLandmarks“.
Zakázáno (403)
UnsupportedFeature
Návratové atributy (emoce, pohlaví, věk, úsměv, vlasy na obličeji, vlasy a make-up) jsou zastaralé a už se nepodporují.
Pošlete týmu Azure Face e-mailem, pokud máte zodpovědný případ použití, který by měl prospěch z používání některé z omezených možností.
Kódy chyb relace rozpoznávání tváře
Tyto kódy chyb mohou být vráceny operacemi relace liveness tváře.
Stavový kód HTTP
Kód chyby
Chybová zpráva
Popis
Chybný požadavek (400)
BadArgument
Spouštěcí parametr je neplatný. Zadejte pole ID poslední položky a pokračujte v procesu výpisu.
Chybný požadavek (400)
BadArgument
Horní parametr je neplatný. Platný rozsah je mezi 1 a 1 000 včetně.
Chybný požadavek (400)
InvalidRequestBody
Byl zadán nesprávný text požadavku. Zkontrolujte schéma operace a zkuste to znovu.
Chybný požadavek (400)
InvalidTokenLifetime
Bylo zadáno neplatné ověřování authTokenTimeToLiveInSeconds. Musí být v rozsahu 60 až 86400.
Chybný požadavek (400)
InvalidLivenessOperationMode
Byla zadána neplatná hodnota livenessOperationMode. Musí být pasivní.
Chybný požadavek (400)
InvalidDeviceCorrelationId
ID korelace zařízení se vyžaduje v textu požadavku během vytváření relace nebo spuštění relace. Nesmí být null nebo prázdný a nesmí být delší než 64 znaků.
Nenalezena (404)
SessionNotFound
ID relace se nenašlo. PLATNOST ID relace vypršela nebo neexistuje.
Rozpoznávání tváře – kódy chyb
Tyto kódy chyb mohou být vráceny operací Rozpoznávání tváře.
Stavový kód HTTP
Kód chyby
Chybová zpráva
Popis
Chybný požadavek (400)
BadArgument
Model recognitionModel není kompatibilní.
Chybný požadavek (400)
BadArgument
ID skupiny osob je neplatné.
Chybný požadavek (400)
BadArgument
ID skupiny velkých osob je neplatné.
Chybný požadavek (400)
BadArgument
ID dynamické skupiny osob je neplatné.
Chybný požadavek (400)
BadArgument
Argument maxNumOfCandidatesReturned není platný.
Platný rozsah je mezi [1, 100].
Chybný požadavek (400)
BadArgument
Argument confidenceThreshold není platný.
Platný rozsah je mezi [0, 1].
Chybný požadavek (400)
BadArgument
Délka faceId není v platném rozsahu.
Platný rozsah je mezi [1, 10].
Chybný požadavek (400)
FaceNotFound
Tvář nebyla nalezena.
Chybný požadavek (400)
PersonGroupNotFound
Skupina osob nebyla nalezena.
Chybný požadavek (400)
LargePersonGroupNotFound
Velká skupina osob nebyla nalezena.
Chybný požadavek (400)
DynamicPersonGroupNotFound
Dynamická skupina osob nebyla nalezena.
Chybný požadavek (400)
PersonGroupNotTrained
Skupina osob není vytrénovaná.
Chybný požadavek (400)
LargePersonGroupNotTrained
Velká skupina osob není vytrénovaná.
Chybný požadavek (400)
PersonGroupIdAndLargePersonGroupIdBothNotNull
ID skupiny velkých osob a ID skupiny osob nejsou null.
Chybný požadavek (400)
PersonGroupIdAndLargePersonGroupIdBothNull
ID skupiny velkých osob i ID skupiny osob mají hodnotu null.
Chybný požadavek (400)
MissingIdentificationScopeParameters
V požadavku není k dispozici žádný parametr oboru identifikace.