VM-Betriebssystem-Images für Batch ansehen

Auf dieser Seite wird beschrieben, wie Sie die Betriebssystem-Images aufrufen, die für die virtuellen Maschinen (VMs) verfügbar sind, auf denen Batchjobs ausgeführt werden.

Auf dieser Seite wird insbesondere beschrieben, wie Sie eine Liste und Details von VM-Betriebssystem-Images aufrufen aus Batch. Weitere Informationen zu VM-Betriebssystem-Images VM-Betriebssystem-Images, die Sie mit Batch verwenden können, finden Sie unter VM-Betriebssystem-Umgebung – Übersicht Wenn Sie andere VM-Betriebssystem-Images ansehen möchten, z. B. öffentliche von Compute Engine oder benutzerdefinierten Images Dokumentation zu Compute Engine-Images.

Hinweise

  1. Wenn Sie Batch noch nicht verwendet haben, lesen Sie den Hilfeartikel Batch-Dateien erstellen und ausführen und aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.

Liste der VM-Betriebssystem-Images über Batch ansehen

Mit der gcloud CLI oder der Batch API können Sie eine Liste aller VM-Betriebssystem-Images von Batch aufrufen.

gcloud

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

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

Die Ausgabe für jedes VM-Betriebssystem-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-Betriebssystem-Images. Beispiel: Der Image-Name batch-debian-11-official-20230802-00-p00 steht für die Image-Version -20230802-00-p00 (Version vom 2. August 2023) für die Image-Familie batch-debian-11-official
  • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Beispielsweise werden alle Bilder von Batch-Images befinden sich im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Familie des Bildes. Eine Image-Familie enthält ein oder mehrere bestimmte Images und steht für den Typ und die Hauptversion des Betriebssystems. Die Image-Familie batch-debian-11-official enthält beispielsweise Batch-Images, die auf der Betriebssystemversion 11 von Debian aus der Compute Engine basieren.

API

Um alle unterstützten VM-Betriebssystem-Images aus Batch aufzulisten, machen Sie den folgende Anfrage an die Methode 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)
  • Das batch-custom-image-Projekt ist erforderlich, um Bilder aus Batch aufzulisten.
  • Der Abfrageparameter ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) lässt keine veralteten Bilder zu. Dazu wird das Feld filter mithilfe der URL-Codierung auf (-deprecated:*) OR (deprecated.state="ACTIVE") gesetzt.
    • Optional: Wenn Sie nicht mehr unterstützte Batch-Bilder 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-Betriebssystem-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-Betriebssystem-Images. Beispiel: Der Image-Name batch-debian-11-official-20230802-00-p00 steht für die Image-Version -20230802-00-p00 (Version vom 2. August 2023) für die Image-Familie batch-debian-11-official
  • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Beispielsweise werden alle Bilder von Batch-Images befinden sich im Projekt batch-custom-image.
  • IMAGE_FAMILY ist die Image-Familie. Eine Image-Familie enthält ein oder mehrere bestimmte Images und steht für den Typ und die Hauptversion des Betriebssystems. Beispiel: Die Image-Familie batch-debian-11-official enthält Batch-Images basierend auf Betriebssystemversion 11 von Debian von Compute Engine.

Details eines VM-Betriebssystem-Images aus Batch ansehen

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

gcloud

Um die Details eines VM-Betriebssystem-Images aus Batch anzusehen, verwenden Sie den gcloud compute images describe-Befehl und geben Sie batch-custom-image als Image-Projekt an:

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

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

API

Wenn Sie die Details eines VM-Betriebssystem-Images aus Batch aufrufen möchten, senden Sie eine Anfrage an die Methode images.get und geben Sie batch-custom-image als Image-Projekt an:

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

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

Nächste Schritte