메뉴
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 객체가 강조 표시된 [Objects] 탭

    page1.html의 [Properties] 탭을 선택한 다음 [Metadata] 상자를 선택합니다. 다음 예제와 같이 메타데이터에 Website Redirect Location을 추가하고 그 값을 /page2.html에 설정합니다. 이 값에는 / 접두사가 필요합니다.

     웹 사이트 리디렉션 위치 값이 포함된 Metadata 상자

    또한, 이 값을 http://www.example.com와 같은 외부 URL에 설정할 수 있습니다. 예를 들어 루트 도메인이 example.com이고 http://example.comhttp://www.example.com에 대한 요청을 모두 처리할 경우, example.comwww.example.com라는 이름의 버킷 2개를 만들 수 있습니다. 그런 다음, 그 중 하나의 버킷(예를 들면 example.com)에서 컨텐츠를 유지하면서 모든 요청을 example.com 버킷으로 리디렉션하도록 나머지 버킷을 구성합니다.

  • 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.htmlx-amz-website-redirect-location을 설정합니다. 요청이 완료되면 page1.html은 콘텐츠가 없어지고 x-amz-website-redirect-location에 따라 지정된 위치로 요청이 리디렉션됩니다.

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

어드밴스 조건부 리디렉션

어드밴스 리디렉션 규칙을 사용하면 특정 객체 키 이름, 요청 접두사 또는 응답 코드에 따라 조건부로 요청을 라우팅할 수 있습니다. 예를 들어 버킷 내 객체를 삭제하거나 이름을 변경하는 경우를 가정해봅시다. 요청을 다른 객체에 리디렉션하는 라우팅 규칙을 추가할 수 있습니다. 폴더를 사용할 수 없게 하려면 다른 웹 페이지에 요청을 리디렉션하도록 라우팅 규칙을 추가하면 됩니다. 또한 오류를 반환하는 요청을 오류 처리 시 다른 도메인으로 라우팅하여 오류 조건을 처리하도록 라우팅 규칙을 추가할 수도 있습니다.

웹 사이트 호스팅용 버킷을 구성할 때에는 어드밴스 리디렉션 규칙을 선택적으로 지정할 수 있습니다.

 선택적인 리디렉션 규칙들을 보여주는 정적 웹 사이트 호스팅 화면

버킷의 웹 사이트 엔드포인트에 대한 모든 요청을 다른 호스트로 리디렉션할 때에는 호스트 이름만 지정하면 됩니다.

 리디렉션 요청이 선택된 정적 웹 사이트 호스팅 화면

규칙 설명 시 XML을 사용합니다. 다음 단원에서는 리디렉션 규칙 지정의 일반적인 구문을 설명하고 그 예를 듭니다.

라우팅 규칙 지정 구문

웹 사이트 구성의 라우팅 규칙을 정의하기 위한 일반 구문은 다음과 같습니다.

Copy
<RoutingRules> = <RoutingRules> <RoutingRule>...</RoutingRule> [<RoutingRule>...</RoutingRule> ...] </RoutingRules> <RoutingRule> = <RoutingRule> [ <Condition>...</Condition> ] <Redirect>...</Redirect> </RoutingRule> <Condition> = <Condition> [ <KeyPrefixEquals>...</KeyPrefixEquals> ] [ <HttpErrorCodeReturnedEquals>...</HttpErrorCodeReturnedEquals> ] </Condition> Note: <Condition> must have at least one child element. <Redirect> = <Redirect> [ <HostName>...</HostName> ] [ <Protocol>...</Protocol> ] [ <ReplaceKeyPrefixWith>...</ReplaceKeyPrefixWith> ] [ <ReplaceKeyWith>...</ReplaceKeyWith> ] [ <HttpRedirectCode>...</HttpRedirectCode> ] </Redirect> Note: <Redirect> must have at least one child element. Also, you can have either ReplaceKeyPrefix with or ReplaceKeyWith, but not both.

다음 표에서는 라우팅 규칙 요소를 설명합니다.

이름 설명
RoutingRules RoutingRule 요소 모음용 컨테이너입니다.
RoutingRule

조건 및 조건이 충족되었을 때 적용되는 리디렉션을 식별하는 규칙입니다.

조건: RoutingRules 컨테이너에는 적어도 1개 이상의 라우팅 규칙이 포함되어 있어야 합니다.

Condition

지정된 리디렉션이 적용되려면 충족되어야 할 조건을 설명하기 위한 컨테이너입니다. 라우팅 규칙이 조건을 포함하지 않는 경우 해당 규칙은 모든 요청에 적용됩니다.

KeyPrefixEquals

리디렉션된 요청을 보내는 객체 키 이름 접두사입니다.

KeyPrefixEquals HttpErrorCodeReturnedEquals를 지정하지 않을 경우 가 필요합니다. KeyPrefixEqualsHttpErrorCodeReturnedEquals가 모두 지정되는 경우 두 항목 모두 true로 설정돼야 조건이 충족됩니다.

HttpErrorCodeReturnedEquals

리디렉션 적용 조건과 일치하는 HTTP 오류 코드입니다. 오류가 발생하고 오류 코드가 이 값에 해당하는 경우, 지정된 리디렉션이 적용됩니다.

HttpErrorCodeReturnedEquals KeyPrefixEquals를 지정하지 않을 경우 가 필요합니다. KeyPrefixEqualsHttpErrorCodeReturnedEquals가 모두 지정되는 경우 두 항목 모두 true로 설정돼야 조건이 충족됩니다.

Redirect

요청에 대한 리디렉션 지침을 제공하는 컨테이너 요소입니다. 다른 호스트나 다른 페이지로 요청을 리디렉션할 수 있으며, 사용할 다른 프로토콜을 지정할 수 있습니다. RoutingRule에는 Redirect 요소가 있어야 합니다. Redirect 요소는 Protocol, HostName, ReplaceKeyPrefixWith, ReplaceKeyWith 또는 HttpRedirectCode 중 한 개 이상의 형제 요소를 포함해야 합니다.

Protocol

응답에서 반환된 Location 위치 헤더에 사용되는 HTTP 또는 HTTPS 프로토콜입니다.

해당 형제 요소 중 하나가 제공되는 경우 Protocol는 필요하지 않습니다.

HostName

응답에서 반환된 위치 헤더에 사용되는 호스트 이름입니다.

해당 형제 요소 중 하나가 제공되는 경우 HostName는 필요하지 않습니다.

ReplaceKeyPrefixWith

리디렉션 요청의 KeyPrefixEquals 값을 대체하는 객체 키 이름의 접두사입니다.

해당 형제 요소 중 하나가 제공되는 경우 ReplaceKeyPrefixWith는 필요하지 않습니다. ReplaceKeyWith가 제공되지 않는 경우에만 제공 가능한 파라미터입니다.

ReplaceKeyWith

응답에서 반환된 위치 헤더에 사용되는 객체 키입니다.

해당 형제 요소 중 하나가 제공되는 경우 ReplaceKeyWith는 필요하지 않습니다. ReplaceKeyPrefixWith가 제공되지 않는 경우에만 제공 가능한 파라미터입니다.

HttpRedirectCode

응답에서 반환된 위치 헤더에 사용되는 HTTP 리디렉션 코드입니다.

해당 형제 요소 중 하나가 제공되는 경우 HttpRedirectCode는 필요하지 않습니다.

다음 예제는 다음과 같은 일반적인 리디렉션 작업을 설명합니다.

예 1: 키 접두사 이름을 바꾼 후 리디렉션

버킷에 다음과 같은 객체가 포함되어 있다고 가정해 보십시오.

  • index.html

  • docs/article1.html

  • docs/article2.html

해당 폴더의 이름을 docs/에서 documents/로 바꾸기로 합니다. 이렇게 이름을 변경한 후에는 접두사에 대한 요청을 docs/에서 documents/로 리디렉션해야 합니다. 예를 들어 docs/article1.html에 대한 요청은 documents/article1.html로 리디렉션됩니다.

이 경우, 웹 사이트 구성에 다음과 같은 라우팅 규칙이 추가됩니다.

Copy
<RoutingRules> <RoutingRule> <Condition> <KeyPrefixEquals>docs/</KeyPrefixEquals> </Condition> <Redirect> <ReplaceKeyPrefixWith>documents/</ReplaceKeyPrefixWith> </Redirect> </RoutingRule> </RoutingRules>

예 2: 삭제된 폴더에 대한 요청을 페이지로 리디렉션

images/ 폴더를 삭제한다고 가정해 보십시오(즉, 키 접두사가 images/인 모든 객체를 삭제). 키 접두사가 images/인 객체에 대한 요청을 folderdeleted.html라는 이름의 페이지로 리디렉션하는 라우팅 규칙을 추가할 수 있습니다.

Copy
<RoutingRules> <RoutingRule> <Condition> <KeyPrefixEquals>images/</KeyPrefixEquals> </Condition> <Redirect> <ReplaceKeyWith>folderdeleted.html</ReplaceKeyWith> </Redirect> </RoutingRule> </RoutingRules>

예 3: HTTP 오류에 대한 리디렉션

요청된 객체를 찾을 수 없는 경우, Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스로 요청을 리디렉션한다고 가정해 보십시오. HTTP 상태 코드 404(찾을 수 없음)가 반환되는 경우 해당 요청을 처리하는 Amazon EC2 인스턴스로 사이트 방문자가 리디렉션되도록 리디렉션 규칙을 추가합니다. 또한, 다음 예제에서는 리디렉션에서 객체 키 접두사 report-404/의 삽입을 설명합니다. 예를 들어 ExamplePage.html 페이지를 요청하고 HTTP 404 오류가 반환되는 경우, 해당 요청은 지정된 Amazon EC2 인스턴스의 report-404/ExamplePage.html 페이지로 리디렉션됩니다. 라우팅 규칙이 하나도 없고 HTTP 오류 404가 발생하는 경우, 구성에 지정된 오류 문서가 반환됩니다.

Copy
<RoutingRules> <RoutingRule> <Condition> <HttpErrorCodeReturnedEquals>404</HttpErrorCodeReturnedEquals > </Condition> <Redirect> <HostName>ec2-11-22-333-44.compute-1.amazonaws.com</HostName> <ReplaceKeyPrefixWith>report-404/</ReplaceKeyPrefixWith> </Redirect> </RoutingRule> </RoutingRules>