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 Cloud de Confiance by S3NS dan API. Untuk menjalankan
kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan konsol Cloud de Confiance untuk mengakses layanan Cloud de Confiance by S3NS dan API, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
-
- Tetapkan region dan zona default.
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, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Cloud de Confiance .
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) pada 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 Cloud de Confiance .
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:
- Untuk menemukan zona AI yang menyediakan kapasitas signifikan untuk akselerator, telusuri zona AI.
- Untuk menemukan semua zona yang mendukung akselerator tertentu, telusuri menurut jenis akselerator.
- Untuk menemukan semua zona yang mendukung jenis mesin tertentu dengan akselerator, telusuri menurut jenis mesin.
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-central1-ai1a adalah zona AI di region us-central1, dengan
us-central1-a sebagai zona induknya. Untuk mempelajari lebih lanjut, lihat
Zona AI.
Konsol Cloud de Confiance 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 Cloud de Confiance , halaman Zones mencantumkan zona AI di region tempat zona ini didukung. Anda dapat mengidentifikasi zona AI dengan
string AI dalam namanya—misalnya, region us-central1 mencantumkan Zone AI1A.
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 menurut 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-8gJenis mesin A4gcloud compute machine-types list \ --filter="name=a4-highgpu-8g" \ --format="value(zone)"ct6e-standard-4tJenis 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-8gJenis mesin A4GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a4-highgpu-8g
ct6e-standard-4tJenis 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.
Mengecualikan zona AI dari daftar
Jika Anda memiliki akses ke zona AI, tetapi tidak ingin melihatnya dalam daftar zona, gunakan filter untuk mengecualikannya. Hal ini mungkin terjadi jika Anda menggunakan
layanan yang tidak didukung zona AI, atau jika Anda memiliki otomatisasi yang ada yang
bergantung pada daftar zona. Anda dapat mengidentifikasi zona AI dengan akhiran -ai dalam
namanya.
gcloud
Untuk mengecualikan zona AI dari daftar zona yang tersedia, gunakan
perintah gcloud compute zones list
dan filter zona yang berisi string -ai:
gcloud compute zones list --filter 'name !~ ".*-ai.*"'
Untuk mengecualikan zona AI saat mencantumkan jenis mesin, gunakan
perintah gcloud compute machine-types list
dan filter zona yang berisi string -ai:
gcloud compute machine-types list --filter 'zone !~ ".*-ai.*"'
REST
Untuk mengecualikan zona AI dari hasil API, gunakan ekspresi reguler name ne ".*-ai.*" dalam parameter kueri filter. Saat menambahkan filter ini ke dalam
URL, Anda harus mengenkode parameter kueri filter sebagai
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
Ganti PROJECT_ID dengan PROJECT_ID Anda.
Terraform
Untuk mengecualikan zona AI dari daftar zona yang tersedia, buat fungsi lokal seperti dalam contoh berikut:
# 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
}
Melihat daftar wilayah yang tersedia
Konsol
Anda dapat melihat region yang tersedia di halaman Zones di konsol Cloud de Confiance .
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 konsolCloud de Confiance .
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
- Pelajari Region dan zona lebih lanjut
- Pelajari cara Mengubah region atau zona default
- Pelajari Resource global, regional, dan zona lebih lanjut