Melihat region dan zona yang tersedia

Halaman ini menjelaskan cara melihat daftar region dan zona yang tersedia, serta cara mendapatkan informasi tentang region tertentu.

Untuk mempelajari region dan zona lebih lanjut, baca dokumentasi Region dan zona.

Untuk mempelajari resource Compute Engine global, regional, dan zona lebih lanjut, baca dokumentasi Resource global, regional, dan zona.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    2. Set a default region and zone.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat region dan zona yang tersedia, minta administrator untuk memberi Anda peran IAM Compute Viewer (roles/compute.viewer) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Melihat daftar zona yang tersedia

Zona adalah area deployment dalam sebuah region. Beberapa region memiliki zona khusus yang menyediakan kapasitas signifikan untuk akselerator yang sangat diminati (GPU dan TPU). Zona khusus ini disebut zona AI, yang ideal untuk workload AI dan ML.

Untuk melihat daftar zona yang tersedia, termasuk zona AI, gunakan salah satu opsi berikut:

Konsol

Lihat daftar zona di halaman Zones di konsol Google Cloud .

Buka halaman Zones

gcloud

Dengan menggunakan Google Cloud CLI, jalankan perintah gcloud compute zones list:

gcloud compute zones list

REST

Buat permintaan GET ke metode zones.list untuk mendapatkan daftar zona untuk suatu project. Ganti PROJECT_ID dengan PROJECT_ID Anda.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones

Melihat daftar zona yang mendukung akselerator (GPU dan TPU)

Untuk melihat daftar zona yang mendukung akselerator (GPU dan TPU), gunakan salah satu metode berikut:

Menelusuri zona AI

Jika Anda ingin menjalankan beban kerja AI dan ML, sebaiknya gunakan zona AI. Anda dapat mengidentifikasi zona AI dengan string ai dalam namanya. Misalnya, us-west4-ai1b adalah zona AI di region us-west4, dengan us-west4-b sebagai zona induknya. Untuk mempelajari lebih lanjut, lihat zona AI.

Konsol Google Cloud mencantumkan zona AI bersama dengan zona lainnya, yang dikelompokkan menurut wilayah. Untuk melihat daftar zona AI yang tersedia, gunakan gcloud CLI atau REST API.

Konsol

Di konsol Google Cloud , halaman Zones mencantumkan zona AI di region tempat zona ini didukung. Anda dapat mengidentifikasi zona AI dengan string AI dalam namanya—misalnya, region us-west4 mencantumkan Zone AI2B.

Buka halaman Zones

gcloud

Gunakan perintah gcloud compute zones list dan filter zona yang berisi string ai:

gcloud compute zones list \
    --filter="name~'-ai'"

REST

Buat permintaan GET ke metode zones.list. Untuk mencocokkan zona yang berisi ai dalam namanya, gunakan parameter kueri filter dengan ekspresi reguler name eq '.*-ai.*'.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones?filter=name%20eq%20'.*-ai.*'

Ganti PROJECT_ID dengan PROJECT_ID Anda.

Menelusuri menurut jenis akselerator

Penelusuran menurut jenis akselerator akan menampilkan semua zona, termasuk zona AI, tempat akselerator tersebut didukung.

gcloud

Untuk menelusuri berdasarkan jenis akselerator, gunakan perintah gcloud compute accelerator-types list dengan flag --filter.

Misalnya, untuk menemukan semua zona dengan akselerator tertentu seperti GPU NVIDIA B200 atau Cloud TPU v6e (Trillium), jalankan salah satu perintah berikut:

  • 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)"

Ganti jenis akselerator dalam contoh dengan jenis akselerator yang ingin Anda telusuri.

REST

Untuk menelusuri menurut jenis akselerator, kirim permintaan GET ke metode acceleratorTypes.aggregatedList dengan parameter filter.

Misalnya, untuk menemukan semua zona dengan akselerator tertentu seperti GPU NVIDIA B200 atau Cloud TPU v6e (Trillium), jalankan salah satu perintah berikut:

  • 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

Ganti jenis akselerator dalam contoh dengan jenis akselerator yang ingin Anda telusuri.

Menelusuri berdasarkan jenis mesin

Penelusuran menurut jenis mesin akan menampilkan semua zona, termasuk zona AI, tempat jenis mesin tersebut didukung.

gcloud

Untuk menelusuri menurut jenis mesin, gunakan perintah gcloud compute machine-types list dengan flag --filter.

Misalnya, untuk menemukan semua zona dengan jenis mesin tertentu seperti jenis mesin A4 a4-highgpu-8g atau jenis mesin Cloud TPU v6e ct6e-standard-4t (Trillium), jalankan salah satu perintah berikut:

  • a4-highgpu-8g Jenis mesin A4

      gcloud compute machine-types list \
      --filter="name=a4-highgpu-8g" \
      --format="value(zone)"

  • ct6e-standard-4t Jenis mesin Cloud TPU v6e (Trillium)

      gcloud compute machine-types list \
      --filter="name=ct6e-standard-4t" \
      --format="value(zone)"

Ganti jenis mesin dalam contoh dengan jenis mesin yang ingin Anda telusuri.

REST

Untuk menelusuri menurut jenis mesin, buat permintaan GET ke metode machineTypes.aggregatedList dengan parameter filter.

Misalnya, untuk menemukan semua zona dengan jenis mesin tertentu seperti jenis mesin A4 a4-highgpu-8g atau jenis mesin Cloud TPU v6e ct6e-standard-4t (Trillium), jalankan salah satu perintah berikut:

  • a4-highgpu-8g Jenis mesin A4

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g

  • ct6e-standard-4t Jenis mesin Cloud TPU v6e (Trillium)

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=ct6e-standard-4t

Ganti PROJECT_ID dengan Project ID Anda dan jenis mesin dengan jenis mesin yang ingin Anda cari.

Melihat daftar wilayah yang tersedia

Konsol

Anda dapat melihat region yang tersedia di halaman Zones di konsolGoogle Cloud .

Buka halaman Zones

gcloud

Dengan menggunakan Google Cloud CLI, jalankan perintah gcloud compute regions list:

gcloud compute regions list

Perintah tersebut mencantumkan semua region yang tersedia dan memberikan informasi seperti kuota dan status region itu sendiri.

Contoh:

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

Buat permintaan GET ke metode regions.list untuk mendapatkan daftar region. Ganti PROJECT_ID dengan PROJECT_ID Anda.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions

Melihat informasi tentang suatu region

Konsol

Anda dapat melihat informasi tentang region di halaman Zona di konsolGoogle Cloud .

Buka halaman Zones

gcloud

Untuk mendapatkan informasi tentang satu region, jalankan perintah gcloud compute regions describe, dengan REGION sebagai nama region yang informasi selengkapnya ingin Anda dapatkan:

gcloud compute regions describe REGION

Responsnya akan mirip dengan berikut ini:

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

Buat permintaan GET ke metode regions.get untuk mendapatkan informasi tentang suatu region. Ganti PROJECT_ID dengan PROJECT_ID Anda dan REGION dengan region yang informasi selengkapnya ingin Anda dapatkan.

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION

Langkah berikutnya