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
<a name="sam-resource-layerversion"></a>

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](#sam-resource-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](building-layers.md).

**Nota importante**: Desde o lançamento do atributo de [UpdateReplacePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html)recurso em CloudFormation, [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html)(recomendado) oferece os mesmos benefícios que[AWS::Serverless::LayerVersion](#sam-resource-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](sam-specification-generated-resources.md).

## Sintaxe
<a name="sam-resource-layerversion-syntax"></a>

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

### YAML
<a name="sam-resource-layerversion-syntax.yaml"></a>

```
Type: AWS::Serverless::LayerVersion
Properties:
  [CompatibleArchitectures](#sam-layerversion-compatiblearchitectures): List
  [CompatibleRuntimes](#sam-layerversion-compatibleruntimes): List
  [ContentUri](#sam-layerversion-contenturi): String | LayerContent
  [Description](#sam-layerversion-description): String
  [LayerName](#sam-layerversion-layername): String
  [LicenseInfo](#sam-layerversion-licenseinfo): String
  [PublishLambdaVersion](#sam-layerversion-PublishLambdaVersion): Boolean
  [RetentionPolicy](#sam-layerversion-retentionpolicy): String
```

## Propriedades
<a name="sam-resource-layerversion-properties"></a>

 `CompatibleArchitectures`   <a name="sam-layerversion-compatiblearchitectures"></a>
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](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html) 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatiblearchitectures)` propriedade de um `AWS::Lambda::LayerVersion` recurso.

 `CompatibleRuntimes`   <a name="sam-layerversion-compatibleruntimes"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatibleruntimes)` propriedade de um `AWS::Lambda::LayerVersion` recurso.

 `ContentUri`   <a name="sam-layerversion-contenturi"></a>
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.](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)  
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](sam-cli-command-reference-sam-build.md) seguido por [sam deploy](sam-cli-command-reference-sam-deploy.md) ou [sam package](sam-cli-command-reference-sam-package.md). Por padrão, os caminhos relativos são resolvidos com relação à localização do AWS SAM modelo.  
*Tipo*: String \$1 [LayerContent](sam-property-layerversion-layercontent.md)  
*Obrigatório*: sim  
*CloudFormation compatibilidade*: essa propriedade é semelhante à `[Content](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-content)` propriedade de um `AWS::Lambda::LayerVersion` recurso. As propriedades aninhadas do Amazon S3 têm nomes diferentes.

 `Description`   <a name="sam-layerversion-description"></a>
Descrição dessa camada.  
*Tipo:* string  
*Obrigatório*: não  
*CloudFormation compatibilidade*: essa propriedade é passada diretamente para a `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-description)` propriedade de um `AWS::Lambda::LayerVersion` recurso.

 `LayerName`   <a name="sam-layerversion-layername"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-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`   <a name="sam-layerversion-licenseinfo"></a>
Informações sobre a licença para isso LayerVersion.  
*Tipo:* string  
*Obrigatório*: não  
*CloudFormation compatibilidade*: essa propriedade é passada diretamente para a `[LicenseInfo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-licenseinfo)` propriedade de um `AWS::Lambda::LayerVersion` recurso.

 `PublishLambdaVersion`   <a name="sam-layerversion-PublishLambdaVersion"></a>
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  
*CloudFormation compatibilidade*: essa propriedade é exclusiva AWS SAM e não tem CloudFormation equivalente.

 `RetentionPolicy`   <a name="sam-layerversion-retentionpolicy"></a>
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`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html) 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ê especifica`Retain`, AWS SAM adiciona um [Atributos de recursos suportados por AWS SAM](sam-specification-resource-attributes.md) de `DeletionPolicy: Retain` ao `AWS::Lambda::LayerVersion` recurso transformado.

## Valores de retorno
<a name="sam-resource-layerversion-return-values"></a>

### Ref.
<a name="sam-resource-layerversion-return-values-ref"></a>

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) no *Guia do usuário do AWS CloudFormation *. 

## Exemplos
<a name="sam-resource-layerversion--examples"></a>

### LayerVersionExample
<a name="sam-resource-layerversion--examples--layerversionexample"></a>

Exemplo de um LayerVersion

#### YAML
<a name="sam-resource-layerversion--examples--layerversionexample--yaml"></a>

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

# LayerContent
<a name="sam-property-layerversion-layercontent"></a>

Um arquivo ZIP que contém o conteúdo de uma [camada do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).

## Sintaxe
<a name="sam-property-layerversion-layercontent-syntax"></a>

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

### YAML
<a name="sam-property-layerversion-layercontent-syntax.yaml"></a>

```
  [Bucket](#sam-layerversion-layercontent-bucket): String
  [Key](#sam-layerversion-layercontent-key): String
  [Version](#sam-layerversion-layercontent-version): String
```

## Propriedades
<a name="sam-property-layerversion-layercontent-properties"></a>

 `Bucket`   <a name="sam-layerversion-layercontent-bucket"></a>
O bucket do Amazon S3 do arquivamento de camada.  
*Tipo:* string  
*Obrigatório*: Sim  
*CloudFormation compatibilidade*: essa propriedade é passada diretamente para a `[S3Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3bucket)` propriedade do tipo de `AWS::Lambda::LayerVersion` `Content` dados.

 `Key`   <a name="sam-layerversion-layercontent-key"></a>
A chave do Amazon S3 do arquivamento de camada.  
*Tipo:* string  
*Obrigatório*: Sim  
*CloudFormation compatibilidade*: essa propriedade é passada diretamente para a `[S3Key](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3key)` propriedade do tipo de `AWS::Lambda::LayerVersion` `Content` dados.

 `Version`   <a name="sam-layerversion-layercontent-version"></a>
Para objetos com controle de versão, a versão do objeto de arquivamento de camada a ser usada.  
*Tipo:* string  
*Obrigatório*: não  
*CloudFormation compatibilidade*: essa propriedade é passada diretamente para a `[S3ObjectVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3objectversion)` propriedade do tipo de `AWS::Lambda::LayerVersion` `Content` dados.

## Exemplos
<a name="sam-property-layerversion-layercontent--examples"></a>

### LayerContent
<a name="sam-property-layerversion-layercontent--examples--layercontent"></a>

Exemplo de conteúdo de camada

#### YAML
<a name="sam-property-layerversion-layercontent--examples--layercontent--yaml"></a>

```
LayerContent:
  Bucket: amzn-s3-demo-bucket-name
  Key: mykey-name
  Version: 121212
```