Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagaimana Lambda memproses catatan dari sumber acara berbasis streaming dan antrian
*Pemetaan sumber peristiwa* adalah sumber daya Lambda yang membaca item dari layanan berbasis streaming dan antrian dan memanggil fungsi dengan kumpulan catatan. Dalam pemetaan sumber peristiwa, sumber daya yang disebut *poller acara secara aktif melakukan polling* untuk pesan baru dan memanggil fungsi. Secara default, Lambda secara otomatis menskalakan poller peristiwa, tetapi untuk jenis sumber peristiwa tertentu, Anda dapat menggunakan [mode yang disediakan](#invocation-eventsourcemapping-provisioned-mode) untuk mengontrol jumlah minimum dan maksimum poller acara yang didedikasikan untuk pemetaan sumber acara Anda.
Layanan berikut menggunakan pemetaan sumber peristiwa untuk menjalankan fungsi Lambda:
+ [Amazon DocumentDB (dengan kompatibilitas MongoDB) (Amazon DocumentDB)](with-documentdb.md)
+ [Amazon DynamoDB](with-ddb.md)
+ [Amazon Kinesis](with-kinesis.md)
+ [Amazon MQ](with-mq.md)
+ [Amazon Managed Streaming for Apache Kafka (Amazon MSK)](with-msk.md)
+ [Apache Kafka yang dikelola sendiri](with-kafka.md)
+ [Amazon Simple Queue Service](with-sqs.md) (Amazon SQS)
**Awas**
Pemetaan sumber peristiwa Lambda memproses setiap peristiwa setidaknya sekali, dan pemrosesan duplikat catatan dapat terjadi. Untuk menghindari potensi masalah yang terkait dengan duplikat peristiwa, kami sangat menyarankan agar Anda membuat kode fungsi Anda idempoten. Untuk mempelajari lebih lanjut, lihat [Bagaimana cara membuat fungsi Lambda saya idempoten](https://repost.aws/knowledge-center/lambda-function-idempotent) di Pusat Pengetahuan. AWS
## Bagaimana pemetaan sumber peristiwa berbeda dari pemicu langsung
*Beberapa Layanan AWS dapat langsung memanggil fungsi Lambda menggunakan pemicu.* Layanan ini mendorong peristiwa ke Lambda, dan fungsi segera dipanggil saat peristiwa yang ditentukan terjadi. Pemicu cocok untuk peristiwa diskrit dan pemrosesan waktu nyata. Saat Anda [membuat pemicu menggunakan konsol Lambda, konsol](lambda-services.md#lambda-invocation-trigger) berinteraksi dengan AWS layanan terkait untuk mengonfigurasi pemberitahuan peristiwa pada layanan tersebut. Pemicunya sebenarnya disimpan dan dikelola oleh layanan yang menghasilkan peristiwa, bukan oleh Lambda. Berikut adalah beberapa contoh layanan yang menggunakan pemicu untuk menjalankan fungsi Lambda:
+ **Amazon Simple Storage Service (Amazon S3)**: Memanggil fungsi saat objek dibuat, dihapus, atau dimodifikasi dalam bucket. Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan pemicu Amazon S3 untuk memanggil fungsi Lambda](with-s3-example.md).
+ **Amazon Simple Notification Service (Amazon SNS)**: Memanggil fungsi saat pesan dipublikasikan ke topik SNS. Untuk informasi selengkapnya, lihat [Tutorial: Menggunakan AWS Lambda dengan Amazon Simple Notification Service](with-sns-example.md).
+ **Amazon API Gateway:** Memanggil fungsi saat permintaan API dibuat ke titik akhir tertentu. Untuk informasi selengkapnya, lihat [Memanggil fungsi Lambda menggunakan titik akhir Amazon API Gateway](services-apigateway.md).
Pemetaan sumber peristiwa adalah sumber daya Lambda yang dibuat dan dikelola dalam layanan Lambda. Pemetaan sumber peristiwa dirancang untuk memproses data streaming volume tinggi atau pesan dari antrian. Memproses catatan dari aliran atau antrian dalam batch lebih efisien daripada memproses catatan secara individual.
## Perilaku batching
Secara default, pemetaan sumber peristiwa mengumpulkan catatan bersama menjadi satu muatan yang dikirim Lambda ke fungsi Anda. Untuk menyempurnakan perilaku batching, Anda dapat mengonfigurasi jendela batching ([MaximumBatchingWindowInSeconds](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html#lambda-CreateEventSourceMapping-request-MaximumBatchingWindowInSeconds)) dan ukuran batch (). [BatchSize](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html#lambda-CreateEventSourceMapping-response-BatchSize) Jendela batching adalah jumlah waktu maksimum untuk mengumpulkan catatan ke dalam satu muatan. Ukuran batch adalah jumlah maksimum catatan dalam satu batch. Lambda memanggil fungsi Anda ketika salah satu dari tiga kriteria berikut terpenuhi:
+ **Jendela batching mencapai nilai maksimumnya.** Perilaku jendela batching default bervariasi tergantung pada sumber peristiwa tertentu.
+ **Untuk sumber peristiwa Kinesis, DynamoDB, dan Amazon SQS: Jendela batching default** adalah 0 detik. Ini berarti bahwa Lambda memanggil fungsi Anda segera setelah catatan tersedia. Untuk mengatur jendela batching, konfigurasikan`MaximumBatchingWindowInSeconds`. Anda dapat mengatur parameter ini ke nilai apa pun dari 0 hingga 300 detik dengan penambahan 1 detik. Jika Anda mengonfigurasi jendela batching, jendela berikutnya dimulai segera setelah pemanggilan fungsi sebelumnya selesai.
+ **Untuk Amazon MSK, sumber acara Apache Kafka, Amazon MQ, dan Amazon DocumentDB yang dikelola sendiri: Jendela batching default adalah 500** ms. Anda dapat mengonfigurasi `MaximumBatchingWindowInSeconds` ke nilai apa pun dari 0 detik hingga 300 detik dengan penambahan detik. Dalam mode yang disediakan untuk pemetaan sumber acara Kafka, saat Anda mengonfigurasi jendela batching, jendela berikutnya dimulai segera setelah batch sebelumnya selesai. Dalam pemetaan sumber peristiwa Kafka yang tidak disediakan, saat Anda mengonfigurasi jendela batching, jendela berikutnya dimulai segera setelah pemanggilan fungsi sebelumnya selesai. Untuk meminimalkan latensi saat menggunakan pemetaan sumber peristiwa Kafka dalam mode yang disediakan, setel ke 0. `MaximumBatchingWindowInSeconds` Pengaturan ini memastikan bahwa Lambda akan mulai memproses batch berikutnya segera setelah menyelesaikan pemanggilan fungsi saat ini. Untuk informasi tambahan tentang pemrosesan latensi rendah, lihat[Latensi rendah Apache Kafka](with-kafka-low-latency.md).
+ **Untuk sumber acara Amazon MQ dan Amazon DocumentDB: Jendela** batching default adalah 500 ms. Anda dapat mengonfigurasi `MaximumBatchingWindowInSeconds` ke nilai apa pun dari 0 detik hingga 300 detik dengan penambahan detik. Jendela batching dimulai segera setelah rekor pertama tiba.
**catatan**
Karena Anda hanya dapat mengubah `MaximumBatchingWindowInSeconds` dalam beberapa 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.
+ **Ukuran batch terpenuhi.** Ukuran batch minimum adalah 1. Ukuran batch default dan maksimum bergantung pada sumber acara. Untuk detail tentang nilai-nilai ini, lihat [BatchSize](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html#lambda-CreateEventSourceMapping-request-BatchSize)spesifikasi untuk operasi `CreateEventSourceMapping` API.
+ **Ukuran payload mencapai [6 MB](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).** Anda tidak dapat mengubah batas ini.
Diagram berikut menggambarkan ketiga kondisi ini. Misalkan jendela batching dimulai pada `t = 7` detik. Dalam skenario pertama, jendela batching mencapai maksimum 40 detik dalam `t = 47` hitungan detik setelah mengumpulkan 5 catatan. Dalam skenario kedua, ukuran batch mencapai 10 sebelum jendela batching berakhir, sehingga jendela batching berakhir lebih awal. Dalam skenario ketiga, ukuran muatan maksimum tercapai sebelum jendela batching berakhir, sehingga jendela batching berakhir lebih awal.
![\[\]](http://docs.aws.amazon.com/id_id/lambda/latest/dg/images/batching-window.png)
Kami menyarankan Anda menguji dengan ukuran batch dan rekaman yang berbeda sehingga frekuensi polling dari setiap sumber acara disetel ke seberapa cepat fungsi Anda dapat menyelesaikan tugasnya. [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html)`BatchSize`Parameter mengontrol jumlah maksimum catatan yang dapat dikirim ke fungsi Anda dengan setiap pemanggilan. Ukuran batch yang lebih besar sering kali dapat menyerap overhead secara lebih efisien di serangkaian catatan yang lebih besar, sehingga meningkatkan throughput Anda.
Lambda tidak menunggu [ekstensi](lambda-extensions.md) yang dikonfigurasi selesai sebelum mengirim batch berikutnya untuk diproses. Dengan kata lain, ekstensi Anda dapat terus berjalan saat Lambda memproses kumpulan catatan berikutnya. Hal ini dapat menyebabkan masalah pembatasan jika Anda melanggar pengaturan atau [batasan konkurensi](lambda-concurrency.md) akun Anda. Untuk mendeteksi apakah ini merupakan masalah potensial, pantau fungsi Anda dan periksa apakah Anda melihat [metrik konkurensi](monitoring-concurrency.md#general-concurrency-metrics) yang lebih tinggi dari yang diharapkan untuk pemetaan sumber peristiwa Anda. Karena waktu yang singkat di antara pemanggilan, Lambda mungkin secara singkat melaporkan penggunaan konkurensi yang lebih tinggi daripada jumlah pecahan. Ini bisa benar bahkan untuk fungsi Lambda tanpa ekstensi.
Secara default, jika fungsi Anda mengembalikan kesalahan, pemetaan sumber peristiwa memproses ulang seluruh batch hingga fungsi berhasil, atau item dalam batch kedaluwarsa. Untuk memastikan pemrosesan dalam urutan, pemetaan sumber peristiwa menghentikan pemrosesan untuk pecahan yang terpengaruh hingga kesalahan teratasi. Untuk sumber aliran (DynamoDB dan Kinesis), Anda dapat mengonfigurasi jumlah maksimum kali Lambda mencoba ulang saat fungsi Anda mengembalikan kesalahan. Kesalahan layanan atau throttle di mana batch tidak mencapai fungsi Anda tidak diperhitungkan dalam upaya coba lagi. Anda juga dapat mengonfigurasi pemetaan sumber peristiwa untuk mengirim catatan pemanggilan ke [tujuan](invocation-async-retain-records.md#invocation-async-destinations) saat membuang kumpulan peristiwa.
## Mode yang disediakan
Pemetaan sumber acara Lambda menggunakan poller acara untuk polling sumber acara Anda untuk pesan baru. Secara default, Lambda mengelola penskalaan otomatis poller ini berdasarkan volume pesan. Ketika lalu lintas pesan meningkat, Lambda secara otomatis meningkatkan jumlah poller acara untuk menangani beban, dan menguranginya saat lalu lintas menurun.
Dalam mode yang disediakan, Anda dapat menyempurnakan throughput pemetaan sumber acara Anda dengan menentukan batas minimum dan maksimum untuk sumber daya polling khusus yang tetap siap menangani pola lalu lintas yang diharapkan. Sumber daya ini secara otomatis menskalakan 3 kali lebih cepat untuk menangani lonjakan tiba-tiba dalam lalu lintas acara dan menyediakan kapasitas 16 kali lebih tinggi untuk memproses jutaan peristiwa. Ini membantu Anda membangun beban kerja berbasis peristiwa yang sangat responsif dengan persyaratan performa yang ketat.
Di Lambda, poller peristiwa adalah unit komputasi dengan kemampuan throughput yang bervariasi menurut jenis sumber peristiwa. Untuk Amazon MSK dan Apache Kafka yang dikelola sendiri, setiap poller acara dapat menangani hingga 5 throughput atau hingga 5 MB/sec pemanggilan bersamaan. Misalnya, jika sumber acara Anda menghasilkan payload rata-rata 1 MB dan durasi rata-rata fungsi Anda adalah 1 detik, satu poller acara Kafka dapat mendukung 5 MB/sec throughput dan 5 pemanggilan Lambda bersamaan (dengan asumsi tidak ada transformasi payload). Untuk Amazon SQS, setiap poller peristiwa dapat menangani hingga 1 throughput atau hingga MB/sec 10 pemanggilan bersamaan. Menggunakan mode yang disediakan menimbulkan biaya tambahan berdasarkan penggunaan poller acara Anda. Untuk detail harganya, lihat [Harga AWS Lambda](https://aws.amazon.com/lambda/pricing/).
Mode yang disediakan tersedia untuk Amazon MSK, Apache Kafka yang dikelola sendiri, dan sumber acara Amazon SQS. Meskipun pengaturan konkurensi memberi Anda kontrol atas penskalaan fungsi Anda, mode yang disediakan memberi Anda kontrol atas throughput pemetaan sumber peristiwa Anda. Untuk memastikan kinerja maksimum, Anda mungkin perlu menyesuaikan kedua pengaturan secara independen.
Mode yang disediakan sangat ideal untuk aplikasi real-time yang membutuhkan latensi pemrosesan peristiwa yang konsisten, seperti perusahaan jasa keuangan yang memproses umpan data pasar, platform e-commerce yang memberikan rekomendasi yang dipersonalisasi secara real-time, dan perusahaan game yang mengelola interaksi pemain langsung.
Setiap poller acara mendukung kapasitas throughput yang berbeda:
+ Untuk Amazon MSK dan Apache Kafka yang dikelola sendiri: hingga 5 throughput atau hingga 5 MB/sec pemanggilan bersamaan
+ Untuk Amazon SQS: hingga 1 throughput atau hingga 10 MB/sec pemanggilan bersamaan atau hingga 10 panggilan API polling SQS per detik.
Untuk pemetaan sumber peristiwa Amazon SQS, Anda dapat mengatur jumlah minimum poller antara 2 dan 200 dengan default 2, dan jumlah maksimum antara 2 dan 2.000 dengan default 200. Lambda menskalakan jumlah poller acara antara minimum dan maksimum yang dikonfigurasi, dengan cepat menambahkan hingga 1.000 konkurensi per menit untuk memberikan pemrosesan acara Anda yang konsisten dan latensi rendah.
Untuk pemetaan sumber acara Kafka, Anda dapat mengatur jumlah minimum poller antara 1 dan 200 dengan default 1, dan jumlah maksimum antara 1 dan 2.000 dengan default 200. Lambda menskalakan jumlah poller acara antara minimum dan maksimum yang dikonfigurasi berdasarkan backlog acara Anda dalam topik Anda untuk memberikan pemrosesan latensi rendah dari acara Anda.
Perhatikan bahwa untuk sumber peristiwa Amazon SQS, setelan konkurensi maksimum tidak dapat digunakan dengan mode yang disediakan. Saat menggunakan mode yang disediakan, Anda mengontrol konkurensi melalui pengaturan poller peristiwa maksimum.
Untuk detail tentang mengonfigurasi mode yang disediakan, lihat bagian berikut:
+ [Mengonfigurasi mode yang disediakan untuk pemetaan sumber peristiwa MSK Amazon](kafka-scaling-modes.md)
+ [Mengkonfigurasi mode yang disediakan untuk pemetaan sumber acara Apache Kafka yang dikelola sendiri](kafka-scaling-modes.md#kafka-provisioned-mode)
+ [Menggunakan mode yang disediakan dengan pemetaan sumber peristiwa Amazon SQS](with-sqs.md#sqs-provisioned-mode)
Untuk meminimalkan latensi dalam mode yang disediakan, atur `MaximumBatchingWindowInSeconds` ke 0. Pengaturan ini memastikan bahwa Lambda akan mulai memproses batch berikutnya segera setelah menyelesaikan pemanggilan fungsi saat ini. Untuk informasi tambahan tentang pemrosesan latensi rendah, lihat[Latensi rendah Apache Kafka](with-kafka-low-latency.md).
Setelah mengonfigurasi mode yang disediakan, Anda dapat mengamati penggunaan poller peristiwa untuk beban kerja Anda dengan memantau metrik. `ProvisionedPollers` Untuk informasi selengkapnya, lihat [Metrik pemetaan sumber acara](monitoring-metrics-types.md#event-source-mapping-metrics).
## API pemetaan sumber kejadian
Untuk mengelola sumber peristiwa dengan [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) atau [AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/), Anda dapat menggunakan operasi API berikut:
+ [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html)
+ [ListEventSourceMappings](https://docs.aws.amazon.com/lambda/latest/api/API_ListEventSourceMappings.html)
+ [GetEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_GetEventSourceMapping.html)
+ [UpdateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_UpdateEventSourceMapping.html)
+ [DeleteEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_DeleteEventSourceMapping.html)
# Menggunakan tag pada pemetaan sumber acara
Anda dapat menandai pemetaan sumber peristiwa untuk mengatur dan mengelola sumber daya Anda. Tag adalah pasangan nilai kunci bentuk bebas yang terkait dengan sumber daya Anda yang didukung secara keseluruhan. Layanan AWS Untuk informasi selengkapnya tentang kasus penggunaan tag, lihat [Strategi penandaan umum](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies) di * AWS Sumber Daya Penandaan dan Panduan Editor Tag*.
Pemetaan sumber peristiwa dikaitkan dengan fungsi, yang dapat memiliki tag sendiri. Pemetaan sumber peristiwa tidak secara otomatis mewarisi tag dari fungsi. Anda dapat menggunakan AWS Lambda API untuk melihat dan memperbarui tag. Anda juga dapat melihat dan memperbarui tag saat mengelola pemetaan sumber peristiwa tertentu di konsol Lambda, termasuk yang menggunakan Mode Terketentuan untuk Amazon SQS.
## Izin diperlukan untuk bekerja dengan tag
Untuk mengizinkan identitas AWS Identity and Access Management (IAM) (pengguna, grup, atau peran) membaca atau menyetel tag pada sumber daya, berikan izin yang sesuai:
+ **lambda: ListTags** —Ketika sumber daya memiliki tag, berikan izin ini kepada siapa saja yang perlu memanggilnya`ListTags`. Untuk fungsi yang ditandai, izin ini juga diperlukan untuk`GetFunction`.
+ **lambda: TagResource** —Berikan izin ini kepada siapa saja yang perlu memanggil `TagResource` atau melakukan tag saat membuat.
Secara opsional, pertimbangkan untuk memberikan UntagResource izin **lambda:** juga untuk mengizinkan `UntagResource` panggilan ke sumber daya.
Untuk informasi selengkapnya, lihat [Kebijakan IAM berbasis identitas untuk Lambda](access-control-identity-based.md).
## Menggunakan tag dengan konsol Lambda
Anda dapat menggunakan konsol Lambda untuk membuat pemetaan sumber peristiwa yang memiliki tag, menambahkan tag ke pemetaan sumber peristiwa yang ada, dan memfilter pemetaan sumber peristiwa berdasarkan tag, termasuk yang dikonfigurasi dalam Mode Tertentu untuk Amazon SQS.
Saat Anda menambahkan pemicu untuk layanan berbasis streaming dan antrian yang didukung menggunakan konsol Lambda, Lambda secara otomatis membuat pemetaan sumber peristiwa. Untuk informasi lebih lanjut tentang sumber acara ini, lihat[Bagaimana Lambda memproses catatan dari sumber acara berbasis streaming dan antrian](invocation-eventsourcemapping.md). Untuk membuat pemetaan sumber peristiwa di konsol, Anda memerlukan prasyarat berikut:
+ Sebuah fungsi.
+ Sumber peristiwa dari layanan yang terpengaruh.
Anda dapat menambahkan tag sebagai bagian dari antarmuka pengguna yang sama yang Anda gunakan untuk membuat atau memperbarui pemicu.
**Untuk menambahkan tag saat Anda membuat pemetaan sumber peristiwa**
1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.
1. Pilih nama fungsi Anda.
1. Di bagian **Gambaran umum fungsi**, pilih **Tambah pemicu**.
1. Di bawah **konfigurasi Trigger**, dalam daftar dropdown, pilih nama layanan sumber acara Anda berasal.
1. Berikan konfigurasi inti untuk sumber acara Anda. Untuk informasi selengkapnya tentang mengonfigurasi sumber acara Anda, lihat bagian untuk layanan terkait di[Memanggil Lambda dengan acara dari layanan lain AWS](lambda-services.md).
1. Di bawah **Konfigurasi pemetaan sumber peristiwa**, pilih **Pengaturan tambahan**.
1. Di bawah **Tag**, pilih **Tambahkan tag baru**
1. Di bidang **Key**, masukkan kunci tag Anda. Untuk informasi tentang pembatasan penandaan, lihat [Batas dan persyaratan penamaan tag](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) di Panduan * AWS Sumber Daya Penandaan dan Editor Tag*.
1. Pilih **Tambahkan**.
**Untuk menambahkan tag ke pemetaan sumber peristiwa yang ada**
1. Buka [pemetaan sumber Acara di konsol Lambda](https://console.aws.amazon.com/lambda/home#/event-source-mappings).
1. Dari daftar sumber daya, pilih **UUID** untuk pemetaan sumber peristiwa yang sesuai dengan ARN **sumber** **Fungsi** dan Acara Anda.
1. Dari daftar tab di bawah **panel konfigurasi Umum**, pilih **Tag**.
1. Pilih **Kelola tanda**.
1. Pilih **Tambahkan tag baru**.
1. Di bidang **Key**, masukkan kunci tag Anda. Untuk informasi tentang pembatasan penandaan, lihat [Batas dan persyaratan penamaan tag](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) di Panduan * AWS Sumber Daya Penandaan dan Editor Tag*.
1. Pilih **Simpan**.
**Untuk memfilter pemetaan sumber peristiwa berdasarkan tag**
1. Buka [pemetaan sumber Acara di konsol Lambda](https://console.aws.amazon.com/lambda/home#/event-source-mappings).
1. Pilih kotak pencarian.
1. Dari daftar dropdown, pilih kunci tag Anda dari bawah subjudul **Tag**.
1. Pilih **Gunakan: “tag-name”** untuk melihat semua pemetaan sumber peristiwa yang ditandai dengan kunci ini, atau pilih **Operator** untuk memfilter lebih lanjut berdasarkan nilai.
1. Pilih nilai tag Anda untuk difilter dengan kombinasi kunci tag dan nilai.
Kotak pencarian juga mendukung pencarian kunci tag. Masukkan nama kunci untuk menemukannya dalam daftar.
## Menggunakan tag dengan AWS CLI
Anda dapat menambahkan dan menghapus tag pada resource Lambda yang ada, termasuk pemetaan sumber peristiwa, dengan API Lambda. Anda juga dapat menambahkan tag saat membuat pemetaan sumber peristiwa, yang memungkinkan Anda menyimpan sumber daya yang ditandai melalui seluruh siklus hidupnya.
### Memperbarui tag dengan tag Lambda APIs
Anda dapat menambahkan dan menghapus tag untuk sumber daya Lambda yang didukung melalui operasi [TagResource](https://docs.aws.amazon.com/lambda/latest/api/API_TagResource.html)dan [UntagResource](https://docs.aws.amazon.com/lambda/latest/api/API_UntagResource.html)API.
Anda dapat memanggil operasi ini menggunakan AWS CLI. Untuk menambahkan tag ke sumber daya yang ada, gunakan `tag-resource` perintah. Contoh ini menambahkan dua tag, satu dengan kunci *Department* dan satu dengan kunci*CostCenter*.
```
aws lambda tag-resource \
--resource arn:aws:lambda:us-east-2:123456789012:resource-type:my-resource \
--tags Department=Marketing,CostCenter=1234ABCD
```
Untuk menghapus tanda, gunakan perintah `untag-resource`. Contoh ini menghapus tag dengan kunci*Department*.
```
aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department
```
### Menambahkan tag saat Anda membuat pemetaan sumber peristiwa
Untuk membuat pemetaan sumber peristiwa Lambda baru dengan tag, gunakan operasi API. [CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html) Tentukan parameter `Tags`. Anda dapat memanggil operasi ini dengan `create-event-source-mapping` AWS CLI perintah dan `--tags` opsi. *Untuk informasi selengkapnya tentang perintah CLI, lihat [create-event-source-mapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-event-source-mapping.html)di Command Reference AWS CLI .*
Sebelum menggunakan `Tags` parameter dengan`CreateEventSourceMapping`, pastikan bahwa peran Anda memiliki izin untuk menandai sumber daya bersama izin yang biasa diperlukan untuk operasi ini. Untuk informasi selengkapnya tentang izin untuk menandai, lihat. [Izin diperlukan untuk bekerja dengan tag](#esm-tags-required-permissions)
### Melihat tag dengan tag Lambda APIs
Untuk melihat tag yang diterapkan ke sumber daya Lambda tertentu, gunakan operasi `ListTags` API. Untuk informasi selengkapnya, lihat [ListTags](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html).
Anda dapat memanggil operasi ini dengan `list-tags` AWS CLI perintah dengan memberikan ARN (Nama Sumber Daya Amazon).
```
aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier
```
### Memfilter sumber daya berdasarkan tag
Anda dapat menggunakan operasi AWS Resource Groups Tagging API [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)API untuk memfilter sumber daya berdasarkan tag. `GetResources`Operasi menerima hingga 10 filter, dengan setiap filter berisi kunci tag dan hingga 10 nilai tag. Anda `GetResources` menyediakan `ResourceType` untuk memfilter berdasarkan jenis sumber daya tertentu.
Anda dapat memanggil operasi ini menggunakan `get-resources` AWS CLI perintah. Untuk contoh penggunaan`get-resources`, lihat [mendapatkan sumber daya di Referensi](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html#examples) Perintah *AWS CLI*.