Versi fungsi Lambda

Anda dapat menggunakan versi untuk mengelola deployment fungsi Anda. Misalnya, Anda dapat menerbitkan versi baru dari fungsi untuk uji beta tanpa memengaruhi pengguna dari versi produksi stabil. Lambda membuat versi baru fungsi Anda setiap kali Anda menerbitkan fungsi. Versi baru adalah salinan dari versi fungsi yang belum diterbitkan. Versi yang tidak dipublikasikan bernama $LATEST.

catatan

Untuk membuat versi baru dari fungsi Anda, Anda harus terlebih dahulu membuat perubahan pada versi yang tidak dipublikasikan ($LATEST). Perubahan ini dapat mencakup memperbarui kode atau memodifikasi pengaturan konfigurasi. Jika $LATEST identik dengan versi yang diterbitkan sebelumnya, Anda tidak akan dapat membuat versi baru sampai Anda menerapkan perubahan ke $LATEST.

Setelah Anda mempublikasikan versi fungsi, kode, runtime, arsitektur, memori, lapisan, dan sebagian besar pengaturan konfigurasi lainnya tidak dapat diubah. Ini berarti Anda tidak dapat mengubah pengaturan ini tanpa menerbitkan versi baru dari $LATEST. Anda dapat mengonfigurasi item berikut untuk versi fungsi yang diterbitkan:

• Pemicu

• Destinasi

• Konkurensi yang disediakan

• Pemanggilan asinkron

• Koneksi database dan proxy

catatan

Saat menggunakan kontrol manajemen runtime dengan mode Otomatis, versi runtime yang digunakan oleh versi fungsi diperbarui secara otomatis. Saat menggunakan pembaruan Fungsi atau mode Manual, versi runtime tidak diperbarui. Untuk informasi selengkapnya, lihat Pembaruan runtime Lambda.

Membuat versi fungsi

Anda dapat mengubah kode dan pengaturan fungsi hanya pada versi fungsi yang belum diterbitkan. Saat Anda memublikasikan versi, Lambda mengunci kode dan sebagian besar pengaturan untuk mempertahankan pengalaman yang konsisten bagi pengguna versi tersebut.

Anda dapat membuat versi fungsi menggunakan konsol Lambda.

Untuk membuat versi baru fungsi

1. Buka halaman Fungsi di konsol Lambda.

2. Pilih fungsi, lalu pilih Versi.

3. Pada halaman konfigurasi fungsi, pilih Terbitkan versi baru.

4. (Opsional) Masukkan deskripsi versi.

5. Pilih Terbitkan.

Atau, Anda dapat mempublikasikan versi fungsi menggunakan operasi PublishVersionAPI.

AWS CLI Perintah berikut menerbitkan versi baru dari suatu fungsi. Respons tersebut mengembalikan informasi konfigurasi tentang versi baru, termasuk nomor versi dan fungsi ARN dengan akhiran versi.

aws lambda publish-version --function-name my-function

Anda akan melihat output berikut:

{
  "FunctionName": "my-function",
  "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:1",
  "Version": "1",
  "Role": "arn:aws:iam::123456789012:role/lambda-role",
  "Handler": "function.handler",
  "Runtime": "nodejs20.x",
  ...
}

catatan

Lambda menetapkan nomor urut yang meningkat secara monoton untuk pembuatan versi. Lambda tidak pernah menggunakan kembali nomor versi, bahkan setelah Anda menghapus dan membuat ulang fungsi.

Menggunakan versi

Anda dapat merujuk fungsi Lambda Anda menggunakan ARN yang memenuhi syarat atau ARN yang tidak memenuhi syarat.

• ARN yang Memenuhi Syarat – Fungsi ARN dengan akhiran versi. Contoh berikut mengacu pada versi 42 dari fungsi helloworld.

  arn:aws:lambda:aws-region:acct-id:function:helloworld:42

• ARN yang Tidak Memenuhi Syarat – Fungsi ARN tanpa akhiran versi.

  arn:aws:lambda:aws-region:acct-id:function:helloworld

Anda dapat menggunakan ARN yang memenuhi syarat atau tidak memenuhi syarat dalam semua operasi API terkait. Namun, Anda tidak dapat menggunakan ARN yang tidak memenuhi syarat untuk membuat alias.

Jika Anda memutuskan untuk tidak menerbitkan versi fungsi, Anda dapat mengaktifkan fungsi tersebut menggunakan ARN yang memenuhi syarat atau tidak memenuhi syarat dalam pemetaan sumber peristiwa. Saat Anda mengaktifkan fungsi menggunakan ARN yang tidak memenuhi syarat, Lambda secara implisit mengaktifkan $LATEST.

Lambda menerbitkan versi fungsi baru hanya jika kode belum pernah dipublikasikan, atau jika kode telah berubah dari versi terakhir yang diterbitkan. Jika tidak ada perubahan, versi fungsi tetap pada versi publikasi terakhir.

ARN yang memenuhi syarat untuk setiap versi fungsi Lambda adalah unik. Setelah Anda menerbitkan versi, Anda tidak dapat mengubah ARN atau kode fungsi.

Memberi izin

Anda dapat menggunakan kebijakan berbasis sumber daya atau kebijakan berbasis identitas untuk memberikan akses ke fungsi Anda. Ruang lingkup izin tergantung pada apakah Anda menerapkan kebijakan ke fungsi atau ke salah satu versi fungsi. Untuk informasi selengkapnya tentang nama sumber daya fungsi dalam kebijakan, lihat Menyesuaikan bagian Sumber Daya dan Ketentuan kebijakan.

Anda dapat menyederhanakan pengelolaan sumber peristiwa dan AWS Identity and Access Management (IAM) kebijakan dengan menggunakan alias fungsi. Untuk informasi selengkapnya, lihat Buat alias untuk fungsi Lambda.