AWS::Serverless::LayerVersion - Amazon Serverless Application Model
语法属性返回值示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS::Serverless::LayerVersion

创建一个 Lambda LayerVersion，其中包含 Lambda 函数所需的库或运行时代码。

这些区域有：AWS::Serverless::LayerVersion资源也支持Metadata资源属性，所以你可以指示Amazon SAM以构建应用程序中包含的图层。有关构建层的更多信息，请参阅。构建层.

重要提示：自发布以来UpdateReplacePolicy中的资源属性Amazon CloudFormation、AWS::Lambda::LayerVersion（推荐）提供与AWS::Serverless::LayerVersion.

转换无服务器 LayerVersion 时，SAM 还会转换资源的逻辑 ID，以便在更新资源时，CloudFormation 不会自动删除旧的 LayerVersion。

语法

要在您的Amazon Serverless Application Model(Amazon SAM) 模板，请使用以下语法。

YAML

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

属性

CompatibleArchitectures

指定图层版本支持的指令集体系结构。

有关此属性的更多信息，请参阅Lambda 指令集架构中的Amazon Lambda开发人员指南.

有效值：x86_64、arm64

类型：List

必需：否

默认值：x86_64

Amazon CloudFormation兼容性：此属性将直接传递给CompatibleArchitectures的财产AWS::Lambda::LayerVersion资源。

CompatibleRuntimes

与此 LayerVersion 兼容的运行时列表。

类型：List

必需：否

Amazon CloudFormation兼容性：此属性将直接传递给CompatibleRuntimes的财产AWS::Lambda::LayerVersion资源。

ContentUri

Amazon S3 Uri、本地文件夹的路径或图层代码的 LayerContent 对象。

如果提供了 Amazon S3 Uri 或 LayerContent 对象，则引用的 Amazon S3 对象必须是包含Lambda 层.

如果提供了本地文件夹的路径，为了正确转换内容，模板必须通过包括sam build然后是sam deploy要么sam package. 默认情况下，相对路径是相对于Amazon SAM模板的位置。

类型：字符串 |图层内容

必需：是

Amazon CloudFormation兼容性：此属性类似于Content的财产AWS::Lambda::LayerVersion资源。嵌套的 Amazon S3 属性的命名不同。

Description

此图层的描述。

类型：字符串

必需：否

Amazon CloudFormation兼容性：此属性将直接传递给Description的财产AWS::Lambda::LayerVersion资源。

LayerName

层的名称或 Amazon Resource Name (ARN)。

类型：字符串

必需：否

默认值：资源逻辑 ID

Amazon CloudFormation兼容性：此属性类似于LayerName的财产AWS::Lambda::LayerVersion资源。如果您没有指定名称，则将使用资源的逻辑 ID 作为名称。

LicenseInfo

有关此 LayerVersion 的许可证的信息。

类型：字符串

必需：否

Amazon CloudFormation兼容性：此属性将直接传递给LicenseInfo的财产AWS::Lambda::LayerVersion资源。

RetentionPolicy

指定更新后是保留还是删除 LayerVersion 的旧版本。

有效值：Retain 或 Delete

类型：字符串

必需：否

Amazon CloudFormation兼容性：此属性对是唯一的Amazon SAM而且没有Amazon CloudFormation等效函数。

附加说明：当你指定Retain、Amazon SAM添加资源属性的DeletionPolicy: Retain对变换AWS::Lambda::LayerVersion资源。

返回值

Ref

当此资源的逻辑 ID 提供给Ref内部函数，它返回底层 Lambda LayerVersion 的资源 ARN。

有关如何使用的更多信息Ref函数，请参阅Ref中的Amazon CloudFormation用户指南.

示例

图层版本示例

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