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:

JSON

{
  "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.

JSON

{
    "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.