GCP Vertex AI取消部署端点模型报404：指定DeployedModel ID缺失

这个报错最常见的原因是传入的deployed_model_id不对：模型本身的资源ID、模型版本ID，和模型部署到端点后生成的部署ID是完全独立的两个标识，不能混用，绝大多数人踩的都是这个坑。

一步步排查修复 #

• 先确认客户端连接的是正确的资源
  不管是用SDK还是REST API，先确认你请求的项目、区域、端点ID和你实际操作的目标资源完全一致，很多人本地SDK默认配置连的是测试项目，找生产环境的模型自然报404。
  SDK正确初始化示例：

  from google.cloud import aiplatform
  # 替换成你自己的项目ID、端点所在区域
  aiplatform.init(project="gcp-project-id", location="端点部署区域，比如us-central1")
  endpoint = aiplatform.Endpoint("你的端点ID")
  

• 拿到真实的部署ID
  不要自己猜ID，直接拉取端点下的已部署模型列表，拿系统生成的真实部署ID：

  for deployed_model in endpoint.list_models():
      print(f"可用deployed_model_id: {deployed_model.id}")
      print(f"关联模型: {deployed_model.model}")
      print(f"流量占比: {deployed_model.traffic_percentage}%")
  

• 执行取消部署
  用上面打印出来的ID替换你之前传的参数即可：

  endpoint.undeploy(deployed_model_id="上一步拿到的真实部署ID")
  

快捷操作 #

如果你确认当前端点只部署了这一个模型（和你描述的100%流量单模型场景一致），不需要手动找ID，直接调用全量取消部署接口即可：

# 注意：生产环境操作前务必确认当前端点是你要操作的目标，避免误下线线上服务
endpoint.undeploy_all()

如果是调用REST接口报同样的错，除了核对请求体里的deployedModelId，还要逐一检查请求路径里的项目编号、区域、端点ID是否正确，任意一项填错都会返回相同的404提示。不要从控制台的「模型管理」页面复制ID当部署ID用，正确的部署ID在端点详情页的「已部署模型」板块可以查到。

内容的提问来源于stack exchange，提问作者Sudhanshu Yadav