Amazon SAM 支持的资源属性 - Amazon Serverless Application Model
异常
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon SAM 支持的资源属性

资源属性是可添加至 Amazon SAM 和 Amazon CloudFormation 资源以控制其他行为和关系的属性。有关资源属性的更多信息，请参阅《Amazon CloudFormation 用户指南》中的资源属性引用。

Amazon SAM 支持由 Amazon CloudFormation 定义的资源属性的子集。在支持的资源属性中，有些仅复制到相应 Amazon SAM 资源的基础生成的 Amazon CloudFormation 资源中，有些则复制到由相应 Amazon SAM 资源产生的所有生成的 Amazon CloudFormation 资源中。有关从相应 Amazon SAM 资源生成的 Amazon CloudFormation 资源的更多信息，请参阅 为 Amazon SAM 生成的 Amazon CloudFormation 资源。

下表汇总了 Amazon SAM 对资源属性的支持，具体视下方所列 异常 而定。

资源属性 目标生成的资源

DependsOn

元数据 1, 2

仅基础 Amazon CloudFormation 生成的资源。有关 Amazon SAM 资源和基础 Amazon CloudFormation 资源之间映射的信息，请参阅 生成的 Amazon CloudFormation 资源场景。

Condition

DeletionPolicy

UpdateReplacePolicy

所有从相应 Amazon SAM 资源生成的 Amazon CloudFormation 资源。有关生成 Amazon CloudFormation 资源的场景的信息，请参阅 生成的 Amazon CloudFormation 资源场景。

注意:

  1. 有关使用 Metadata 资源属性和 AWS::Serverless::Function 资源类型的更多信息，请参阅 在 Amazon SAM 中构建具有自定义运行时的 Lambda 函数。

  2. 有关使用 Metadata 资源属性和 AWS::Serverless::LayerVersion 资源类型的更多信息，请参阅 在 Amazon SAM 中构建 Lambda 层。

异常

前面描述的资源属性规则有许多例外情况：

  • 对于 AWS::Lambda::LayerVersion，仅适用于 Amazon SAM 的自定义字段 RetentionPolicy 为生成的 Amazon CloudFormation 资源设置 DeletionPolicy。它的优先级高于 DeletionPolicy 其本身。如果两者均未设置，则默认将 DeletionPolicy 设置为 Retain。

  • 对于 AWS::Lambda::Version，如果未指定 DeletionPolicy，则默认为 Retain。

  • 对于为无服务器函数指定 DeploymentPreferences 的场景，资源属性不会复制到以下生成的 Amazon CloudFormation 资源中：

    • AWS::CodeDeploy::Application

    • AWS::CodeDeploy::DeploymentGroup

    • 为此场景创建的名为 CodeDeployServiceRole 的 AWS::IAM::Role

  • 如果您的 Amazon SAM 模板包含多个带有隐式创建的 API 事件源的函数，则这些函数将共享生成的 AWS::ApiGateway::RestApi 资源。在这种情况下，如果函数具有不同的资源属性，则对于生成的 AWS::ApiGateway::RestApi 资源，Amazon SAM 将根据以下优先级列表复制资源属性：

    • UpdateReplacePolicy:

      1. Retain

      2. Snapshot

      3. Delete

    • DeletionPolicy:

      1. Retain

      2. Delete