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 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*.
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 API Lambda untuk melihat dan memperbarui tag. Anda juga dapat melihat dan memperbarui tag sambil mengelola fungsi tertentu di konsol Lambda.
**Topics**
+ [Izin diperlukan untuk bekerja dengan tag](#fxn-tags-required-permissions)
+ [Menggunakan tag dengan konsol Lambda](#using-tags-with-the-console)
+ [Menggunakan tag dengan AWS CLI](#configuration-tags-cli)
## 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 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](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.
1. Pilih **Buat fungsi**.
1. Pilih **Author dari awal** atau **gambar Container**.
1. Di bawah **Informasi dasar**, atur fungsi Anda. Untuk informasi selengkapnya tentang mengonfigurasi fungsi, lihat[Mengkonfigurasi fungsi AWS Lambda](lambda-functions.md).
1. Perluas **Pengaturan lanjutan**, lalu pilih **Aktifkan tag**.
1. Pilih **Tambahkan tag baru**, lalu masukkan **Kunci** dan **Nilai** opsional. Untuk menambahkan lebih banyak tag, ulangi langkah ini.
1. Pilih **Buat fungsi**.
**Untuk menambahkan tag ke fungsi yang ada**
1. Buka [Halaman fungsi](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.
1. Pilih nama sebuah fungsi.
1. Pilih **Konfigurasi**, lalu pilih **Tag**.
1. Di bagian **Tanda**, pilih **Kelola tanda**.
1. Pilih **Tambahkan tag baru**, lalu masukkan **Kunci** dan **Nilai** opsional. Untuk menambahkan lebih banyak tag, ulangi langkah ini.
1. Pilih **Simpan**.
**Untuk memfilter fungsi dengan tag**
1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.
1. Pilih kotak pencarian untuk melihat daftar properti fungsi dan tombol tag.
1. Pilih kunci tag untuk melihat daftar nilai yang sedang digunakan di AWS Wilayah saat ini.
1. Pilih **Gunakan: “tag-name”** untuk melihat semua fungsi 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.
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 API Lambda. 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 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 membuat fungsi
Untuk membuat fungsi Lambda baru dengan tag, gunakan operasi [CreateFunction](https://docs.aws.amazon.com//lambda/latest/api/API_CreateFunction.html)API. Tentukan parameter `Tags`. Anda dapat memanggil operasi ini dengan perintah `create-function` CLI dan opsi --tags. Sebelum menggunakan parameter tag dengan`CreateFunction`, 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](#fxn-tags-required-permissions) Contoh ini menambahkan dua tag, satu dengan kunci *Department* dan satu dengan kunci*CostCenter*.
```
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](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
```
Anda dapat melihat tag yang diterapkan ke sumber daya tertentu dengan operasi [GetFunction](https://docs.aws.amazon.com/lambda/latest/api/API_GetFunction.html)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](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)API untuk memfilter sumber daya Anda 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*.