Hiba útmutató a 4.0-s, 3.1-s és 3.0-s verzióhoz
A Dokumentumintelligencia egységes kialakítással jeleníti meg a REST API-kban előforduló összes hibát. Amikor egy API-művelet 4xx vagy 5xx állapotkódot ad vissza, a hiba további információi a válasz JSON törzsében lesznek visszaadva az alábbiak szerint:
{
"error": {
"code": "InvalidRequest",
"message": "Invalid request.",
"innererror": {
"code": "InvalidContent",
"message": "The file format is unsupported or corrupted. Refer to documentation for the list of supported formats."
}
}
}
Olyan hosszú ideig futó műveletek esetén, amelyekben több hiba is előfordul, a legfelső szintű hibakód a legsúlyosabb hibára van állítva, az egyes hibák pedig a error.details tulajdonság alatt jelennek meg . Ilyen esetekben az egyes hibák céltulajdonsága határozza meg a hiba eseményindítóját.
{
"status": "failed",
"createdDateTime": "2021-07-14T10:17:51Z",
"lastUpdatedDateTime": "2021-07-14T10:17:51Z",
"error": {
"code": "InternalServerError",
"message": "An unexpected error occurred.",
"details": [
{
"code": "InternalServerError",
"message": "An unexpected error occurred."
},
{
"code": "InvalidContentDimensions",
"message": "The input image dimensions are out of range. Refer to documentation for supported image dimensions.",
"target": "2"
}
]
}
}
A legfelső szintű error.code tulajdonság a következő hibaüzenetek egyike lehet:
| Hibakód | Üzenet | Http-állapot |
|---|---|---|
| InvalidRequest | Érvénytelen kérelem. | 400 |
| InvalidArgument | Érvénytelen argumentum. | 400 |
| Forbidden | A hozzáférés szabályzat vagy más konfiguráció miatt tiltott. | 403 |
| NotFound | Az erőforrás nem található. | 404 |
| MethodNotAllowed | A kért HTTP-metódus nem engedélyezett. | 405 |
| Ütközés | Ütközés miatt a kérés nem hajtható végre. | 409 |
| Nem támogatottMediaType | A kérelem tartalomtípusa nem támogatott. | 415 |
| InternalServerError | Egy váratlan hiba történt. | 500 |
| ServiceUnavailable | Átmeneti hiba történt. Próbálkozzon újra. | 503 |
Ha lehetséges, további részleteket a belső hibatulajdonság tartalmaz.
| Leggyakoribb hibakód | Belső hibakód | Üzenet |
|---|---|---|
| Ütközés | ModelExists | A megadott névvel rendelkező modell már létezik. |
| Forbidden | AuthorizationFailed | Az engedélyezés nem sikerült: {details} |
| Forbidden | InvalidDataProtectionKey | Az adatvédelmi kulcs érvénytelen: {details} |
| Forbidden | OutboundAccessForbidden | A kérelem nem engedélyezett tartománynevet tartalmaz, vagy megsérti az aktuális hozzáférés-vezérlési szabályzatot. |
| InternalServerError | Ismeretlen | Ismeretlen hiba. |
| InvalidArgument | InvalidContentSourceFormat | Érvénytelen tartalomforrás: {details} |
| InvalidArgument | InvalidParameter | A(z) {parameterName} paraméter érvénytelen: {details} |
| InvalidArgument | InvalidParameterLength | A(z) {parameterName} paraméter hossza nem haladhatja meg a(z) {maxChars} karaktert. |
| InvalidArgument | InvalidSasToken | A közös hozzáférésű jogosultságkód (SAS) érvénytelen: {details} |
| InvalidArgument | ParameterMissing | A(z) {parameterName} paraméter megadása kötelező. |
| InvalidRequest | ContentSourceNotAccessible | A tartalom nem érhető el: {details} |
| InvalidRequest | ContentSourceTimeout | Időtúllépés a fájl ügyféltől való fogadása közben. |
| InvalidRequest | DocumentModelLimit | A fiók legfeljebb {maximumModels} modelleket hozhat létre. |
| InvalidRequest | DocumentModelLimitNeural | A fiók legfeljebb 10 egyéni neurális modellt hozhat létre havonta. További kapacitás kéréséhez forduljon az ügyfélszolgálathoz. |
| InvalidRequest | DocumentModelLimitComposed | A fiók nem hozhat létre több {details} összetevőmodellt tartalmazó modellt. |
| InvalidRequest | InvalidContent | A fájl sérült, vagy a formátum nem támogatott. A támogatott formátumok listáját a dokumentációban találja. |
| InvalidRequest | InvalidContentDimensions | A bemeneti kép méretei a tartományon kívül vannak. A támogatott képméreteket a dokumentációban találja. |
| InvalidRequest | InvalidContentLength | A bemeneti kép túl nagy. A maximális fájlméretet a dokumentációban találja. |
| InvalidRequest | InvalidFieldsDefinition | Érvénytelen mezők: {details} |
| InvalidRequest | InvalidTrainingContentLength | A betanítási tartalom {bytes} bájtot tartalmaz. A betanítás legfeljebb {maxBytes} bájtra korlátozódik. |
| InvalidRequest | InvalidTrainingContentPageCount | A betanítási tartalom {pages} oldalakat tartalmaz. A betanítás csak {pages} oldalakra korlátozódik. |
| InvalidRequest | ModelAnalyzeError | Nem sikerült elemezni egyéni modell használatával: {details} |
| InvalidRequest | ModelBuildError | Nem sikerült létrehozni a modellt: {details} |
| InvalidRequest | ModelComposeError | Nem sikerült megírni a modellt: {details} |
| InvalidRequest | ModelNotReady | A modell nem áll készen a kért műveletre. Várjon, amíg a betanítás befejeződik, vagy ellenőrizze a műveleti hibákat. |
| InvalidRequest | ModelReadOnly | A kért modell írásvédett. |
| InvalidRequest | NotSupportedApiVersion | A kért művelethez {minimumApiVersion} vagy újabb szükséges. |
| InvalidRequest | OperationNotCancellable | A művelet már nem szakítható meg. |
| InvalidRequest | TrainingContentMissing | Hiányoznak a betanítási adatok: {details} |
| InvalidRequest | Nem támogatottKontent | A tartalom nem támogatott: {details} |
| NotFound | ModelNotFound | A kért modell nem található. Törölték vagy még mindig építik. |
| NotFound | OperationNotFound | A kért művelet nem található. Az azonosító érvénytelen, vagy a művelet lejárt. |