오류

다음 섹션에서는 v2 및 v1 리소스 메서드의 오류 모델을 각각 설명합니다.

v2 리소스 오류 모델

기본적으로 리소스 메서드는 200 OK 상태로 응답합니다.요청이 실패하면 Open Cloud는 표준 오류 코드를 반환합니다.모든 오류 응답에는 동일한 형식이 있으며 포함 내용:

• code - HTTP 상태 코드를 나타냅니다.
• message - 오류를 설명하는 메시지
• details - 오류와 관련된 자세한 정보를 포함하는 개체

예시 오류
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

코드

다음 표에서는 code에 대한 가능한 값을 설명합니다.

v1 리소스 오류 모델

모든 오류 응답에는 일관된 표준 형식이 있으며 다음이 포함됩니다:

• 모든 Open Cloud 끝점에 적용할 수 있는 높은 수준의 원인인 error 필드.
• 설명 오류 message , 오류를 더 설명하는 설명 오류.
• 각 API에 특정한 오류의 자세한 정보를 다루는 errorDetails 개체.

오류의 근본 원인을 분석하려면 error 필드와 errorDetails 필드의 값을 참조하십시오.오류 처리를 보완하기 위해 message 필드를 사용하세요, 때로는 errorDetails 필드와 동일한 수준의 세부 정보를 다루지 않을 수 있기 때문입니다.

표준 데이터 저장소 오류 응답 예시
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

예제 오류 응답은 높은 수준의 Open Cloud 를 , 오류 를 으로, 그리고 데이터 저장소에 특정한 을 으로 표시합니다.응답의 error 및 datastoreErrorCode 필드에서, 오류를 일으킨 무효한 커서 매개 변수를 전달했음을 이해할 수 있습니다.그런 다음 커서 매개변수를 수정하여 문제를 해결할 수 있습니다.

모든 주문된 데이터 저장소 오류 응답에는 다음과 같은 형식이 포함되어 있습니다.

정렬된 데이터 저장소 오류 응답 예시
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

The code 는 고수준 오류의 문자열을 포함하고, The message 는 오류와 관련된 특정 세부 정보를 포함합니다

코드

모든 고수준 Open Cloud 오류의 요약을 위해 다음 표를 참조하십시오.