GCP Recommender API调用返回“Listed 0 items”问题求助

可能原因 #

• 资源未满足推荐/洞察触发条件
  不同类型的推荐器和洞察有明确的触发阈值：
  • google.compute.instance.CpuUsageInsight 通常针对CPU平均使用率<5%持续超过14天的实例；
  • google.compute.instance.IdleResourceRecommender 要求实例闲置（无流量、低负载）超过7天。如果你的实例不符合这些条件，自然不会生成结果。
• 权限配置不足
  即使能执行命令，当前账号可能缺少recommender.insights.list或recommender.recommendations.list权限，或者没有被授予roles/recommender.viewer这类包含查看权限的角色。
• Recommender API未启用
  项目中未开启Recommender API时，GCP不会生成任何推荐或洞察数据，查询自然返回空结果。
• 位置参数不匹配
  Compute Engine实例的推荐/洞察数据并非全部存储在global位置，大部分是和实例所在区域绑定的（比如us-central1），指定错误的位置会导致查不到数据。
• 数据采集周期未达标
  GCP需要时间收集和分析资源使用数据，新创建的实例通常需要7-30天的积累周期，才能生成有效的洞察或推荐。

解决办法 #

• 验证资源状态
  登录GCP控制台，进入Compute Engine的实例监控面板，查看目标实例过去14-30天的CPU使用率、网络流量等数据，确认是否符合触发条件。
• 检查并补充权限
  给当前账号分配roles/recommender.viewer角色（涵盖所有推荐器和洞察的查看权限），或者单独添加recommender.insights.list和recommender.recommendations.list权限。
• 启用Recommender API
  在GCP控制台的API库中搜索“Recommender API”，点击启用按钮完成配置。
• 修正位置参数
  找到实例所在的区域（比如us-west1），替换命令中的--location=global参数，示例：

  gcloud beta recommender insights list --project=my_project_id --location=us-west1 --insight-type=google.compute.instance.CpuUsageInsight
  

  gcloud recommender recommendations list --project=my_project_id --location=us-west1 --recommender=google.compute.instance.IdleResourceRecommender
  

• 等待数据积累
  如果是新实例，等待至少7天（部分场景需要14天以上），待GCP完成数据采集和分析后再重新查询。

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