利用可能なリージョンとゾーンを表示する

このページでは、利用可能なリージョンとゾーンのリストを取得する方法、および特定のリージョンの情報を取得する方法について説明します。

リージョンとゾーンの詳細については、リージョンとゾーンのドキュメントをご覧ください。

グローバル、リージョン、ゾーンの Compute Engine リソースについて詳しくは、グローバル リソース、リージョン リソース、ゾーンリソースのドキュメントをご覧ください。

始める前に

  • まだ設定していない場合は、認証を設定します。認証とは、 Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

    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. After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.

        3. REST

        このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

          After installing the Google Cloud CLI, initialize it by running the following command: 

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

利用可能なリージョンとゾーンを表示するために必要な権限を取得するには、プロジェクトに対する 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

次のステップ