AWS::Serverless::Api DefinitionBody自动生成机制及配置咨询

1. 自动生成是SAM CLI还是AWS后端执行？ #

这个自动生成逻辑是由SAM CLI在本地执行的，而非AWS后端处理。当你运行sam build或sam deploy时，SAM CLI会扫描模板中的AWS::Serverless::Function资源及其关联的Api事件配置，自动拼接出对应的OpenAPI定义（即DefinitionBody），之后再把包含生成内容的完整模板发送到AWS CloudFormation完成部署。

2. 能否配置自动生成的行为？ #

默认的自动生成逻辑没有直接的“配置开关”来精细化调整，但你可以通过以下几种方式实现自定义适配：

• 全局配置统一调整：在模板的Globals部分定义Api的通用属性（比如默认授权方式、CORS规则），SAM自动生成的API会继承这些全局设置。
• 单个接口属性微调：在每个Function的Events配置里的Api节点中，指定Method、Path、Auth、RequestParameters等属性，SAM会根据这些参数生成对应接口的细节，覆盖默认行为。
• 混合自动与自定义定义：如果需要更复杂的调整，可以使用CloudFormation的!MergeWith指令，将SAM自动生成的DefinitionBody和你手动编写的部分配置合并，比如补充自定义响应模型、路径参数校验规则等。
• 完全手动定义（兜底方案）：如果上述方式都满足不了需求，直接指定DefinitionUri或DefinitionBody，SAM就会跳过自动生成逻辑，完全使用你提供的API定义。

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