AWS::Serverless::LayerVersion

Crea una Lambda LayerVersion que contiene el código de biblioteca o de tiempo de ejecución que necesita una función Lambda.

El AWS::Serverless::LayerVersion recurso también admite el atributo Metadata resource, por lo que puede indicarle que cree AWS SAM las capas incluidas en su aplicación. Para obtener más información sobre la creación de capas, consulte Creación de capas.

Nota importante: Desde la publicación del atributo de UpdateReplacePolicyrecurso en AWS CloudFormation, AWS::Lambda::LayerVersion(recomendado) ofrece las mismas ventajas queAWS::Serverless::LayerVersion.

Cuando se transforma un servidor sin servidor LayerVersion , SAM también transforma el identificador lógico del recurso para que los antiguos no LayerVersions se eliminen automáticamente CloudFormation cuando se actualice el recurso.

nota

Cuando lo implementa AWS CloudFormation, AWS SAM transforma sus AWS SAM recursos en AWS CloudFormation recursos. Para obtener más información, consulte Recursos de AWS CloudFormation generados.

Sintaxis

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

YAML

Type: AWS::Serverless::LayerVersion
Properties:
  CompatibleArchitectures: List
  CompatibleRuntimes: List
  ContentUri: String | LayerContent
  Description: String
  LayerName: String
  LicenseInfo: String
  RetentionPolicy: String

Propiedades

CompatibleArchitectures

Especifica las arquitecturas del conjunto de instrucciones compatibles para la versión de capa.

Para obtener más información sobre esta propiedad, consulte Arquitecturas del conjunto de instrucciones Lambda en la Guía para desarrolladores de AWS Lambda .

Valores válidos: x86_64, arm64

Tipo: lista

Obligatorio: no

Valor predeterminado: x86_64

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la CompatibleArchitectures propiedad de un AWS::Lambda::LayerVersion recurso.

CompatibleRuntimes

Lista de tiempos de ejecución compatibles con esto LayerVersion.

Tipo: lista

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la CompatibleRuntimes propiedad de un AWS::Lambda::LayerVersion recurso.

ContentUri

Uri de Amazon S3, ruta a la carpeta local u LayerContent objeto del código de capa.

Si se proporciona un URI o un LayerContent objeto de Amazon S3, el objeto de Amazon S3 al que se hace referencia debe ser un archivo ZIP válido que contenga el contenido de una capa Lambda.

Si se proporciona una ruta a una carpeta local, para que el contenido se transforme correctamente, la plantilla debe seguir el flujo de trabajo que incluye sam build seguido de sam deploy o sam package. De forma predeterminada, las rutas relativas se resuelven con respecto a la ubicación de la AWS SAM plantilla.

Tipo: Cadena | LayerContent

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad es similar a la Content propiedad de un AWS::Lambda::LayerVersion recurso. Las propiedades anidadas de Amazon S3 tienen un nombre diferente.

Description

Descripción de esta capa.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Description propiedad de un AWS::Lambda::LayerVersion recurso.

LayerName

El nombre o nombre de recurso de Amazon (ARN) de la capa.

Tipo: cadena

Obligatorio: no

Predeterminado: identificador lógico del recurso

AWS CloudFormation compatibilidad: esta propiedad es similar a la LayerName propiedad de un AWS::Lambda::LayerVersion recurso. Si no especifica un nombre, se utilizará como nombre el ID lógico del recurso.

LicenseInfo

Información sobre la licencia correspondiente LayerVersion.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la LicenseInfo propiedad de un AWS::Lambda::LayerVersion recurso.

RetentionPolicy

Esta propiedad especifica si las versiones antiguas LayerVersion se conservan o se eliminan al eliminar un recurso. Si necesita conservar sus versiones antiguas LayerVersion al actualizar o reemplazar un recurso, debe tener el UpdateReplacePolicy atributo activado. Para obtener información sobre cómo hacerlo, consulte el UpdateReplacePolicyatributo de la Guía del AWS CloudFormation usuario.

Valores válidos: Retain o Delete

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un AWS CloudFormation equivalente.

Notas adicionales: Al especificarRetain, AWS SAM agrega un Atributos de recursos valor de DeletionPolicy: Retain al AWS::Lambda::LayerVersion recurso transformado.

Valores devueltos

Ref.

Cuando se proporciona el identificador lógico de este recurso a la función Ref intrínseca, devuelve el ARN del recurso de la Lambda subyacente. LayerVersion

Para obtener más información sobre el uso de la función Ref, consulte Ref en la Guía del usuario de AWS CloudFormation .

Ejemplos

LayerVersionExample

Ejemplo de un LayerVersion

YAML

Properties:
  LayerName: MyLayer
  Description: Layer description
  ContentUri: 's3://my-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain