ゾーンを管理する

このページでは、Distributed Cloud デプロイで Google Distributed Cloud ゾーンリソースを管理する方法について説明します。 Google Cloud API の構造により、Distributed Cloud Edge Container API では、Distributed Cloud ゾーンリソースはロケーションと呼ばれます。

Distributed Cloud ゾーンの詳細については、Distributed Cloud の仕組みをご覧ください。

ゾーンの一覧表示

Google Cloud プロジェクトの Distributed Cloud ゾーンを一覧表示するには、このセクションの手順を完了します。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。

コンソール

  1. Google Cloud コンソールで、[エッジゾーン] ページに移動します。

    [エッジゾーン] に移動

  2. ゾーンのリストとその詳細を確認します。

gcloud

gcloud edge-cloud container zones list コマンドを使用します。

gcloud edge-cloud container zones list \
    --project=PROJECT_ID

PROJECT_ID は、ターゲットGoogle Cloud プロジェクトの ID に置き換えます。

API

projects.locations.list メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • FILTER: 返される結果を特定の値に制限する式。
  • PAGE_SIZE: ページごとに返す結果の数
  • SORT_BY: 返される結果の並べ替えの基準とするフィールド名のカンマ区切りリストデフォルトの並べ替え順は昇順です。降順で並べ替えるには、目的のフィールドに ~ という接頭辞を付けます。
  • PAGE_TOKEN: レスポンスの nextPageToken フィールドで、最後のリスト リクエストのレスポンスで受け取ったトークン。このトークンを送信して、結果のページを受け取ります。

ゾーンのネットワーク構成を初期化する

Distributed Cloud ゾーンのネットワーク構成を初期化するには、このセクションの手順を完了します。

ゾーンのネットワーク構成を初期化する前に、まず Distributed Cloud Edge Network API を有効にする必要があります。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge ネットワーク管理者ロール（roles/edgenetwork.admin）が必要です。

次の場合、各 Distributed Cloud ゾーンのネットワーク構成を初期化する必要があります。

  • Distributed Cloud ハードウェアがオンプレミスにインストールされた直後。
  • 既存の Distributed Cloud デプロイで Distributed Cloud バージョン 1.3.0 にアップグレードしたが、Distributed Cloud Edge Network API の限定公開プレビューに参加していない。

ゾーンのネットワーク構成を初期化すると、default という名前のデフォルトのルーターが作成されます。次に、対応する相互接続のアタッチメントを作成して、Distributed Cloud ハードウェアを注文したときにリクエストしたすべての相互接続とピアリングするように default ルーターを構成します。これにより、Distributed Cloud デプロイにローカル ネットワークへの基本的なアップリンク接続が提供されます。

これは 1 回限りの手順です。後続の実行では、既存の Distributed Cloud ネットワーク設定は変更されません。

gcloud

gcloud edge-cloud networking zones init コマンドを使用します。

gcloud edge-cloud networking zones init ZONE_NAME \
    --project=PROJECT_ID \
    --location=REGION

次のように置き換えます。

  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。
  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが作成される Google Cloud リージョン。

API

projects.locations.zones.initialize メソッドに POST リクエストを送信します。

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが作成される Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。

ゾーンに関する情報を取得する

Distributed Cloud ゾーンに関する情報を取得するには、このセクションの手順を行います。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロール（roles/edgecontainer.viewer）が必要です。

コンソール

  1. Google Cloud コンソールで、[エッジゾーン] ページに移動します。

    [エッジゾーン] に移動

  2. 目的のゾーンをクリックします。

    Google Cloud コンソールに、選択したゾーンに関する詳細情報が表示されます。

gcloud

gcloud edge-cloud container zones describe コマンドを使用します。

gcloud edge-cloud container zones describe ZONE_NAME \
    --project=PROJECT_ID

次のように置き換えます。

  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。
  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。

API

projects.locations.get メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations/REGION

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが作成される Google Cloud リージョン。

次のステップ