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 Como criar camadas do Lambda no AWS SAM.

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, SAM também transforma a identificação lógica do recurso para que os antigos não LayerVersions sejam excluídos automaticamente CloudFormation quando o recurso for atualizado.

nota

Quando você implanta AWS CloudFormation, AWS SAM transforma seus AWS SAM recursos em AWS CloudFormation recursos. Para obter mais informações, consulte Recursos gerados do AWS CloudFormation para o 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
  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.

Type: 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 Amazon Resource Name (ARN) da camada.

Type: 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.

Type: 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 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

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