(선택 사항) 사용자 지정 오류 문서 구성 - Amazon Simple Storage Service

(선택 사항) 사용자 지정 오류 문서 구성

버킷을 정적 웹 사이트로 구성한 후 오류가 발생하면 Amazon S3에서 HTML 오류 문서를 반환합니다. 선택적으로 사용자 지정 오류 문서를 사용하여 버킷을 구성하고 오류가 발생하면 Amazon S3에서 해당 문서를 반환하도록 할 수 있습니다.

참고

일부 브라우저는 오류가 발생하는 경우 자체 오류 메시지를 표시하므로 Amazon S3가 반환하는 오류 문서가 무시됩니다. 예를 들어 HTTP 404 Not Found(HTTP 404 찾을 수 없음) 오류가 발생할 때 Google Chrome은 Amazon S3이 반환하는 오류 문서를 무시하고 자체 오류를 표시할 수도 있습니다.

Amazon S3 HTTP 응답 코드

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

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

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

304 Not Modified(304 수정되지 않음)

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

400 Malformed Request(400 형식이 잘못된 요청)

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

[403 Forbidden]

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

404 Not Found(404 찾을 수 없음)

웹 사이트 엔드포인트가 404 Not Found(404 찾을 수 없음)로 응답하는 이유는 다음과 같습니다.

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

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

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

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

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

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

500 Service Error(500 서비스 오류)

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

[503 Service Unavailable]

사용자가 요청 속도를 줄여야 한다고 Amazon S3이 판단하는 경우 웹 사이트 엔드포인트가 503 Service Unavailable(503 서비스 사용 불가)로 응답합니다.

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


						403 금지됨 오류 메시지 예

사용자 지정 오류 문서 구성

버킷을 정적 웹 사이트로 구성할 때 사용자에게 친숙한 오류 메시지와 추가 도움말이 포함된 사용자 지정 오류 문서를 선택적으로 제공할 수 있습니다. Amazon S3는 HTTP 4XX 클래스 오류 코드에 대해서만 사용자 지정 오류 문서를 반환합니다.

사용자 지정 오류 문서를 구성하려면

  1. AWS Management 콘솔에 로그인한 다음 https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔을 엽니다.

  2. 버킷 목록에서 버킷 이름을 선택합니다.

  3. [Properties]를 선택합니다.

  4. [Static website hosting]을 선택합니다.

    버킷이 이미 정적 웹 사이트로 구성되어 있는 경우 다음 단계에 따라 오류 문서 정보를 업데이트하거나 추가할 수 있습니다. 버킷을 정적 웹 사이트로 구성하지 않은 경우 먼저 필요한 구성을 설정해야 합니다. 자세한 내용은 웹 사이트 호스팅 사용 단원을 참조하십시오.

  5. 오류 문서 상자에 오류 문서 이름을 입력합니다.

  6. 저장을 선택합니다.

REST API를 사용하여 사용자 지정 오류 문서가 있는 정적 웹 사이트로 버킷을 구성하는 방법에 대한 자세한 내용은 Amazon Simple Storage Service API ReferencePutBucketWebsite를 참조하십시오.