查看 Batch 的 VM OS 映像檔

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

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

事前準備

  1. 如果您從未使用過 Batch，請參閱「開始使用 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
  • 如要列出 Batch 中的圖片，必須使用 --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-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 中的映像檔，必須提供 batch-custom-image 專案。
  • ?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) 查詢參數。

每個 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-custom-image 專案中。
  • IMAGE_FAMILY：圖片系列。 映像檔系列包含一或多個特定映像檔，代表 OS 的類型和主要版本。舉例來說，batch-debian-11-official 映像檔系列包含以 Compute Engine 的 Debian OS 版本 11 為基礎的 Batch 映像檔。

從 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

如要查看 Batch 中 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 映像檔名稱。

後續步驟