能否通过Fn::ImportValue为导入的现有API Gateway资源新增AWS SAM无服务器函数？

答案是肯定的，但只能给现有API添加全新路由，没法修改已有的路由配置，具体实现和注意事项如下：

实现步骤 #

1. 先从原API堆栈导出必要值 #

首先得确保部署现有API的CloudFormation/SAM堆栈已经导出了API的关键标识，比如RestApiId（API的唯一ID）和目标父资源的ResourceId（比如根路径的ID）。示例原堆栈输出配置：

Outputs:
  MyRestApiId:
    Value: !Ref MyRestApi
    Export:
      Name: MyRestApi-Id
  MyRestApiRootResourceId:
    Value: !GetAtt MyRestApi.RootResourceId
    Export:
      Name: MyRestApi-RootResourceId

2. 在新SAM模板中导入并关联函数 #

在包含新函数的SAM模板里，用Fn::ImportValue导入上面的导出值，然后通过Api事件把函数绑定到新的API路由上：

Resources:
  NewServerlessFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./path-to-function-code/
      Handler: index.handler
      Runtime: python3.11
      Events:
        NewApiEndpoint:
          Type: Api
          Properties:
            RestApiId: !ImportValue MyRestApi-Id
            Path: /new-function-endpoint
            Method: POST
            # 如果要把路由挂在非根路径下，导入对应父资源的ResourceId填这里
            ParentId: !ImportValue MyRestApi-RootResourceId

必须注意的限制 #

• 只能加新路由：SAM通过导入值的方式无法修改现有API里已存在的路由，只能新增完全独立的路由。
• 权限要匹配：跨堆栈场景下，要确保API Gateway有触发新函数的权限，新函数也允许被API Gateway调用（SAM通常会自动生成这些权限，但如果遇到权限问题，需要手动检查IAM角色配置）。
• 依赖原堆栈导出值：如果原堆栈删除或者导出值被修改，新堆栈的部署会直接失败。

复杂场景的替代方案 #

如果需要对现有API做更多调整（比如修改现有路由、添加阶段变量、配置自定义域名等），更稳妥的方式是：

• 直接在原API的SAM/CloudFormation模板里新增函数和路由，保持API和相关资源的部署一致性。
• 用原生CloudFormation资源AWS::ApiGateway::Resource和AWS::ApiGateway::Method手动配置，SAM的Api事件其实是这些原生资源的封装，灵活性更高。

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