Menambahkan lapisan ke Fungsi Acara

Lapisan Lambda adalah arsip file.zip yang berisi kode atau data tambahan. Lapisan biasanya berisi dependensi pustaka, runtime kustom, atau file konfigurasi.

Bagian ini menjelaskan cara menambahkan layer ke Lambda Event Function. Untuk informasi konseptual lebih lanjut tentang lapisan dan mengapa Anda mungkin mempertimbangkan untuk menggunakannya, lihatMengelola dependensi Fungsi Acara Lambda dengan lapisan.

Sebelum Anda dapat mengkonfigurasi Fungsi Acara untuk menggunakan lapisan, Anda harus:

• Package konten layer Anda

• Buat layer di Lambda

• Pastikan Anda memiliki izin untuk memanggil GetLayerVersionAPI pada versi layer. Untuk Fungsi Acara di Anda Akun AWS, Anda harus memiliki izin ini dalam kebijakan pengguna Anda. Untuk menggunakan lapisan di akun lain, pemilik akun tersebut harus memberi akun Anda izin dalam kebijakan berbasis sumber daya. Sebagai contoh, lihat Memberikan akses lapisan Lambda ke akun lain.

Anda dapat menambahkan hingga lima lapisan ke Fungsi Acara. Total ukuran unzip dari Event Function dan semua layer tidak dapat melebihi kuota ukuran paket deployment unzip sebesar 250 MB. Untuk informasi selengkapnya, lihat Kuota Lambda.

Fungsi Acara Anda dapat terus menggunakan versi lapisan apa pun yang telah Anda tambahkan, bahkan setelah versi lapisan itu dihapus, atau setelah izin Anda untuk mengakses lapisan dicabut. Namun, Anda tidak dapat membuat Fungsi Acara baru yang menggunakan versi layer yang dihapus.

Untuk menambahkan layer ke Fungsi Acara

1. Buka halaman Fungsi Acara konsol Lambda.

2. Pilih Fungsi Acara.

3. Gulir ke bawah ke bagian Layers, lalu pilih Add a layer.

4. Di bawah Pilih layer, pilih sumber layer:

   1. AWS layer: Pilih dari daftar ekstensi AWS-managed.

   2. Custom layers: Pilih layer yang dibuat di file Anda Akun AWS.

   3. Tentukan ARN: Untuk menggunakan lapisan dari yang berbeda Akun AWS, seperti ekstensi pihak ketiga, masukkan Nama Sumber Daya Amazon (ARN).

5. Pilih Tambahkan.

Urutan di mana Anda menambahkan lapisan adalah urutan di mana Lambda menggabungkan konten lapisan ke dalam lingkungan eksekusi. Anda dapat mengubah urutan penggabungan lapisan menggunakan konsol.

Untuk memperbarui urutan penggabungan lapisan untuk Fungsi Acara (konsol)

1. Buka halaman Fungsi Acara konsol Lambda.

2. Pilih Fungsi Acara untuk dikonfigurasi.

3. Di bawah Layers, pilih Edit

4. Pilih salah satu layer.

5. Pilih Merge sebelumnya atau Merge nanti untuk menyesuaikan urutan layer.

6. Pilih Simpan.

Lapisan berversi. Isi dari setiap versi lapisan tidak dapat diubah. Pemilik layer dapat merilis versi layer baru untuk menyediakan konten yang diperbarui. Anda dapat menggunakan konsol untuk memperbarui versi lapisan yang dilampirkan ke Fungsi Acara Anda.

Untuk memperbarui versi layer untuk Event Function (konsol)

1. Buka halaman Fungsi di konsol Lambda.

2. Pilih layer yang ingin Anda perbarui versinya.

3. Pilih tab Fungsi menggunakan versi ini.

4. Pilih Fungsi Acara yang ingin Anda ubah, lalu pilih Edit.

5. Untuk versi Layer, pilih versi layer yang akan diubah.

6. Pilih fungsi Perbarui.

Anda tidak dapat memperbarui versi lapisan Fungsi Acara di seluruh AWS akun.

Menemukan informasi lapisan

Untuk menemukan layer di akun Anda yang kompatibel dengan runtime Event Function, gunakan ListLayersAPI. Misalnya, Anda dapat menggunakan perintah list-layers ( AWS Command Line Interface CLI) berikut:

aws lambda list-layers --compatible-runtime python3.14

Anda akan melihat output yang serupa dengan yang berikut:

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2025-04-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.14"
                ]
            }
        }
    ]
}

Untuk membuat daftar semua lapisan di akun Anda, hilangkan --compatible-runtime opsi. Detail respons menunjukkan versi terbaru dari setiap lapisan.

Anda juga bisa mendapatkan versi terbaru dari layer menggunakan ListLayerVersionsAPI. Misalnya, Anda dapat menggunakan perintah list-layer-versions CLI berikut:

aws lambda list-layer-versions --layer-name my-layer

Anda akan melihat output yang serupa dengan yang berikut:

{
    "LayerVersions": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        },
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
            "Version": 1,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:27:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        }
    ]
}