REST 오류 응답 - Amazon Simple Storage Service

REST 오류 응답

REST 요청에 오류가 발생할 경우 HTTP 응답에는 다음이 포함됩니다.

  • XML 오류 문서 - 응답의 본문

  • 콘텐츠 유형: application/xml

  • 적합한 3xx, 4xx 또는 5xx HTTP 상태 코드

다음은 REST 오류 응답의 예입니다.

<?xml version="1.0" encoding="UTF-8"?> <Error> <Code>NoSuchKey</Code> <Message>The resource you requested does not exist</Message> <Resource>/mybucket/myfoto.jpg</Resource> <RequestId>4442587FB7D0A2F9</RequestId> </Error>

Amazon S3 오류에 대한 자세한 내용은 ErrorCodeList를 참조하세요.

응답 헤더

다음은 모든 작업에서 반환되는 응답 헤더입니다.

  • x-amz-request-id: 시스템에서 각 요청에 할당한 고유 ID. Amazon S3에 문제가 있을 경우 Amazon은 이를 활용하여 문제를 해결합니다.

  • x-amz-id-2: 문제 해결에 도움이 되는 특별 토큰.

오류 응답

Amazon S3 요청에 오류가 발생할 경우 클라이언트는 오류 응답을 받습니다. 오류 응답의 정확한 형식은 API마다 다릅니다. 예를 들어, REST 오류 응답은 SOAP 오류 응답과 다릅니다. 하지만 모든 오류 응답에는 공통 요소가 있습니다.

참고

HTTP를 통한 SOAP 지원은 중단되었지만 SOAP는 HTTPS를 통해 계속해서 사용할 수 있습니다. Amazon S3의 새로운 기능들은 SOAP에서 지원되지 않습니다. SOAP를 사용하는 대신 REST API 또는 AWS SDK를 사용하는 것이 좋습니다.

오류 코드

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. 대부분의 오류 코드는 SOAP와 REST API에서 공통적이지만 일부는 API마다 다릅니다. 예를 들어, NoSuchKey는 공통적이지만, UnexpectedContent는 잘못된 REST 요청에 대한 응답에서만 발생할 수 있습니다. 모든 경우에 SOAP 고장 코드는 오류 코드 표에 표시된 접두사를 포함하므로, 실제로 NoSuchKey 오류는 SOAP에서 Client.NoSuchKey로 반환됩니다.

참고

HTTP를 통한 SOAP 지원은 중단되었지만 SOAP는 HTTPS를 통해 계속해서 사용할 수 있습니다. Amazon S3의 새로운 기능들은 SOAP에서 지원되지 않습니다. SOAP를 사용하는 대신 REST API 또는 AWS SDK를 사용하는 것이 좋습니다.

오류 메시지

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

추가 세부 정보

많은 오류 응답에는 프로그래밍 오류를 진단하는 개발자가 판독하고 이해하기 위한 체계적 데이터가 추가로 포함되어 있습니다. 예를 들어, REST PUT 요청에 서버에서 계산된 다이제스트와 일치하지 않는 Content-MD5 헤더를 보내면 BadDigest 오류가 반환됩니다. 오류 응답에는 계산한 다이제스트와 예상한 다이제스트와 같은 세부적인 요소도 포함합니다. 개발 단계 이 정보를 사용하여 오류를 진단할 수 있습니다. 프로덕션 단계에서 모범적인 프로그램은 오류 로그에 이 내용을 포함할 수 있습니다.