VM-Betriebssystem-Images für Batch ansehen

Auf dieser Seite wird beschrieben, wie Sie die Betriebssystem-Images (OS-Images) für die VM-Instanzen (virtuelle Maschinen) aufrufen, auf denen Batch-Jobs ausgeführt werden.

Insbesondere wird auf dieser Seite beschrieben, wie Sie eine Liste und Details von VM-OS-Images aus Batch aufrufen. Weitere Informationen zu VM-OS-Images und dazu, welche VM-OS-Images Sie mit Batch verwenden können, finden Sie unter VM-OS-Umgebung – Übersicht. Wenn Sie andere VM-OS-Images aufrufen möchten, z. B. öffentliche Images aus Compute Engine oder benutzerdefinierte Images, lesen Sie stattdessen die Dokumentation zu Compute Engine-Images.

Hinweis

  1. Wenn Sie Batch noch nicht verwendet haben, lesen Sie den Artikel Erste Schritte mit Batch und aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzererfüllen.

Liste der VM-OS-Images aus Batch aufrufen

Sie können eine Liste aller VM-OS-Images aus Batch mit der gcloud CLI oder der Batch API aufrufen.

gcloud

Verwenden Sie den folgenden gcloud compute images list Befehl, um alle unterstützten VM-OS-Images aus Batch aufzulisten:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Das Flag --project=batch-custom-image ist erforderlich, um Images aus Batch aufzulisten.
  • Mit dem Flag --no-standard-images werden die Standard-Images aus Compute Engine ausgelassen.
  • Optional: Wenn Sie veraltete Batch-Images sehen möchten, fügen Sie auch das Flag --show-deprecated hinzu.

Die Ausgabe für jedes VM-OS-Image sieht in etwa so aus:

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

Diese Ausgabe enthält die folgenden Werte:

  • IMAGE_NAME: der Name des Images Ein Image-Name steht für eine bestimmte Version eines VM-OS-Images. Der Image-Name batch-cos-stable-official-20260730-00-p01 steht beispielsweise für die Image-Version -20260730-00-p01 (die Version vom 30. Juli 2026) für die Image-Familie batch-cos-stable-official.
  • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Alle Images aus Batch-Images befinden sich beispielsweise im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Familie des Images Eine Image-Familie enthält ein oder mehrere bestimmte Images und steht für den Typ und die Hauptversion des Betriebssystems. Die batch-debian-12-official Image-Familie enthält beispielsweise Batch-Images, die auf der Betriebssystemversion 12 von Debian aus Compute Engine basieren.

API

Senden Sie die folgende Anfrage an die images.list Methode, um alle unterstützten VM-OS-Images aus Batch aufzulisten:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • Das Projekt batch-custom-image ist erforderlich, um Images aus Batch aufzulisten.
  • Mit dem ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) Abfrageparameter werden veraltete Images ausgelassen. Dazu wird die URL-Codierung verwendet, um das Feld filter auf (-deprecated:*) OR (deprecated.state="ACTIVE") zu setzen.
    • Optional: Wenn Sie veraltete Batch-Images sehen möchten, entfernen Sie den Abfrageparameter ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

Die Ausgabe für jedes VM-OS-Image sieht in etwa so aus:

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

Diese Ausgabe enthält die folgenden Werte:

  • IMAGE_NAME: der Name des Images Ein Image-Name steht für eine bestimmte Version eines VM-OS-Images. Der Image-Name batch-cos-stable-official-20260730-00-p01 steht beispielsweise für die Image-Version -20260730-00-p01 (die Version vom 30. Juli 2026) für die Image-Familie batch-cos-stable-official.
  • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Alle Images aus Batch-Images befinden sich beispielsweise im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Familie des Images Eine Image-Familie enthält ein oder mehrere bestimmte Images und steht für den Typ und die Hauptversion des Betriebssystems. Die batch-debian-12-official Image-Familie enthält beispielsweise Batch-Images, die auf der Betriebssystemversion 12 von Debian aus Compute Engine basieren.

Details eines VM-OS-Images aus Batch aufrufen

Sie können alle Details eines VM-OS-Images mit der gcloud CLI oder der Batch API aufrufen.

gcloud

Verwenden Sie den gcloud compute images describe Befehl und geben Sie batch-custom-image als Image-Projekt an, um die Details eines VM-OS-Images aus Batch aufzurufen:

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

Ersetzen Sie IMAGE_NAME durch den Namen des VM-OS-Images aus Batch, das Sie beschreiben möchten.

API

Senden Sie eine Anfrage an die images.get Methode und geben Sie batch-custom-image als Image-Projekt an, um die Details eines VM-OS-Images aus Batch aufzurufen:

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

Ersetzen Sie IMAGE_NAME durch den Namen des VM-OS-Images aus Batch, das Sie beschreiben möchten.

Nächste Schritte