API Gateway의 REST API에 대한 API 엔드포인트 유형 - Amazon API Gateway

API Gateway의 REST API에 대한 API 엔드포인트 유형

API 엔드포인트 유형은 API의 호스트 이름을 나타냅니다. API 엔드포인트 유형은 대다수 API 트래픽의 출처에 따라 엣지 최적화, 리전 또는 프라이빗 엔드포인트일 수 있습니다.

엣지 최적화 API 엔드포인트

엣지 최적화 API 엔드포인트는 일반적으로 클라이언트가 지리적으로 분산된 경우 도움이 되는 가장 가까운 CloudFront 접속 지점(POP)으로 요청을 라우팅합니다. 이것은 API Gateway REST API의 기본 엔드포인트 유형입니다.

엣지 최적화 API는 HTTP 헤더의 이름을 대문자로 처리합니다(예: Cookie).

CloudFront에서는 요청을 오리진에 전달하기 전에 쿠키 이름을 기준으로 HTTP 쿠키를 일반 순서로 정렬합니다. CloudFront 가 쿠키를 처리하는 방법에 대해서는 쿠키를 기반으로 콘텐츠 캐싱을 참조하세요.

엣지 최적화 API를 위해 사용되는 사용자 지정 도메인 이름은 모든 리전에 적용됩니다.

리전 API 엔드포인트

리전 API 엔드포인트는 동일 리전의 클라이언트를 위한 것입니다. EC2 인스턴스를 실행하는 클라이언트가 동일 리전에서 API를 호출하거나 API가 수요가 큰 소수의 클라이언트에게 서비스를 제공하기 위한 것이라면 리전 API는 연결 오버헤드를 줄입니다.

리전 API에 대해 API가 배포된 리전별로 고유한 사용자 지정 도메인 이름이 사용됩니다. 여러 리전에 배포된 리전 API를 배포하는 경우, 모든 리전에서 동일한 사용자 지정 도메인 이름을 사용할 수 있습니다. Amazon Route 53과 함께 사용자 지정 도메인을 사용하여 지연 시간 기반 라우팅 등의 작업을 수행할 수 있습니다. 자세한 내용은 API Gateway에서 리전 사용자 지정 도메인 이름 설정API Gateway API에서 엣지 최적화 사용자 지정 도메인 이름 설정 단원을 참조하세요.

리전 API 엔드포인트는 모든 헤더 이름을 그대로 전달합니다.

참고

API 클라이언트가 지리적으로 분산되어 있는 경우, API Gateway가 API를 서비스 제어 CloudFront 배포와 연결하지 않도록 하기 위해 리전 API 엔드포인트를 자체 Amazon CloudFront 배포와 함께 사용할 수 있습니다. 이 사용 사례에 대한 자세한 내용은 고유의 CloudFront 배포를 사용하여 API Gateway를 설정하려면 어떻게 해야 합니까?를 참조하세요.

프라이빗 API 엔드포인트

프라이빗 API 엔드포인트는 인터페이스 VPC 종단점을 사용해서 Amazon Virtual Private Cloud(VPC)에서만 액세스할 수 있는 API 엔드포인트입니다. 이때 이 엔드포인트는 사용자가 VPC에서 만든 엔드포인트 네트워크 인터페이스(ENI)입니다. 자세한 내용은 API Gateway의 프라이빗 REST API 단원을 참조하세요.

프라이빗 API 엔드포인트는 모든 헤더 이름을 그대로 전달합니다.