ゾーンを管理する

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

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

次のステップ