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 nilai kunci 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 di AWS Sumber Daya Penandaan dan Panduan Editor Tag.

Tanda berlaku pada tingkat fungsi, bukan pada versi atau alias. Tag bukan bagian dari konfigurasi khusus versi yang AWS Lambda membuat snapshot saat Anda memublikasikan versi. Anda dapat menggunakan Lambda API untuk melihat dan memperbarui tag. Anda juga dapat melihat dan memperbarui tag sambil mengelola fungsi 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.

Untuk informasi selengkapnya, lihat Kebijakan berbasis identitas 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 Author dari awal atau gambar Container.

  4. Di bawah Informasi dasar, atur fungsi Anda. Untuk informasi selengkapnya tentang mengonfigurasi fungsi, lihatMengkonfigurasi fungsi AWS Lambda.

  5. Perluas Pengaturan lanjutan, lalu pilih Aktifkan tag.

  6. Pilih Tambahkan tag baru, lalu masukkan Kunci 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 Konfigurasi, lalu pilih Tag.

  4. Di bagian Tanda, pilih Kelola tanda.

  5. Pilih Tambahkan tag baru, lalu masukkan Kunci 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 tombol tag.

  3. Pilih kunci tag untuk melihat daftar nilai yang sedang digunakan di AWS Wilayah saat ini.

  4. Pilih Gunakan: “tag-name” untuk melihat semua fungsi 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.

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 menambahkan dan menghapus tag pada sumber daya Lambda yang ada, termasuk fungsi, dengan Lambda. API Anda juga dapat menambahkan tag saat membuat fungsi, 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 TagResourcedan UntagResourceAPIoperasi.

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 kuncinya 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 membuat fungsi

Untuk membuat fungsi Lambda baru dengan tag, gunakan operasi. CreateFunctionAPI Tentukan parameter Tags. Anda dapat memanggil operasi ini dengan create-function CLI perintah dan opsi --tags. Sebelum menggunakan parameter tag denganCreateFunction, 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 Contoh ini menambahkan dua tag, satu dengan kunci Department dan satu dengan kuncinya CostCenter.

aws lambda create-function --function-name my-function --handler index.js --runtime nodejs20.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 lebih lanjut, 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 GetFunctionAPIoperasi. Fungsionalitas yang sebanding tidak tersedia untuk jenis sumber daya lainnya.

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

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

Memfilter sumber daya berdasarkan tag

Anda dapat menggunakan AWS Resource Groups Tagging API GetResourcesAPIoperasi untuk memfilter sumber daya Anda dengan 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 get-resources di AWS CLICommand Reference.