查看可用的區域和可用區

本頁面說明如何查看可用地區和區域清單,以及如何取得有關特定地區的資訊。

如要進一步瞭解區域和可用區,請參閱區域和可用區說明文件。

如要進一步瞭解全球、區域和可用區 Compute Engine 資源,請參閱全球、區域和可用區資源說明文件。

事前準備

  • 如果尚未設定驗證,請先完成設定。 驗證可確認您的身分,以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例,請選取下列其中一個選項,向 Compute Engine 進行驗證:

    選取這個頁面上的分頁,瞭解如何使用範例:

    控制台

    使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時,無須設定驗證。

    gcloud

    1. 安裝 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」(區域) 頁面中查看區域清單。

前往「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-ai1aus-central1 地區中的 AI 區域,而 us-central1-a 是其父項區域。詳情請參閱「AI 可用區」一文。

Google Cloud 控制台會列出 AI 可用區和其他可用區,並依區域分組。如要查看可用的 AI 區域清單,請使用 gcloud CLI 或 REST API。

控制台

在 Google Cloud 控制台中,「區域」頁面會列出支援這些區域的地區中的 AI 區域。您可以透過名稱中的 AI 字串識別 AI 可用區,例如 us-central1 區域會列出 Zone AI1A

前往「Zones」(區域) 頁面

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-8g A4 機型

      gcloud compute machine-types list \
          --filter="name=a4-highgpu-8g" \
          --format="value(zone)"
    
  • ct6e-standard-4t Cloud 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-8g A4 機型

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
    
  • ct6e-standard-4t Cloud 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 控制台的「區域」頁面中查看可用區域。

前往「Zones」(區域) 頁面

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」(區域) 頁面上查看有關地區的資訊。

前往「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

後續步驟