

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS::Serverless::LayerVersion
<a name="sam-resource-layerversion"></a>

Crea una Lambda LayerVersion che contiene il codice di libreria o di runtime necessario per una funzione Lambda.

La [AWS::Serverless::LayerVersion](#sam-resource-layerversion) risorsa supporta anche l'attributo `Metadata` resource, quindi puoi indicare di AWS SAM creare livelli inclusi nell'applicazione. Per ulteriori informazioni sulla creazione di livelli, consulta[Creazione di livelli Lambda in AWS SAM](building-layers.md).

**Nota importante**: dal rilascio dell'attributo [UpdateReplacePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html)resource in 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)(consigliato) offre gli stessi vantaggi di[AWS::Serverless::LayerVersion](#sam-resource-layerversion).

Quando un Serverless LayerVersion viene trasformato, SAM trasforma anche l'ID logico della risorsa in modo che LayerVersions le versioni precedenti non vengano eliminate automaticamente CloudFormation quando la risorsa viene aggiornata.

**Nota**  
Quando esegui la distribuzione in AWS CloudFormation, AWS SAM trasforma le tue AWS SAM risorse in risorse. CloudFormation Per ulteriori informazioni, consulta [CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `CompatibleArchitectures`   <a name="sam-layerversion-compatiblearchitectures"></a>
Specifica le architetture dei set di istruzioni supportate per la versione di livello.  
*Per ulteriori informazioni su questa proprietà, consulta [Architetture dei set di istruzioni Lambda nella Guida per gli](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html) sviluppatori.AWS Lambda *  
*Valori validi*: `x86_64`, `arm64`  
Tipo: elenco  
*Obbligatorio:* no  
*Default*: `x86_64`  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CompatibleArchitectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatiblearchitectures)` proprietà di una risorsa. `AWS::Lambda::LayerVersion`

 `CompatibleRuntimes`   <a name="sam-layerversion-compatibleruntimes"></a>
Elenco di runtime compatibili con questo LayerVersion.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CompatibleRuntimes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatibleruntimes)` proprietà di una `AWS::Lambda::LayerVersion` risorsa.

 `ContentUri`   <a name="sam-layerversion-contenturi"></a>
Amazon S3 Uri, percorso della cartella locale o LayerContent oggetto del codice del livello.  
[Se viene fornito un Uri o un oggetto Amazon S3, l' LayerContent oggetto Amazon S3 a cui si fa riferimento deve essere un archivio ZIP valido che contiene il contenuto di un livello Lambda.](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)  
Se viene fornito un percorso a una cartella locale, affinché il contenuto venga trasformato correttamente, il modello deve passare attraverso il flusso di lavoro che include, [sam build](sam-cli-command-reference-sam-build.md) seguito da o. [sam deploy](sam-cli-command-reference-sam-deploy.md) [sam package](sam-cli-command-reference-sam-package.md) Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.  
*Tipo*: String \$1 [LayerContent](sam-property-layerversion-layercontent.md)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[Content](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-content)` proprietà di una `AWS::Lambda::LayerVersion` risorsa. Le proprietà annidate di Amazon S3 sono denominate in modo diverso.

 `Description`   <a name="sam-layerversion-description"></a>
Descrizione di questo livello.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-description)` proprietà di una `AWS::Lambda::LayerVersion` risorsa.

 `LayerName`   <a name="sam-layerversion-layername"></a>
Il nome o l'Amazon Resource Name (ARN) del livello.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Predefinito*: ID logico della risorsa  
*CloudFormation compatibilità*: questa proprietà è simile alla `[LayerName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-layername)` proprietà di una `AWS::Lambda::LayerVersion` risorsa. Se non si specifica un nome, l'id logico della risorsa verrà utilizzato come nome.

 `LicenseInfo`   <a name="sam-layerversion-licenseinfo"></a>
Informazioni sulla licenza a tale scopo LayerVersion.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà viene passata direttamente alla `[LicenseInfo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-licenseinfo)` proprietà di una `AWS::Lambda::LayerVersion` risorsa.

 `PublishLambdaVersion`   <a name="sam-layerversion-PublishLambdaVersion"></a>
Una proprietà opt-in che crea una nuova versione Lambda ogni volta che si verifica una modifica nella `LayerVersion` risorsa di riferimento. Se abilitata con `AutoPublishAlias` e `AutoPublishAliasAllProperties` nella funzione Lambda connessa, verrà creata una nuova versione Lambda per ogni modifica apportata alla risorsa. `LayerVersion`  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RetentionPolicy`   <a name="sam-layerversion-retentionpolicy"></a>
Questa proprietà specifica se le versioni precedenti del file `LayerVersion` vengono conservate o eliminate quando si elimina una risorsa. Se è necessario conservare le vecchie versioni della risorsa `LayerVersion` quando si aggiorna o si sostituisce una risorsa, è necessario che l'`UpdateReplacePolicy`attributo sia abilitato. Per informazioni su questa operazione, consulta l'[`UpdateReplacePolicy`attributo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html) nella *Guida per l'AWS CloudFormation utente*.  
*Valori validi*: `Retain` o `Delete`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.  
*Note aggiuntive*: quando si specifica`Retain`, AWS SAM aggiunge un [Attributi delle risorse supportati da AWS SAM](sam-specification-resource-attributes.md) di `DeletionPolicy: Retain` alla `AWS::Lambda::LayerVersion` risorsa trasformata.

## Valori restituiti
<a name="sam-resource-layerversion-return-values"></a>

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

Quando l'ID logico di questa risorsa viene fornito alla funzione `Ref` intrinseca, restituisce l'ARN della risorsa Lambda sottostante. LayerVersion

*Per ulteriori informazioni sull'uso della `Ref` funzione, consulta [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)la Guida per l'utente.AWS CloudFormation * 

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

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

Esempio di 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>

Un archivio ZIP che racchiude i contenuti di un [livello Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `Bucket`   <a name="sam-layerversion-layercontent-bucket"></a>
Il bucket Amazon S3 dell'archivio del livello.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3bucket)` proprietà del tipo di `AWS::Lambda::LayerVersion` `Content` dati.

 `Key`   <a name="sam-layerversion-layercontent-key"></a>
La chiave Amazon S3 dell'archivio del livello.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3Key](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3key)` proprietà del tipo di `AWS::Lambda::LayerVersion` `Content` dati.

 `Version`   <a name="sam-layerversion-layercontent-version"></a>
Per gli oggetti con versione, la versione dell'oggetto dell'archivio del livello da utilizzare.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[S3ObjectVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3objectversion)` proprietà del tipo di `AWS::Lambda::LayerVersion` `Content` dati.

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

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

Esempio di contenuto del livello

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

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