Tipos de endpoint da API para APIs REST no API Gateway
Um tipo de endpoint da API refere-se ao nome do host da API. O tipo de endpoint da API pode ser otimizado para fronteiras, regional ou privado, dependendo de onde a maior parte do seu tráfego de API se origina.
Endpoint de API otimizado para bordas
Um endpoint de API otimizado para borda geralmente direciona as solicitações para o ponto de presença (POP) do CloudFront mais próximo, o que pode ajudar nos casos em que os clientes estão distribuídos geograficamente. Esse é o tipo de endpoint padrão para APIs REST do API Gateway.
As APIs otimizadas para fronteiras mantêm em letra maiúscula os nomes dos cabeçalhos HTTPCookie).
O CloudFront classifica os cookies HTTP em ordem natural por nome de cookie antes de encaminhar a solicitação para sua origem. Para obter mais informações sobre a maneira como o CloudFront processa os cookies, consulte Armazenamento em cache de conteúdo com base em cookies.
Qualquer nome de domínio personalizado que for usado para uma API otimizada para a borda se aplicará a todas as regiões.
Endpoints de API regionais
Um endpoint de API regional é destinado a clientes na mesma região. Quando um cliente em execução em uma instância do EC2 chama uma API na mesma região, ou quando uma API é destinada a atender a um pequeno número de clientes com alta demanda, uma API regional reduz a carga da conexão.
Para uma API regional, o nome de domínio personalizado que você usa é específico da região em que a API é implantada. Se você implantar uma API regional implantada em várias regiões, o nome de domínio personalizado poderá ser o mesmo em todas as regiões. Você pode usar domínios personalizados em conjunto com o Amazon Route 53 para executar tarefas como roteamento baseado em latência. Para obter mais informações, consulte Configurar um nome de domínio regional personalizado no API Gateway e Configurar um nome de domínio personalizado otimizado para borda no API Gateway.
Os endpoints de API regionais transmitem todos os nomes de cabeçalho no estado em que se encontram.
nota
Nos casos em que os clientes da API são geograficamente dispersos, ainda poderá fazer sentido usar um endpoint de API regional junto à sua própria distribuição do Amazon CloudFront para garantir que o API Gateway não associe a API às distribuições do CloudFront controladas pelo serviço. Para obter mais informações sobre esse caso de uso, consulte Como posso configurar o API Gateway com minha própria distribuição do CloudFront?
Endpoints privados de API
Um endpoint privado da API é um endpoint de API que somente pode ser acessado de sua Amazon Virtual Private Cloud (VPC) usando um VPC endpoint de interface, uma endpoint network interface (ENI – Interface de rede de endpoint) que você cria em sua VPC. Para obter mais informações, consulte APIs REST privadas no API Gateway.
Os endpoints privados de API transmitem todos os nomes de cabeçalho no estado em que se encontram.
