AWS::Serverless::LayerVersion - AWS Serverless Application Model
構文プロパティ戻り値例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS::Serverless::LayerVersion

Lambda 関数に必要なライブラリまたはランタイムコード LayerVersion を含む Lambda を作成します。

AWS::Serverless::LayerVersion リソースはMetadataリソース属性もサポートしているため、アプリケーションに含まれるレイヤーを構築する AWS SAM ように指示できます。レイヤーの構築に関する詳細については、「AWS SAM での Lambda レイヤーの構築」を参照してください。

重要な注意： でのUpdateReplacePolicyリソース属性のリリース以降 AWS CloudFormation、 AWS::Lambda::LayerVersion (推奨) は と同じ利点を提供しますAWS::Serverless::LayerVersion。

Serverless LayerVersion が変換されると、 はリソースの論理 ID SAM も変換するため、リソースが更新され CloudFormation ても古い LayerVersions は自動的に削除されません。

注記

にデプロイすると AWS CloudFormation、 は AWS SAM リソースを AWS CloudFormation リソース AWS SAM に変換します。詳細については、「AWS SAM 向けに生成された AWS CloudFormation リソース」を参照してください。

構文

AWS Serverless Application Model （AWS SAM) テンプレートでこのエンティティを宣言するには、次の構文を使用します。

YAML

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

プロパティ

CompatibleArchitectures

レイヤバージョンでサポートされる命令セットアーキテクチャを指定します。

このプロパティの詳細については、AWS Lambda デベロッパーガイドの「Lambda 命令セットアーキテクチャ」を参照してください。

有効な値: x86_64、arm64

タイプ: リスト

必須: いいえ

デフォルト: x86_64

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの CompatibleArchitecturesプロパティに直接渡されます。

CompatibleRuntimes

この と互換性のあるランタイムのリスト LayerVersion。

タイプ: リスト

必須: いいえ

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの CompatibleRuntimesプロパティに直接渡されます。

ContentUri

Amazon S3 Uri、ローカルフォルダへのパス、またはレイヤーコードの LayerContent オブジェクト。

Amazon S3 Uri または LayerContent オブジェクトが指定されている場合、参照される Amazon S3 オブジェクトは Lambda レイヤー の内容を含む有効なZIPアーカイブである必要があります。

ローカルフォルダへのパスが提供されている場合は、コンテンツが適切に変換されるようにするために、sam build が含まれ、その後に sam deploy または sam package が続くワークフローをテンプレートが実行する必要があります。デフォルトでは、相対パスは AWS SAM テンプレートの場所に対して解決されます。

タイプ： 文字列 | LayerContent

必須: はい

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの Contentプロパティに似ています。ネストされた Amazon S3 プロパティには異なる名前が付けられています。

Description

このレイヤーの説明です。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの Descriptionプロパティに直接渡されます。

LayerName

レイヤーの名前または Amazon リソースネーム (ARN）。

型: 文字列

必須: いいえ

デフォルト: リソースの論理 ID

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの LayerNameプロパティに似ています。名前を指定しない場合は、リソースの論理 ID が名前として使用されます。

LicenseInfo

この のライセンスに関する情報 LayerVersion。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性： このプロパティは、AWS::Lambda::LayerVersionリソースの LicenseInfoプロパティに直接渡されます。

RetentionPolicy

このプロパティは、リソースを削除するときに LayerVersion の古いバージョンを保持するか削除するかを指定します。リソースを更新または置き換えるときに LayerVersion の古いバージョンを保持する必要がある場合は、 UpdateReplacePolicy 属性を有効にする必要があります。これを行う方法については、「AWS CloudFormation ユーザーガイド」の 「UpdateReplacePolicy 属性」を参照してください。

有効な値: Retain または Delete

タイプ：文字列

必須: いいえ

AWS CloudFormation 互換性 : このプロパティは に一意 AWS SAM であり、 AWS CloudFormation 同等の はありません。

追加の注意： を指定するとRetain、 は変換されたAWS::Lambda::LayerVersionリソースDeletionPolicy: Retainに AWS SAM でサポートされているリソース属性/ AWS SAM を追加します。

戻り値

参照番号

このリソースの論理 ID がRef組み込み関数に提供されると、基盤となる Lambda ARNのリソースが返されます LayerVersion。

Ref 関数の使用方法の詳細については、「AWS CloudFormation ユーザーガイド」の「Ref」を参照してください。

例

LayerVersionExample

の例 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