# Adición de capas a las funciones
Una capa de Lambda es un archivo .zip que contiene código o datos adicionales. Las capas suelen contener dependencias de biblioteca, un [tiempo de ejecución personalizado](runtimes-custom.md) o archivos de configuración.
En esta sección se explica cómo agregar una capa a una función de Lambda. Para obtener más información conceptual sobre las capas y los motivos por los que podría considerar la posibilidad de utilizarlas, consulte [Administración de las dependencias de Lambda con capas](chapter-layers.md).
Para poder configurar una función de Lambda en la que se utilice una capa, debe hacer lo siguiente:
+ [Empaquete el contenido de su capa](packaging-layers.md).
+ [Cree una capa en Lambda](creating-deleting-layers.md).
+ Asegúrese de que tiene permiso para llamar a la API [GetLayerVersion](https://docs.aws.amazon.com/lambda/latest/api/API_GetLayerVersion.html) en la versión de la capa. Para las funciones de su Cuenta de AWS, debe tener este permiso en su [política de usuario](access-control-identity-based.md). Para utilizar una capa en otra cuenta, el propietario de esa cuenta debe conceder permiso a su cuenta en una [política basada en recursos](access-control-resource-based.md). Para ver ejemplos, consulte [Concesión de acceso a las capas de Lambda a otras cuentas](permissions-layer-cross-account.md).
Puede agregar hasta cinco capas a una función de Lambda. El tamaño total descomprimido de la función y todas las capas no puede superar la cuota de tamaño del paquete de implementación sin comprimir, de 250 MB. Para obtener más información, consulte [Cuotas de Lambda](gettingstarted-limits.md).
Sus funciones pueden seguir utilizando cualquier versión de capa que ya haya agregado, incluso después de que se haya eliminado esa versión de capa o después de revocar su permiso de acceso a la capa. Sin embargo, no puede crear una nueva función que utilice una versión de capa eliminada.
**Adición de una capa a una función**
1. Abra la página de [Funciones](https://console.aws.amazon.com/lambda/home#/functions) en la consola de Lambda.
1. Elija la función.
1. Desplácese hacia abajo hasta la sección **Capas** y, a continuación, elija **Agregar una capa**.
1. En **Elegir una capa**, elija un origen de capa:
1. **Capas de AWS**: elija en la lista de [extensiones administradas por AWS](extensions-api-partners.md#aws-managed-extensions).
1. **Capas personalizadas**: elija una capa creada en su Cuenta de AWS.
1. **Especificar un ARN**: para usar una capa [de una Cuenta de AWS distinta](permissions-layer-cross-account.md), como una [extensión de un tercero](extensions-api-partners.md), ingrese el Nombre de recurso de Amazon (ARN).
1. Elija **Agregar**.
El orden en el que agrega las capas es el orden en que Lambda combina el contenido de las capas en el entorno de ejecución. Puede cambiar el orden de fusión de capas mediante la consola.
**Para actualizar el orden de combinación de capas de una función (consola)**
1. Abra la página de [Funciones](https://console.aws.amazon.com/lambda/home#/functions) en la consola de Lambda.
1. Elija la función que desea configurar.
1. En **Layers** (Capas), elija **Edit** (Editar).
1. Elija una de las capas.
1. Elija **Merge earlier** (Fusionar antes) o **Merge later** (Fusionar después) para ajustar el orden de las capas.
1. Seleccione **Save**.
Las capas están versionadas. El contenido de cada versión de capa es inmutable. El propietario de una capa puede lanzar una nueva versión de capa para proporcionar contenido actualizado. Puede utilizar la consola para actualizar la versión de capa adjunta a sus funciones.
**Para actualizar las versiones de las capas de la función (consola)**
1. Abra la página de [Capas](https://console.aws.amazon.com/lambda/home#/layers) de la consola de Lambda.
1. Elija la capa para la que desea actualizar la versión.
1. Elija la pestaña **Funciones que utilizan esta versión**.
1. Elija las funciones que desee modificar y, a continuación, elija **Editar**.
1. En **Versión de la capa**, seleccione la versión de capa a la que desea cambiar.
1. Elija **Update functions** (Actualizar funciones).
No se pueden actualizar las versiones de capas de función entre cuentas de AWS.
## Búsqueda de información de capa
Para buscar capas en su cuenta que sean compatibles con el tiempo de ejecución de su función, utilice la API [ListLayers](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayers.html). Por ejemplo, puede usar el siguiente comando [list-layers](https://docs.aws.amazon.com/cli/latest/reference/lambda/list-layers.html) de la AWS Command Line Interface (CLI):
```
aws lambda list-layers --compatible-runtime python3.14
```
Debería ver una salida similar a esta:
```
{
"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"
]
}
}
]
}
```
Para enumerar todas las capas de su cuenta, omita la opción `--compatible-runtime`. Los detalles de la respuesta muestran la versión más reciente de cada capa.
También puede obtener la versión más reciente de una capa con la API [ListLayerVersions](https://docs.aws.amazon.com/lambda/latest/api/API_ListLayerVersions.html). Por ejemplo, puede usar el siguiente comando `list-layer-versions` de la CLI:
```
aws lambda list-layer-versions --layer-name my-layer
```
Debería ver una salida similar a esta:
```
{
"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"
]
}
]
}
```