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

아티클
11/19/2024

문서 인텔리전스는 통합 디자인을 사용하여 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	요청된 작업을 찾을 수 없습니다. 식별자가 잘못되었거나 작업이 만료되었습니다.

다음을 통해 공유

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

피드백

추가 리소스