查看 Batch 的 VM OS 映像檔

本頁說明如何查看可供執行批次作業的虛擬機器 (VM) 執行個體的作業系統 (OS) 映像檔。

本頁面將說明如何透過 Batch 查看 VM OS 映像檔的清單和詳細資料。如要進一步瞭解 VM OS 映像檔,以及可搭配 Batch 使用的 VM OS 映像檔,請參閱「VM OS 環境總覽」。如要查看其他 VM OS 映像檔 (例如 Compute Engine 的公開映像檔或自訂映像檔),請改為參閱 Compute Engine 映像檔說明文件

事前準備

  1. 如果您之前未使用過 Batch,請參閱「開始使用 Batch」,並完成專案和使用者的必要條件,啟用 Batch。

透過批次作業查看 VM OS 映像檔清單

您可以使用 gcloud CLI 或 Batch API 查看 Batch 中的所有 VM OS 映像檔清單。

gcloud

如要列出 Batch 支援的所有 VM OS 映像檔,請使用下列 gcloud compute images list 指令

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • 您必須使用 --project=batch-custom-image 旗標才能列出批次中的圖片。
  • --no-standard-images 標記會省略 Compute Engine 中的標準映像檔。
  • 選用:如要查看已淘汰的 Batch 圖片,請一併加入 --show-deprecated 旗標。

每個 VM OS 映像檔的輸出內容如下:

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

輸出內容包含下列值:

  • 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 images 中的所有圖片都位於 batch-custom-image 專案中。
  • IMAGE_FAMILY:圖片的系列。映像檔系列包含一或多個特定映像檔,並代表 OS 的類型和主要版本。舉例來說,batch-debian-11-official 映像檔系列包含以 Compute Engine 提供的 Debian 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 專案,才能列出批次中的圖片。
  • ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) 查詢參數會使用網址編碼filter 欄位設為 (-deprecated:*) OR (deprecated.state="ACTIVE"),藉此省略已淘汰的圖片。
    • 選用:如要查看已淘汰的 Batch 圖片,請移除 ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22) 查詢參數。

每個 VM OS 映像檔的輸出內容如下:

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

輸出內容包含下列值:

  • 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 images 中的所有圖片都位於 batch-custom-image 專案中。
  • IMAGE_FAMILY:圖片的系列。映像檔系列包含一或多個特定映像檔,並代表 OS 的類型和主要版本。舉例來說,batch-debian-11-official 映像檔系列包含以 Compute Engine 提供的 Debian 11 版作業系統為基礎的 Batch 映像檔。

透過批次作業查看 VM OS 映像檔的詳細資料

您可以使用 gcloud CLI 或 Batch API 查看 VM OS 映像檔的所有詳細資料。

gcloud

如要透過 Batch 查看 VM OS 映像檔的詳細資料,請使用 gcloud compute images describe 指令,並指定 batch-custom-image 做為映像檔專案:

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

IMAGE_NAME 替換為您要說明的 Batch 中的 VM OS 映像檔名稱。

API

如要透過批次查看 VM OS 映像檔的詳細資料,請向 images.get 方法提出要求,並指定 batch-custom-image 做為映像檔專案:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

IMAGE_NAME 替換為您要說明的 Batch 中的 VM OS 映像檔名稱。

後續步驟