GetEventSourceMapping - AWS Lambda

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

GetEventSourceMapping

Mengembalikan detail tentang pemetaan sumber peristiwa. Anda bisa mendapatkan pengidentifikasi pemetaan dari output ListEventSourceMappings.

Sintaks Permintaan

GET /2015-03-31/event-source-mappings/UUID HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

UUID

Pengidentifikasi pemetaan sumber peristiwa.

Wajib: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200 Content-type: application/json { "AmazonManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "BatchSize": number, "BisectBatchOnFunctionError": boolean, "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "DocumentDBEventSourceConfig": { "CollectionName": "string", "DatabaseName": "string", "FullDocument": "string" }, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionArn": "string", "FunctionResponseTypes": [ "string" ], "LastModified": number, "LastProcessingResult": "string", "MaximumBatchingWindowInSeconds": number, "MaximumRecordAgeInSeconds": number, "MaximumRetryAttempts": number, "ParallelizationFactor": number, "Queues": [ "string" ], "ScalingConfig": { "MaximumConcurrency": number }, "SelfManagedEventSource": { "Endpoints": { "string" : [ "string" ] } }, "SelfManagedKafkaEventSourceConfig": { "ConsumerGroupId": "string" }, "SourceAccessConfigurations": [ { "Type": "string", "URI": "string" } ], "StartingPosition": "string", "StartingPositionTimestamp": number, "State": "string", "StateTransitionReason": "string", "Topics": [ "string" ], "TumblingWindowInSeconds": number, "UUID": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AmazonManagedKafkaEventSourceConfig

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

Tipe: Objek AmazonManagedKafkaEventSourceConfig

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.

BisectBatchOnFunctionError

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

Jenis: Boolean

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

DocumentDBEventSourceConfig

Pengaturan konfigurasi khusus untuk sumber acara DocumentDB.

Tipe: Objek DocumentDBEventSourceConfig

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})?:(.*)

FilterCriteria

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

Tipe: Objek FilterCriteria

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-_]+))?

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

LastModified

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

Tipe: Timestamp

LastProcessingResult

Hasil pemanggilan Lambda terakhir dari fungsi Anda.

Jenis: String

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.

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.

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.

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.

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]*

ScalingConfig

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

Tipe: Objek ScalingConfig

SelfManagedEventSource

Klaster dikelola sendiri Apache Kafka untuk sumber peristiwa Anda.

Tipe: Objek SelfManagedEventSource

SelfManagedKafkaEventSourceConfig

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

Tipe: Objek SelfManagedKafkaEventSourceConfig

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.

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

StartingPositionTimestamp

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

Tipe: Timestamp

State

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

Jenis: String

StateTransitionReason

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

Jenis: String

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\-_.]+)

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.

UUID

Pengidentifikasi pemetaan sumber peristiwa.

Jenis: String

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidParameterValueException

Salah satu parameter dalam permintaan tidak valid.

Kode Status HTTP: 400

ResourceNotFoundException

Sumber daya yang ditentukan dalam permintaan tidak ada.

Kode Status HTTP: 404

ServiceException

Layanan AWS Lambda mengalami kesalahan internal.

Kode Status HTTP: 500

TooManyRequestsException

Batas throughput permintaan terlampaui. Untuk informasi lebih lanjut, lihat Kuota Lambda.

Kode Status HTTP: 429

Lihat Juga

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