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 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.

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 memanggilnyaListTags. Untuk fungsi yang ditandai, izin ini juga diperlukan untukGetFunction.

• 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.

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.

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, lihatBagaimana Lambda memproses catatan dari sumber acara berbasis streaming dan antrian. 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 di konsol Lambda.

2. Pilih nama fungsi Anda.

3. Di bagian Gambaran umum fungsi, pilih Tambah pemicu.

4. Di bawah konfigurasi Trigger, dalam daftar dropdown, pilih nama layanan sumber acara Anda berasal.

5. Berikan konfigurasi inti untuk sumber acara Anda. Untuk informasi selengkapnya tentang mengonfigurasi sumber acara Anda, lihat bagian untuk layanan terkait diMemanggil Lambda dengan acara dari layanan lain AWS.

6. Di bawah Konfigurasi pemetaan sumber peristiwa, pilih Pengaturan tambahan.

7. Di bawah Tag, pilih Tambahkan tag baru

8. Di bidang Key, masukkan kunci tag Anda. Untuk informasi tentang pembatasan penandaan, lihat Batas dan persyaratan penamaan tag di Panduan AWS Sumber Daya Penandaan dan Editor Tag.

9. Pilih Tambahkan.

Untuk menambahkan tag ke pemetaan sumber peristiwa yang ada

1. Buka pemetaan sumber Acara di konsol Lambda.

2. Dari daftar sumber daya, pilih UUID untuk pemetaan sumber peristiwa yang sesuai dengan ARN sumber Fungsi dan Acara Anda.

3. Dari daftar tab di bawah panel konfigurasi Umum, pilih Tag.

4. Pilih Kelola tanda.

5. Pilih Tambahkan tag baru.

6. Di bidang Key, masukkan kunci tag Anda. Untuk informasi tentang pembatasan penandaan, lihat Batas dan persyaratan penamaan tag di Panduan AWS Sumber Daya Penandaan dan Editor Tag.

7. Pilih Simpan.

Untuk memfilter pemetaan sumber peristiwa berdasarkan tag

1. Buka pemetaan sumber Acara di konsol Lambda.

2. Pilih kotak pencarian.

3. Dari daftar dropdown, pilih kunci tag Anda dari bawah subjudul Tag.

4. Pilih Gunakan: “tag-name” untuk melihat semua pemetaan sumber peristiwa yang ditandai dengan kunci ini, atau pilih Operator untuk memfilter lebih lanjut berdasarkan nilai.

5. 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 sumber daya 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 TagResourcedan UntagResourceAPI.

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 kunciCostCenter.

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 kunciDepartment.

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 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-mappingdi Command Reference AWS CLI .

Sebelum menggunakan Tags parameter denganCreateEventSourceMapping, pastikan bahwa peran Anda memiliki izin untuk menandai sumber daya bersama izin yang biasa diperlukan untuk operasi ini. Untuk informasi selengkapnya tentang izin untuk penandaan, lihat. Izin diperlukan untuk bekerja dengan tag

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.

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 GetResourcesAPI untuk memfilter sumber daya Anda berdasarkan tag. GetResourcesOperasi 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 penggunaanget-resources, lihat mendapatkan sumber daya di Referensi Perintah AWS CLI.