You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Lambda::Types::CreateEventSourceMappingRequest

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing CreateEventSourceMappingRequest as input to an Aws::Client method, you can use a vanilla Hash:

{
  event_source_arn: "Arn", # required
  function_name: "FunctionName", # required
  enabled: false,
  batch_size: 1,
  maximum_batching_window_in_seconds: 1,
  parallelization_factor: 1,
  starting_position: "TRIM_HORIZON", # accepts TRIM_HORIZON, LATEST, AT_TIMESTAMP
  starting_position_timestamp: Time.now,
  destination_config: {
    on_success: {
      destination: "DestinationArn",
    },
    on_failure: {
      destination: "DestinationArn",
    },
  },
  maximum_record_age_in_seconds: 1,
  bisect_batch_on_function_error: false,
  maximum_retry_attempts: 1,
  topics: ["Topic"],
}

Instance Attribute Summary collapse

Instance Attribute Details

#batch_sizeInteger

The maximum number of items to retrieve in a single batch.

  • Amazon Kinesis - Default 100. Max 10,000.

  • Amazon DynamoDB Streams - Default 100. Max 1,000.

  • Amazon Simple Queue Service - Default 10. Max 10.

  • Amazon Managed Streaming for Apache Kafka - Default 100. Max 10,000.

Returns:

  • (Integer)

    The maximum number of items to retrieve in a single batch.

#bisect_batch_on_function_errorBoolean

(Streams) If the function returns an error, split the batch in two and retry.

Returns:

  • (Boolean)

    (Streams) If the function returns an error, split the batch in two and retry.

#destination_configTypes::DestinationConfig

(Streams) An Amazon SQS queue or Amazon SNS topic destination for discarded records.

Returns:

#enabledBoolean

If true, the event source mapping is active. Set to false to pause polling and invocation.

Returns:

  • (Boolean)

    If true, the event source mapping is active.

#event_source_arnString

The Amazon Resource Name (ARN) of the event source.

  • Amazon Kinesis - The ARN of the data stream or a stream consumer.

  • Amazon DynamoDB Streams - The ARN of the stream.

  • Amazon Simple Queue Service - The ARN of the queue.

  • Amazon Managed Streaming for Apache Kafka - The ARN of the cluster.

Returns:

  • (String)

    The Amazon Resource Name (ARN) of the event source.

#function_nameString

The name of the Lambda function.

Name formats .title

  • Function name - MyFunction.

  • Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.

  • Version or Alias ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD.

  • Partial ARN - 123456789012:function:MyFunction.

The length constraint applies only to the full ARN. If you specify only the function name, it\'s limited to 64 characters in length.

Returns:

  • (String)

    The name of the Lambda function.

#maximum_batching_window_in_secondsInteger

(Streams) The maximum amount of time to gather records before invoking the function, in seconds.

Returns:

  • (Integer)

    (Streams) The maximum amount of time to gather records before invoking the function, in seconds.

#maximum_record_age_in_secondsInteger

(Streams) Discard records older than the specified age. The default value is infinite (-1).

Returns:

  • (Integer)

    (Streams) Discard records older than the specified age.

#maximum_retry_attemptsInteger

(Streams) Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records will be retried until the record expires.

Returns:

  • (Integer)

    (Streams) Discard records after the specified number of retries.

#parallelization_factorInteger

(Streams) The number of batches to process from each shard concurrently.

Returns:

  • (Integer)

    (Streams) The number of batches to process from each shard concurrently.

#starting_positionString

The position in a stream from which to start reading. Required for Amazon Kinesis, Amazon DynamoDB, and Amazon MSK Streams sources. AT_TIMESTAMP is only supported for Amazon Kinesis streams.

Possible values:

  • TRIM_HORIZON
  • LATEST
  • AT_TIMESTAMP

Returns:

  • (String)

    The position in a stream from which to start reading.

#starting_position_timestampTime

With StartingPosition set to AT_TIMESTAMP, the time from which to start reading.

Returns:

  • (Time)

    With StartingPosition set to AT_TIMESTAMP, the time from which to start reading.

#topicsArray<String>

(MSK) The name of the Kafka topic.

Returns:

  • (Array<String>)

    (MSK) The name of the Kafka topic.