使用Terraform创建MongoDB集群报401未授权访问资源错误

错误现象 #

使用Terraform创建MongoDB集群时返回401错误，错误信息：

error creating MongoDB Cluster - You are not authorized for this resource
已完成的前置配置：

• 使用API密钥作为身份凭证执行Terraform操作
• 已配置IP白名单、API密钥ACL规则
• 操作人账号持有对应组织、项目的所有者角色

根因排查与修复方案 #

按优先级依次排查以下问题，90%以上的该类错误都能解决：

• 给API密钥单独分配项目级角色
  API密钥是独立的权限主体，不会自动继承创建者的组织/项目所有者权限。进入MongoDB控制台的API密钥管理页，找到当前使用的密钥，手动给它绑定目标项目的Project Owner或者Cluster Admin角色，仅配置组织级权限、未绑定具体项目角色的密钥无法操作项目下的集群资源。
• 校验Provider配置的参数正确性
  打开Terraform配置文件，核对mongodbatlas provider块的核心参数，不要把组织ID误填到项目ID字段：

  provider "mongodbatlas" {
    public_key  = "当前使用的API公钥"
    private_key = "对应API私钥"
    project_id  = "目标集群所属的项目ID，不要填组织ID"
  }
  

  如果你在mongodbatlas_cluster等项目级资源块中单独指定了project_id参数，也要同步核对该值和目标项目ID完全一致，避免ID填错跨项目操作触发权限报错。
• 核对白名单配置层级
  API密钥的IP白名单/ACL规则必须和密钥所属层级匹配：组织级创建的API密钥，白名单需要配置在组织的API访问列表中；项目级创建的API密钥，白名单需要配置在对应项目的API访问列表下，层级不匹配的白名单规则不会生效。
• 确认API密钥状态正常
  进入API密钥管理页，确认当前使用的密钥处于启用状态，没有被管理员禁用、没有超出有效期。

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