Esta página describe cómo ver las imágenes del sistema operativo (SO) disponibles para las instancias de máquina virtual (VM) que ejecutan trabajos por lotes.
En esta página, se describe específicamente cómo ver una lista y los detalles de las imágenes de SO de la VM de Batch. Para obtener más información sobre las imágenes de SO de la VM Las imágenes de SO de VM que puedes usar con Batch, consulta Descripción general del entorno del SO de la 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.
Antes de comenzar
- Si nunca usaste Batch, revisa Comienza a usar Batch y habilitar Batch completando el requisitos previos para los proyectos y usuarios.
Visualiza una lista de imágenes de SO de VM de Batch
Puedes ver una lista de todas las imágenes de SO de la VM en Batch mediante con gcloud CLI o la API de Batch.
gcloud
Para obtener una lista de todas las imágenes de SO de VM compatibles desde Batch, usa el siguiente comando gcloud compute images list
:
gcloud compute images list \
--project=batch-custom-image \
--no-standard-images
- La marca
--project=batch-custom-image
es obligatoria para mostrar la lista de imágenes de Batch. - La marca
--no-standard-images
omite las imágenes estándar de Compute Engine. - Opcional: Si necesitas ver el procesamiento obsoleto de Batch
también incluye la marca
--show-deprecated
.
El resultado de cada imagen de SO de la 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
: Es 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 imagenbatch-debian-11-official-20230802-00-p00
representa la versión de la imagen-20230802-00-p00
(la versión del 2 de agosto de 2023) para la familia de imágenesbatch-debian-11-official
IMAGE_PROJECT_ID
: el ID del proyecto del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Las imágenes por lotes están en el proyectobatch-custom-image
.IMAGE_FAMILY
: Es la familia de la imagen. Una familia de imágenes incluye una o más imágenes específicas y representa la tipo y versión principal del SO. Por ejemplo, la familia de imágenesbatch-debian-11-official
contiene imágenes de lotes basadas en la versión 11 del SO Debian desde Compute Engine.
API
Para obtener una lista de todas las imágenes de SO de la VM compatibles con Batch, crea la
siguiente solicitud al método 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)
- Se requiere el proyecto
batch-custom-image
para enumerar imágenes de por lotes. - El
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
el parámetro de consulta omite las imágenes obsoletas mediante Codificación de URL para establecer el campofilter
en(-deprecated:*) OR (deprecated.state="ACTIVE")
.- Opcional: Si necesitas ver el procesamiento obsoleto de Batch
imágenes, quita el
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22)
parámetro de consulta.
- Opcional: Si necesitas ver el procesamiento obsoleto de Batch
imágenes, quita el
El resultado de cada imagen del SO de la 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
: Es 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 imagenbatch-debian-11-official-20230802-00-p00
representa la versión-20230802-00-p00
de la imagen (la versión del 2 de agosto de 2023) para la familia de imágenesbatch-debian-11-official
.IMAGE_PROJECT_ID
: el ID del proyecto del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Las imágenes por lotes están en el proyectobatch-custom-image
.IMAGE_FAMILY
: Es la familia de la imagen. Una familia de imágenes incluye una o más imágenes específicas y representa la tipo y versión principal del SO. Por ejemplo, la familia de imágenesbatch-debian-11-official
contiene imágenes de lotes basadas en la versión 11 del SO Debian desde Compute Engine.
Visualiza detalles de una imagen de SO de VM desde Batch
Puedes ver todos los detalles de una imagen del SO de una VM con la CLI de gcloud o la API de Batch.
gcloud
Para ver los detalles de una imagen de SO de VM de Batch, usa el
Comando gcloud compute images describe
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 del
Imagen de SO de la VM de Batch que deseas describir.
API
Para ver los detalles de una imagen de SO de la VM de Batch, crea una
solicitud a la
Método images.get
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 del
Imagen de SO de la VM de Batch que deseas describir.
¿Qué sigue?
- Obtén más información sobre las imágenes de SO de VM para Batch: