本页介绍了如何查看可供运行批处理作业的虚拟机 (VM) 实例使用的操作系统 (OS) 映像。
具体而言,本页介绍了如何通过批处理查看虚拟机操作系统映像的列表和详细信息。如需详细了解虚拟机操作系统映像以及您可以与批处理一起使用的虚拟机操作系统映像,请参阅虚拟机操作系统环境概览。如果您想查看其他虚拟机操作系统映像(例如 Compute Engine 中的公共映像或自定义映像),请改为参阅 Compute Engine 映像文档。
准备工作
- 如果您之前未使用过批处理功能,请参阅开始使用批处理,并完成适用于项目和用户的前提条件,以启用批处理功能。
通过批处理查看虚拟机操作系统映像列表
您可以使用 gcloud CLI 或 Batch API 查看 Batch 中的所有虚拟机操作系统映像的列表。
gcloud
如需从批处理列出所有受支持的虚拟机操作系统映像,请使用以下 gcloud compute images list
命令:
gcloud compute images list \
--project=batch-custom-image \
--no-standard-images
- 如需从批处理列出图片,必须使用
--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
:包含映像的项目的 project ID。例如,批量图片中的所有图片都位于batch-custom-image
项目中。IMAGE_FAMILY
:映像的系列。映像系列包含一个或多个特定映像,表示操作系统的类型和主要版本。例如,batch-debian-11-official
映像系列包含基于 Compute Engine 中的 Debian 操作系统版本 11 的批处理映像。
API
如需从批处理列出所有受支持的虚拟机操作系统映像,请向 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
项目才能列出批处理中的图片。 ?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
:包含映像的项目的 project ID。例如,批量图片中的所有图片都位于batch-custom-image
项目中。IMAGE_FAMILY
:映像的系列。映像系列包含一个或多个特定映像,表示操作系统的类型和主要版本。例如,batch-debian-11-official
映像系列包含基于 Compute Engine 中的 Debian 操作系统版本 11 的批处理映像。
通过批处理查看虚拟机操作系统映像的详细信息
您可以使用 gcloud CLI 或 Batch API 查看虚拟机操作系统映像的所有详细信息。
gcloud
如需通过批处理查看虚拟机操作系统映像的详细信息,请使用 gcloud compute images describe
命令,并将 batch-custom-image
指定为映像项目:
gcloud compute images describe IMAGE_NAME --project=batch-custom-image
将 IMAGE_NAME
替换为您要描述的来自批处理的虚拟机操作系统映像的名称。
API
如需通过批处理查看虚拟机操作系统映像的详细信息,请向 images.get
方法发出请求,并将 batch-custom-image
指定为映像项目:
GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME
将 IMAGE_NAME
替换为您要描述的来自批处理的虚拟机操作系统映像的名称。
后续步骤
- 详细了解适用于批处理的虚拟机操作系统映像: