Visualizzare le immagini del sistema operativo VM per Batch

Questa pagina descrive come visualizzare le immagini del sistema operativo (OS) 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 del sistema operativo della VM da Batch. Per saperne di più sulle immagini del sistema operativo della VM e su quali immagini del sistema operativo della VM puoi utilizzare con Batch, consulta la panoramica dell'ambiente del sistema operativo della VM. Se vuoi visualizzare altre immagini del sistema operativo della VM, come le immagini pubbliche di Compute Engine o le immagini personalizzate, consulta invece la documentazione sulle immagini di Compute Engine.

Prima di iniziare

  1. Se non hai mai utilizzato Batch, consulta la guida Inizia a utilizzare Batch e attiva Batch completando i prerequisiti per progetti e utenti.

Visualizzare un elenco di immagini del sistema operativo della VM da Batch

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

gcloud

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

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 le immagini Batch ritirate, 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. Un nome immagine rappresenta una versione specifica di un'immagine del sistema operativo della VM. Ad esempio, il nome 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 di 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 del sistema operativo Debian di Compute Engine.

API

Per elencare tutte le immagini del sistema operativo della VM supportate da Batch, invia la seguente richiesta al images.list metodo:

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 è obbligatorio per elencare le immagini da Batch.
  • Il parametro di query ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omette le immagini ritirate utilizzando la codifica URL per impostare il campo filter su (-deprecated:*) OR (deprecated.state="ACTIVE").
    • (Facoltativo) Se devi visualizzare le immagini Batch ritirate, 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. Un nome immagine rappresenta una versione specifica di un'immagine del sistema operativo della VM. Ad esempio, il nome 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 di 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 del sistema operativo Debian di Compute Engine.

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

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

gcloud

Per visualizzare i dettagli di un'immagine del sistema operativo della VM da Batch, utilizza il gcloud compute images describe comando 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 della VM da Batch di cui vuoi visualizzare la descrizione.

API

Per visualizzare i dettagli di un'immagine del sistema operativo della VM da Batch, invia una richiesta al images.get metodo 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 della VM da Batch di cui vuoi visualizzare la descrizione.

Passaggi successivi