도메인 이름을 사용하여 Amazon API Gateway API로 트래픽 라우팅 - Amazon Route 53
사전 조건트래픽을 API Gateway 엔드포인트로 라우팅하도록 Route 53 구성

도메인 이름을 사용하여 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 Gateway 엔드포인트로 라우팅하도록 Route 53 구성

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

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

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

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

    1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/apigateway/에서 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. 다음 값을 지정하십시오:

    중요

    별칭을 활성화하는 것이 좋습니다. Route 53 별칭 레코드를 사용하지 않는 도메인 이름의 경우 프라이빗 DNS가 활성화된 VPC를 사용하여 프라이빗 API를 간접 호출하면 문제가 발생할 수 있습니다. 프라이빗 DNS는 VPC 내의 기본 DNS 확인 동작을 재정의하므로 외부 DNS 레코드와 충돌할 수 있습니다.

    라우팅 정책

    해당 라우팅 정책을 선택합니다. 자세한 내용은 라우팅 정책 선택 단원을 참조하십시오.

    레코드 이름

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

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

    별칭

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

    값/트래픽 라우팅 대상

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

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

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

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

    레코드 유형

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

    대상 상태 평가

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

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

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