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
- Wenn Sie Batch noch nie verwendet haben, lesen Sie die Informationen unter Erste Schritte mit Batch. 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-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-Namebatch-debian-11-official-20230802-00-p00
stellt beispielsweise die Image-Version-20230802-00-p00
(die Version vom 2. August 2023) für die Image-Familiebatch-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 Projektbatch-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-Familiebatch-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 Feldfilter
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)
.
- Optional: Wenn Sie verworfene Batch-Images aufrufen möchten, entfernen Sie den Abfrageparameter
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-Namebatch-debian-11-official-20230802-00-p00
stellt beispielsweise die Image-Version-20230802-00-p00
(die Version vom 2. August 2023) für die Image-Familiebatch-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 Projektbatch-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-Familiebatch-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
- Weitere Informationen zu VM-Betriebssystem-Images für Batch: