查看适用于批处理的虚拟机操作系统映像

本页面介绍如何查看可用于运行 Batch 作业的虚拟机 (VM) 实例的操作系统 (OS) 映像。

具体而言，本页面介绍如何查看 Batch 中的虚拟机操作系统映像的列表和详细信息。如需详细了解虚拟机操作系统映像以及可与 Batch 搭配使用的虚拟机操作系统映像，请参阅 虚拟机操作系统环境概览。 如果您想查看其他虚拟机操作系统映像（例如 Compute Engine 中的公共 映像或自定义映像），请改为参阅 Compute Engine 映像文档。

准备工作

  1. 如果您之前未使用过 Batch，请查看 Batch 使用入门 ，并完成 项目和用户的前提条件以启用 Batch。

查看 Batch 中的虚拟机操作系统映像列表

您可以使用 gcloud CLI 或 Batch API 查看 Batch 中的所有虚拟机操作系统映像的列表。

gcloud

如需列出 Batch 中的所有受支持虚拟机操作系统映像，请使用 以下 gcloud compute images list 命令：

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • 必须使用 --project=batch-custom-image 标志才能列出 Batch 中的映像。
  • --no-standard-images 标志会省略 Compute Engine 中的标准映像。
  • 可选：如果您需要查看已废弃的 Batch 映像，请同时添加 --show-deprecated 标志。

每个虚拟机操作系统映像的输出类似于以下内容：

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

此输出包括以下值：

  • IMAGE_NAME：映像的名称。 映像名称表示虚拟机操作系统映像的特定版本。 例如，映像名称 batch-cos-stable-official-20260730-00-p01 表示映像系列 batch-cos-stable-official的映像版本 -20260730-00-p01 （2026 年 7 月 30 日的版本）。
  • IMAGE_PROJECT_ID：包含映像的项目的 项目 ID 。例如，Batch 映像中的所有映像都位于 batch-custom-image 项目中。
  • IMAGE_FAMILY：映像的系列。 映像系列包含一个或多个特定映像，并表示 操作系统的类型和 主要版本 。例如，batch-debian-12-official 映像系列 包含基于 Compute Engine 的 Debian 操作系统版本 12 的 Batch 映像。

API

如需列出 Batch 中的所有受支持虚拟机操作系统映像，请向 images.list 方法发出以下 请求：

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • 必须使用 batch-custom-image 项目才能列出 Batch 中的映像。
  • ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) 查询参数通过使用 网址编码 将 filter 字段设置为 (-deprecated:*) OR (deprecated.state="ACTIVE") 来省略已废弃的映像。
    • 可选：如果您需要查看已废弃的 Batch 映像，请移除 ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22) 查询参数。

每个虚拟机操作系统映像的输出类似于以下内容：

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

此输出包括以下值：

  • IMAGE_NAME：映像的名称。 映像名称表示虚拟机操作系统映像的特定版本。 例如，映像名称 batch-cos-stable-official-20260730-00-p01 表示映像系列 batch-cos-stable-official的映像版本 -20260730-00-p01 （2026 年 7 月 30 日的版本）。
  • IMAGE_PROJECT_ID：包含映像的项目的 项目 ID 。例如，Batch 映像中的所有映像都位于 batch-custom-image 项目中。
  • IMAGE_FAMILY：映像的系列。 映像系列包含一个或多个特定映像，并表示 操作系统的类型和 主要版本 。例如，batch-debian-12-official 映像系列 包含基于 Compute Engine 的 Debian 操作系统版本 12 的 Batch 映像。

查看 Batch 中的虚拟机操作系统映像的详细信息

您可以使用 gcloud CLI 或 Batch API 查看虚拟机操作系统映像的所有详细信息。

gcloud

如需查看 Batch 中的虚拟机操作系统映像的详细信息，请使用 gcloud compute images describe 命令 并将 batch-custom-image 指定为映像项目：

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

将 IMAGE_NAME 替换为您要描述的 Batch 中的虚拟机操作系统映像的名称。

API

如需查看 Batch 中的虚拟机操作系统映像的详细信息，请向 images.get方法 发出请求，并将 batch-custom-image 指定为映像项目：

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

将 IMAGE_NAME 替换为您要描述的 Batch 中的虚拟机操作系统映像的名称。

后续步骤