API Gateway에서 사용자 지정 도메인 이름을 통해 API로 트래픽을 전송합니다.

사용자 지정 도메인 이름에 대한 라우팅 모드를 구성할 때 수신 트래픽이 API로 전달되는 방식을 설정합니다. 라우팅 규칙, API 매핑 또는 라우팅 규칙 및 API 매핑 모두를 사용하여 API로 트래픽을 전송합니다. 다음 섹션에서는 라우팅 규칙을 사용해야 하는 경우, API 매핑을 사용해야 하는 경우, 사용자 지정 도메인 이름에 대해 라우팅 모드를 설정하는 방법을 설명합니다.

라우팅 규칙을 사용해야 하는 경우

라우팅 규칙을 사용하는 경우 특정 조건과 일치하는 수신 요청을 특정 REST API 스테이지로 전달합니다. 예를 들어, 헤더 version:v1과 기본 경로 /users가 포함된 경우 규칙은 요청을 users REST API의 production 스테이지로 라우팅할 수 있습니다. 라우팅 규칙을 사용하여 A/B 테스트 또는 API의 새 버전 사용 증가와 같은 사용 사례를 지원하는 고급 동적 라우팅 토폴로지를 생성합니다.

트래픽을 REST API로 보낼 때는 사용자 지정 도메인 이름에 대한 라우팅 규칙을 사용하는 것이 좋습니다. 라우팅 규칙을 사용하여 API 매핑을 다시 만들 수 있습니다. 자세한 내용은 라우팅 규칙을 사용하여 API 매핑 다시 만들기 섹션을 참조하세요.

REST API 경우 라우팅 규칙과 API 매핑을 함께 사용할 수도 있습니다. 라우팅 규칙과 API 매핑을 함께 사용하는 경우 API Gateway는 API 매핑을 평가하기 전에 항상 라우팅 규칙을 평가합니다. 라우팅 규칙과 API 매핑을 함께 사용하여 현재 사용자 지정 도메인 이름을 마이그레이션하거나 라우팅 규칙을 탐색합니다.

라우팅 규칙에 대한 고려 사항

다음 고려 사항은 라우팅 규칙 사용에 영향을 미칠 수 있습니다.

• WebSocket 또는 HTTP API는 라우팅 규칙의 대상 API로 지원되지 않습니다.

• 사용자 지정 도메인 이름에 REST 및 HTTP API 모두에 대한 API 매핑이 있는 경우 라우팅 규칙이 지원되지 않습니다.

• 프라이빗 사용자 지정 도메인을 프라이빗 REST API로 라우팅하는 규칙을 만들 수 있습니다. 퍼블릭 사용자 지정 도메인을 리전 또는 엣지 최적화 API로 라우팅하는 규칙을 만들 수 있습니다.

• 퍼블릭 사용자 지정 도메인을 프라이빗 API로 라우팅하는 규칙을 만들 수 없습니다. 프라이빗 사용자 지정 도메인을 퍼블릭 API로 라우팅하는 규칙을 만들 수 없습니다.

라우팅 규칙과 API 매핑 중에서 선택

가능하면 라우팅 규칙을 사용하는 것이 좋습니다. HTTP 또는 WebSocket API로 트래픽을 전송하는 데만 API 매핑을 사용합니다.