CloudFormation中AWS::ApiGateway::Method报错'Invalid Resource identifier specified'排查

关于Deployment提前创建的问题 #

必须通过DependsOn显式指定Deployment对所有Method资源的依赖关系。CloudFormation默认会根据资源引用自动推断依赖，但程序化生成模板时，可能存在引用未正确关联的情况，导致Deployment在Method创建前就执行。

解决方式：在AWS::ApiGateway::Deployment资源中添加DependsOn属性，列出所有AWS::ApiGateway::Method的逻辑ID，确保Deployment仅在所有Method创建完成后才触发创建。示例：

MyApiDeployment:
  Type: AWS::ApiGateway::Deployment
  Properties:
    RestApiId: !Ref MyRestApi
    StageName: prod
  DependsOn:
    - MyGetMethod
    - MyPostMethod

关于Method的ResourceId报错问题 #

报错“Invalid Resource identifier specified”即使引用符合文档规范，也可能是以下原因导致：

• 逻辑ID拼写/大小写错误：CloudFormation资源逻辑ID区分大小写，检查ResourceId的!Ref指向的AWS::ApiGateway::Resource逻辑ID是否完全匹配，程序化生成时容易出现大小写不一致或拼写错误。
• 跨API引用错误：确认Method的RestApiId和引用的Resource所属的RestApiId是同一个，避免将其他API的Resource ID误用到当前API的Method中。
• Resource未正确创建：检查对应的AWS::ApiGateway::Resource是否存在依赖缺失，比如子Resource未正确依赖父Resource，导致Resource未成功创建，进而Method引用无效的ID。
• 程序化生成的引用格式错误：如果是通过代码生成模板，确认输出的ResourceId是!Ref ResourceLogicalId而不是硬编码的资源物理ID，物理ID在模板创建阶段还未生成，会导致引用无效。

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