新建Compute Engine访问Google Cloud Storage报权限范围错误如何处理
错误提示含义解释
because the Compute Engine instance does not have any permission scopes specified
这个提示指的是你当前运行Node.js应用的新GCE实例,没有配置对应的OAuth 2.0权限范围。GCP对Compute Engine实例调用官方API有两层权限校验:
- 第一层是实例绑定的服务账号本身的IAM权限,比如是否有云存储桶的读取权限
- 第二层就是这里提到的实例层面的权限范围,是作用于整个实例的访问限制,就算服务账号有对应权限,只要实例没开对应服务的scope,就无法申请到合法的API访问令牌,请求直接被拦截。
你代码中调用云存储的getFiles()接口需要云存储相关的scope,当前实例未配置该scope,所以触发了访问令牌刷新失败的异常。
权限范围的查看与配置方法
权限范围是GCE实例的属性,修改前必须先停止实例,有两种操作方式:
1. Cloud控制台操作
- 进入Google Cloud控制台的「Compute Engine - 虚拟机实例」页面
- 找到目标实例,点击实例名称进入详情页,点击顶部「停止」按钮等待实例关机
- 关机完成后点击顶部「编辑」按钮
- 下拉找到「Cloud API访问权限」板块,找到「Cloud Storage」项,按需选择权限:
- 仅需要读取存储桶文件选「只读」即可
- 需要上传、修改、删除文件选「读写」
- 保存配置后重新启动实例即可
2. gcloud命令行操作
执行以下命令替换对应的实例名、可用区参数即可:
# 停止实例 gcloud compute instances stop <你的实例名称> --zone <实例所在可用区> # 配置权限范围,storage-ro为云存储只读,需要读写换成storage-rw即可 gcloud compute instances set-service-account <你的实例名称> \ --zone <实例所在可用区> \ --scopes storage-ro # 重新启动实例 gcloud compute instances start <你的实例名称> --zone <实例所在可用区>
相关问题说明
必须修改Compute Engine实例的配置才能解决该问题:权限范围是实例层级的独立限制,仅修改代码、调整服务账号IAM权限都无法绕过该限制,必须完成上述实例配置修改。
配置完成后建议额外确认实例绑定的服务账号是否有目标存储桶的对应IAM权限,比如roles/storage.objectViewer(只读)或者roles/storage.objectAdmin(读写),两层权限都配置正确后访问就不会再报错。
内容的提问来源于stack exchange,提问作者marco birchler
相关产品推荐
相关产品推荐

