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

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

AWS::Serverless::LayerVersion

创建包含 Lamb LayerVersion da 函数所需的库或运行时代码的 Lambda。

该AWS::Serverless::LayerVersion资源还支持Metadata资源属性，因此您可以指示Amazon SAM构建应用程序中包含的图层。有关建筑层的更多信息，请参阅建筑图层。

重要说明：自从发布UpdateReplacePolicy资源属性以来Amazon CloudFormation，AWS::Lambda::LayerVersion（推荐）提供的好处与AWS::Serverless::LayerVersion。

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

注意

当您部署到时Amazon CloudFormation，Amazon SAM会将您的Amazon SAM资源转换为Amazon CloudFormation资源。有关更多信息，请参阅生成的Amazon CloudFormation资源：

语法

要在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

指定层版本支持的指令集架构。

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

有效值：x86_64、arm64

类型：清单

必需：否

默认值：x86_64

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

CompatibleRuntimes

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

类型：清单

必需：否

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

ContentUri

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

如果提供了 Amazon S3 URI 或 LayerContent 对象，则引用的Amazon S3 对象必须是包含 Lambda 层内容的有效 ZIP 存档。

如果提供了本地文件夹的路径，则要正确转换内容，模板必须经过包括sam deploy或sam build在内的工作流程sam package。默认情况下，相对路径是相对于Amazon SAM模板的位置进行解析的。

类型：字符串 | LayerContent

必需：是

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

Description

此层的描述。

类型：字符串

必需：否

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

LayerName

层的名称或 Amazon 资源名称（ARN）。

类型：字符串

必需：否

默认：资源逻辑 ID

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

LicenseInfo

有关此许可证的信息 LayerVersion。

类型：字符串

必需：否

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

RetentionPolicy

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

有效值：Retain 或 Delete

类型：字符串

必需：否

Amazon CloudFormation兼容性：此属性是唯一的Amazon SAM，没有Amazon CloudFormation等效属性。

附加说明：指定时Retain，Amazon SAM将DeletionPolicy: Retain向转换后的AWS::Lambda::LayerVersion资源添加一个资源属性。

返回值

Ref

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

有关使用该Ref函数的更多信息，请参阅Ref《Amazon CloudFormation用户指南》。

示例

LayerVersionExample

的示例 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