このページでは、利用可能なリージョンとゾーンのリストを表示する方法、および特定のリージョンの情報を取得する方法について説明します。
リージョンとゾーンの詳細については、リージョンとゾーンのドキュメントをご覧ください。
グローバル、リージョン、ゾーンの Compute Engine リソースについて詳しくは、グローバル リソース、リージョン リソース、ゾーンリソースのドキュメントをご覧ください。
準備
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
必要なロール
リージョンとゾーンの可用性を表示するために必要な権限を取得するには、プロジェクトに対するCompute 閲覧者(roles/compute.viewer
)IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理に関する記事をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
使用可能なゾーンのリストを表示する
コンソール
Google Cloud コンソールの [ゾーン] ページでゾーンのリストを表示します。
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 ゾーンのリストを表示する
GPU をサポートするゾーンのリストを表示するには、gcloud CLI または REST を使用します。
gcloud
GPU タイプで検索する
GPU タイプで検索するには、--filter
フラグを指定して gcloud compute accelerator-types list
コマンドを使用して、使用可能なゾーンを検索します。
たとえば、H100 80 GB GPU を搭載したすべてのゾーンを検索するには、次のコマンドを実行します。
gcloud compute accelerator-types list --filter="nvidia-h100-80gb"
出力として、ゾーン別に整理された使用可能な GPU のリストが返されます。その後 gcloud compute accelerator-types describe
コマンドを使用して、返された各 GPU モデルの説明を取得できます。
マシンタイプで検索する
A3、A2、G2 のアクセラレータ最適化マシンタイプでは、GPU が VM に自動的に接続されます。これらのマシンタイプの場合、--filter
フラグを指定して gcloud compute machine-types list
コマンドを使用すると、使用可能なゾーンを検索できます。たとえば、A3 High マシンタイプを含むすべてのゾーンを検索するには、次のコマンドを実行します。
gcloud compute machine-types list --filter="name=a3-highgpu-8g"
REST
GPU タイプで検索する
特定の GPU モデルで利用可能なゾーンを表示するには、--filter
パラメータを使用して acceleratorTypes.aggregatedList
メソッドに GET
リクエストを送信します。
たとえば、H100 80 GB GPU を搭載したすべてのゾーンを検索するには、次のコマンドを実行します。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
マシンタイプで検索する
A3、A2、G2 のアクセラレータ最適化マシンタイプでは、GPU が VM に自動的に接続されます。これらのマシンタイプでは、--filter
パラメータを使用して machineTypes.aggregatedList
メソッドを使用すると、使用可能なゾーンを検索できます。
たとえば、A3 High マシンタイプを含むすべてのゾーンを検索するには、次のコマンドを実行します。
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/machineTypes?filter=name=a3-higgpu-8
PROJECT_ID
は、実際のプロジェクト ID に置き換えます。
出力では、使用可能な GPU のリストと、ゾーンごとに整理された各 GPU モデルの説明が返されます。
使用可能なリージョンのリストを表示する
コンソール
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 コンソールの [ゾーン] ページでリージョンの情報を表示できます。
gcloud
1 つのリージョンの情報を取得するには、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
次のステップ
- リージョンとゾーンの詳細を確認する
- デフォルトのリージョンまたはゾーンの変更について学習する
- グローバル リソース、リージョン リソース、ゾーンリソースの詳細を確認する