VM-Betriebssystem-Images für Batch ansehen

Auf dieser Seite wird beschrieben, wie Sie die Betriebssystem-Images (Betriebssystem-Images) aufrufen, die für die VM-Instanzen verfügbar sind, die Batchjobs ausführen.

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

Hinweise

Liste der VM-Betriebssystem-Images aus Batch ansehen

Sie können eine Liste aller VM-Betriebssystem-Images aus Batch über die gcloud CLI oder Batch API 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 erforderlich, um Images aus Batch aufzulisten.
  • Das Flag --no-standard-images lässt die Standard-Images von Compute Engine weg.
  • Optional: Wenn Sie verworfene Batch-Images aufrufen möchten, fügen Sie auch das Flag --show-deprecated ein.

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. Der Image-Name batch-debian-11-official-20230802-00-p00 stellt beispielsweise die Image-Version -20230802-00-p00 (die Version vom 2. August 2023) für die Image-Familie batch-debian-11-official dar.
  • IMAGE_PROJECT_ID ist die Projekt-ID des Projekts, das das Image enthält. Beispielsweise befinden sich alle Images aus Batch-Images im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Image-Familie. Eine Image-Familie enthält ein oder mehrere spezifische Images und stellt den Typ und die Hauptversion des Betriebssystems dar. Die Image-Familie batch-debian-11-official enthält beispielsweise Batch-Images, die auf Version 11 von Debian basieren.

API

Stellen Sie die folgende Anfrage an die Methode images.list, um alle unterstützten VM-Betriebssystem-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.
  • Der Abfrageparameter ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) lässt verworfene Bilder aus. Dazu wird das Feld filter mithilfe der URL-Codierung auf (-deprecated:*) OR (deprecated.state="ACTIVE") festgelegt.
    • Optional: Wenn Sie verworfene Batch-Images aufrufen 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. Der Image-Name batch-debian-11-official-20230802-00-p00 stellt beispielsweise die Image-Version -20230802-00-p00 (die Version vom 2. August 2023) für die Image-Familie batch-debian-11-official dar.
  • IMAGE_PROJECT_ID ist die Projekt-ID des Projekts, das das Image enthält. Beispielsweise befinden sich alle Images aus Batch-Images im Projekt batch-custom-image.
  • IMAGE_FAMILY: die Image-Familie. Eine Image-Familie enthält ein oder mehrere spezifische Images und stellt den Typ und die Hauptversion des Betriebssystems dar. Die Image-Familie batch-debian-11-official enthält beispielsweise Batch-Images, die auf Version 11 von Debian basieren.

Details eines VM-Betriebssystem-Images aus Batch ansehen

Sie können alle Details eines VM-Betriebssystem-Images über die gcloud CLI oder die Batch API aufrufen.

gcloud

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

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