View a markdown version of this page

Menggunakan tag pada fungsi Lambda - AWS Lambda

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

Menggunakan tag pada fungsi Lambda

Anda dapat menandai fungsi untuk mengatur dan mengelola sumber daya Anda. Tag adalah pasangan kunci-nilai bentuk bebas yang terkait dengan sumber daya Anda yang didukung di seluruh. Layanan AWS Untuk informasi selengkapnya tentang kasus penggunaan tag, lihat Strategi penandaan umum dalam Panduan Penand aan Sumber AWS Daya dan Tag Editor.

Tanda berlaku pada tingkat fungsi, bukan pada versi atau alias. Tag bukan bagian dari konfigurasi khusus versi yang membuat AWS Lambda snapshot saat Anda menerbitkan versi. Anda dapat menggunakan API Lambda untuk melihat dan memperbarui tag. Anda juga dapat melihat dan memperbarui tag sambil mengelola fungsi tertentu di konsol Lambda.

Anda juga dapat menggunakan tag untuk mengontrol akses ke fungsi Anda dengan kontrol akses berbasis atribut (ABAC). Untuk informasi selengkapnya, lihat Menggunakan kontrol akses berbasis atribut di Lambda.

Izin diperlukan untuk bekerja dengan tag

Untuk mengiz AWS Identity and Access Management inkan identitas (IAM) (pengguna, grup, atau peran) membaca atau menetapkan 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 Identity-based Kebijakan IAM untuk Lambda.

Menggunakan tag dengan konsol Lambda

Anda dapat menggunakan konsol Lambda untuk membuat fungsi yang memiliki tag, menambahkan tag ke fungsi yang ada, dan memfilter fungsi berdasarkan tag yang Anda tambahkan.

Untuk menambahkan tag saat Anda membuat fungsi
  1. Buka halaman Fungsi di konsol Lambda.

  2. Pilih Buat fungsi.

  3. Pilih Penulis dari awal atau gambar kontainer.

  4. Di bawah Informasi dasar, atur fungsi Anda. Untuk informasi selengkapnya tentang mengkonfigurasi fungsi, lihatMelakukan konfigurasi AWS Lambda fungsi.

  5. Perluas Pengaturan lanj utan, lalu pilih Aktifkan tag.

  6. Pilih Tambahkan tag baru, lalu masukkan K unci dan Nilai opsional. Untuk menambahkan lebih banyak tag, ulangi langkah ini.

  7. Pilih Buat fungsi.

Untuk menambahkan tag ke fungsi yang ada
  1. Buka Halaman fungsi di konsol Lambda.

  2. Pilih nama sebuah fungsi.

  3. Pilih Konfigur asi, lalu pilih Tag.

  4. Di bagian Tanda, pilih Kelola tanda.

  5. Pilih Tambahkan tag baru, lalu masukkan K unci dan Nilai opsional. Untuk menambahkan lebih banyak tag, ulangi langkah ini.

  6. Pilih Simpan.

Untuk memfilter fungsi dengan tag
  1. Buka halaman Fungsi di konsol Lambda.

  2. Pilih kotak pencarian untuk melihat daftar properti fungsi dan kunci tag.

  3. Pilih kunci tag untuk melihat daftar nilai yang digunakan di Wil AWS ayah saat ini.

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

  5. Pilih nilai tag Anda untuk difilter berdasarkan kombinasi kunci tag dan nilai.

Bilah pencarian juga mendukung pencarian kunci tanda. Masukkan tag untuk melihat hanya daftar kunci tag, atau masukkan nama kunci untuk menemukannya dalam daftar.

Menggunakan tag dengan AWS CLI

Anda dapat menambah dan menghapus tag pada sumber daya Lambda yang ada, termasuk fungsi, dengan Lambda API. Anda juga dapat menambahkan tag saat membuat fungsi, untuk menjaga agar sumber daya tetap ditandai melalui seluruh siklus hidupnya.

Memperbarui tag dengan API tag Lambda

Anda dapat menambahkan dan menghapus tag untuk sumber daya Lambda yang didukung melalui operasi TagResource dan UntagResource 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 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 membuat fungsi

Untuk membuat fungsi Lambda baru dengan tag, gunakan operasi CreateFunction API. Tentukan parameter Tags. Anda dapat memanggil operasi ini dengan perintah create-function CLI dan opsi --tags.

Sebelum menggunakan parameter tag denganCreateFunction, pastikan peran Anda memiliki izin untuk menandai sumber daya di samping izin biasa yang diperlukan untuk operasi ini. Untuk informasi selengkapnya tentang izin untuk penandaan, lihatIzin diperlukan untuk bekerja dengan tag. Contoh ini menambahkan dua tag, satu dengan kunci Department dan satu dengan kunciCostCenter.

aws lambda create-function --function-name my-function --handler index.js --runtime nodejs24.x \ --role arn:aws:iam::123456789012:role/lambda-role \ --tags Department=Marketing,CostCenter=1234ABCD

Melihat tag pada suatu fungsi

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

Anda dapat melihat tag yang diterapkan ke sumber daya tertentu dengan operasi GetFunction API. Fungsionalitas yang sebanding tidak tersedia untuk jenis sumber daya lainnya.

Anda dapat memanggil operasi ini dengan perintah get-function CLI:

aws lambda get-function --function-name my-function

Memfilter sumber daya berdasarkan tag

Anda dapat menggunakan operasi AWS Resource Groups Tagging API GetResources API untuk memfilter sumber daya berdasarkan tag. GetResourcesOperasi menerima hingga 10 filter, dengan setiap filter berisi kunci tag dan hingga 10 nilai tag. Anda menyediakan GetResources ResourceType untuk memfilter berdasarkan jenis sumber daya tertentu.

Anda dapat memanggil operasi ini menggunakan get-resources AWS CLI perintah. Untuk contoh penggunaanget-resources, lihat get-resources di Referensi Perintah AWS CLI.