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 mengaturMaximumBatchingWindowInSeconds
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 harusMaximumBatchingWindowInSeconds
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_TIMESTAMP
didukung 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.StartingPositionTimestamp
tidak bisa di masa depan.Tipe: Timestamp
- State
-
Status pemetaan sumber peristiwa. Status bisa menjadi salah satu dari berikut:
Creating
,Enabling
,Enabled
,Disabling
,Disabled
,Updating
, atauDeleting
.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: