AWS::Serverless::LayerVersion - AWS Serverless Application Model
SintaxisPropiedadesvalores devueltosEjemplos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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, consulta Creación de capas Lambda en AWS SAM.

Nota importante: Desde la publicación del atributo de UpdateReplacePolicyrecurso en, CloudFormationAWS::Lambda::LayerVersion(recomendado) ofrece los mismos beneficios 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 CloudFormation recursos. Para obtener más información, consulte CloudFormation Recursos generados para AWS SAM.

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
  PublishLambdaVersion: Boolean
  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, consulta 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

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

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í

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

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

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

LicenseInfo

Información sobre la licencia correspondiente LayerVersion.

Tipo: cadena

Obligatorio: no

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

PublishLambdaVersion

Propiedad opcional que crea una nueva versión de Lambda cada vez que se produce un cambio en el recurso al LayerVersion que se hace referencia. Cuando se habilita con la función Lambda conectada AutoPublishAlias y AutoPublishAliasAllProperties en ella, se creará una nueva versión de Lambda para cada cambio realizado en el recurso. LayerVersion

Tipo: Booleano

Obligatorio: no

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

RetentionPolicy

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

Valores válidos: Retain o Delete

Tipo: cadena

Obligatorio: no

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

Notas adicionales: Al especificarRetain, AWS SAM agrega un Atributos de recursos compatibles con AWS SAM 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, consulta Ref en la Guía del usuario de AWS CloudFormation .

Ejemplos

LayerVersionExample

Ejemplo de LayerVersion

YAML

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