启用 Compute Engine API：从零上手 – 谷歌GCP云服务器代维护

TL;DR：讲清启用 Compute Engine API 的作用、控制台与 gcloud 步骤、常见报错、替代方案和运维最佳实践。

它是什么：先认识 Compute Engine API

先把 API 想成 GCP 的「办事窗口」。你在控制台点「创建 VM」，或运行 gcloud 命令，背后都是把请求交给 Compute Engine API。它是 GCP 用来创建、查询、启动、停止和删除 VM 等资源的后台接口，磁盘、镜像、网络等相关资源也由它配合管理。

启用 Compute Engine API，就是在当前项目里打开这项服务。打开后，控制台和 gcloud 才能调用它；没打开时，常见提示是「需要启用 API」，或命令报服务未启用、权限不足一类错误。如果你已装好 gcloud，先确认当前项目；这不会创建 VM：

gcloud config get-value project

这行显示当前项目 ID。为什么要先看？因为 API 是按项目启用的：很多人在 A 项目开过，却把命令跑在 B 项目，以为没生效。项目 ID 不是项目名，也不是邮箱；结果为空、显示 (unset)，或不是目标项目时，先别继续。确认项目后，再检查服务状态：

gcloud services list --enabled --filter="name:compute.googleapis.com"

这条命令会看当前项目有没有 compute.googleapis.com。别误会：Compute Engine API 不是一台服务器，也不是 SSH 服务。启用它不会生成一台叫「API」的 VM，不会让你登录，也不会自动打开 22 端口。它负责让管理 VM 的请求被平台接受：创建、查询、开机、关机、删除都要先过这道门。能否 SSH 连进 VM，还取决于实例、外部 IP、防火墙、密钥和权限。

按项目配置：不同项目要分别启用，换项目后重新检查，不能继承。
不只看账号登录：登录同一个 Google 账号，也要有项目内 IAM 权限。
和账单一起生效：结算账号无效、账单异常或额度用完，后续创建 VM 仍会失败。
别混报错：API 未启用、没权限、账单不可用、SSH 连不上，是不同问题。

一句话：启用 Compute Engine API 是给当前项目开通管理 VM 的入口；项目选对，账号登录、账单状态和权限都满足后，控制台与 gcloud 的请求才会被 GCP 正常受理。

解决什么问题：为什么创建 VM 前要先启用

把「启用 Compute Engine API」想成给当前项目开一扇总门。控制台的「创建实例」只是替你调用门后的接口。门没开，新建 VM 常提示服务未启用，或被误判成权限不足；区域、机器类型、镜像也可能空白、灰色，选不了机器配置。先开门，就少截图、少找按钮。

gcloud init
gcloud config get-value project
gcloud services enable compute.googleapis.com
gcloud services list --enabled --filter="config.name:compute.googleapis.com"

第一行引导登录并选项目；第二行务必确认项目 ID 是你要放 VM 的那个，第三行才在该项目开启，第四行验证。常见坑是：在测试项目开了，却去正式项目建机；本地终端和 Cloud Shell 配置不同，以为开过。项目不对就重跑初始化那一行。也别以为开门等于万能：账号仍要有创建实例的 IAM 权限；只加角色、不开 API 一样报错。

这个开关是项目级的，不是每台 VM、每个页面各开一次。启用后，控制台、gcloud、脚本和自动化工具都走同一入口，拉取区域、机型、镜像的规则一致，不用再对照「为什么我能选、他不能选」。

后续挂载磁盘、配 VPC 和防火墙、做快照、存自定义镜像，也都经这套接口读取或创建；先打底，按钮和脚本才不会忽灰忽报找不到。

显式开关还方便管理：审计日志能查谁何时启用；启用本身通常不产生 VM 账单，真正计费的是之后运行中的 VM、磁盘、快照，便于按预算创建；最小权限上，可把「启用服务」与「创建实例」分开授权，不必为建一台机器给大范围管理员。

怎么上手：控制台与 gcloud 两条路

想开虚拟机却看到「Compute Engine API 尚未启用」？别慌，API 就像水电总闸，不先拧开，机器根本通不了电。给你两条路，挑顺手的来。

路线一：控制台点一点

打开 console.cloud.google.com 登录后，先盯住左上角的项目下拉框。这是新手最大的坑：常挂着默认旧项目，结果 API 开到了别处，回头怎么找都找不到。同时确认项目已绑有效账单账号，没绑的话「启用」按钮会灰掉——GCP 得先确认能结账才肯放行。

顶部搜索框敲 Compute Engine API 进详情页，点「启用」。别立刻关页面，等状态变成「已启用」再走：权限下发到各可用区有延迟，马上建机器常会报「服务未就绪」，多等十几秒最省心。

路线二：gcloud 敲三行

想长期用就装 Google Cloud CLI。先登录、再锁项目、最后开服务，顺序别反，不然命令又跑到别的项目去了：

gcloud auth login
gcloud config set project my-vm-demo-2024
gcloud services enable compute.googleapis.com

第一行会弹浏览器让你授权；第二行复制后把 my-vm-demo-2024 换成控制台里那串小写加数字的项目 ID，千万别填中文显示名，这是最常见的报错；第三行只开服务、不建资源，干净又安全。

飘红字「没权限」咋办

这不是你点错了，是 IAM 角色不够。去「IAM 与管理」查一眼：最对症的是 Service Usage Admin（专管 API 开关），顺手加 Compute Admin 也行，后面建 VM 正好用得上。公司项目管得严就别硬试，把上面第三行命令发给项目所有者（Owner）代跑，比走审批快得多。

收尾验一下

别启用完就关电脑。回控制台进「Compute Engine → 虚拟机实例」，试着建台最小的 e2-micro（有免费额度，练手不心疼）；或者回到终端跑一行，能正常返回列表就说明闸真通了：

gcloud compute instances list

只要不再弹「API not enabled」就算过关。以后碰到别的 API 提示，照着「选项目 → 开服务 → 等生效 → 验一下」这套节奏走，基本不翻车。

与替代方案对比：别把几个入口混在一起

先别把三个入口想成三套系统：控制台页面、gcloud、Terraform 最后都调用同一批 GCP API，把项目里的 compute.googleapis.com 打开。网页点完再跑命令只是确认；命令成功回页面刷新也是同一状态，不是互相替代的后端。

控制台：第一次最稳。「API 和服务 → 库」搜「Compute Engine API」→「启用」，能看见顶部项目和状态，适合可视化确认；缺点是步骤多，项目一多就点不过来，不适合批量项目。坑：API 是按项目启用的，顶部选了 A 却去 B 建虚拟机，会又报「未启用」，不是账号开一次就全开。
gcloud：运维、脚本化、重复启用更顺手。本地要装 Google Cloud CLI 并登录；用控制台右上角 Cloud Shell 可免安装，但授权和选默认项目绕不开。第一条开浏览器登录选项目，第二条打印账号和项目给你核对，第三条才启用：

gcloud init
gcloud config list
gcloud services enable compute.googleapis.com

先核对，是因为命令默认打在「当前默认项目」上，旧电脑常留着上次的配置。批量时先看清单，确认没有生产项目再跑循环；--project 显式指定，免得默认项目串台：

gcloud projects list --format="value(projectId)"
for p in $(gcloud projects list --format="value(projectId)"); do
  gcloud services enable compute.googleapis.com --project="$p"
done

别一上来整段复制循环，它会对账号可见的每个项目都执行；个别项目报 403，多半是 IAM 没给够，不是命令写错。

Terraform 等基础设施即代码：适合团队规范。把「开哪些服务」写进文件，评审和复用都方便；但新手先懂项目和 IAM：项目是资源归属单位，执行人要有 serviceusage.services.enable 权限（常见是 Service Usage Admin），能看项目不等于能启用。存成 main.tf：

provider "google" {}

resource "google_project_service" "compute" {
  service            = "compute.googleapis.com"
  disable_on_destroy = false
}

再在 Cloud Shell 或 macOS / Linux 里执行，Windows 开 Cloud Shell 最省事。第一行把 Terraform 项目和刚才 gcloud 选的项目对齐，第二行给 Terraform 授权；最后一步看到计划里只新增 1 项，再输入 yes：

export GOOGLE_PROJECT="$(gcloud config get-value project)"
gcloud auth application-default login
terraform init
terraform apply

disable_on_destroy = false 是故意的：以后删资源时别顺手关掉 API，已有虚拟机会受影响。记住，三者只是「谁去按开关」，Terraform 多做的只是把状态记进 tfstate，按的仍是同一批 GCP API。

最佳实践：启用后也要稳、省、安全

Compute Engine API 启用成功只是拿到“可以创建 VM 的门票”。下面命令默认你已在 Cloud Shell 登录并选好当前项目；若提示项目为空，先切到目标项目再复制执行。

权限收窄。只给负责启用的人临时加 Service Usage Admin；日常查看用 Compute Viewer，管 VM 用 Compute Instance Admin (v1)，用完移除，别长期给 Project Owner。Owner 能改账单、删项目，误点代价大。先查项目本级高风险角色；没有输出也别大意，组织或文件夹继承权限还要在 IAM 页面看。
```
PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
gcloud projects get-iam-policy "$PROJECT_ID" --flatten='bindings[].members' --format='table(bindings.role,bindings.members)' | grep -E 'roles/owner|roles/serviceusage.serviceUsageAdmin|roles/compute.instanceAdmin.v1|roles/compute.viewer' || true
```

每个项目留清单。复制后会让你输入用途，并写入时间、当前账号、项目 ID、账单账号和用途；排错、审计时能说清“谁开的、为何开、钱算哪”。坑：账单栏为空要先去“结算”确认绑定或找管理员看权限；代别人启用，要在用途里写实际申请人。

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
read -r -p "用途备注（例如：官网压测/课堂演示）：" PURPOSE
BILLING_ACCOUNT="$(gcloud billing projects describe "$PROJECT_ID" --format='value(billingAccountName)' 2>/dev/null)"
[ -f compute-api-enable-log.csv ] || printf 'time,project_id,enabled_by,billing_account,purposen' > compute-api-enable-log.csv
printf '%s,%s,%s,%s,%sn' "$(date -u +%FT%TZ)" "$PROJECT_ID" "$(gcloud config get-value account 2>/dev/null)" "$BILLING_ACCOUNT" "$PURPOSE" | tee -a compute-api-enable-log.csv

启用后立刻体检。项目级和区域级配额、可用区、机器类型、防火墙都要看。坑：某区域没有目标机型、配额为 0、防火墙没放行 SSH/RDP，常常等到创建 VM 才报错；别只看“API 已启用”就下单。

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
gcloud compute project-info describe --project "$PROJECT_ID" --format='table(quotas.metric,quotas.limit,quotas.usage)'
gcloud compute regions list --project "$PROJECT_ID" --format='table(name,status)'
gcloud compute regions list --project "$PROJECT_ID" --format='value(name)' | while read -r REGION; do
  printf '区域: %sn' "$REGION"
  gcloud compute regions describe "$REGION" --project "$PROJECT_ID" --format='table(quotas.metric,quotas.limit,quotas.usage)'
done
gcloud compute zones list --project "$PROJECT_ID" --format='table(name,region.basename(),status)' --limit=20
gcloud compute machine-types list --project "$PROJECT_ID" --format='table(name,zone.basename(),guestCpus,memoryMb)' --limit=20
gcloud compute firewall-rules list --project "$PROJECT_ID" --format='table(name,network.basename(),direction,priority,allowed,sourceRanges)'

自动化要等。API 生效和权限传播有延迟，脚本要重试，并把 gcloud 命令、项目 ID、错误日志留档，否则 CI 偶发失败很难复现。下面最多试 5 次，每次等 10 秒，日志写到 compute-api-enable.log。

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
LOG_FILE="compute-api-enable.log"
ENABLE_CMD="gcloud services enable compute.googleapis.com --project $PROJECT_ID"
CHECK_CMD="gcloud services list --enabled --project $PROJECT_ID --format=value(config.name)"
{
  printf '开始时间: %sn' "$(date -u +%FT%TZ)"
  printf '项目 ID: %sn' "$PROJECT_ID"
  printf '启用命令: %sn' "$ENABLE_CMD"
  printf '检查命令: %sn' "$CHECK_CMD"
} >> "$LOG_FILE"

for i in 1 2 3 4 5; do
  printf '第 %s 次执行: %sn' "$i" "$ENABLE_CMD" >> "$LOG_FILE"
  gcloud services enable compute.googleapis.com --project "$PROJECT_ID" >> "$LOG_FILE" 2>> "$LOG_FILE"
  if gcloud services list --enabled --project "$PROJECT_ID" --format='value(config.name)' 2>> "$LOG_FILE" | grep -q '^compute.googleapis.com$'; then
    printf '第 %s 次确认已启用n' "$i" >> "$LOG_FILE"
    break
  fi
  printf '第 %s 次尚未生效或失败，10 秒后重试n' "$i" >> "$LOG_FILE"
  sleep 10
done

if gcloud services list --enabled --project "$PROJECT_ID" --format='value(config.name)' 2>> "$LOG_FILE" | grep -q '^compute.googleapis.com$'; then
  printf '最终状态: 已启用n' >> "$LOG_FILE"
else
  printf '最终状态: 未确认，请查看上面的错误日志n' >> "$LOG_FILE"
fi
tail -n 20 "$LOG_FILE"

不用就真删。禁用 API 不会自动清理 VM、磁盘、快照或静态 IP；停止 VM 也不等于删除，磁盘和预留 IP 仍可能计费。测试资源统一用 api-enable-test 开头命名，先列出来确认没混进生产资源，再删；提示磁盘被占用时，等 VM 删完再跑一次磁盘那段。

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
gcloud compute instances list --project "$PROJECT_ID" --filter='name~^api-enable-test' --format='table(name,zone.basename(),status)'
gcloud compute disks list --project "$PROJECT_ID" --filter='name~^api-enable-test' --format='table(name,zone.basename(),sizeGb,users)'

确认列表里只有测试资源后，再执行：

PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
gcloud compute instances list --project "$PROJECT_ID" --filter='name~^api-enable-test' --format='csv[no-heading](name,zone.basename())' | while IFS=, read -r NAME ZONE; do
  gcloud compute instances delete "$NAME" --zone="$ZONE" --project="$PROJECT_ID" --quiet
done
gcloud compute disks list --project "$PROJECT_ID" --filter='name~^api-enable-test' --format='csv[no-heading](name,zone.basename())' | while IFS=, read -r NAME ZONE; do
  gcloud compute disks delete "$NAME" --zone="$ZONE" --project="$PROJECT_ID" --quiet
done

常见问题（FAQ）

不启用会怎样？

创建或管理 VM 时可能报权限或服务未启用错误，控制台也会拦截。

启用会收费吗？

启用 API 本身通常不收费，后续创建 VM、磁盘和出网流量才计费。

需要什么权限？

项目所有者或具备 Service Usage Admin、相关 IAM 权限的账号可操作。

用控制台还是 gcloud？

新手先用控制台，批量或多项目自动化更适合 gcloud 和脚本。

启用后多久生效？

通常几秒到几分钟，若报错可等待后重试并检查配额和账单。

不想自己折腾 GCP？我们提供云平台代维护、上云迁移与账单代付服务，一对一技术支持。

查看代维服务 →