Hata kılavuzu v4.0, v3.1 ve v3.0
Belge Zekası, REST API'lerinde karşılaşılan tüm hataları temsil etmek için birleşik bir tasarım kullanır. Bir API işlemi 4xx veya 5xx durum kodu döndürdüğünde, yanıt JSON gövdesinde hatayla ilgili ek bilgiler aşağıdaki gibi döndürülür:
{
"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."
}
}
}
Birden çok hatayla karşılaşıldığı uzun süre çalışan işlemler için en üst düzey hata kodu, error.details özelliği altında listelenen tek tek hatalar ile en ciddi hataya ayarlanır. Bu tür senaryolarda, her bir hatanın hedef özelliği hatanın tetikleyicisini belirtir.
{
"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"
}
]
}
}
En üst düzey error.code özelliği aşağıdaki hata kodu iletilerinden biri olabilir:
| Hata Kodu | İleti | Http Durumu |
|---|---|---|
| InvalidRequest | Geçersiz istek. | 400 |
| InvalidArgument | Geçersiz bağımsız değişken. | 400 |
| Yasak | İlke veya diğer yapılandırma nedeniyle erişim yasaktır. | Kategori 403 |
| NotFound | Kaynak bulunamadı. | 404 |
| MethodNotAllowed | İstenen HTTP yöntemine izin verilmiyor. | 405 |
| Çakışma | Çakışma nedeniyle istek tamamlanamadı. | 409 |
| DesteklenmeyenMediaType | İstek içerik türü desteklenmez. | Kategori 415 |
| InternalServerError | Beklenmeyen bir hata oluştu. | 500 |
| ServiceUnavailable | Geçici bir hata oluştu. Yeniden deneyin. | 503 |
Mümkün olduğunda, iç hata özelliğinde daha fazla ayrıntı belirtilir.
| En Önemli Hata Kodu | İç Hata Kodu | İleti |
|---|---|---|
| Çakışma | ModelExists | Sağlanan ada sahip bir model zaten var. |
| Yasak | AuthorizationFailed | Yetkilendirme başarısız oldu: {details} |
| Yasak | InvalidDataProtectionKey | Veri koruma anahtarı geçersiz: {details} |
| Yasak | OutboundAccessForbidden | İstek, izin verilmeyen bir etki alanı adı içeriyor veya geçerli erişim denetimi ilkesini ihlal ediyor. |
| InternalServerError | Bilinmiyor | Bilinmeyen hata. |
| InvalidArgument | InvalidContentSourceFormat | Geçersiz içerik kaynağı: {details} |
| InvalidArgument | InvalidParameter | {parameterName} parametresi geçersiz: {details} |
| InvalidArgument | InvalidParameterLength | {parameterName} parametresi uzunluğu {maxChars} karakteri aşmamalıdır. |
| InvalidArgument | InvalidSasToken | Paylaşılan erişim imzası (SAS) geçersiz: {details} |
| InvalidArgument | ParameterMissing | {parameterName} parametresi gereklidir. |
| InvalidRequest | ContentSourceNotAccessible | İçeriğe erişilemiyor: {details} |
| InvalidRequest | ContentSourceTimeout | İstemciden dosya alınırken zaman aşımı. |
| InvalidRequest | DocumentModelLimit | Hesap {maximumModels} modellerinden fazlasını oluşturamaz. |
| InvalidRequest | DocumentModelLimitNeural | Hesap ayda 10'dan fazla özel sinir modeli oluşturamaz. Daha fazla kapasite istemek için desteğe başvurun. |
| InvalidRequest | DocumentModelLimitComposed | Hesap, {details} bileşen modellerinden daha fazlasını içeren bir model oluşturamaz. |
| InvalidRequest | InvalidContent | Dosya bozuk veya biçim desteklenmiyor. Desteklenen biçimlerin listesi için belgelere bakın. |
| InvalidRequest | InvalidContentDimensions | Giriş görüntüsü boyutları aralık dışında. Desteklenen görüntü boyutları için belgelere bakın. |
| InvalidRequest | InvalidContentLength | Giriş görüntüsü çok büyük. En büyük dosya boyutu için belgelere bakın. |
| InvalidRequest | InvalidFieldsDefinition | Geçersiz alanlar: {details} |
| InvalidRequest | InvalidTrainingContentLength | Eğitim içeriği {bytes} bayt içeriyor. Eğitim {maxBytes} bayt ile sınırlıdır. |
| InvalidRequest | InvalidTrainingContentPageCount | Eğitim içeriği {pages} sayfa içeriyor. Eğitim {pages} sayfayla sınırlıdır. |
| InvalidRequest | ModelAnalyzeError | Özel model kullanılarak analiz yapılamıyor: {details} |
| InvalidRequest | ModelBuildError | Model derlanamadı: {details} |
| InvalidRequest | ModelComposeError | Model oluşturamadı: {details} |
| InvalidRequest | ModelNotReady | Model istenen işlem için hazır değil. Eğitimin tamamlanmasını bekleyin veya işlem hatalarını denetleyin. |
| InvalidRequest | ModelReadOnly | İstenen model salt okunur. |
| InvalidRequest | NotSupportedApiVersion | İstenen işlem {minimumApiVersion} veya üzerini gerektiriyor. |
| InvalidRequest | OperationNotCancellable | İşlem artık iptal edilemiyor. |
| InvalidRequest | TrainingContentMissing | Eğitim verileri eksik: {details} |
| InvalidRequest | UnsupportedContent | İçerik desteklenmiyor: {details} |
| NotFound | ModelNotFound | İstenen model bulunamadı. Silindi veya hala oluşturuldu. |
| NotFound | OperationNotFound | İstenen işlem bulunamadı. Tanımlayıcı geçersiz veya işlemin süresi doldu. |