EventSourceMappingConfiguration - AWS Lambda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

EventSourceMappingConfiguration

Pemetaan antara AWS sumber daya dan fungsi Lambda. Untuk detailnya, lihat CreateEventSourceMapping.

Daftar Isi

AmazonManagedKafkaEventSourceConfig

Pengaturan konfigurasi khusus untuk sumber peristiwa Amazon Managed Streaming for Apache Kafka (Amazon MSK).

Tipe: Objek AmazonManagedKafkaEventSourceConfig

Diperlukan: Tidak

BatchSize

Jumlah maksimum rekaman di setiap batch yang Lambda tarik dari aliran atau antrian Anda dan dikirim ke fungsi Anda. Lambda meneruskan semua catatan dalam batch ke fungsi dalam satu panggilan, hingga batas payload untuk pemanggilan sinkron (6 MB).

Nilai default: Bervariasi berdasarkan layanan. Untuk Amazon SQS, defaultnya adalah 10. Untuk semua layanan lainnya, defaultnya adalah 100.

Pengaturan terkait: Ketika Anda mengatur BatchSize ke nilai yang lebih besar dari 10, Anda harus mengatur MaximumBatchingWindowInSeconds ke setidaknya 1.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 10000.

Diperlukan: Tidak

BisectBatchOnFunctionError

(Kinesis dan DynamoDB Streams saja) Jika fungsi mengembalikan kesalahan, pisahkan batch menjadi dua dan coba lagi. Nilai default salah.

Tipe: Boolean

Wajib: Tidak

DestinationConfig

(Kinesis, DynamoDB Streams, Amazon MSK, dan sumber peristiwa Apache Kafka yang dikelola sendiri saja) Objek konfigurasi yang menentukan tujuan suatu peristiwa setelah Lambda memprosesnya.

Tipe: Objek DestinationConfig

Diperlukan: Tidak

DocumentDBEventSourceConfig

Pengaturan konfigurasi khusus untuk sumber acara DocumentDB.

Tipe: Objek DocumentDBEventSourceConfig

Diperlukan: Tidak

EventSourceArn

Amazon Resource Name (ARN) sumber peristiwa.

Tipe: String

Pola: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

Diperlukan: Tidak

FilterCriteria

Objek yang mendefinisikan kriteria filter yang menentukan apakah Lambda harus memproses suatu peristiwa. Untuk informasi selengkapnya, lihat Pemfilteran acara Lambda.

Tipe: Objek FilterCriteria

Diperlukan: Tidak

FunctionArn

ARN fungsi Lambda.

Tipe: String

Pola: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

Diperlukan: Tidak

FunctionResponseTypes

(Kinesis, DynamoDB Streams, dan Amazon SQS) Daftar enum tipe respons saat ini diterapkan pada pemetaan sumber peristiwa.

Tipe: Array string

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

Nilai yang Valid: ReportBatchItemFailures

Diperlukan: Tidak

LastModified

Tanggal pemetaan sumber peristiwa terakhir diperbarui atau statusnya berubah, dalam detik waktu Unix.

Tipe: Timestamp

Diperlukan: Tidak

LastProcessingResult

Hasil pemanggilan Lambda terakhir dari fungsi Anda.

Tipe: String

Wajib: Tidak

MaximumBatchingWindowInSeconds

Jumlah waktu maksimum, dalam hitungan detik, yang dihabiskan Lambda untuk mengumpulkan catatan sebelum menjalankan fungsi. Anda dapat mengonfigurasi MaximumBatchingWindowInSeconds ke nilai apa pun dari 0 detik hingga 300 detik dengan penambahan detik.

Untuk aliran dan sumber peristiwa Amazon SQS, jendela batching default adalah 0 detik. Untuk sumber acara Amazon MSK, Apache Kafka yang dikelola sendiri, Amazon MQ, dan DocumentDB, jendela batching default adalah 500 ms. Perhatikan bahwa karena Anda hanya dapat mengubah MaximumBatchingWindowInSeconds dalam penambahan detik, Anda tidak dapat kembali ke jendela batching default 500 ms setelah Anda mengubahnya. Untuk mengembalikan jendela batching default, Anda harus membuat pemetaan sumber peristiwa baru.

Setelan terkait: Untuk aliran dan sumber peristiwa Amazon SQS, bila Anda BatchSize menyetel ke nilai yang lebih besar dari 10, Anda harus MaximumBatchingWindowInSeconds menyetel ke setidaknya 1.

Tipe: Bilangan Bulat

Rentang yang Valid: Nilai minimum 0. Nilai maksimum 300.

Diperlukan: Tidak

MaximumRecordAgeInSeconds

(Hanya Kinesis dan DynamoDB Streams) Buang rekaman yang lebih tua dari usia yang ditentukan. Nilai defaultnya adalah -1, yang menetapkan usia maksimum hingga tak terbatas. Ketika nilai diatur ke tak terhingga, Lambda tidak pernah menghapus catatan lama.

catatan

Nilai valid minimum untuk usia rekor maksimum adalah 60-an. Meskipun nilai kurang dari 60 dan lebih besar dari -1 termasuk dalam rentang absolut parameter, mereka tidak diperbolehkan

Jenis: Integer

Rentang yang Valid: Nilai minimum -1. Nilai maksimum 604800.

Diperlukan: Tidak

MaximumRetryAttempts

(Hanya Kinesis dan DynamoDB Streams) Buang catatan setelah jumlah percobaan ulang yang ditentukan. Nilai default adalah -1, yang menetapkan jumlah maksimum coba lagi ke tak terhingga. Kapan tak MaximumRetryAttempts terbatas, Lambda mencoba kembali catatan yang gagal sampai catatan berakhir di sumber acara.

Jenis: Integer

Rentang yang Valid: Nilai minimum -1. Nilai maksimum 10000.

Diperlukan: Tidak

ParallelizationFactor

(Kinesis dan DynamoDB Streams saja) Jumlah batch yang akan diproses secara bersamaan dari setiap pecahan. Nilai default adalah 1.

Tipe: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 10.

Diperlukan: Tidak

Queues

(Amazon MQ) Nama antrean tujuan broker Amazon MQ yang akan digunakan.

Tipe: Array string

Anggota Array: Jumlah tetap 1 item.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 1000.

Pola: [\s\S]*

Diperlukan: Tidak

ScalingConfig

(Hanya Amazon SQS) Konfigurasi penskalaan untuk sumber peristiwa. Untuk informasi selengkapnya, lihat Mengonfigurasi konkurensi maksimum untuk sumber peristiwa Amazon SQS.

Tipe: Objek ScalingConfig

Diperlukan: Tidak

SelfManagedEventSource

Klaster dikelola sendiri Apache Kafka untuk sumber peristiwa Anda.

Tipe: Objek SelfManagedEventSource

Diperlukan: Tidak

SelfManagedKafkaEventSourceConfig

Pengaturan konfigurasi khusus untuk sumber acara Apache Kafka yang dikelola sendiri.

Tipe: Objek SelfManagedKafkaEventSourceConfig

Diperlukan: Tidak

SourceAccessConfigurations

Susunan protokol autentikasi, komponen VPC, atau host virtual untuk mengamankan dan menentukan sumber peristiwa Anda.

Tipe: Array objek SourceAccessConfiguration

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 22 item.

Diperlukan: Tidak

StartingPosition

Posisi dalam pengaliran tempat untuk mulai membaca. Diperlukan untuk sumber acara Amazon Kinesis dan Amazon DynamoDB Stream. AT_TIMESTAMPdidukung hanya untuk aliran Amazon Kinesis, Amazon DocumentDB, Amazon MSK, dan Apache Kafka yang dikelola sendiri.

Jenis: String

Nilai yang Valid: TRIM_HORIZON | LATEST | AT_TIMESTAMP

Diperlukan: Tidak

StartingPositionTimestamp

Dengan StartingPosition diatur keAT_TIMESTAMP, waktu untuk mulai membaca, dalam detik waktu Unix. StartingPositionTimestamptidak bisa di masa depan.

Tipe: Timestamp

Diperlukan: Tidak

State

Status pemetaan sumber peristiwa. Status bisa menjadi salah satu dari berikut: Creating, Enabling, Enabled, Disabling, Disabled, Updating, atau Deleting.

Tipe: String

Wajib: Tidak

StateTransitionReason

Menunjukkan apakah pengguna atau Lambda membuat perubahan terakhir pada pemetaan sumber peristiwa.

Tipe: String

Wajib: Tidak

Topics

Nama topik Kafka.

Tipe: Array string.

Anggota Array: Jumlah tetap 1 item.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 249.

Pola: ^[^.]([a-zA-Z0-9\-_.]+)

Diperlukan: Tidak

TumblingWindowInSeconds

(Hanya Kinesis dan DynamoDB Streams) Durasi dalam detik jendela pemrosesan untuk sumber peristiwa DynamoDB dan Kinesis Streams. Nilai 0 detik menunjukkan tidak ada jendela jatuh.

Tipe: Bilangan Bulat

Rentang yang Valid: Nilai minimum 0. Nilai maksimum 900.

Diperlukan: Tidak

UUID

Pengidentifikasi pemetaan sumber peristiwa.

Tipe: String

Wajib: Tidak

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: