AWS::Serverless::LayerVersion - AWS Serverless Application Model
SintaxePropriedadesValores de retornoExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 Construindo camadas Lambda em AWS SAM.

Nota importante: Desde o lançamento do atributo de UpdateReplacePolicyrecurso em 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 CloudFormation recursos. Para obter mais informações, consulte CloudFormation Recursos gerados para AWS SAM.

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

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

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

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

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

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

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

PublishLambdaVersion

Uma propriedade opcional que cria uma nova versão do Lambda sempre que há uma alteração no recurso referenciadoLayerVersion. Quando habilitado com AutoPublishAlias e AutoPublishAliasAllProperties na função Lambda conectada, haverá uma nova versão do Lambda criada para cada alteração feita no recurso. LayerVersion

Tipo: booliano

Obrigatório: não

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

RetentionPolicy

Essa propriedade especifica se versões antigas da LayerVersion são retidas ou excluídas quando você exclui um recurso. Se você precisar reter versões antigas do LayerVersion quando atualizar ou substituir um recurso, deverá ter o atributo UpdateReplacePolicy habilitado. Para obter informações sobre como fazer isso, consulte atributo UpdateReplacePolicy no Guia do usuário do AWS CloudFormation .

Valores válidos: Retain ou Delete

Tipo: string

Obrigatório: não

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

Observações adicionais: Quando você especificaRetain, AWS SAM adiciona um Atributos de recursos suportados por AWS SAM 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://sam-s3-demo-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain