用途:该技能用于直接调用 Google Cloud REST API,覆盖通常通过 gcloud 访问的广泛资源管理面,包括项目、IAM、已启用 API、计算、存储、数据、部署、日志与账单。适合需要发现可访问项目及其 IAM 策略、检查已启用 API 与常见基础设施资源,或将某个 gcloud 任务转换为直接 REST 调用的场景。
前提与授权:需在 app.vm0.ai/connectors 连接 Google Cloud 连接器,访问令牌注入为 $GOOGLE_CLOUD_TOKEN。连接器不绑定单一项目,可见范围由 Google IAM 角色、已启用 API 与组织策略决定。连接器已授权的 API 主机涵盖 cloudresourcemanager、serviceusage、iam、compute、appengine、sqladmin、bigquery、storage、run、cloudbuild、artifactregistry、container、cloudfunctions、secretmanager、logging、monitoring、cloudbilling、pubsub、firestore、spanner。
主要能力与用法:以 curl 配合 Authorization: Bearer 令牌调用。常见用法包括搜索可访问项目(GET cloudresourcemanager.googleapis.com/v3/projects:search)、获取项目元数据、读取 IAM 策略(POST v3/projects/{id}:getIamPolicy)、测试权限(testIamPermissions)、列出服务账号、列出已启用 API、启用 API,以及列举 Compute Engine 实例、Cloud Storage 桶与对象、BigQuery 数据集与表并运行查询、Cloud Run 服务、GKE 集群、Cloud Build 构建、Artifact Registry 仓库、Cloud Functions、App Engine 服务、Pub/Sub 主题、Firestore 数据库、Spanner 实例、Cloud SQL 实例、Secret Manager 密钥、Logging 日志、Monitoring 指标描述符与项目账单信息。多份操作需先将请求体写入 /tmp 下的 JSON 文件再以 -d @文件 提交。
限制与注意事项:先通过 Cloud Resource Manager 发现项目;Service Usage 或 Resource Manager 返回 projects/{number} 时使用项目编号,产品 API 文档使用 {project} 或 {projectId} 时使用项目 ID;使用前应检查已启用 API。Google IAM 是权限的唯一依据,已连接的 OAuth 令牌不会绕过 IAM、组织策略、VPC Service Controls 或 API 启用状态。建议先做只读检查,启用 API、更改 IAM、创建或删除资源、读取密钥内容前需用户明确确认。大项目需用 nextPageToken 或 pageToken 处理分页,含斜杠、空格、引号等特殊字符时需 URL 编码。故障排查可运行 zero doctor check-connector 命令。其余细节暂未提供。