Tutorial: Uso de Lambda con API Gateway

Para crear la política de

1. Abra la página de Policies (Políticas) de la consola de IAM.

2. Seleccione Crear política.

3. Elija la pestaña JSON y pegue la siguiente política personalizada en el editor JSON.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "Stmt1428341300017",
         "Action": [
           "dynamodb:DeleteItem",
           "dynamodb:GetItem",
           "dynamodb:PutItem",
           "dynamodb:Query",
           "dynamodb:Scan",
           "dynamodb:UpdateItem"
         ],
         "Effect": "Allow",
         "Resource": "*"
       },
       {
         "Sid": "",
         "Resource": "*",
         "Action": [
           "logs:CreateLogGroup",
           "logs:CreateLogStream",
           "logs:PutLogEvents"
         ],
         "Effect": "Allow"
       }
     ]
   }

4. Elija Siguiente: Etiquetas.

5. Elija Siguiente: Revisar.

6. En Review policy (Revisar política), para el Name (Nombre) de la política, ingrese lambda-apigateway-policy.

7. Seleccione Crear política.

Para crear una función de ejecución y adjuntar su política de permisos personalizada

1. Abra la página Roles en la consola de IAM.

2. Elija Creación de rol.

3. Para el tipo de entidad de confianza, seleccione Servicio de AWS y, para el caso de uso, elija Lambda.

4. Elija Siguiente.

5. En el cuadro de búsqueda de políticas, escriba lambda-apigateway-policy.

6. En los resultados de búsqueda, seleccione la política que ha creado (lambda-apigateway-policy), y luego Next (Siguiente).

7. En Role details (Detalles del rol), introduzca lambda-apigateway-role en Role name (Nombre del rol) y, luego, elija Create role (Crear rol).

Para invocar la función de Lambda con el comando AWS CLI.

1. Guarde el siguiente JSON como un archivo denominado input.txt.

   {
       "operation": "echo",
       "payload": {
           "somekey1": "somevalue1",
           "somekey2": "somevalue2"
       }
   }

2. Ejecute el siguiente comando AWS CLI de la invoke.

   aws lambda invoke \
   --function-name LambdaFunctionOverHttps \
   --payload file://input.txt outputfile.txt \
   --cli-binary-format raw-in-base64-out

   La opción cli-binary-format es obligatoria si va a utilizar la versión 2 de la AWS CLI. Para que esta sea la configuración predeterminada, ejecute aws configure set cli-binary-format raw-in-base64-out. Para obtener más información, consulte Opciones de la línea de comandos globales compatibles con AWS CLI en la Guía del usuario de la AWS Command Line Interface versión 2.

   Debería ver la siguiente respuesta:

   {
       "StatusCode": 200,
       "ExecutedVersion": "LATEST"
   }

3. Confirme que la función ha realizado la operación echo que especificó en el evento de prueba de JSON. Inspeccione el archivo outputfile.txt y compruebe que contiene lo siguiente:

   {"somekey1": "somevalue1", "somekey2": "somevalue2"}

Para crear la API

1. Abra la consola de API Gateway.

2. Seleccione Create API (Crear API).

3. En el cuadro REST API (API de REST), elija Build (Crear).

4. En Detalles de la API, deje seleccionada la opción Nueva API y, en Nombre de la API, ingrese DynamoDBOperations.

5. Seleccione Create API (Crear API).

Para crear el recurso

1. En la consola de puerta de enlace de API, en la página Recursos de su API, seleccione Crear recurso.

2. En Detalles del recurso, ingrese el nombre del recursoDynamoDBManager.

3. Elija Create Resource (Crear recurso).

Para crear el método POST

1. En la página Recursos de su API, asegúrese de que el recurso /DynamoDBManager esté resaltado. A continuación, en el panel Métodos, seleccione Crear método.

2. En Tipo de método, elija POST.

3. En Tipo de integración, seleccione función de Lambda.

4. Para la función de Lambda, elija el nombre de recurso de Amazon (ARN) para la función (LambdaFunctionOverHttps).

5. Elija Crear método.

Creación de la tabla de DynamoDB

1. Abra la página Tables (Tablas) en la consola de DynamoDB.

2. Seleccione Create table (Creación de tabla).

3. En Table details (Detalles de la tabla), haga lo siguiente:

   1. En Nombre de la tabla, introduzca lambda-apigateway.

   2. En Partition key (Clave de partición), ingrese id y mantenga el tipo de datos establecido como String (Cadena).

4. En Settings (Configuración), mantenga los valores predeterminados en Default settings (Configuración predeterminada).

5. Seleccione Create table (Creación de tabla).

Prueba 1: Crear un nuevo elemento en la tabla de DynamoDB

1. En la consola de API Gateway, elija su API (DynamoDBOperations).

2. Elija el método POST debajo del recurso DynamoDBManager.

   

3. Elija la pestaña Test (Prueba). Puede que tenga que elegir el botón de flecha hacia la derecha para mostrar la pestaña.

4. En Método de prueba, deje vacías las cadenas de consulta y los encabezados. En Cuerpo de la solicitud, pegue el siguiente JSON:

   {
     "operation": "create",
     "payload": {
       "Item": {
         "id": "1234ABCD",
         "number": 5
       }
     }
   }

5. Seleccione Probar.

   Los resultados que se muestran al finalizar la prueba deben mostrar el estado 200. Este código de estado indica que la operación create se ha realizado correctamente.

   Para confirmarlo, verifique que ahora su tabla de DynamoDB contenga un nuevo elemento.

6. Abra la página Tables (Tablas) en la consola de DynamoDB y elija la tabla lambda-apigateway.

7. Elija Explore table items (Explorar elementos de la tabla). En el panel Items returned (Devolución de elementos), debería ver un elemento con el id1234ABCD y el número de 5. Ejemplo:

   

Prueba 2: Actualización del elemento de la tabla de DynamoDB

1. En la consola de la puerta de enlace de API, vuelva a la pestaña Prueba del método POST.

2. En Método de prueba, deje vacías las cadenas de consulta y los encabezados. En Cuerpo de la solicitud, pegue el siguiente JSON:

   {
       "operation": "update",
       "payload": {
           "Key": {
               "id": "1234ABCD"
           },
           "UpdateExpression": "SET #num = :newNum",
           "ExpressionAttributeNames": {
               "#num": "number"
           },
           "ExpressionAttributeValues": {
               ":newNum": 10
           }
       }
   }

3. Seleccione Probar.

   Los resultados que se muestran cuando finaliza la prueba deben mostrar el estado 200. Este código de estado indica que la operación update se ha realizado correctamente.

   Para confirmarlo, compruebe que el elemento de la tabla de DynamoDB se haya modificado.

4. Abra la página Tables (Tablas) en la consola de DynamoDB y elija la tabla lambda-apigateway.

5. Elija Explore table items (Explorar elementos de la tabla). En el panel Items returned (Devolución de elementos), debería ver un elemento con el id1234ABCD y el número de 10.

   

Para implementar la API

1. Abra la página API de la consola de API Gateway y seleccione la API de DynamoDBOperations.

2. En la página Recursos de su API, seleccione Implementar la API.

3. Para la Etapa de implementación, seleccione *Nueva etapa* y, en Nombre de etapa, introduzca test.

4. Elija Implementar.

5. En el panel Editor de etapas de prueba, copie la URL de invocación. Lo utilizará en el siguiente paso para invocar su función mediante una solicitud HTTP.

Para crear un elemento en la tabla de DynamoDB con curl

1. Ejecute el siguiente comando curl por medio de la URL de invocación que copió en el paso anterior. Cuando use el curl con la opción -d (data), utilice automáticamente el método HTTP POST.

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "create", "payload": {"Item": {"id": "5678EFGH", "number": 15}}}'

   Si la operación se realizó correctamente, debería ver una respuesta con el código de estado HTTP 200.

2. También puede utilizar la consola de DynamoDB para comprobar que el nuevo elemento esté en la tabla con las siguientes acciones:

   1. Abra la página Tables (Tablas) en la consola de DynamoDB y elija la tabla lambda-apigateway.

   2. Elija Explore table items (Explorar elementos de la tabla). En el panel Items returned (Devolución de elementos), debería ver un elemento con el id5678EFGH y el número15.

Para leer el elemento en la tabla de DynamoDB con curl

• Ejecute el siguiente comando curl para leer el valor del elemento que acaba de crear. Utilice su propia URL de invocación.

  curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager -d \
  '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

  Debería ver uno de los siguientes resultados dependiendo de si eligió el código de función Node.js o Python:

  Node.js

  {"$metadata":{"httpStatusCode":200,"requestId":"7BP3G5Q0C0O1E50FBQI9NS099JVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "attempts":1,"totalRetryDelay":0},"Item":{"id":"5678EFGH","number":15}}

  Python

  {"Item":{"id":"5678EFGH","number":15},"ResponseMetadata":{"RequestId":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "HTTPStatusCode":200,"HTTPHeaders":{"server":"Server","date":"Wed, 31 Jul 2024 00:37:01 GMT","content-type":"application/x-amz-json-1.0",
  "content-length":"52","connection":"keep-alive","x-amzn-requestid":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG","x-amz-crc32":"2589610852"},
  "RetryAttempts":0}}

Para actualizar el elemento en la tabla de DynamoDB con curl

1. Ejecute el siguiente comando curl para actualizar el elemento que acaba de crear cambiando el valor number. Utilice su propia URL de invocación.

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "update", "payload": {"Key": {"id": "5678EFGH"}, "UpdateExpression": "SET #num = :new_value", "ExpressionAttributeNames": {"#num": "number"}, "ExpressionAttributeValues": {":new_value": 42}}}'

2. Para confirmar que se ha actualizado el valor de number correspondiente al elemento, ejecute otro comando de lectura:

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

Para eliminar el elemento en la tabla de DynamoDB con curl

1. Si lo desea, ejecute el siguiente comando para eliminar el curl que ha creado. Utilice su propia URL de invocación.

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "delete", "payload": {"Key": {"id": "5678EFGH"}}}'

2. Confirme que la operación de eliminación se ha realizado correctamente. En el panel Elementos devueltos de la página Explorar elementos de la consola de DynamoDB, verifique que el elemento con id 5678EFGH ya no se encuentre en la tabla.

Cómo eliminar la función de Lambda

1. Abra la página de Funciones en la consola de Lambda.

2. Seleccione la función que ha creado.

3. Elija Acciones, Eliminar.

4. Escriba delete en el campo de entrada de texto y elija Delete(Eliminar).

Cómo eliminar el rol de ejecución

1. Abra la página Roles en la consola de IAM.

2. Seleccione el rol de ejecución que creó.

3. Elija Eliminar.

4. Si desea continuar, escriba el nombre del rol en el campo de entrada de texto y elija Delete (Eliminar).

Para eliminar la API

1. Abra la página API de la consola de API Gateway.

2. Seleccione la API que ha creado.

3. Elija Acciones, Eliminar.

4. Elija Eliminar.

Para eliminar una tabla de DynamoDB

1. Abra la página Tables (Tablas) en la consola de DynamoDB.

2. Seleccione la tabla que ha creado.

3. Elija Eliminar.

4. Escriba delete en el cuadro de texto.

5. Elija Delete table (Eliminar tabla).