Transfira um grupo de APIs de uma instância do API Gateway para outra para atender a requisitos maiores de throughput, SLA ou isolamento de rede.
Tipos de instância
Instância serverless (VPC): Os locatários compartilham o mesmo endereço IP de saída e largura de banda. Ideal para testes e cargas de trabalho de produção em pequena escala.
Instância dedicada (VPC): Oferece um acordo de nível de serviço (SLA) superior com recursos isolados, incluindo endereços IP públicos de entrada dedicados, endereços IP de Virtual Private Cloud (VPC), largura de banda de saída para a Internet e clusters de servidores isolados. Adquira uma especificação com o limite de requisições por segundo (RPS) necessário para sua carga de trabalho.
Antes de começar
Revise os pontos abaixo antes de iniciar a migração. Caso tenha alterado o RPS de um grupo de APIs, envie um ticket antes de prosseguir.
Migrar de uma instância serverless para uma instância dedicada
Após a migração, o RPS máximo e a política de segurança HTTPS da instância dedicada de destino passam a valer para o grupo de APIs.
O endereço IP de saída da instância pode mudar. Verifique o novo endereço na página Instances e adicione-o à lista de permissões de IPs autorizados a acessar seu serviço de backend.
Se o grupo de APIs utilizar algum dos recursos a seguir, ative-os na instância de destino antes da migração: nome de domínio de segundo nível para acesso via VPC, nome de domínio interno para chamadas de API do API Gateway, tráfego IPv6 de entrada e tráfego IPv6 de saída.
Se o destino for uma instância de integração VPC, confirme se o grupo de segurança da Elastic Network Interface (ENI) associada permite o endereço IP ou bloco CIDR do serviço de backend.
Migrar de uma instância dedicada para outra instância dedicada
Após a migração, o RPS máximo e a política de segurança HTTPS da instância dedicada de destino passam a valer para o grupo de APIs.
O endereço IP de saída da instância pode mudar. Verifique o novo endereço na página Instances e adicione-o à lista de permissões de IPs autorizados a acessar seu serviço de backend.
Se o grupo de APIs utilizar algum dos recursos a seguir, ative-os na instância de destino antes da migração: nome de domínio de segundo nível para acesso via VPC, nome de domínio interno para chamadas de API do API Gateway, tráfego IPv6 de entrada e tráfego IPv6 de saída.
Se o destino for uma instância de integração VPC, confirme se o grupo de segurança da ENI associada permite o endereço IP ou bloco CIDR do serviço de backend.
Migrar um grupo de APIs
Faça login no console do API Gateway. Na barra de navegação superior, selecione uma região.
No painel de navegação à esquerda, escolha Manage APIs > API Groups. Clique no grupo de APIs que deseja migrar.
Na página Group Details, clique em Modify Instance for API Group Deployment.
Na caixa de diálogo, selecione uma instância de destino na lista suspensa Destination Instance. Leia as precauções, marque I have read the preceding statement and know the potential risks associated with the migration e clique em Migration. A alteração entra em vigor entre 1 e 10 minutos, dependendo do cache do Domain Name System (DNS).
Se a especificação da instância dedicada não atender mais aos seus requisitos, atualize-a para uma especificação superior. Para mais informações, consulte Alterar a especificação de uma instância.
Devido ao cache de DNS, algumas requisições ainda podem alcançar a instância anterior após a conclusão da migração. Verifique se todo o tráfego foi direcionado para a nova instância antes de desativar a antiga.