AWS::Serverless::LayerVersion

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

La AWS::Serverless::LayerVersion risorsa supporta anche l'attributo Metadata resource, in modo da poter indicare come AWS SAM creare livelli inclusi nell'applicazione. Per ulteriori informazioni sulla creazione di livelli, consultaStrati di costruzione.

Nota importante: dal rilascio dell'attributo UpdateReplacePolicyresource in AWS CloudFormation, AWS::Lambda::LayerVersion(consigliato) offre gli stessi vantaggi diAWS::Serverless::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. AWS CloudFormation Per ulteriori informazioni, consulta AWS CloudFormationRisorse generate.

Sintassi

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

YAML

Type: AWS::Serverless::LayerVersion
Properties:
  CompatibleArchitectures: List
  CompatibleRuntimes: List
  ContentUri: String | LayerContent
  Description: String
  LayerName: String
  LicenseInfo: String
  RetentionPolicy: String

Proprietà

CompatibleArchitectures

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 sviluppatori.AWS Lambda

Valori validi: x86_64, arm64

Tipo: Elenco

Required: No

Default: x86_64

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla CompatibleArchitectures proprietà di una AWS::Lambda::LayerVersion risorsa.

CompatibleRuntimes

Elenco di runtime compatibili con questo LayerVersion.

Tipo: Elenco

Required: No

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla CompatibleRuntimes proprietà di una AWS::Lambda::LayerVersion risorsa.

ContentUri

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.

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 seguito da o. sam deploy sam package Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.

Tipo: String | LayerContent

Campo obbligatorio: sì

AWS CloudFormation compatibilità: Questa proprietà è simile alla Content proprietà di una AWS::Lambda::LayerVersion risorsa. Le proprietà annidate di Amazon S3 sono denominate in modo diverso.

Description

Descrizione di questo livello.

▬Tipo: stringa

Required: No

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla Description proprietà di una AWS::Lambda::LayerVersion risorsa.

LayerName

Il nome o l'Amazon Resource Name (ARN) del livello.

▬Tipo: stringa

Required: No

Predefinito: ID logico della risorsa

AWS CloudFormation compatibilità: questa proprietà è simile alla LayerName proprietà di una AWS::Lambda::LayerVersion risorsa. Se non si specifica un nome, l'id logico della risorsa verrà utilizzato come nome.

LicenseInfo

Informazioni sulla licenza a tale scopo LayerVersion.

▬Tipo: stringa

Required: No

AWS CloudFormation compatibilità: Questa proprietà viene passata direttamente alla LicenseInfo proprietà di una AWS::Lambda::LayerVersion risorsa.

RetentionPolicy

Questa proprietà specifica se le vecchie versioni 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'UpdateReplacePolicyattributo sia abilitato. Per informazioni su questa operazione, consulta l'UpdateReplacePolicyattributo nella Guida per l'AWS CloudFormation utente.

Valori validi: Retain o Delete

▬Tipo: stringa

Required: No

AWS CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un AWS CloudFormation equivalente.

Note aggiuntive: quando si specificaRetain, AWS SAM aggiunge un Attributi delle risorse di DeletionPolicy: Retain alla AWS::Lambda::LayerVersion risorsa trasformata.

Valori restituiti

Ref

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 Refla Guida per l'utente.AWS CloudFormation

Esempi

LayerVersionExample

Esempio di LayerVersion

YAML

Properties:
  LayerName: MyLayer
  Description: Layer description
  ContentUri: 's3://my-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain