이 페이지에서는 Batch 작업을 실행하는 가상 머신(VM) 인스턴스에 제공되는 운영체제(OS) 이미지를 열람하는 방법을 설명합니다.
특히 이 페이지에서는 Batch에서 VM OS 이미지의 목록과 세부정보를 보는 방법을 설명합니다. VM OS 이미지 및 Batch에서 사용할 수 있는 VM OS 이미지에 관한 자세한 내용은 VM OS 환경 개요를 참고하세요.
Compute Engine의 공개 이미지 또는 맞춤 이미지와 같은 다른 VM OS 이미지를 보려면 Compute Engine 이미지 문서를 참고하세요.
IMAGE_NAME: 이미지의 이름입니다.
이미지 이름은 VM OS 이미지의 특정 버전을 나타냅니다.
예를 들어 이미지 이름 batch-debian-11-official-20230802-00-p00은 이미지 계열 batch-debian-11-official의 이미지 버전 -20230802-00-p00(2023년 8월 2일 버전)을 나타냅니다.
IMAGE_PROJECT_ID: 이미지가 포함된 프로젝트의 프로젝트 ID입니다. 예를 들어 Batch 이미지의 모든 이미지는 batch-custom-image 프로젝트에 있습니다.
IMAGE_FAMILY: 이미지의 계열.
특정 이미지가 하나 이상 포함되었으며 OS의 유형과 메이저 버전을 나타내는 이미지 계열. 예를 들어 batch-debian-11-official 이미지 계열에는 Compute Engine의 Debian OS 버전 11을 기반으로 하는 Batch 이미지가 포함되어 있습니다.
API
Batch에서 지원되는 모든 VM OS 이미지를 나열하려면 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)
batch-custom-image 프로젝트는 Batch의 이미지를 나열하는 데 필요합니다.
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) 쿼리 매개변수는 URL 인코딩을 사용하여 filter 필드를 (-deprecated:*) OR (deprecated.state="ACTIVE")로 설정하여 지원 중단된 이미지를 생략합니다.
(선택사항) 지원 중단된 Batch 이미지를 확인해야 하는 경우 ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22) 쿼리 매개변수를 삭제하세요.
IMAGE_NAME: 이미지의 이름입니다.
이미지 이름은 VM OS 이미지의 특정 버전을 나타냅니다.
예를 들어 이미지 이름 batch-debian-11-official-20230802-00-p00은 이미지 계열 batch-debian-11-official의 이미지 버전 -20230802-00-p00(2023년 8월 2일 버전)을 나타냅니다.
IMAGE_PROJECT_ID: 이미지가 포함된 프로젝트의 프로젝트 ID입니다. 예를 들어 Batch 이미지의 모든 이미지는 batch-custom-image 프로젝트에 있습니다.
IMAGE_FAMILY: 이미지의 계열.
특정 이미지가 하나 이상 포함되었으며 OS의 유형과 메이저 버전을 나타내는 이미지 계열. 예를 들어 batch-debian-11-official 이미지 계열에는 Compute Engine의 Debian OS 버전 11을 기반으로 하는 Batch 이미지가 포함되어 있습니다.
Batch에서 VM OS 이미지 세부정보 보기
gcloud CLI 또는 Batch API를 사용하여 VM OS 이미지의 모든 세부정보를 볼 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(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)"]]
