도메인 이름을 사용하여 Amazon API Gateway API로 트래픽 라우팅

Amazon API Gateway를 사용해 API를 생성, 게시, 유지 관리, 모니터링, 보호할 수 있습니다. AWS 클라우드에 저장된 데이터 외에도 AWS 서비스 또는 기타 웹 서비스에 액세스하는 API를 생성할 수 있습니다.

API Gateway API로 도메인 트래픽을 라우팅하는 데 사용하는 방법은 리전 API Gateway 엔드포인트를 생성했든 아니면 엣지 최적화 API Gateway 엔드포인트를 생성했든 관계없이동일합니다.

• 리전 API 엔드포인트(Regional API endpoint): 리전 API 엔드포인트로 트래픽을 라우팅하는 Route 53 별칭 레코드를 생성합니다.

• 엣지 최적화 API 엔드포인트(Edge-optimized API endpoint): 트래픽을 엣지 최적화 API로 라우팅하는 Route 53 별칭 레코드를 생성합니다. 이로 인해 트래픽이 엣지 최적화 API와 연결된 CloudFront 배포로 라우팅됩니다.

별칭 레코드는 CNAME 레코드와 유사한 DNS에 대한 Route 53 확장입니다. 별칭 레코드와 CNAME 레코드의 비교는 별칭 또는 비 별칭 레코드 선택 단원을 참조하십시오.

참고

Route 53은 API Gateway API 또는 기타 AWS 리소스에 대한 별칭 쿼리에 대해서는 요금을 부과하지 않습니다.

필수 조건

시작하기 전에 다음을 준비해야 합니다.

• api.example.com과 같이 생성하려는 Route 53 레코드의 이름과 일치하는 사용자 지정 도메인 이름이 있는 API Gateway API입니다.

  자세한 정보는 다음 주제를 참조하세요.

  • Amazon API Gateway 개발자 가이드의 HTTP API에 대한 사용자 지정 도메인 이름 설정

  • Amazon API Gateway 개발자 가이드의 REST API에 대한 사용자 지정 도메인 이름 설정

  • Amazon API Gateway 개발자 안내서에서 API에 대한 WebSocket 사용자 지정 도메인 이름을 설정합니다.

• 등록된 도메인 이름. Amazon Route 53을 도메인 등록 기관으로 사용하거나 다른 등록 기관을 사용할 수 있습니다.

• 도메인의 DNS 서비스가 될 Route 53입니다. Route 53을 사용하여 도메인 이름을 등록하면 Route 53이 해당 도메인의 DNS 서비스로 자동 구성됩니다.

  Route 53을 도메인의 DNS 서비스 공급자로 사용하는 방법에 대한 자세한 내용은 Amazon Route 53를 기존 도메인에 대한 DNS 서비스로 설정 섹션을 참조하세요.

트래픽을 API Gateway 엔드포인트로 라우팅하도록 Route 53 구성

API Gateway 엔드포인트로 트래픽을 라우팅하도록 Route 53을 구성하려면 다음 절차를 수행합니다.

API Gateway 엔드포인트로 트래픽을 라우팅하려면

1. 동일한 계정을 사용하여 Route 53 호스팅 영역과 엔드포인트를 생성한 경우, 2단계로 건너뜁니다.

   서로 다른 계정을 사용하여 호스팅 영역과 엔드포인트를 생성한 경우, 사용하려는 사용자 지정 도메인 이름의 대상 도메인 이름을 가져옵니다.

   1. https://console.aws.amazon.com/apigateway/ 에서 AWS Management Console 로그인하고 API Gateway 콘솔을 엽니다.

   2. 탐색 창에서 사용자 지정 도메인 이름을 선택합니다.

   3. 사용하려는 사용자 지정 도메인 이름을 선택하고 API Gateway 도메인 이름의 값을 가져옵니다.

2. https://console.aws.amazon.com/route53/에서 Route 53 콘솔을 엽니다.

3. 탐색 창에서 호스팅 영역(Hosted zones)을 선택합니다.

4. 트래픽을 API로 라우팅하는 데 사용할 도메인 이름이 있는 호스팅 영역 이름을 선택합니다.

5. Create Record Set(레코드 세트 생성)를 선택합니다.

6. 다음 값을 지정하십시오:

   라우팅 정책

   해당 라우팅 정책을 선택합니다. 자세한 정보는 라우팅 정책 선택을 참조하세요.

   레코드 이름

   트래픽을 API로 라우팅하는 데 사용할 도메인 이름을 입력합니다.

   트래픽을 라우팅하려는 API에는 api.example.com과 같이 Route 53 레코드의 이름과 일치하는 사용자 지정 도메인 이름이 포함되어야 합니다.

   별칭

   빠른 생성(Quick create)레코드 생성 방법을 사용하는 경우, 별칭(Alias)을 켭니다.

   값/트래픽 라우팅 대상

   API Gateway API에 대한 별칭(Alias to API Gateway API)을 선택한 다음 엔드포인트의 출처인 리전을 선택합니다.

   엔드포인트 값을 지정하는 방법은 호스팅 영역과 API를 동일한 AWS 계정을 사용하여 생성했는지 아니면 다른 계정을 사용하여 생성했는지에 따라 달라집니다.

   • 동일한 계정(Same account) - 대상 도메인 이름의 목록에는 레코드 이름(Record name)에 대해 지정한 값과 일치하는 사용자 지정 도메인 이름이 있는 API만 포함됩니다. 해당되는 값을 선택합니다.

   • 서로 다른 계정(Different accounts) - 이 절차의 1단계에서 가져온 값을 입력합니다.

   레코드 유형

   A - IPv4 주소(A – IPv4 address)를 선택합니다.

   대상 상태 평가

   DNS 장애 조치를 관리하려면 사용자 지정 상태 확인을 구성하십시오. 예제는 API Gateway 사용 설명서의 DNS 장애 조치를 위한 사용자 지정 상태 점검 구성을 참조하십시오.

7. 레코드 생성을 선택합니다.

   변경 사항은 일반적으로 60초 이내에 모든 Route 53 서버로 전파됩니다. 전파가 완료되면 이 절차에서 생성한 별칭 레코드의 이름을 사용하여 트래픽을 API로 라우팅할 수 있습니다.