View a markdown version of this page

SOAP 오류 응답 - Amazon Simple Storage Service

SOAP 오류 응답

참고

Amazon S3용 SOAP API는 신규 고객에게 제공되지 않으며 2025년 8월 31일에 서비스 종료(EOL)됩니다. REST API 또는 AWS SDK를 사용하는 것이 좋습니다.

SOAP에서 오류 결과는 HTTP 응답 코드 500과 함께 SOAP 오류로 클라이언트에 반환됩니다. SOAP 오류가 반환되지 않으면 요청이 성공한 것입니다. Amazon S3 SOAP 오류 코드는 Amazon S3 전용 오류 코드와 연결된 표준 SOAP 1.1 오류 코드('Server' 또는 'Client')로 구성되어 있습니다(예: "Server.InternalError" 또는 "Client.NoSuchBucket"). SOAP 오류 문자열 요소에는 사람이 읽을 수 있는 일반적인 오류 메시지가 영어로 담겨 있습니다. 마지막으로 SOAP 오류 세부 요소에는 오류와 관련된 기타 정보가 포함됩니다.

예를 들어, 존재하지 않는 "Fred" 객체를 제거하려고 시도하면 SOAP 응답의 본문에 "NoSuchKey" SOAP 오류가 포함됩니다.

다음 예제는 샘플 SOAP 오류 응답을 보여줍니다.

<soapenv:Body>
  <soapenv:Fault>
    <Faultcode>soapenv:Client.NoSuchKey</Faultcode>
    <Faultstring>The specified key does not exist.</Faultstring>
    <Detail>
      <Key>Fred</Key>
    </Detail>
  </soapenv:Fault>
  </soapenv:Body>

다음 표에서는 SOAP 오류 응답 요소를 설명합니다.

이름 설명
Detail

오류와 관련된 키를 위한 컨테이너

유형: 컨테이너

상위 항목: Body.Fault
Fault

오류 정보를 위한 컨테이너입니다.

유형: 컨테이너

상위 항목: Body
Faultcode

오류 코드는 오류 상태를 고유하게 식별하는 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. 자세한 내용은 오류 코드 목록을 참조하세요.

유형: 문자열

상위 항목: Body.Fault
Faultstring

오류 문자열에는 오류 상태에 관한 일반적인 설명(영문)이 포함되어 있습니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 문자열을 무시할 가능성이 큽니다.

유형: 문자열

상위 항목: Body.Fault
Key

오류와 관련된 키를 식별

유형: 문자열

상위 항목: Body.Fault