Cómo ver imágenes del SO de VM para Batch

En esta página, se describe cómo ver las imágenes del sistema operativo (SO) disponibles para las instancias de máquina virtual (VM) que ejecutan trabajos de Batch.

En particular, en esta página, se describe cómo ver una lista y los detalles de las imágenes del SO de VM de Batch. Para obtener más información sobre las imágenes del SO de VM y qué imágenes del SO de VM puedes usar con Batch, consulta Descripción general del entorno del SO de VM. Si quieres ver otras imágenes del SO de VM, como imágenes públicas de Compute Engine o imágenes personalizadas, consulta la documentación de imágenes de Compute Engine en su lugar.

Antes de comenzar

  1. Si nunca usaste Batch, revisa Comienza a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.

Visualiza una lista de imágenes del SO de VM de Batch

Puedes ver una lista de todas las imágenes del SO de VM de Batch con gcloud CLI o la API de Batch.

gcloud

Para enumerar todas las imágenes del SO de VM compatibles de Batch, usa el siguiente gcloud compute images list comando:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • La marca --project=batch-custom-image es obligatoria para enumerar imágenes de Batch.
  • La marca --no-standard-images omite las imágenes estándar de Compute Engine.
  • Opcional: Si necesitas ver imágenes obsoletas de Batch, incluye también la marca --show-deprecated.

El resultado de cada imagen de SO de VM es similar al siguiente:

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

En esta salida, se incluyen los siguientes valores:

  • IMAGE_NAME: el nombre de la imagen. Un nombre de imagen representa una versión específica de una imagen de SO de VM. Por ejemplo, el nombre de la imagen batch-cos-stable-official-20260730-00-p01 representa la versión de la imagen -20260730-00-p01 (la versión del 30 de julio de 2026) para la familia de imágenes batch-cos-stable-official.
  • IMAGE_PROJECT_ID: el ID del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Batch se encuentran en el proyecto batch-custom-image.
  • IMAGE_FAMILY: la familia de la imagen. Una familia de imágenes incluye una o más imágenes específicas y representa el tipo y la versión principal del SO. Por ejemplo, la familia de imágenes batch-debian-12-official contiene imágenes de Batch basadas en la versión 12 del SO de Debian de Compute Engine.

API

Para enumerar todas las imágenes del SO de VM compatibles de Batch, realiza la siguiente solicitud al images.list método:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • Se requiere el proyecto batch-custom-image para enumerar imágenes de Batch.
  • El parámetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite las imágenes obsoletas mediante la codificación de URL para establecer el campo filter en (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Opcional: Si necesitas ver imágenes obsoletas de Batch, quita el parámetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

El resultado de cada imagen de SO de VM es similar al siguiente:

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

En esta salida, se incluyen los siguientes valores:

  • IMAGE_NAME: el nombre de la imagen. Un nombre de imagen representa una versión específica de una imagen de SO de VM. Por ejemplo, el nombre de la imagen batch-cos-stable-official-20260730-00-p01 representa la versión de la imagen -20260730-00-p01 (la versión del 30 de julio de 2026) para la familia de imágenes batch-cos-stable-official.
  • IMAGE_PROJECT_ID: el ID del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Batch se encuentran en el proyecto batch-custom-image.
  • IMAGE_FAMILY: la familia de la imagen. Una familia de imágenes incluye una o más imágenes específicas y representa el tipo y la versión principal del SO. Por ejemplo, la familia de imágenes batch-debian-12-official contiene imágenes de Batch basadas en la versión 12 del SO de Debian de Compute Engine.

Visualiza los detalles de una imagen de SO de VM de Batch

Puedes ver todos los detalles de una imagen de SO de VM con gcloud CLI o la API de Batch.

gcloud

Para ver los detalles de una imagen de SO de VM de Batch, usa el gcloud compute images describe comando y especifica batch-custom-image como el proyecto de imagen:

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

Reemplaza IMAGE_NAME por el nombre de la imagen de SO de VM de Batch que deseas describir.

API

Para ver los detalles de una imagen de SO de VM de Batch, realiza una solicitud al images.get método y especifica batch-custom-image como el proyecto de imagen:

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

Reemplaza IMAGE_NAME por el nombre de la imagen de SO de VM de Batch que deseas describir.

¿Qué sigue?