다음을 통해 공유


오류 가이드 v4.0, v3.1 및 v3.0

문서 인텔리전스는 통합 디자인을 사용하여 REST API에서 발생한 모든 오류를 나타냅니다. API 작업이 4xx 또는 5xx 상태 코드를 반환할 때마다 오류에 대한 추가 정보가 다음과 같이 응답 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."
    }
  }
}

여러 오류가 발생할 수 있는 장기 실행 작업의 경우 최상위 오류 코드는 가장 심각한 오류로 설정되며 개별 오류는 error.details 속성 아래에 나열됩니다. 이러한 시나리오에서 각 개별 오류의 대상 속성은 오류의 트리거를 지정합니다.

{
    "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"
            }
        ]
    }
}

최상위 error.code 속성은 다음 오류 코드 메시지 중 하나일 수 있습니다.

오류 코드 메시지 HTTP 상태
InvalidRequest 잘못된 요청입니다. 400
InvalidArgument 인수가 잘못되었습니다. 400
금지 정책 또는 기타 구성으로 인해 액세스가 금지되었습니다. 403
NotFound 리소스를 찾을 수 없습니다. 404
MethodNotAllowed 요청된 HTTP 메서드는 허용되지 않습니다. 405
충돌 충돌로 인해 요청을 완료할 수 없습니다. 409
UnsupportedMediaType 요청 콘텐츠 형식은 지원되지 않습니다. 415
InternalServerError 예기치 않은 오류가 발생했습니다. 500
ServiceUnavailable 일시적인 오류가 발생했습니다. 다시 시도하세요. 503

가능하면 내부 오류 속성에 자세한 정보가 지정됩니다.

최상위 오류 코드 내부 오류 코드 메시지
충돌 ModelExists 제공된 이름을 가진 모델이 이미 있습니다.
금지 AuthorizationFailed 권한 부여 실패: {details}
금지 InvalidDataProtectionKey 데이터 보호 키가 잘못됨: {details}
금지 OutboundAccessForbidden 요청에 허용되지 않는 도메인 이름이 포함되어 있거나 현재 액세스 제어 정책을 위반합니다.
InternalServerError Unknown 알 수 없는 오류입니다.
InvalidArgument InvalidContentSourceFormat 잘못된 콘텐츠 원본: {details}
InvalidArgument InvalidParameter 매개 변수 {parameterName}이 잘못됨: {details}
InvalidArgument InvalidParameterLength 매개 변수 {parameterName} 길이는 {maxChars} 문자를 초과할 수 없습니다.
InvalidArgument InvalidSasToken SAS(공유 액세스 서명)가 잘못됨: {details}
InvalidArgument ParameterMissing 매개 변수 {parameterName}이 필요합니다.
InvalidRequest ContentSourceNotAccessible 콘텐츠에 액세스할 수 없음: {details}
InvalidRequest ContentSourceTimeout 클라이언트에서 파일을 수신하는 동안 시간이 초과되었습니다.
InvalidRequest DocumentModelLimit 계정은 {maximumModels} 모델을 초과하여 만들 수 없습니다.
InvalidRequest DocumentModelLimitNeural 계정은 매월 10개를 초과하여 사용자 지정 신경망 모델을 만들 수 없습니다. 더 많은 용량을 요청하려면 지원에 문의하세요.
InvalidRequest DocumentModelLimitComposed 계정은 {details} 구성 요소 모델을 초과하여 모델을 만들 수 없습니다.
InvalidRequest InvalidContent 파일이 손상되었거나 지원되지 않은 형식입니다. 지원되는 형식 목록은 설명서를 참조하세요.
InvalidRequest InvalidContentDimensions 입력 이미지 차원이 범위를 벗어났습니다. 지원되는 이미지 차원에 대한 설명서를 참조하세요.
InvalidRequest InvalidContentLength 입력 이미지가 너무 큽니다. 최대 파일 크기에 대한 설명서를 참조하세요.
InvalidRequest InvalidFieldsDefinition 잘못된 필드: {details}
InvalidRequest InvalidTrainingContentLength 학습 콘텐츠에는 {bytes} 바이트가 포함됩니다. 학습은 {maxBytes} 바이트로 제한됩니다.
InvalidRequest InvalidTrainingContentPageCount 학습 콘텐츠에는 {pages} 페이지가 포함되어 있습니다. 학습은 {pages} 페이지로 제한됩니다.
InvalidRequest ModelAnalyzeError 사용자 지정 모델을 사용하여 분석할 수 없음: {details}
InvalidRequest ModelBuildError 모델을 빌드할 수 없음: {details}
InvalidRequest ModelComposeError 모델을 구성할 수 없음: {details}
InvalidRequest ModelNotReady 모델이 요청한 작업을 수행할 준비가 되지 않았습니다. 학습이 완료되기를 기다리거나 작업 오류를 확인합니다.
InvalidRequest ModelReadOnly 요청된 모델은 읽기 전용입니다.
InvalidRequest NotSupportedApiVersion 요청된 작업에는 {minimumApiVersion} 이상이 필요합니다.
InvalidRequest OperationNotCancellable 작업을 더 이상 취소할 수 없습니다.
InvalidRequest TrainingContentMissing 학습 데이터가 누락됨: {details}
InvalidRequest UnsupportedContent 콘텐츠가 지원되지 않음: {details}
NotFound ModelNotFound 요청한 모델을 찾을 수 없습니다. 삭제되었거나 여전히 빌드 중입니다.
NotFound OperationNotFound 요청된 작업을 찾을 수 없습니다. 식별자가 잘못되었거나 작업이 만료되었습니다.