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

本页面介绍了如何查看可用于运行 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
  • 如需列出 Batch 中的映像，必须使用 --project=batch-custom-image 标志。
  • --no-standard-images 标志会从 Compute Engine 中省略标准映像。
  • 可选：如果您需要查看已弃用的 Batch 映像，请同时添加 --show-deprecated 标志。

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

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

此输出包括以下值：

  • IMAGE_NAME：映像的名称。 映像名称表示虚拟机操作系统映像的特定版本。 例如，映像名称 batch-debian-11-official-20230802-00-p00 表示映像系列 batch-debian-11-official 的映像版本 -20230802-00-p00（2023 年 8 月 2 日的版本）。
  • IMAGE_PROJECT_ID：包含映像的项目的项目 ID。例如，Batch 映像中的所有映像都位于 batch-custom-image 项目中。
  • IMAGE_FAMILY：映像的系列。 映像系列包含一个或多个特定映像，表示操作系统的类型和主要版本。例如，batch-debian-11-official 映像系列包含基于 Compute Engine 的 Debian 操作系统版本 11 的 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-debian-11-official-20230802-00-p00 表示映像系列 batch-debian-11-official 的映像版本 -20230802-00-p00（2023 年 8 月 2 日的版本）。
  • IMAGE_PROJECT_ID：包含映像的项目的项目 ID。例如，Batch 映像中的所有映像都位于 batch-custom-image 项目中。
  • IMAGE_FAMILY：映像的系列。 映像系列包含一个或多个特定映像，表示操作系统的类型和主要版本。例如，batch-debian-11-official 映像系列包含基于 Compute Engine 的 Debian 操作系统版本 11 的 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 虚拟机操作系统映像的名称。

后续步骤