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

웹 페이지 리디렉션 구성

Amazon S3 버킷이 웹 사이트 호스팅용으로 구성되는 경우 객체에 대한 요청을 동일 버킷의 다른 객체로 혹은 외부 URL로 리디렉션할 수 있습니다. 객체 메타데이터에 x-amz-website-redirect-location 속성을 추가하여 리디렉션을 설정할 수 있습니다. 이 경우 웹 사이트가 해당 객체를 301 리디렉션으로 해석합니다. 다른 객체로 요청을 리디렉션하려면 대상 객체의 키에 이르도록 리디렉션 위치를 설정합니다. 외부 URL로 요청을 리디렉션하려면 리디렉션 위치를 원하는 URL로 설정합니다. 객체 메타데이터에 대한 자세한 정보는 시스템 정의 메타데이터 단원을 참조하십시오.

웹 사이트 호스팅용으로 구성된 버킷은 웹 사이트 엔드포인트와 REST 엔드포인트를 모두 포함합니다. 301 리디렉션으로 구성된 페이지에 대한 요청은 요청의 엔드포인트에 따라 요청 결과가 다음과 같을 수 있습니다.

  • 리전별 웹 사이트 엔드포인트 - Amazon S3이 x-amz-website-redirect-location 속성 값에 따라 페이지 요청을 리디렉션합니다.

  • REST 엔드포인트 - Amazon S3이 페이지 요청을 리디렉션하지 않습니다. 이 경우 요청된 객체가 반환됩니다.

엔드포인트에 대한 자세한 내용은 Amazon 웹 사이트와 REST API 엔드포인트 간의 주요 차이점 단원을 참조하십시오.

Amazon S3 REST API를 사용하여 Amazon S3 콘솔에서 페이지 리디렉션을 설정할 수 있습니다..

Amazon S3 콘솔의 페이지 리디렉션 지원

객체의 메타데이터에 웹 사이트 리디렉션 위치를 설정하기 위해 Amazon S3 콘솔을 사용할 수 있습니다. 페이지 리디렉션을 설정하는 경우 원본 객체 콘텐츠를 유지하거나 삭제할 수 있습니다. 예를 들어 버킷에 page1.html 객체가 있다고 가정해 보십시오. 이 페이지에 대한 모든 요청을 다른 객체인 page2.html로 리디렉션하려는 경우 다음 중 하나를 수행할 수 있습니다.

  • page1.html 객체의 콘텐츠를 유지하고 페이지 요청만 리디렉션하려면 page1.html 객체를 선택하십시오.

    page1.html의 [Properties] 탭을 선택한 다음 [Metadata] 상자를 선택합니다. 다음 예와 같이 메타데이터에 웹 사이트 리디렉션 위치를 추가하고 해당 값을 /page2.html에 설정합니다. 이 값에는 / 접두사가 필요합니다.

    또한, 이 값을 http://www.example.com와 같은 외부 URL에 설정할 수 있습니다.

  • page1.html 객체의 콘텐츠를 삭제하고 요청을 리디렉션하려면 키가 동일한 새 0바이트 객체 page1.html를 업로드하여 기존 객체를 대체한 다음, 업로드 프로세스에서 page1.html에 대한 Website Redirect Location을 지정할 수 있습니다. 객체 업로드에 대한 자세한 내용은 Amazon Simple Storage Service 콘솔 사용 설명서S3 객체 업로드를 참조하십시오.

REST API를 통한 페이지 리디렉션 설정

다음 Amazon S3 API 작업은 요청의 x-amz-website-redirect-location 헤더를 지원합니다. Amazon S3은 객체 메타데이터의 헤더 값을 x-amz-website-redirect-location으로 저장합니다.

페이지 리디렉션을 설정하는 경우 객체 콘텐츠를 유지하거나 삭제할 수 있습니다. 예를 들어 버킷에 page1.html 객체가 있다고 가정해 보십시오.

  • page1.html의 콘텐츠를 유지하고 페이지 요청만 리디렉션하려는 경우 PUT Object - Copy 요청을 제출하면 page1.html 객체를 원본으로 사용하는 새 page1.html 객체를 만들 수 있습니다. 해당 요청에는 x-amz-website-redirect-location 헤더를 설정합니다. 요청이 완료되면 콘텐츠가 변경되지 않은 원래 페이지가 생기지만 사용자가 지정한 리디렉션 위치로 Amazon S3이 해당 페이지에 대한 모든 요청을 리디렉션합니다.

  • page1.html 객체의 콘텐츠를 삭제하고 해당 페이지에 대한 요청을 리디렉션하려는 경우 PUT 객체 요청을 보내면 객체 키가 같은 0바이트 객체인 page1.html을 업로드할 수 있습니다. PUT 요청에서 새 객체에 page1.html x-amz-website-redirect-location을 설정합니다. 요청이 완료되면 page1.html은 콘텐츠가 없어지고 x-amz-website-redirect-location에 따라 지정된 위치로 요청이 리디렉션됩니다.

GET Object 작업을 사용하여 다른 객체 메타데이터와 함께 객체를 검색하는 경우 Amazon S3이 해당 응답의 x-amz-website-redirect-location 헤더를 반환합니다.