

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

# Menambahkan lapisan ke fungsi
<a name="adding-layers"></a>

Lapisan Lambda adalah arsip file.zip yang berisi kode atau data tambahan. Lapisan biasanya berisi dependensi pustaka, [runtime kustom](runtimes-custom.md), atau file konfigurasi. 

Bagian ini menjelaskan cara menambahkan layer ke fungsi Lambda. Untuk informasi konseptual lebih lanjut tentang lapisan dan mengapa Anda mungkin mempertimbangkan untuk menggunakannya, lihat[Mengelola dependensi Lambda dengan lapisan](chapter-layers.md).

Sebelum Anda dapat mengkonfigurasi fungsi Lambda untuk menggunakan lapisan, Anda harus:
+ [Package konten layer Anda](packaging-layers.md)
+ [Buat layer di Lambda](creating-deleting-layers.md)
+ Pastikan Anda memiliki izin untuk memanggil [GetLayerVersion](https://docs.aws.amazon.com/lambda/latest/api/API_GetLayerVersion.html)API pada versi layer. Untuk fungsi dalam Anda Akun AWS, Anda harus memiliki izin ini dalam [kebijakan pengguna](access-control-identity-based.md) Anda. Untuk menggunakan lapisan di akun lain, pemilik akun tersebut harus memberi akun Anda izin dalam [kebijakan berbasis sumber daya](access-control-resource-based.md). Sebagai contoh, lihat [Memberikan akses lapisan Lambda ke akun lain](permissions-layer-cross-account.md).

Anda dapat menambahkan hingga lima lapisan ke fungsi Lambda. Ukuran total fungsi yang belum di-zip dan semua lapisan tidak dapat melebihi kuota ukuran paket deployment yang belum di-zip sebesar 250 MB. Untuk informasi selengkapnya, lihat [Kuota Lambda](gettingstarted-limits.md).

Fungsi 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 baru yang menggunakan versi lapisan yang dihapus.

**Untuk menambahkan lapisan ke fungsi**

1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.

1. Pilih fungsinya.

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

1. Di bawah **Pilih layer**, pilih sumber layer:

   1. **AWS layer**: Pilih dari daftar [ekstensi AWS-managed](extensions-api-partners.md#aws-managed-extensions).

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

   1. **Tentukan ARN**: Untuk menggunakan lapisan [dari yang berbeda Akun AWS](permissions-layer-cross-account.md), seperti [ekstensi pihak ketiga](extensions-api-partners.md), masukkan Nama Sumber Daya Amazon (ARN).

1. 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 Anda (konsol)**

1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/functions) di konsol Lambda.

1. Pilih fungsi yang akan dikonfigurasi.

1. Di bawah **Layers**, pilih **Edit**

1. Pilih salah satu layer.

1. Pilih **Merge sebelumnya** atau **Merge nanti** untuk menyesuaikan urutan layer.

1. 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 Anda.

**Untuk memperbarui versi lapisan untuk fungsi Anda (konsol)**

1. Buka [halaman Fungsi](https://console.aws.amazon.com/lambda/home#/layers) di konsol Lambda.

1. Pilih layer yang ingin Anda perbarui versinya.

1. Pilih tab **Fungsi menggunakan versi ini**.

1. Pilih fungsi yang ingin Anda ubah, lalu pilih **Edit**.

1. Untuk **versi Layer**, pilih versi layer yang akan diubah.

1. Pilih **fungsi Perbarui**.

Anda tidak dapat memperbarui versi lapisan fungsi di seluruh AWS akun.

## Menemukan informasi lapisan
<a name="finding-layer-information"></a>

Untuk menemukan lapisan di akun Anda yang kompatibel dengan runtime fungsi Anda, gunakan [ListLayers](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayers.html)API. Misalnya, Anda dapat menggunakan perintah [list-layers (](https://docs.aws.amazon.com/cli/latest/reference/lambda/list-layers.html) 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 [ListLayerVersions](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayerVersions.html)API. 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"
            ]
        }
    ]
}
```