Taller 04 · API sin servidores: Lambda y API Gateway

21 de noviembre de 2026⏱ 3 min de lecturaProf. profesor

Costo esperado: Prácticamente cero: Lambda incluye un millón de solicitudes al mes de forma gratuita permanente (confírmalo en Free Tier).

Objetivo: Crear una función Lambda, exponerla con una API HTTP, ponerle límite de peticiones y reducir los registros.

💰 Reglas de oro de la capa gratuita: (1) trabaja siempre en us-east-1; (2) ten un presupuesto con alertas (Taller 00); (3) etiqueta todo con proyecto=curso-nube; (4) elimina lo creado al terminar, no basta con apagarlo. Consulta la guía Atajos para aprovechar la capa gratuita.

Antes de empezar

  • Taller 00 hecho.

Paso 1 · Crea la función (consola)

  1. Consola → Lambda → Create function → Author from scratch.
  2. Nombre: taller-hola. Runtime: Python (la versión más reciente disponible). Deja el rol por defecto.
  3. Pega este código en lambda_function.py y pulsa Deploy.
import json

def lambda_handler(event, context):
    params = event.get("queryStringParameters") or {}
    nombre = params.get("nombre") or event.get("nombre", "mundo")
    return {
        "statusCode": 200,
        "headers": {"Content-Type": "application/json; charset=utf-8"},
        "body": json.dumps({"mensaje": f"Hola {nombre} desde Lambda"}, ensure_ascii=False),
    }

Pestaña Test → evento {"nombre": "Ana"} → Test. Debes ver statusCode 200 y el mensaje.

Paso 2 · Publícala con API Gateway (CloudShell)

export AWS_DEFAULT_REGION=us-east-1
export PROYECTO=curso-nube
aws sts get-caller-identity   # comprueba que estás en TU cuenta
FN=taller-hola
ACC=$(aws sts get-caller-identity --query Account --output text)
ARN=arn:aws:lambda:us-east-1:$ACC:function:$FN
API=$(aws apigatewayv2 create-api --name taller-api --protocol-type HTTP --target $ARN --query ApiId --output text)
aws lambda add-permission --function-name $FN --statement-id apigw-invoke \
  --action lambda:InvokeFunction --principal apigateway.amazonaws.com \
  --source-arn "arn:aws:execute-api:us-east-1:$ACC:$API/*/*"
URL=$(aws apigatewayv2 get-api --api-id $API --query ApiEndpoint --output text)
curl "$URL?nombre=Ana"

Paso 3 · Ponle freno (límite de uso) y reduce los logs

Una API pública puede recibir miles de peticiones. Limita la tasa para que nunca te salgas de la capa gratuita:

aws apigatewayv2 update-stage --api-id $API --stage-name '$default' \
  --default-route-settings ThrottlingBurstLimit=5,ThrottlingRateLimit=2
aws logs put-retention-policy --log-group-name /aws/lambda/$FN --retention-in-days 1

Prueba con varias llamadas seguidas y observa cómo, al pasar el límite, la API responde 429 Too Many Requests.

Paso 4 · Observa

  • Lambda → Monitor: invocaciones, duración y errores.
  • CloudWatch → Log groups: la salida de cada ejecución.
  • Pregunta: ¿qué es el «arranque en frío» y cómo lo notaste en la primera llamada?

Limpieza (obligatoria)

aws apigatewayv2 delete-api --api-id $API
aws lambda delete-function --function-name $FN
aws logs delete-log-group --log-group-name /aws/lambda/$FN

En IAM → Roles, borra también el rol que la consola creó para la función (taller-hola-role-…).

Entregables

  • Captura del Test exitoso en Lambda.
  • Salida de curl con la respuesta JSON.
  • Captura de la respuesta 429 al superar el límite.
  • Captura de la función y la API eliminadas.

Para reflexionar

  • ¿Por qué una API pública necesita un límite de peticiones?
  • ¿Qué papel cumple cada servicio en una API sin servidores?
  • ¿Por qué darle a la función un rol con el mínimo de permisos?

Criterios de evaluación

CriterioPeso
Funciona y cumple lo pedido40%
Costo y seguridad: presupuesto activo, recursos etiquetados, todo eliminado al final30%
Evidencias (capturas y salidas de comandos)20%
Explicación de lo que hiciste y por qué10%
Bitly

¡Buen trabajo! Llegaste al final de esta clase. Repasa los ejemplos, haz la tarea y, si tienes dudas, déjalas en los comentarios. — Bitly

💬 Preguntas y comentarios

¿Algo no quedó claro? Pregunta aquí y te respondo.

Deja tu pregunta