Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 beschrieben, wie Sie eine Liste und Details zu VM-Betriebssystem-Images in Batch aufrufen. Weitere Informationen zu VM-Betriebssystem-Images und zu den VM-Betriebssystem-Images, die Sie mit Batch verwenden können, finden Sie unter VM-Betriebssystemumgebung – Übersicht.
Informationen zu anderen VM-Betriebssystem-Images, z. B. zu öffentlichen Images aus der Compute Engine oder benutzerdefinierten Images, finden Sie in der Dokumentation zu Compute Engine-Images.
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 steht beispielsweise für die Image-Version -20230802-00-p00 (die Version vom 2. August 2023) der Image-Familie batch-debian-11-official.
IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Beispiel: Alle Bilder aus 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
Wenn Sie alle unterstützten VM-Betriebssystem-Images aus 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 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:
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 steht beispielsweise für die Image-Version -20230802-00-p00 (die Version vom 2. August 2023) der Image-Familie batch-debian-11-official.
IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Beispiel: Alle Bilder aus 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.
Details zu einem VM-Betriebssystem-Image 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 in Batch aufrufen möchten, verwenden Sie den Befehl gcloud compute images describe und geben Sie batch-custom-image als Image-Projekt an:
Ersetzen Sie IMAGE_NAME durch den Namen des VM-Betriebssystem-Images aus dem 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:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-02 (UTC)."],[[["\u003cp\u003eThis page outlines the process for viewing available operating system (OS) images for virtual machine (VM) instances that run Batch jobs.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either the gcloud CLI or the Batch API to list all supported VM OS images from Batch, with the \u003ccode\u003ebatch-custom-image\u003c/code\u003e project being required for the listing operation.\u003c/p\u003e\n"],["\u003cp\u003eEach VM OS image output provides an image name (a specific version), an image project ID, and an image family (the OS type and major version).\u003c/p\u003e\n"],["\u003cp\u003eTo get detailed information on a specific VM OS image from Batch, use the \u003ccode\u003egcloud compute images describe\u003c/code\u003e command in the CLI or the \u003ccode\u003eimages.get\u003c/code\u003e method in the API, specifying \u003ccode\u003ebatch-custom-image\u003c/code\u003e as the project.\u003c/p\u003e\n"],["\u003cp\u003eIf you wish to explore other types of VM images, such as public or custom images, you can view the Compute Engine images documentation.\u003c/p\u003e\n"]]],[],null,["# View VM OS images for Batch\n\nThis page describes how to view the operating system (OS) images available for\nthe virtual machine (VM) instances that run Batch jobs.\n\nSpecifically, this page describes how to view a list and details of VM OS images\nfrom Batch. To learn more about VM OS images and which\nVM OS images you can use with Batch, see\n[VM OS environment overview](/batch/docs/vm-os-environment-overview).\nIf you want to view other VM OS images, such as public\nimages from Compute Engine or custom images, see the\n[Compute Engine images documentation](/compute/docs/images) instead.\n\nBefore you begin\n----------------\n\n1. If you haven't used Batch before, review [Get started with Batch](/batch/docs/get-started) and enable Batch by completing the [prerequisites for projects and users](/batch/docs/get-started#prerequisites).\n\nView a list of VM OS images from Batch\n--------------------------------------\n\nYou can view a list of all the VM OS images from Batch using\nthe gcloud CLI or Batch API. \n\n### gcloud\n\nTo list all supported VM OS images from Batch, use the\nfollowing [`gcloud compute images list` command](/sdk/gcloud/reference/compute/images/list): \n\n gcloud compute images list \\\n --project=batch-custom-image \\\n --no-standard-images\n\n- The `--project=batch-custom-image` flag is required to list images from Batch.\n- The `--no-standard-images` flag omits the standard images from Compute Engine.\n- Optional: if you need to see deprecated Batch images, also include the `--show-deprecated` flag.\n\nThe output for each VM OS image is similar to the following: \n\n NAME: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eIMAGE_NAME\u003c/span\u003e\u003c/var\u003e\n PROJECT: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eIMAGE_PROJECT_ID\u003c/span\u003e\u003c/var\u003e\n FAMILY: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eIMAGE_FAMILY\u003c/span\u003e\u003c/var\u003e\n ...\n\nThis output includes the following values:\n\n- \u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e: the name of the image. An image name represents a specific version of a VM OS image. For example, the image name `batch-debian-11-official-20230802-00-p00` represents image version `-20230802-00-p00` (the version from August 2, 2023) for the image family `batch-debian-11-official`.\n- \u003cvar translate=\"no\"\u003eIMAGE_PROJECT_ID\u003c/var\u003e: the [project ID](/resource-manager/docs/creating-managing-projects#identifying_projects) of the project that contains the image. For example, all images from Batch images are in the `batch-custom-image` project.\n- \u003cvar translate=\"no\"\u003eIMAGE_FAMILY\u003c/var\u003e: the family of the image. An image family includes one or more specific images and represents the type and [major version](https://en.wikipedia.org/wiki/Software_versioning) of the OS. For example, the `batch-debian-11-official` image family contains Batch images based on OS version 11 of [Debian from Compute Engine](/compute/docs/images/os-details#debian).\n\n### API\n\nTo list all supported VM OS images from Batch, make the\nfollowing request to the [`images.list` method](/compute/docs/reference/rest/v1/images/list): \n\n GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)\n\n- The `batch-custom-image` project is required to list images from Batch.\n- The `?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)` query parameter omits deprecated images by using [URL-encoding](https://en.wikipedia.org/wiki/URL_encoding) to set the `filter` field to `(-deprecated:*) OR (deprecated.state=\"ACTIVE\")`.\n - Optional: if you need to see deprecated Batch images, remove the `?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22)` query parameter.\n\nThe output for each VM OS image is similar to the following: \n\n {\n ...\n \"name\": \"\u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e\",\n ...\n \"family\": \"\u003cvar translate=\"no\"\u003eIMAGE_FAMILY\u003c/var\u003e\",\n \"selfLink\": \"https://www.googleapis.com/compute/v1/projects/\u003cvar translate=\"no\"\u003eIMAGE_PROJECT_ID\u003c/var\u003e/global/images/\u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e\",\n ...\n }\n\nThis output includes the following values:\n\n- \u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e: the name of the image. An image name represents a specific version of a VM OS image. For example, the image name `batch-debian-11-official-20230802-00-p00` represents image version `-20230802-00-p00` (the version from August 2, 2023) for the image family `batch-debian-11-official`.\n- \u003cvar translate=\"no\"\u003eIMAGE_PROJECT_ID\u003c/var\u003e: the [project ID](/resource-manager/docs/creating-managing-projects#identifying_projects) of the project that contains the image. For example, all images from Batch images are in the `batch-custom-image` project.\n- \u003cvar translate=\"no\"\u003eIMAGE_FAMILY\u003c/var\u003e: the family of the image. An image family includes one or more specific images and represents the type and [major version](https://en.wikipedia.org/wiki/Software_versioning) of the OS. For example, the `batch-debian-11-official` image family contains Batch images based on OS version 11 of [Debian from Compute Engine](/compute/docs/images/os-details#debian).\n\nView details of a VM OS image from Batch\n----------------------------------------\n\nYou can view all the details of a VM OS image\nusing the gcloud CLI or Batch API. \n\n### gcloud\n\nTo view the details of a VM OS image from Batch, use the\n[`gcloud compute images describe` command](/sdk/gcloud/reference/compute/images/describe)\nand specify `batch-custom-image` as the image project: \n\n```\ngcloud compute images describe IMAGE_NAME --project=batch-custom-image\n```\n\nReplace \u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e with the name of the\nVM OS image from Batch that you want to describe.\n\n### API\n\nTo view the details of a VM OS image from Batch, make a\nrequest to the\n[`images.get` method](/compute/docs/reference/rest/v1/images/get)\nand specify `batch-custom-image` as the image project: \n\n GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/\u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eIMAGE_NAME\u003c/var\u003e with the name of the\nVM OS image from Batch that you want to describe.\n\nWhat's next\n-----------\n\n- Learn more about VM OS images for Batch:\n - [VM OS environment overview](/batch/docs/vm-os-environment-overview)\n - [Specify the VM OS image for a job](/batch/docs/specify-vm-os-image)"]]
