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 uma Lambda LayerVersion que contém a biblioteca ou o código de runtime necessário para uma função do Lambda.

O AWS::Serverless::LayerVersion recurso também suporta o atributo Metadata recurso, 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 recurso updateReplacePolicy em CloudFormation AWS::Lambda::LayerVersion, (recomendado) oferece os mesmos benefícios que AWS::Serverless::LayerVersion.

Quando uma versão de camada sem servidor é transformada, o SAM também transforma a identificação lógica do recurso para que as LayerVersions antigas não sejam excluídas automaticamente pelo CloudFormation quando o recurso for atualizado.

nota

Quando você implanta AWS CloudFormation, AWS SAM transforma seus recursos AWS SAM em recursos CloudFormation. Para obter mais informações, consulte Recursos gerados do CloudFormation para o AWS SAM.

Sintaxe

Para declarar esta entidade no modelo do AWS Serverless Application Model (AWS SAM), use a seguinte sintaxe:

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

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

CompatibleRuntimes

Lista de runtimes compatíveis com esta LayerVersion.

Tipo: lista

Obrigatório: não

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

ContentUri

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

Se um objeto Amazon S3 Uri ou LayerContent for fornecido, o objeto 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 modelo AWS SAM.

Tipo: String | LayerContent

Obrigatório: Sim

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

Description

Descrição dessa camada.

Tipo: string

Obrigatório: não

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

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

Compatibilidade CloudFormation: essa propriedade é semelhante à propriedade LayerName de um recurso AWS::Lambda::LayerVersion. 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 esta LayerVersion.

Tipo: string

Obrigatório: não

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

PublishLambdaVersion

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

Tipo: booliano

Obrigatório: não

Compatibilidade CloudFormation: Essa propriedade é exclusiva do 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

Compatibilidade CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem CloudFormation equivalente.

Observações adicionais: Quando você especifica Retain, AWS SAM adiciona um Atributos de recursos compatíveis com o AWS SAM de DeletionPolicy: Retain ao recurso transformado AWS::Lambda::LayerVersion.

Valores de retorno

Ref.

Quando o ID lógico desse recurso é fornecido à função intrínseca Ref retorna o ARN do recurso do Lambda LayerVersion subjacente.

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 uma 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