AWS::Serverless::LayerVersion

Cria um Lambda LayerVersion que contém a biblioteca ou o código de tempo de execução necessário para uma função Lambda.

O AWS::Serverless::LayerVersion recurso também suporta o atributo Metadata resource, para que você possa AWS SAM instruir a criar camadas incluídas em seu aplicativo. Para obter mais informações sobre a criação de camadas, consulte Construir camadas.

Nota importante: Desde o lançamento do atributo de UpdateReplacePolicyrecurso em AWS CloudFormation, AWS::Lambda::LayerVersion(recomendado) oferece os mesmos benefícios queAWS::Serverless::LayerVersion.

Quando um Serverless LayerVersion é transformado, o SAM também transforma o ID lógico do recurso para que o antigo não seja excluído automaticamente CloudFormation quando o recurso LayerVersions for atualizado.

nota

Quando você implanta AWS CloudFormation, AWS SAM transforma seus AWS SAM recursos em AWS CloudFormation recursos. Para ter mais informações, consulte Recursos gerados da AWS CloudFormation.

Sintaxe

Para declarar essa entidade em seu modelo AWS Serverless Application Model (AWS SAM), use a sintaxe a seguir.

YAML

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

Propriedades

CompatibleArchitectures

Especifica as arquiteturas de conjunto de instruções suportadas para a versão da camada.

Para obter mais informações sobre esta propriedade, consulte Arquiteturas de conjuntos de instruções do Lambda no Guia do desenvolvedor do AWS Lambda .

Valores válidos: x86_64, arm64

Tipo: lista

Obrigatório: não

Padrão: x86_64

AWS CloudFormation compatibilidade: essa propriedade é passada diretamente para a CompatibleArchitectures propriedade de um AWS::Lambda::LayerVersion recurso.

CompatibleRuntimes

Lista de tempos de execução compatíveis com isso LayerVersion.

Tipo: lista

Obrigatório: não

AWS CloudFormation compatibilidade: essa propriedade é passada diretamente para a CompatibleRuntimes propriedade de um AWS::Lambda::LayerVersion recurso.

ContentUri

Uri do Amazon S3, caminho para a pasta local ou LayerContent objeto do código da camada.

Se um Uri ou LayerContent objeto do Amazon S3 for fornecido, o objeto do Amazon S3 referenciado deverá ser um arquivo ZIP válido que contenha o conteúdo de uma camada Lambda.

Se for fornecido um caminho para uma pasta local, para que o conteúdo seja transformado corretamente, o modelo deverá passar pelo fluxo de trabalho que inclui sam build seguido por sam deploy ou sam package. Por padrão, os caminhos relativos são resolvidos com relação à localização do AWS SAM modelo.

Tipo: String | LayerContent

Obrigatório: Sim

AWS CloudFormation compatibilidade: essa propriedade é semelhante à Content propriedade de um AWS::Lambda::LayerVersion recurso. As propriedades aninhadas do Amazon S3 têm nomes diferentes.

Description

Descrição dessa camada.

Tipo: string

Obrigatório: não

AWS CloudFormation compatibilidade: essa propriedade é passada diretamente para a Description propriedade de um AWS::Lambda::LayerVersion recurso.

LayerName

O nome ou o nome de recurso da Amazon (ARN) da camada.

Tipo: string

Obrigatório: não

Padrão: ID lógica do recurso

AWS CloudFormation compatibilidade: essa propriedade é semelhante à LayerName propriedade de um AWS::Lambda::LayerVersion recurso. Caso você não especifique um nome, o ID lógico do recurso será usado como nome.

LicenseInfo

Informações sobre a licença para isso LayerVersion.

Tipo: string

Obrigatório: não

AWS CloudFormation compatibilidade: essa propriedade é passada diretamente para a LicenseInfo propriedade de um AWS::Lambda::LayerVersion recurso.

RetentionPolicy

Essa propriedade especifica se suas versões antigas LayerVersion são mantidas ou excluídas quando você exclui um recurso. Se precisar manter versões antigas do seu LayerVersion ao atualizar ou substituir um recurso, você deve ter o UpdateReplacePolicy atributo ativado. Para obter informações sobre como fazer isso, consulte o UpdateReplacePolicyatributo no Guia AWS CloudFormation do usuário.

Valores válidos: Retain ou Delete

Tipo: string

Obrigatório: não

AWS CloudFormation compatibilidade: essa propriedade é exclusiva AWS SAM e não tem AWS CloudFormation equivalente.

Observações adicionais: Quando você especificaRetain, AWS SAM adiciona um Atributos de recursos de DeletionPolicy: Retain ao AWS::Lambda::LayerVersion recurso transformado.

Valores de retorno

Ref.

Quando a ID lógica desse recurso é fornecida à função Ref intrínseca, ela retorna o ARN do recurso do Lambda subjacente. LayerVersion

Para obter mais informações sobre como usar a função Ref, consulte Ref no Guia do usuário do AWS CloudFormation .

Exemplos

LayerVersionExample

Exemplo de um 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