aws-lambda-dynamodb - Construcciones de Soluciones de AWS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

aws-lambda-dynamodb

Todas las clases están en desarrollo activo y están sujetas a cambios o eliminación no compatibles con versiones anteriores en cualquier versión futura. Estos no están sujetos a laVersiones semánticasModelo. Esto significa que, aunque puede usarlos, es posible que necesite actualizar el código fuente cuando actualice a una versión más reciente de este paquete.

Nota: Para garantizar una funcionalidad adecuada, los paquetes de AWS Solutions Constructs y los paquetes CDK de AWS del proyecto deben tener la misma versión.

Idioma Paquete
Python
aws_solutions_constructs.aws_lambda_dynamodb
Mecanografía
@aws-solutions-constructs/aws-lambda-dynamodb
Java
software.amazon.awsconstructs.services.lambdadynamodb

Overview

Este constructo de soluciones de AWS implementa la función AWS Lambda y la tabla de Amazon DynamoDB con permisos de mínimo privilegio.

Aquí hay una definición mínima de patrón implementable en TypeScript:

import { LambdaToDynamoDBProps, LambdaToDynamoDB } from '@aws-solutions-constructs/aws-lambda-dynamodb'; const props: LambdaToDynamoDBProps = { lambdaFunctionProps: { runtime: lambda.Runtime.NODEJS_14_X, // This assumes a handler function in lib/lambda/index.js code: lambda.Code.fromAsset(`${__dirname}/lambda`), handler: 'index.handler' } }; new LambdaToDynamoDB(this, 'test-lambda-dynamodb-stack', props);

Initializer

new LambdaToDynamoDB(scope: Construct, id: string, props: LambdaToDynamoDBProps);

Parámetros

Patrón de construcción

Nombre Tipo Descripción
¿ExistenteLambdaobj? lambda.Function Instancia existente del objeto Lambda Function, proporcionando tanto esto comolambdaFunctionPropsprovocará un error.
¿LambdaFunctionProps? lambda.FunctionProps Propiedades opcionales proporcionadas por el usuario para anular las propiedades predeterminadas de la función Lambda. Se pasa por alto si unexistingLambdaObjse encuentra a su disposición.
¿DynamotableProps? dynamodb.TableProps Los accesorios proporcionados por el usuario opcionales para anular los accesorios predeterminados para la tabla de DynamoDB
ExistingTableObj? dynamodb.Table Instancia existente del objeto de tabla DynamoDB, proporcionando tanto esto comodynamoTablePropsprovocará un error.
¿Permisos de tabla? string Permisos de tabla opcionales que se concederán a la función Lambda. Puede que se especifique una de las siguientes opciones:All,Read,ReadWrite, o bienWrite.
TableEnvironmentVariableName? string Nombre opcional para el conjunto de variables de entorno de tabla DynamoDB para la función Lambda.
¿Existe VPC? ec2.IVpc Una VPC opcional existente en la que se debe implementar este patrón. Cuando se implementa en una VPC, la función Lambda utilizará ENI en la VPC para acceder a los recursos de red y se creará un extremo de puerta de enlace en la VPC para Amazon DynamoDB. Si se proporciona una VPC existente, eldeployVpcno se puedetrue. Utilizaec2.IVpcpara permitir que los clientes proporcionen VPC que existen fuera de la pila mediante el comandoec2.Vpc.fromLookup()Método de.
¿VPCProps? ec2.VpcProps Propiedades opcionales proporcionadas por el usuario para anular las propiedades predeterminadas de la nueva VPC.enableDnsHostnames,enableDnsSupport,natGateways, ysubnetConfigurationestán establecidos por el patrón, por lo que cualquier valor para esas propiedades suministradas aquí será anulado. SideployVpcno estrueentonces esta propiedad será ignorada.
¿Implementar VPC? boolean Si se crea una nueva VPC basada envpcPropsen el que desplegar este patrón. Si se establece esto en true, se implementará la VPC mínima y más privada para ejecutar el patrón:
  • Una subred aislada en cada zona de disponibilidad utilizada por el programa CDK

  • enableDnsHostnamesyenableDnsSupportambos se establecerán entrue

Si esta propiedad estrue, luegoexistingVpcNo se puede especificar . El valor predeterminado es false.

Propiedades de patrón

Nombre Tipo Descripción
DynamoTable dynamodb.Table Devuelve una instancia de la tabla DynamoDB creada por el patrón.
Lambdafunction lambda.Function Devuelve una instancia de la función Lambda creada por el patrón.
¿VPC? ec2.IVpc Devuelve una interfaz en la VPC utilizada por el patrón (si la hay). Esta puede ser una VPC creada por el patrón o la VPC suministrada al constructor del patrón.

Configuración predeterminada

La implementación lista para usar de este patrón sin anulación establecerá los siguientes valores predeterminados:

Función de AWS Lambda

  • Configurar el rol de IAM de acceso limitado con privilegios para la función Lambda.

  • Habilite la reutilización de conexiones con la función Keep-Alive para NodeJS Lambda.

  • Active el rastreo de X-Ray.

  • Configuración de las variables de entorno:

    • DDB_TABLE_NAME (predeterminado)

    • AWS_NODEJS_CONNECTION_REUSE_ENABLED(para Node 10.x y funciones superiores)

Amazon DynamoDB Tabla

  • Establezca el modo de facturación para la tabla de DynamoDB en Bajo demanda (pago por solicitud).

  • Habilite el cifrado del lado del servidor para DynamoDB Table mediante la clave KMS administrada por AWS.

  • Crea una clave de partición llamada 'id' para DynamoDB Table.

  • Conservar la tabla al eliminar la pila CloudFormation.

  • Habilite las copias de seguridad continuas y la recuperación a un momento dado.

Architecture

Diagram showing data flow from OpenSearch and Lambda to DynamoDB and CloudSearch.

GitHub

Para ver el código de este patrón, crear/ver problemas y solicitudes de extracción, y mucho más:
Circular icon with a graduation cap symbol representing education or learning.
@aws -soluciones-constructs/aws-lambda-dynamodb