AWS HubAWS HubSão Paulo operando · 2 eventos no mundo

DeveloperComunidade

Nível de dificuldade: Avançado (4 de 5)

API Gateway no DVA-C03: o que throttling, caching e authorizers fazem na prática

Por AWS Hub7 min de leitura

O Amazon API Gateway aparece em praticamente todos os domínios do exame AWS Certified Developer Associate (DVA-C03): desenvolvimento, segurança, deploy e troubleshooting. Um guia publicado na DEV Community por Nivaro, autor de materiais de prática para o DVA-C03, organiza os pontos que mais se repetem nas questões, baseado na página oficial do exame e no guia do desenvolvedor do serviço. A observação vale também fora da prova: são os mesmos erros que aparecem em produção.

A lógica das questões (e dos incidentes reais) é sempre a mesma: a pergunta descreve um sintoma ou um requisito, não pede definição. Quem já quebrou uma API em homologação reconhece o padrão na hora.

REST API ou HTTP API: o que muda na escolha

A HTTP API é mais barata, tem latência menor e suporta integração com Lambda, integração HTTP, JWT authorizers (Cognito ou qualquer provedor OIDC) e autorização IAM. Já a REST API traz API keys e usage plans, cache de resposta, validação de requisição, integração com o AWS WAF, resource policies, endpoints privados e mapping templates para transformar request e response.

A régua prática: se o requisito menciona cache, usage plan por cliente, API key, validação de requisição ou WAF, a resposta é REST API. Se o pedido é só custo ou latência mínima sem nada disso, HTTP API resolve com menos operação.

Os quatro códigos de erro que todo dev de API Gateway encontra

  • 429 Too Many Requests: throttling, seja o limite de conta por região, um limite de stage/method configurado, ou o limite de um usage plan ligado à API key. A correção é subir o limite, criar um usage plan adequado, ou fazer o cliente repetir com backoff exponencial.
  • 502 Bad Gateway: quase sempre uma integração Lambda proxy devolvendo resposta no formato errado. Com proxy integration, a função precisa retornar um objeto com statusCode, headers e um body que seja string. Devolver um objeto puro, sem serializar o body, gera 502.
  • 504 Gateway Timeout: a integração demorou demais. Integrações de REST API têm timeout padrão de 29 segundos; se o backend precisa de mais tempo, o caminho não é esperar, e sim tornar o trabalho assíncrono, por exemplo colocando o job numa fila SQS ou disparando uma execução no Step Functions e respondendo de imediato.
  • 403 Forbidden: falta de autorização, API key ausente quando o método exige uma, ou uma resource policy negando o chamador.

Um jeito rápido de guardar: 4xx é problema do lado do cliente ou de limite configurado; 5xx é algo que quebrou atrás do API Gateway.

json
{
 "statusCode": 200,
 "headers": { "Content-Type": "application/json" },
 "body": "{\"ok\":true}"
}

Esse é o formato mínimo que uma função Lambda por trás de proxy integration precisa devolver. Esquecer de transformar o corpo em string com JSON.stringify() (ou equivalente) é o erro mais comum por trás do 502.

Throttling em camadas e o papel do usage plan

O API Gateway aplica limite em várias camadas: primeiro um limite de conta por região, depois limites de stage e method configurados por quem opera a API, e por último limites por cliente via usage plan. Um usage plan associa uma ou mais stages a API keys e define taxa, burst e, opcionalmente, uma cota, por exemplo 10.000 requisições por mês.

Esse é o cenário clássico de "cada cliente pode fazer até N requisições" ou "oferecer um plano gratuito e um pago para a mesma API". Um ponto que costuma pegar quem estuda: a API key serve para identificar e medir o consumo do cliente, não para autenticação. Se a pergunta (ou o requisito do projeto) é sobre quem pode chamar a API, o mecanismo certo é authorizer ou IAM, não API key.

Cache de resposta: TTL, chave de cache e invalidação

APIs REST podem fazer cache de resposta por stage, com TTL padrão de 300 segundos, máximo de 3600 segundos, e TTL igual a 0 desligando o cache. É possível escolher quais parâmetros (headers, query strings, path) entram na chave de cache: se dois usuários começam a ver dado um do outro, o sintoma mais provável é uma chave de cache incompleta, faltando por exemplo o identificador do usuário entre os parâmetros considerados.

Um cliente pode pedir para pular o cache enviando o header Cache-Control: max-age=0, mas só se tiver permissão para invalidar; exigir autorização para esse header evita que qualquer chamador zere o cache da API. Na leitura de um requisito: "reduzir chamadas ao backend" ou "melhorar latência em requisições repetidas idênticas" aponta para cache de stage; "usuário vê dado desatualizado depois de uma mudança" aponta para baixar o TTL ou tratar a invalidação.

Authorizers: qual mecanismo cabe em cada cenário

Essa é uma das áreas mais cobradas, e também uma das mais confundidas no dia a dia:

  • IAM: o chamador assina a requisição com Signature Version 4; faz sentido para serviços AWS, ferramentas internas e chamadas entre contas.
  • Cognito user pool authorizer (REST API) ou JWT authorizer (HTTP API): usuário se autentica num user pool ou provedor OIDC e envia um token; é o caminho natural para apps web e mobile com cadastro e login próprios.
  • Lambda authorizer: a decisão fica numa função sua, para tokens customizados, provedores de identidade que não são OIDC, ou decisões baseadas em header, query string ou IP de origem. Existem dois tipos: TOKEN, que olha um único header (como um bearer token), e REQUEST, que pode olhar headers, query strings, stage variables e contexto.

O resultado de um Lambda authorizer pode ser cacheado, por padrão por 300 segundos. Se o sintoma é "a função authorizer é invocada em toda requisição e o custo subiu", a resposta é ativar ou aumentar esse cache. Se o sintoma é o oposto, "um usuário continua com acesso depois que a permissão dele foi removida", a política em cache é a explicação mais provável, e reduzir o TTL do cache do authorizer é o ajuste.

Stages, stage variables e rollout gradual

Um deployment é uma foto da API; uma stage (dev, test, prod) é onde esse deployment fica publicado. Stage variables funcionam como variáveis de ambiente da stage, um padrão comum é apontar cada stage para um alias de Lambda diferente com ${stageVariables.lambdaAlias}, lembrando que o API Gateway precisa de permissão para invocar cada alias.

Para rollout gradual no nível da API, o recurso é canary release numa stage de REST API, enviando uma porcentagem do tráfego para um novo deployment. Se o requisito é sobre a função Lambda em si, e não sobre a API, a resposta mais comum passa por aliases com peso ou traffic shifting do CodeDeploy.

CORS: a pegadinha do proxy integration

Quando um app de outro domínio chama a API e recebe erro de CORS no navegador, o CORS precisa estar habilitado na API para que o preflight OPTIONS devolva os headers certos. Mas com integração Lambda proxy, o API Gateway repassa a resposta da função sem alterar nada, então é a própria função que precisa devolver o header Access-Control-Allow-Origin. Habilitar CORS só no console, sem ajustar a resposta da função, não resolve, e esse detalhe aparece em questões (e em bugs reais) com mais frequência do que parece.

Como transformar isso em prática

Ler a lista acima ajuda na véspera da prova, mas o guia da DEV Community sugere o caminho que realmente fixa o conteúdo: montar uma API pequena na própria conta, com integração Lambda proxy, um usage plan com API key, um authorizer do Cognito e uma stage com cache ligado. Depois, quebrar de propósito: devolver um corpo que não é string, adicionar um sleep maior que o timeout, chamar a API sem a key. Ver o 502, o 504 e o 403 na tela, e não só ler a definição deles, é o que faz essas questões ficarem óbvias na hora da prova.

O artigo original, de autoria de Nivaro na DEV Community, também traz um checklist de decisão rápida ligando cada tipo de requisito (custo, limite por cliente, leitura repetida, autenticação, código de erro, rollout seguro) ao recurso correspondente do API Gateway, útil tanto para revisão de exame quanto para design de API no trabalho.

Fonte: DEV Community — #aws

Serviços neste textoDeveloper

Leve para a sua IA

Decida com o seu assistente, com o contexto deste texto já montado.

1. O que você quer saber

Ver o prompt
Li no AWS Hub: "API Gateway no DVA-C03: o que throttling, caching e authorizers fazem na prática" (https://awshub.com.br/comunidade/api-gateway-no-dva-c03-o-que-throttling-caching-e-authorizers-fazem-na-pratica).
Resumo: Um guia de estudo para a certificação Developer Associate (DVA-C03) organiza os tópicos de API Gateway que mais aparecem em cenários de erro e limite, do 502 do proxy Lambda ao cache que vaza dado de outro usuário.
Serviços: Developer

Minha stack: [descreva em uma linha: serviços, linguagem, volume, região]

Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?

Newsletter semanal

A semana da AWS, em português

Os lançamentos que importam, o que chegou à região São Paulo e o melhor tutorial da semana. Toda sexta, gratuita.