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

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

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

准备工作

查看来自 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 中的标准映像。
  • 可选：如果您需要查看已废弃的批量映像，还应添加 --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-custom-image 项目中。
  • IMAGE_FAMILY：映像系列。映像系列包括一个或多个特定映像，表示操作系统的类型和主要版本。例如，batch-debian-11-official 映像系列包含基于 Debian 11 版本的批处理映像。

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 中的映像，必须使用 batch-custom-image 项目。
  • ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) 查询参数使用网址编码将 filter 字段设置为 (-deprecated:*) OR (deprecated.state="ACTIVE")，从而省略已弃用的图片。
    • 可选：如果您需要查看已弃用的批量图片，请移除 ?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-custom-image 项目中。
  • IMAGE_FAMILY：映像系列。映像系列包括一个或多个特定映像，表示操作系统的类型和主要版本。例如，batch-debian-11-official 映像系列包含基于 Debian 11 版本的批处理映像。

查看来自 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 中虚拟机操作系统映像的名称。

后续步骤