AWS::Serverless::LayerVersion

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

LaAWS::Serverless::LayerVersionsupporta anche la risorsaMetadataattributo risorsa, in modo da poter istruireAWS SAMper creare livelli inclusi nell'applicazione. Per ulteriori informazioni sui livelli di creazione, consulta.Livelli di costruzione.

Nota importante: Dal rilascio delUpdateReplacePolicyattributo della risorsa inAWS 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 CloudFormation non venga automaticamente eliminato da CloudFormation quando la risorsa viene aggiornata.

Sintassi

Per dichiarare questa entità nel tuoAWS Serverless Application Model(AWS SAM) template, utilizzare la sintassi seguente.

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 del set di istruzioni supportate per la versione del layer.

Per ulteriori informazioni su questa proprietà, consulta.Architetture del set di istruzioni LambdanellaAWS LambdaGuida per gli sviluppatori.

Valori validi: x86_64, arm64

Type: Elenco

Campo obbligatorio: No

Default: x86_64

AWS CloudFormationcompatibilità: Questa proprietà viene trasmessa direttamente alCompatibleArchitecturesproprietà di unAWS::Lambda::LayerVersionrisorsa.

CompatibleRuntimes

Elenco di runtime compatibili con questa versione LayerVersion.

Type: Elenco

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene trasmessa direttamente alCompatibleRuntimesproprietà di unAWS::Lambda::LayerVersionrisorsa.

ContentUri

Uri Amazon S3, percorso della cartella locale o oggetto LayerContent del codice layer.

Se viene fornito un oggetto Uri o LayerContent Amazon S3, l'oggetto Amazon S3 a cui fa riferimento deve essere un archivio ZIP valido che contenga il contenuto di unStrato Lambda.

Se viene fornito un percorso di una cartella locale, affinché il contenuto venga trasformato correttamente, il modello deve passare attraverso il flusso di lavoro che includestessa costruzioneseguito da entrambisam deployosam package. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alAWS SAMposizione del modello.

Type: Stringa |Contenuto layer

Campo obbligatorio: Sì

AWS CloudFormationcompatibilità: Questa proprietà è simile allaContentproprietà di unAWS::Lambda::LayerVersionrisorsa. Le proprietà di Amazon S3 nidificate sono denominate in modo diverso.

Description

Descrizione di questo livello.

Type: Stringa

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene trasmessa direttamente alDescriptionproprietà di unAWS::Lambda::LayerVersionrisorsa.

LayerName

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

Type: Stringa

Campo obbligatorio: No

Default: ID logico della risorsa

AWS CloudFormationcompatibilità: Questa proprietà è simile allaLayerNameproprietà di unAWS::Lambda::LayerVersionrisorsa. Se non si specifica un nome, l'ID logico della risorsa verrà utilizzato come nome.

LicenseInfo

Informazioni sulla licenza per questa versione LayerVersion.

Type: Stringa

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene trasmessa direttamente alLicenseInfoproprietà di unAWS::Lambda::LayerVersionrisorsa.

RetentionPolicy

Specifica se le versioni precedenti di LayerVersion vengono mantenute o eliminate dopo un aggiornamento.

Valori validi: Retain o Delete

Type: Stringa

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà è univoco perAWS SAMe non ha unAWS CloudFormationequivalente.

Note aggiuntive: Quando si specificaRetain,AWS SAMaggiunge unAttributi delle risorsediDeletionPolicy: Retainalla trasformazioneAWS::Lambda::LayerVersionrisorsa.

Valori restituiti

Ref

Quando l'ID logico di questa risorsa viene fornito alReffunzione intrinseca, restituisce la risorsa ARN della Lambda LayerVersion sottostante.

Per ulteriori informazioni sull'utilizzo diRefConsulta la funzioneRefnellaAWS CloudFormationGuida per l’utente di.

Esempi

Esempio di versione layer

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