VM-Betriebssystem-Images für Batch ansehen

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

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

Hinweise

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

Liste der VM-Betriebssystem-Images aus Batch ansehen

Sie können eine Liste aller VM-Betriebssystemimages von 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-Betriebssystem-Images von Batch aufzulisten:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Das Flag --project=batch-custom-image ist erforderlich, um Bilder aus Batch aufzulisten.
  • Das Flag --no-standard-images schließt die Standard-Images von Compute Engine aus.
  • Optional: Wenn Sie eingestellte 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 repräsentiert eine bestimmte Version eines VM-Betriebssystem-Images. Der Imagename batch-debian-11-official-20230802-00-p00 steht beispielsweise für die Imageversion -20230802-00-p00 (die 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. Alle Bilder aus Batch-Images befinden sich beispielsweise im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Familie des Bildes. Eine Imagefamilie umfasst ein oder mehrere bestimmte Images und repräsentiert 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 von Compute Engine basieren.

API

Wenn Sie alle unterstützten VM-Betriebssystem-Images von Batch auflisten möchten, stellen Sie die 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 einem Batch aufzulisten.
  • Mit dem Suchparameter ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) werden verworfene Bilder ausgelassen. Dazu wird die URL-Codierung verwendet, um das Feld filter auf (-deprecated:*) OR (deprecated.state="ACTIVE") zu setzen.
    • Optional: Wenn Sie eingestellte 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 repräsentiert eine bestimmte Version eines VM-Betriebssystem-Images. Der Imagename batch-debian-11-official-20230802-00-p00 steht beispielsweise für die Imageversion -20230802-00-p00 (die 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. Alle Bilder aus Batch-Images befinden sich beispielsweise im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Familie des Bildes. Eine Imagefamilie umfasst ein oder mehrere bestimmte Images und repräsentiert 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 von Compute Engine basieren.

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

Wenn Sie die Details eines VM-Betriebssystem-Images aus Batch aufrufen möchten, verwenden Sie den Befehl gcloud compute images describe 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-Images aus Batch, das Sie beschreiben möchten.

API

Wenn Sie die Details eines VM-Betriebssystem-Images aus Batch aufrufen möchten, stellen 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 Batch, das Sie beschreiben möchten.

Nächste Schritte