本頁面說明如何查看可用地區和區域清單,以及如何取得有關特定地區的資訊。
如要進一步瞭解區域和可用區,請參閱區域和可用區說明文件。
如要進一步瞭解全球、區域和可用區 Compute Engine 資源,請參閱全球、區域和可用區資源說明文件。
事前準備
-
如果尚未設定驗證,請先完成設定。
驗證可確認您的身分,以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例,請選取下列其中一個選項,向 Compute Engine 進行驗證:
選取這個頁面上的分頁,瞭解如何使用範例:
控制台
使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時,無須設定驗證。
gcloud
-
安裝 Google Cloud CLI。 完成後,執行下列指令來初始化 Google Cloud CLI:
gcloud init若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
-
- 設定預設地區和區域。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI。
若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。
必要的角色
如要取得查看可用區域和可用區所需的權限,請要求系統管理員授予您專案的「Compute 檢視者 」(roles/compute.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
查看可用區域清單
可用區是區域內的某個部署範圍。部分區域設有專門的可用區,可為需求量高的加速器 (GPU 和 TPU) 提供大量容量。這些專門的可用區稱為「AI 可用區」,非常適合用於 AI 和機器學習工作負載。
如要查看可用區域清單 (包括 AI 區域),請採取下列任一做法:
控制台
在 Google Cloud 控制台的「Zones」(區域) 頁面中查看區域清單。
gcloud
使用 Google Cloud CLI 執行 gcloud compute zones list 指令:
gcloud compute zones list
REST
對 zones.list 方法發出 GET 要求,即可取得專案的區域清單。請將 PROJECT_ID
改成您的PROJECT_ID。
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
查看支援加速器 (GPU 和 TPU) 的區域清單
如要查看支援加速器 (GPU 和 TPU) 的區域清單,請使用下列其中一種方法:
搜尋 AI 可用區
如要執行 AI 和機器學習工作負載,請考慮使用 AI 可用區。您可以透過名稱中的 ai 字串識別 AI 可用區。舉例來說,us-central1-ai1a 是 us-central1 地區中的 AI 區域,而 us-central1-a 是其父項區域。詳情請參閱「AI 可用區」一文。
Google Cloud 控制台會列出 AI 可用區和其他可用區,並依區域分組。如要查看可用的 AI 區域清單,請使用 gcloud CLI 或 REST API。
控制台
在 Google Cloud 控制台中,「區域」頁面會列出支援這些區域的地區中的 AI 區域。您可以透過名稱中的 AI 字串識別 AI 可用區,例如 us-central1 區域會列出 Zone AI1A。
gcloud
使用 gcloud compute zones list 指令,並篩選含有 ai 字串的區域:
gcloud compute zones list \
--filter="name~'-ai'"
REST
對 zones.list 方法發出 GET 要求。如要比對名稱中含有 ai 的區域,請使用 filter 查詢參數和規則運算式 name eq '.*-ai.*'。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'
請將 PROJECT_ID
改成您的PROJECT_ID。
依加速器類型搜尋
依加速器類型搜尋時,系統會傳回支援該加速器的所有區域,包括 AI 區域。
gcloud
如要依加速器類型搜尋,請使用 gcloud compute accelerator-types list 指令,並加上 --filter 旗標。
舉例來說,如要找出所有搭載特定加速器的區域,例如 NVIDIA B200 GPU 或 Cloud TPU v6e (Trillium),請執行下列其中一個指令:
NVIDIA B200
gcloud compute accelerator-types list \ --filter="name=nvidia-b200" \ --format="value(zone)"Cloud TPU v6e (Trillium)
gcloud compute accelerator-types list \ --filter="name=ct6e" \ --format="value(zone)"
將範例中的加速器類型,替換成您要搜尋的加速器類型。
REST
如要依加速器類型搜尋,請使用 filter 參數,向 acceleratorTypes.aggregatedList 方法發出 GET 要求。
舉例來說,如要找出具有特定加速器 (例如 NVIDIA B200 GPU 或 Cloud TPU v6e (Trillium)) 的所有區域,請執行下列其中一個指令:
NVIDIA B200
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-b200
Cloud TPU v6e (Trillium)
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=ct6e
將範例中的加速器類型,替換成您要搜尋的加速器類型。
依機型搜尋
依機型搜尋時,系統會傳回支援該機型的所有可用區,包括 AI 可用區。
gcloud
如要依機型搜尋,請使用 gcloud compute machine-types list 指令,並加上 --filter 旗標。
舉例來說,如要找出具有特定機型 (例如 a4-highgpu-8g A4 機型或 ct6e-standard-4t Cloud TPU v6e (Trillium) 機型) 的所有可用區,請執行下列任一指令:
a4-highgpu-8gA4 機型gcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"ct6e-standard-4tCloud TPU v6e (Trillium) 機型gcloud compute machine-types list \ --filter="name=ct6e-standard-4t" \ --format="value(zone)"
將範例中的機型,替換成要搜尋的機型。
REST
如要依機型搜尋,請使用 filter 參數,向 machineTypes.aggregatedList 方法發出 GET 要求。
舉例來說,如要找出具有特定機型 (例如 a4-highgpu-8g A4 機型或 ct6e-standard-4t Cloud TPU v6e (Trillium) 機型) 的所有可用區,請執行下列任一指令:
a4-highgpu-8gA4 機型GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
ct6e-standard-4tCloud TPU v6e (Trillium) 機型GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t
將 PROJECT_ID 替換為專案 ID,並將機器類型替換為要搜尋的機型。
從清單中排除 AI 可用區
如果您有權存取 AI 區域,但不想在區域清單中看到這些區域,請使用篩選器排除。如果您使用的服務不支援 AI 區域,或是現有自動化程序依賴區域清單,就可能會發生這種情況。您可以根據名稱中的 -ai 後置字串,判斷是否為 AI 區域。
gcloud
如要從可用區域清單中排除 AI 區域,請使用 gcloud compute zones list 指令,並篩選含有 -ai 字串的區域:
gcloud compute zones list --filter 'name !~ ".*-ai.*"'
如要在列出機型時篩除 AI 可用區,請使用 gcloud compute machine-types list 指令,並篩選含有 -ai 字串的可用區:
gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'
REST
如要從 API 結果中排除 AI 區域,請在篩選查詢參數中使用 name ne ".*-ai.*" 規則運算式。將這個篩選器加入網址時,請務必將篩選器查詢參數編碼為 filter=name%20ne%20%22.%2A-ai.%2A%22。
https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20ne%20%22.%2A-ai.%2A%22
請將 PROJECT_ID
改成您的PROJECT_ID。
Terraform
如要從可用區域清單中排除 AI 區域,請建立本機函式,如下列範例所示:
# Fetch zones from API
data "google_compute_zones" "available" {
project = var.my_project_id
region = var.my_region
status = "UP"
}
locals {
# Filter the list in Terraform
non_ai_zones = [
for zone in data.google_compute_zones.available.names : zone
if !strcontains(zone, "-ai")
]
}
# Example usage
output "standard_gce_zones" {
description = "List of zones, excluding AI/ML zones."
value = locals.non_ai_zones
}
查看可用地區清單
控制台
您可以在Google Cloud 控制台的「區域」頁面中查看可用區域。
gcloud
使用 Google Cloud CLI 執行 gcloud compute regions list 指令:
gcloud compute regions list
這項指令會列出所有可用區域,並提供配額和區域本身狀態等資訊。
例如:
gcloud compute regions list NAME CPUS DISKS_GB ADDRESSES RESERVED_ADDRESSES STATUS asia-east1 0/24 0/10240 0/23 0/7 UP asia-northeast1 0/24 0/10240 0/23 0/7 UP asia-southeast1 0/24 0/10240 0/23 0/7 UP europe-west1 0/24 0/10240 2/23 0/7 UP us-central1 0/24 0/10240 0/23 0/7 UP us-east1 0/24 0/10240 0/23 0/7 UP us-west1 0/24 0/10240 0/23 0/7 UP
REST
對 regions.list 方法發出 GET 要求,即可取得區域清單。請將 PROJECT_ID
改成您的PROJECT_ID。
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
查看區域資訊
控制台
您可以在Google Cloud 控制台的「Zones」(區域) 頁面上查看有關地區的資訊。
gcloud
如要取得有關單一區域的資訊,請執行 gcloud compute
regions describe 指令,其中 REGION 是您想要取得更多相關資訊的區域名稱:
gcloud compute regions describe REGION
畫面會顯示類似以下的回應:
creationTimestamp: '2013-09-06T17:54:12.193-07:00'
description: us-central1
id: '5778272079688511892'
kind: compute#region
name: us-central1
quotas:
- limit: 24.0
metric: CPUS
usage: 5.0
- limit: 5120.0
metric: DISKS_TOTAL_GB
usage: 650.0
- limit: 7.0
metric: STATIC_ADDRESSES
usage: 4.0
- limit: 23.0
metric: IN_USE_ADDRESSES
usage: 5.0
- limit: 1024.0
metric: SSD_TOTAL_GB
usage: 0.0
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1
status: UP
zones:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-b
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-c
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-f
REST
對 regions.get 方法發出 GET 要求,即可取得區域相關資訊。請將 PROJECT_ID 替換為您的 PROJECT_ID,並將 REGION 替換為您要取得更多資訊的區域。
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
後續步驟
- 進一步瞭解地區和區域
- 瞭解如何變更預設地區或區域
- 進一步瞭解全域、區域和可用區資源