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, AWS 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

Al realizar la implementación en AWS CloudFormation, AWS SAM transforma AWS SAM los recursos en AWS CloudFormation recursos. Para obtener más información, consulte Recursos AWS CloudFormation de AWS SAM 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, 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

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 ZIP archivo 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 el nombre del 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 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

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 de su LayerVersion dispositivo se eliminan o se eliminan al eliminar un recurso. Si necesita conservar sus versiones antiguas LayerVersion al actualizar o reemplazar un recurso, debes tener el UpdateReplacePolicy atributo activado. Para obtener información sobre cómo hacerlo, consulta 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 AWS SAM y no tiene un AWS CloudFormation equivalente.

Notas adicionales: Cuando se especificaRetain, se AWS SAM añade 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 recurso ARN de la LayerVersion Lambda subyacente.

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://amzn-s3-demo-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain