오류 응답 동작 구성 - Amazon CloudFront

오류 응답 동작 구성

오류가 발생할 경우 CloudFront가 응답하는 방식을 관리할 수 있는 몇 가지 옵션이 제공됩니다. 사용자 지정 오류 응답을 구성하려면 CloudFront 콘솔, CloudFront API 또는 을 사용할 수 있습니다AWS CloudFormation 구성 업데이트에 선택한 방법과 관계없이 다음 팁과 권장 사항을 고려하세요.

  • CloudFront에서 액세스 가능한 위치에 사용자 지정 오류 페이지를 저장합니다. Amazon S3 버킷에 저장하는 것이 좋으며 나머지 웹 사이트 또는 애플리케이션 콘텐츠와 같은 위치에 저장하지 않는 것이 좋습니다. 웹 사이트 또는 애플리케이션과 동일한 오리진에 사용자 지정 오류 페이지를 저장할 경우 오리진이 5xx 오류를 반환하기 시작하면 오리진 서버를 사용할 수 없기 때문에 CloudFront가 사용자 지정 오류 페이지를 가져올 수 없습니다. 자세한 내용은 다른 위치에 객체 및 사용자 지정 오류 페이지 저장 섹션을 참조하세요.

  • CloudFront에 사용자 지정 오류 페이지를 가져올 권한이 있는지 확인합니다. 사용자 지정 오류 페이지가 Amazon S3에 저장되어 있는 경우 페이지에 공개적으로 액세스할 수 있거나 CloudFront 오리진 액세스 제어(OAC)를 구성해야 합니다. 사용자 지정 오류 페이지가 사용자 지정 오리진에 저장되어 있는 경우 페이지에 공개적으로 액세스할 수 있어야 합니다.

  • (선택 사항) 원하는 경우 사용자 지정 오류 페이지와 함께 Cache-Control 또는 Expires 헤더를 추가하도록 오리진을 구성합니다. [오류 캐싱 최소 TTL(Error Caching Minimum TTL)] 설정을 사용하여 CloudFront에서 사용자 지정 오류 페이지를 캐싱할 기간을 제어할 수도 있습니다. 자세한 내용은 CloudFront에서 오류를 캐싱하는 기간 제어 단원을 참조하십시오.

사용자 지정 오류 응답 구성

CloudFront 콘솔에서 사용자 지정 오류 응답을 구성하려면 CloudFront 배포가 있어야 합니다. 콘솔에서 사용자 지정 오류 응답에 대한 구성 설정은 기존 배포에만 사용할 수 있습니다. 배포를 생성하는 방법에 대한 자세한 내용은 기본 CloudFront 배포 시작하기 섹션을 참조하세요.

Console
사용자 지정 오류 응답을 구성하려면(콘솔)
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudfront/v4/home#distributions에 있는 CloudFront 콘솔에서 배포 페이지를 엽니다.

  2. 배포 목록에서 업데이트할 배포를 선택합니다.

  3. [오류 페이지(Error Pages)] 탭을 선택한 다음 [사용자 지정 오류 응답 생성(Create Custom Error Response)]을 선택합니다.

  4. 관련 값들을 입력합니다. 자세한 내용은 사용자 지정 오류 페이지 및 오류 캐싱 단원을 참조하십시오.

  5. 원하는 값을 입력한 후 [생성(Create)]을 선택합니다.

CloudFront API or AWS CloudFormation

CloudFront API 또는 AWS CloudFormation을(를) 사용하여 사용자 지정 오류 응답을 구성하려면 배포에서 CustomErrorResponse 유형을 사용합니다. 자세한 내용은 다음 자료를 참조하십시오.