本頁說明如何查看可供執行批次作業的虛擬機器 (VM) 執行個體的作業系統 (OS) 映像檔。
本頁面將說明如何透過 Batch 查看 VM OS 映像檔的清單和詳細資料。如要進一步瞭解 VM OS 映像檔,以及可搭配 Batch 使用的 VM OS 映像檔,請參閱「VM OS 環境總覽」。如要查看其他 VM OS 映像檔 (例如 Compute Engine 的公開映像檔或自訂映像檔),請改為參閱 Compute Engine 映像檔說明文件。
事前準備
- 如果您之前未使用過 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)
查詢參數。
- 選用:如要查看已淘汰的 Batch 圖片,請移除
每個 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 映像檔名稱。
後續步驟
- 進一步瞭解 Batch 適用的 VM OS 映像檔: