如何通过Fn::Transform将Ref传递给CloudFormation宏？

报错原因 #

CloudFormation在调用宏（Transform）的早期阶段会先验证宏的参数，要求参数必须是静态可解析的值（字符串、数字、布尔或它们的列表）。而Ref、Fn:GetAtt这类动态引用要等到资源创建阶段才能解析出实际值，此时宏还未被调用就会触发参数验证失败，导致报错。

可行解决方案 #

方案1：传递资源逻辑ID作为静态参数，在宏中生成动态引用 #

将目标资源的逻辑ID（而非实际资源ID）以静态字符串形式传给宏，然后在宏的Lambda处理函数中，生成包含Ref或Fn:GetAtt的模板代码，让CloudFormation后续自动解析。

示例模板：

Transform:
  - Name: TestMacro
    Parameters:
      TargetResourceLogicalID: MyEC2Instance # 静态字符串传逻辑ID
Resources:
  MyEC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: ami-xxxxxx
      InstanceType: t2.micro

宏的Lambda函数示例（Python）：

def lambda_handler(event, context):
    template = event["template"]
    params = event["transformParameters"]
    target_logical_id = params["TargetResourceLogicalID"]
    
    # 在生成的模板中添加引用该资源的内容
    template["Resources"]["NewResource"] = {
        "Type": "AWS::S3::Bucket",
        "Properties": {
            "Tags": [
                {
                    "Key": "AttachedEC2",
                    "Value": {"Ref": target_logical_id} # 宏生成动态引用
                }
            ]
        }
    }
    return {"template": template}

方案2：将动态引用片段放在模板主体中，由宏直接处理 #

不需要通过宏参数传递引用，而是把包含动态引用的资源定义放在模板主体里，让宏直接修改或扩展这部分内容。这种方式跳过了宏参数的静态验证，直接让宏操作模板中的动态引用。

示例模板：

Transform:
  - Name: TestMacro
Resources:
  MyEC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: ami-xxxxxx
      InstanceType: t2.micro
  # 以下是需要宏处理的资源，包含动态引用
  ToBeProcessedResource:
    Type: Custom::MyResource
    Properties:
      SourceEC2: !Ref MyEC2Instance

宏的Lambda函数可以直接读取ToBeProcessedResource的Properties，对其进行修改或生成关联资源，此时!Ref MyEC2Instance会在宏处理后保留在模板中，后续由CloudFormation解析。

关键注意事项 #

• 宏的执行时机在CloudFormation模板解析的早期，此时所有资源都未被创建，无法获取实际的资源ID。
• 所有需要动态引用的内容，必须以CloudFormation支持的内置函数形式（Ref、Fn:GetAtt等）保留在宏输出的模板中，由CloudFormation后续阶段处理。

内容的提问来源于stack exchange，提问作者Dasmowenator