Visualizza immagini VM OS per Batch

Questa pagina descrive come visualizzare le immagini del sistema operativo disponibili per le istanze di macchine virtuali (VM) che eseguono job batch.

In particolare, questa pagina descrive come visualizzare un elenco e i dettagli delle immagini VM OS da Batch. Per scoprire di più sulle immagini del sistema operativo VM e sulle immagini del sistema operativo VM che puoi utilizzare con Batch, consulta Panoramica dell'ambiente del sistema operativo VM. Se vuoi visualizzare altre immagini di sistema operativo VM, come immagini pubbliche da Compute Engine o personalizzate, consulta la documentazione sulle immagini di Compute Engine.

Prima di iniziare

Visualizza un elenco di immagini VM OS da Batch

Puoi visualizzare un elenco di tutte le immagini del sistema operativo VM da Batch utilizzando gcloud CLI o l'API Batch.

gcloud

Per elencare tutte le immagini del sistema operativo VM supportate da Batch, utilizza il seguente comando gcloud compute images list:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Il flag --project=batch-custom-image è obbligatorio per elencare le immagini da Batch.
  • Il flag --no-standard-images omette le immagini standard di Compute Engine.
  • (Facoltativo) Se devi visualizzare immagini batch deprecate, includi anche il flag --show-deprecated.

L'output per ogni immagine del sistema operativo della VM è simile al seguente:

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

Questo output include i seguenti valori:

  • IMAGE_NAME: il nome dell'immagine. Il nome di un'immagine rappresenta una versione specifica di un'immagine del sistema operativo di una VM. Ad esempio, il nome dell'immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione dell'immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: l'ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini delle immagini batch si trovano nel progetto batch-custom-image.
  • IMAGE_FAMILY: la famiglia dell'immagine. Una famiglia di immagini include una o più immagini specifiche e rappresenta il tipo e la versione principale del sistema operativo. Ad esempio, la famiglia di immagini batch-debian-11-official contiene immagini batch basate sulla versione 11 di Debian.

API

Per elencare tutte le immagini del sistema operativo VM supportate da Batch, effettua la seguente richiesta al metodo 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)
  • Il progetto batch-custom-image è necessario per elencare le immagini da Batch.
  • Il parametro di query ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omette immagini deprecate utilizzando la codifica degli URL per impostare il campo filter su (-deprecated:*) OR (deprecated.state="ACTIVE").
    • (Facoltativo) Se devi visualizzare immagini batch deprecate, rimuovi il parametro di query ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

L'output per ogni immagine del sistema operativo della VM è simile al seguente:

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

Questo output include i seguenti valori:

  • IMAGE_NAME: il nome dell'immagine. Il nome di un'immagine rappresenta una versione specifica di un'immagine del sistema operativo di una VM. Ad esempio, il nome dell'immagine batch-debian-11-official-20230802-00-p00 rappresenta la versione dell'immagine -20230802-00-p00 (la versione del 2 agosto 2023) per la famiglia di immagini batch-debian-11-official.
  • IMAGE_PROJECT_ID: l'ID progetto del progetto che contiene l'immagine. Ad esempio, tutte le immagini delle immagini batch si trovano nel progetto batch-custom-image.
  • IMAGE_FAMILY: la famiglia dell'immagine. Una famiglia di immagini include una o più immagini specifiche e rappresenta il tipo e la versione principale del sistema operativo. Ad esempio, la famiglia di immagini batch-debian-11-official contiene immagini batch basate sulla versione 11 di Debian.

Visualizza i dettagli di un'immagine del sistema operativo VM da Batch

Puoi visualizzare tutti i dettagli di un'immagine del sistema operativo di una VM utilizzando gcloud CLI o l'API Batch.

gcloud

Per visualizzare i dettagli di un'immagine del sistema operativo VM da Batch, utilizza il comando gcloud compute images describe e specifica batch-custom-image come progetto immagine:

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

Sostituisci IMAGE_NAME con il nome dell'immagine del sistema operativo VM di Batch che vuoi descrivere.

API

Per visualizzare i dettagli di un'immagine VM OS da Batch, effettua una richiesta al metodo images.get e specifica batch-custom-image come progetto immagine:

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

Sostituisci IMAGE_NAME con il nome dell'immagine del sistema operativo VM di Batch che vuoi descrivere.

Passaggi successivi