메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

사용자 지정 오류 문서 지원

다음 표는 오류 발생 시 Amazon S3이 반환하는 HTTP 응답 코드의 하위 집합 목록입니다.

HTTP 오류 코드 설명
[301 Moved Permanently] 사용자가 Amazon S3 웹 사이트 엔드포인트(http://s3-website-<region>.amazonaws.com/)에 곧바로 요청을 보내는 경우 Amazon S3은 [301 Moved Permanently] 응답을 반환하고 해당 요청을 https://aws.amazon.com/s3/으로 리디렉션합니다.
[302 Found]

http://<bucket>.s3-website-<region>.amazonaws.com/xx 에 대한 요청이 후행 슬래시 없이 Amazon S3에 수신되는 경우, 키 이름이 x인 객체가 첫 검색 대상이 됩니다. 객체를 찾을 수 없는 경우 Amazon S3은 해당 요청이 하위 폴더 x에 대한 것으로 판단하므로 맨 뒤에 슬래시를 추가하여 요청을 리디렉션하고 [302 Found]를 반환합니다.

[304 Not Modified]

Amazon S3 사용자는 헤더 If-Modified-Since, If-Unmodified-Since, If-Match 및/또는 If-None-Match를 요청하여 클라이언트가 보유하는 캐시된 사본과 요청된 객체가 동일한지 확인합니다. 객체가 동일한 경우 웹 사이트 엔드포인트가 [304 Not Modified] 응답을 반환합니다.

[400 Malformed Request]

잘못된 리전 엔드포인트를 통해 사용자가 버킷에 액세스하려는 경우 웹 사이트 엔드포인트가 [400 Malformed Request]로 응답합니다.

[403 Forbidden]

사용자 요청이 공개적으로 읽기 가능한 객체로 변환되는 경우 웹 사이트 엔드포인트가 [403 Forbidden]으로 응답합니다. 객체 소유자는 버킷 정책이나 ACL을 사용하여 객체를 공개적으로 읽기 가능하도록 설정해야 합니다.

[404 Not Found]

웹 사이트 엔드포인트가 [404 Not Found]로 응답하는 이유는 다음과 같습니다.

  • Amazon S3이 웹 사이트 URL이 존재하지 않는 객체 키를 참조한다고 판단함.

  • Amazon이 존재하지 않는 인덱스 문서에 대한 요청이라고 유추함.

  • URL에 지정된 버킷이 존재하지 않음.

  • URL에 지정된 버킷이 존재하지만 웹 사이트로 구성되지 않음.

[404 Not Found]에 대해 반환되는 사용자 지정 문서를 만들 수 있습니다. 반드시 웹 사이트처럼 구성된 버킷에 문서를 업로드하고 해당 문서를 사용하는 것으로 웹 사이트 호스팅을 구성해야 합니다.

Amazon S3이 URL을 객체나 인덱스 문서에 대한 요청으로 해석하는 작동 방법에 대한 정보는 인덱스 문서 지원 구성 단원을 참조하십시오.

[500 Service Error]

내부 서버 오류가 발생하는 경우 웹 사이트 엔드포인트가 [500 Service Error]로 응답합니다.

[503 Service Unavailable]

사용자가 요청 속도를 줄어야 한다고 Amazon S3이 판단하는 경우 웹 사이트 엔드포인트가 [503 Service Unavailable]로 응답합니다.

이러한 각 오류에 대해 Amazon S3은 사전 정의된 HTML 메시지를 반환합니다. 다음은 403 Forbidden 요청에 대해 반환된 HTML 메시지 예입니다.

사용자에게 친숙한 오류 메시지와 추가 도움말이 포함된 사용자 지정 오류 문서를 선택 사항으로 제공할 수 있습니다. 버킷에 웹 사이트 구성을 추가하면서 이와 같은 사용자 지정 오류 문서를 구성의 일부로 설정할 수 있습니다. Amazon S3은 HTTP 4XX 클래스 오류 코드에 대한 사용자 지정 오류 문서를 반환하게 됩니다.

오류 문서 및 브라우저 동작

오류가 발생하는 경우 Amazon S3이 HTML 오류 문서를 반환합니다. 웹 사이트를 사용자 지정 오류 문서로 구성한 경우 Amazon S3이 해당 오류 문서를 반환합니다. 하지만 오류가 발생하는 경우 일부 브라우저는 자체 오류 메시지를 표시하므로 Amazon S3이 반환하는 오류 문서가 무시됩니다. 예를 들어 HTTP 404 Not Found 오류가 발생하는 경우 Chrome이 Amazon S3이 반환하는 오류 문서를 무시하고 자체 오류 메시지를 표시할 수도 있습니다.