ゾーンを管理する

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

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

ゾーンの一覧表示

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

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

コンソール

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

    [Edge ゾーン] に移動

  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 を有効にする必要があります。

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

次のような場合は、Distributed Cloud コネクテッド ゾーンごとにネットワーク構成を初期化する必要があります。

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

ゾーンのネットワーク構成を初期化すると、default という名前のデフォルト ルーターが作成されます。次に、default ルーターは、Distributed Cloud コネクテッド ハードウェアを注文したときにリクエストしたすべての相互接続とピアリングするように構成されます。これを行うには、対応する相互接続のアタッチメントを作成します。これにより、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 コネクテッド ゾーンに関する情報を取得するには、このセクションの手順を完了します。

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

コンソール

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

    [Edge ゾーン] に移動

  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 リージョン。

次のステップ