DynamoDB

El objeto que describe unDynamoDBtipo de origen de evento. Para obtener más información, consulteUso deAWS Lambdacon Amazon DynamoDBen laAWS LambdaGuía para desarrolladores.

AWS SAMgenera unAWS::Lambda::EventSourceMappingrecurso cuando se establece este tipo de evento.

Sintaxis

Para declarar esta entidad en suAWS Serverless Application Model(AWS SAM), utilice la siguiente sintaxis.

YAML

  BatchSize: Integer
  BisectBatchOnFunctionError: Boolean
  DestinationConfig: DestinationConfig
  Enabled: Boolean
  FilterCriteria: FilterCriteria
  FunctionResponseTypes: List
  MaximumBatchingWindowInSeconds: Integer
  MaximumRecordAgeInSeconds: Integer
  MaximumRetryAttempts: Integer
  ParallelizationFactor: Integer
  StartingPosition: String
  Stream: String
  TumblingWindowInSeconds: Integer

Properties

BatchSize

El número máximo de elementos que se recuperan en un único lote.

Type: Entero

Obligatorio: No

Valor predeterminado: 100

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alBatchSizepropiedad de unAWS::Lambda::EventSourceMappingrecurso.

Minimum: 1

Maximum: 1000

BisectBatchOnFunctionError

Si la función devuelve un error, divida el lote en dos y vuelva a intentarlo.

Type: Booleano

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alBisectBatchOnFunctionErrorpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

DestinationConfig

Una cola de Amazon Simple Queue Service (Amazon SQS) o destino de tema de Amazon Simple Notification Service (Amazon SNS) para registros desechados.

Type: DestinationConfig

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alDestinationConfigpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

Enabled

Deshabilita el mapeo de origen de eventos para pausar el sondeo y la invocación.

Type: Booleano

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alEnabledpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

FilterCriteria

Un objeto que define los criterios para determinar si Lambda debe procesar un evento. Para obtener más información, consulteAWS Lambdafiltrado de eventosen laAWS LambdaGuía para desarrolladores.

Type: FilterCriteria

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alFilterCriteriapropiedad de unAWS::Lambda::EventSourceMappingrecurso.

FunctionResponseTypes

Una lista de los tipos de respuesta aplicados actualmente a la asignación de origen de eventos. Para obtener más información, consulteInformes de fallos de artículos de loteen laAWS LambdaGuía para desarrolladores.

Valores válidos: ReportBatchItemFailures

Type: Lista

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alFunctionResponseTypespropiedad de unAWS::Lambda::EventSourceMappingrecurso.

MaximumBatchingWindowInSeconds

La cantidad de tiempo máxima para recopilar registros antes de invocar la función, en segundos.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alMaximumBatchingWindowInSecondspropiedad de unAWS::Lambda::EventSourceMappingrecurso.

MaximumRecordAgeInSeconds

La antigüedad máxima de un registro que Lambda envía a una función para que lo procese.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alMaximumRecordAgeInSecondspropiedad de unAWS::Lambda::EventSourceMappingrecurso.

MaximumRetryAttempts

El número máximo de veces que se debe volver a intentar cuando la función devuelve un error.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alMaximumRetryAttemptspropiedad de unAWS::Lambda::EventSourceMappingrecurso.

ParallelizationFactor

El número de lotes de cada partición que se procesarán simultáneamente.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alParallelizationFactorpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

StartingPosition

Posición del flujo donde comienza la lectura.

Valores válidos: TRIM_HORIZON o LATEST

Type: Cadena

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alStartingPositionpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

Stream

El nombre de recurso de Amazon (ARN) del flujo de DynamoDB.

Type: Cadena

Obligatorio: Sí

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alEventSourceArnpropiedad de unAWS::Lambda::EventSourceMappingrecurso.

TumblingWindowInSeconds

La duración, en segundos, de una ventana de procesamiento. El intervalo válido va de 1 a 900 (15 minutos).

Para obtener más información, consulteVentanas de saltos de tamaño constanteen laAWS LambdaGuía para desarrolladores.

Type: Entero

Obligatorio: No

AWS CloudFormationcompatibilidad: Esta propiedad se transfiere directamente alTumblingWindowInSecondspropiedad de unAWS::Lambda::EventSourceMappingrecurso.

Ejemplos

Origen de eventos de DynamoDB para la tabla de DynamoDB existente

Origen de eventos de DynamoDB para una tabla de DynamoDB que ya existe en unAWSaccount.

YAML

Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: arn:aws:dynamodb:us-east-1:123456789012:table/TestTable/stream/2016-08-11T21:21:33.291
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false
      

Evento de DynamoDB para tabla de DynamoDB declarado en plantilla

Evento DynamoDB para una tabla de DynamoDB declarada en el mismo archivo de plantilla.

YAML

Events:
  DDBEvent:
    Type: DynamoDB
    Properties:
      Stream: 
        !GetAtt MyDynamoDBTable.StreamArn   # This must be the name of a DynamoDB table declared in the same template file
      StartingPosition: TRIM_HORIZON
      BatchSize: 10
      Enabled: false