Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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*.