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

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

AWS::Serverless::LayerVersion

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

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

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

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

注意

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

语法

要在 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
  PublishLambdaVersion: Boolean
  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 对象，则引用的亚马逊 S3 对象必须是包含 Lambda 层内容的有效 ZIP 档案。

如果提供了本地文件夹的路径，则为使内容正确转换，模板必须经过包括 sam build 以及后续的 sam deploy 或 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属性。

PublishLambdaVersion

一个 opt-in 属性，每当引用的资源发生变化时，它都会创建一个新的 Lambda 版本。LayerVersion当使用AutoPublishAlias和AutoPublishAliasAllProperties在连接的 Lambda 函数中启用时，将为对资源所做的每一次更改创建一个新的 Lambda 版本。LayerVersion

类型：布尔值

必需：否

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

RetentionPolicy

此属性指定当您删除资源时，是保留还是删除 LayerVersion 的旧版本。如果您在更新或替换资源时需要保留 LayerVersion 的旧版本，则必须启用 UpdateReplacePolicy 属性。有关执行此操作的信息，请参阅《Amazon CloudFormation 用户指南》中的 UpdateReplacePolicy 属性。

有效值：Retain 或 Delete

类型：字符串

必需：否

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

其他注意事项：指定后Retain， Amazon SAM 会DeletionPolicy: Retain向转换后的AWS::Lambda::LayerVersion资源添加一个支持的资源属性 Amazon SAM。

返回值

Ref

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

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

示例

LayerVersionExample

的示例 LayerVersion

YAML

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