ハブとスポークの操作

このページでは、Network Connectivity Center のハブとスポークを一覧表示、作成、説明、削除、更新する方法について説明します。

Network Connectivity Center の概要については、Network Connectivity Center の概要をご覧ください。

2 つのサイト間のデータ転送を設定する方法を説明したチュートリアルについては、Cloud VPN スポークを使用した 2 つの支店の接続をご覧ください。

始める前に

Network Connectivity Center を簡単に構成できるように、次の手順を行います。

  1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  3. Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Cloud SDK をインストールして初期化します。
  1. gcloud コマンドを使用している場合、プロジェクト ID を次のコマンドで設定します。このページの gcloud コマンドラインの手順では、プロジェクト ID がすでに設定済みであることを前提としています。
          gcloud config set project PROJECT_ID
        
  1. すでに設定されているプロジェクト ID を表示することもできます。
          gcloud config list --format='text(core.project)'
        

Network Connectivity API の有効化

Network Connectivity Center を使用して任意のタスクを行う前に、Network Connectivity API を有効にする必要があります。次の操作を行います。または、API を有効にするで説明されているように、Cloud Console API ライブラリを使用することもできます。

Console

Network Connectivity API を有効にするには:

  1. Cloud Console で、[Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. [有効にする] をクリックします。

API に関する注意事項

注: 一般公開プレビューの間、このガイドに記載されているコマンドは Network Connectivity API のアルファ版を使用していますが、Compute Engine API についてはベータ版を使用しています。

名前または URI でのハブまたはスポーク リソースの指定

コマンドの入力時には、名前または完全な URI によって次のネットワーク接続センター リソースを指定できます。

  • ハブ
  • スポークに接続されたリソース

この方法は、gcloud コマンドライン ツールと Network Connectivity API に適用されます。

たとえば、TUNNEL_NAME または projects/PROJECT_NAME/regions/REGION/vpnTunnels/TUNNEL_NAME としてスポークに接続された HA VPN トンネルを参照できます。

次の例は、URI を使用して 2 つの HA VPN トンネルをスポークに追加して指定する方法を示しています。

--vpn-tunnel="https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME","https://www.googleapis.com/compute/projects/PROJECT_ID/regions/REGION/vpnTunnels/TUNNEL_NAME"

ハブの操作

このセクションでは、Network Connectivity Center のハブを一覧表示、作成、説明、削除する方法について説明します。ハブのラベルと説明を更新することもできます。

ハブの作成

プロジェクトごとに 1 つのハブを作成できます。ハブを作成するときに、必要に応じて説明とラベルを追加できます。

Console

  1. Cloud Console で、[Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択します。

  3. ハブ名を入力します。

  4. 必要に応じて説明を入力します。

  5. プロジェクト ID を確認します。プロジェクト ID が誤っている場合は、画面上部のプルダウン メニューを使用して別のプロジェクトを選択します。

  6. [続行] をクリックします。

  7. 次のいずれかを行います。

  8. [完了] をクリックします。

gcloud

ハブを作成するには、次のコマンドを入力します。

ラベルの詳細については、ラベルの要件をご覧ください。

  gcloud alpha network-connectivity hubs create NAME \
    --description=DESCRIPTION \
    --labels=KEY=VALUE

次の値を置き換えます。

  • NAME: 新しいハブの名前
  • DESCRIPTION: ハブを説明するテキスト(省略可)
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

API

ハブを作成するには、networkconnectivity.hubs.create メソッドを使用します。

ラベルの詳細については、ラベルの要件をご覧ください。

  POST https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/global/hubs
  {
    "name":"NAME",
    "description":"DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

次の値を置き換えます。

  • PROJECT_ID: 新しいハブを含むプロジェクトのプロジェクト ID
  • NAME: 新しいハブの名前
  • DESCRIPTION: ハブを説明するテキスト(省略可)
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

ハブの一覧表示

Network Connectivity Center では、1 つのプロジェクトに 1 つのハブしかありません。プロジェクトのハブを表示するには、次のガイダンスに沿ってください。

Console

  1. Cloud Console で、[Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択します。

gcloud

プロジェクトに関連付けられたハブを一覧表示するには、次のコマンドを入力します。

  gcloud alpha network-connectivity hubs list

API

プロジェクトに関連付けられているハブを一覧表示するには、networkconnectivity.hubs.list メソッドを使用します。

  GET https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/global/hubs

PROJECT_ID は、一覧表示するハブを含むプロジェクトのプロジェクト ID に置き換えます。

ハブの説明

プロジェクトのハブに関する詳細を取得するには、次のガイダンスに従ってください。ハブに接続されたスポークに関する追加情報については、スポークの説明をご覧ください。

Console

  1. Cloud Console で、[Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択すると、そのプロジェクトのハブに関する情報が表示されます。

  3. ハブのスポークの詳細を表示するには、[スポーク] タブをクリックします。

gcloud

既存のハブに関する詳細情報を取得するには、次のコマンドを入力します。

gcloud alpha network-connectivity hubs describe NAME

NAME は、ハブの名前で置き換えます。

API

既存のハブの詳細情報を取得するには、networkconnectivity.hubs.get メソッドを使用します。

  GET https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/global/hubs/NAME

次の値を置き換えます。

  • PROJECT_ID: 説明するハブを含むプロジェクトのプロジェクト ID
  • NAME: 説明するハブの名前

このコマンドの出力には、次の情報が表示されます。

  • ハブが作成された時刻
  • ハブに適用されたラベル
  • ハブの名前
  • ハブに接続された各スポークの URI
  • ハブの一意の ID
  • ハブの最終更新日時
 createTime: '2020-11-05T21:29:09.168879193Z'
    labels:
     hubs: hub-us-west2
     name: projects/my-project/locations/global/hubs/my-hub
     spokes:
     - https://networkconnectivity.googleapis.com/v1alpha1/projects/419575220454/locations/us-west2/spokes/spoke1
    uniqueId: 8ca1fd2d-979e-4925-bd23-a5f739b3f4ae
  updateTime: '2020-11-05T21:29:09.305702283Z'
 

ラベルまたは新しい説明でハブを更新する

ハブを作成した後、次のいずれかを追加または変更して、ハブを更新できます。

  • ハブに適用されたラベル
  • ハブの説明

ハブの作成で説明されているように、ハブの作成時にラベルまたは説明を設定することもできます。

ラベルの詳細については、ラベルの要件をご覧ください。

gcloud

ハブの説明の更新や、ハブへのラベルの追加を行うには、次のコマンドを入力します。

  gcloud alpha network-connectivity hubs update NAME \
    --description=DESCRIPTION \
    --labels=KEY=VALUE

次の値を置き換えます。

  • NAME: ハブの名前
  • DESCRIPTION: ハブの新しい説明(省略可)
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

API

ハブの説明の更新や、ハブへのラベルの追加を行うには、networkconnectivity.hubs.patch メソッドを使用します。

  PATCH https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/global/hubs/NAME
  {
    "description": "DESCRIPTION",
    "labels": {
      "KEY": "VALUE"
    }
  }

次の値を置き換えます。

  • PROJECT_ID: ラベルを追加するハブを含むプロジェクトのプロジェクト ID
  • NAME: ハブの名前
  • DESCRIPTION: ハブの新しい説明(省略可)
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

ハブの削除

ハブを削除する前に、スポークの削除で説明されているように、そのスポークを削除する必要があります。

Console

  1. Cloud Console で、[Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択します。

  3. [ハブを削除] をクリックします。

  4. 確認のダイアログで、次のいずれかを行います。

    • ハブを削除しない場合は、[キャンセル] をクリックします。
    • [削除] をクリックしてハブを削除します。

gcloud

ハブを削除するには、次のコマンドを入力します。

  gcloud alpha network-connectivity hubs delete NAME

NAME は、ハブの名前で置き換えます。

API

ハブを削除するには、networkconnectivity.hubs.delete メソッドを使用します。

  DELETE https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/global/hubs/NAME

次の値を置き換えます。

  • PROJECT_ID: 削除するハブを含むプロジェクトのプロジェクト ID
  • NAME: 削除するハブの名前

スポークの操作

このセクションでは、Network Connectivity Center のスポークを一覧表示、作成、説明、削除する方法について説明します。ハブのラベルと説明を更新することもできます。

スポークのガイドライン

スポークを作成する際に、接続する Google Cloud ネットワーク リソースのタイプを指定します。

スポークが接続するサイトに最も近いリージョンにスポークを作成することをおすすめします。たとえば、サイトにはオンプレミスのデータセンター、支店、別のクラウド プロバイダなどが考えられます。

要件

  • 接続する Google Cloud リソースと同じリージョンにスポークを作成する必要があります。たとえば、HA VPN トンネルをスポークに接続する場合、そのスポークは、それらのトンネルを含む HA VPN ゲートウェイと同じリージョンに存在する必要があります。
  • gcloud コマンドライン ツールまたは API を使用して複数のリソースをスポークに接続するには、リソース名をカンマで区切ります。カンマの前後にスペースを入れないでください。
  • 既存のスポークに対してリソース(HA VPN トンネル、VLAN アタッチメント、ルーター アプライアンス インスタンスなど)を追加または削除することはできません。代わりに、スポークを削除して再作成し、スポークに含めるリソースを追加する必要があります。

スポークに複数のリソースを接続する際の推奨事項

スポークを作成するときに複数のリソースを追加できますが、すべてのリソースは同じタイプでなければなりません。たとえば、複数の HA VPN トンネルを追加できますが、HA VPN トンネルと VLAN アタッチメントを追加することはできません。また、スポークは複数のリソースに関連付けることができる一方で、各リソースは 1 つのスポークにしか関連付けできません。詳細については、スポークのリソースタイプをご覧ください。

さらに、Router アプライアンス スポークの作成VLAN アタッチメント スポークの作成VPN スポークの作成で説明されているリソース固有の推奨事項もご覧ください。

ASN のスポーク アサインメント

スポーク リソースの ASN 要件の説明に従って ASN を割り当てる必要があります。

スポーク リソースの検証

スポークを作成する前に、対応するリソースを正しく構成する必要があります。詳細については、Router アプライアンスのスポークの作成VLAN アタッチメントのスポークの作成VPN スポークの作成でリソース固有の推奨事項をご覧ください。

Router アプライアンス スポークの作成

VLAN アタッチメントや VPN スポークとは異なり、Router アプライアンス スポークは、Google Cloud 外部の 1 つのロケーションに関連付ける必要はありません。ただし、ルーター アプライアンス インスタンスはリージョン リソースであるため、近いロケーションからデータを受信するように構成することをおすすめします。

複数の同じサイトからデータを受信するように複数のルーター アプライアンス インスタンスを構成する場合は、それらのインスタンスを同じスポークに関連付けることをおすすめします。

Network Connectivity Center では、インスタンス間でサイト間データ転送が行われません。複数のルーター アプライアンス インスタンスをスポークにリンクする場合は、この点に注意してください。サイト間データ転送を使用するには、複数のスポークを設定する必要があります。これにより、Network Connectivity Center はこれらのスポーク間でのデータ転送を許可します。

Router アプライアンス スポークを作成したら、ルーター アプライアンス インスタンスと、同じリージョンにある Cloud Router との間に BGP ピアリングを設定する必要があります。詳細については、ルーター アプライアンス インスタンスの作成をご覧ください。

Router アプライアンスのスポークの作成に必要なリソースの構成方法については、次のドキュメントをご覧ください。

Console

スポークの基本情報を入力する

  1. Google Cloud Console で、[Network Connectivity Center] ページに移動します。
  2. Network Connectivity Center に移動
  3. プロジェクトのプルダウン メニューでプロジェクトを選択します。
  4. [スポーク] タブをクリックします。
  5. [スポークを追加する] をクリックします。
  6. [ネットワーク] プルダウン リストで、ネットワークを選択します。すべてのハブのスポークが同じ VPC ネットワーク内に存在する必要があります。
  7. [新しいスポーク] フォームに、スポーク名を入力します。必要であれば、説明も入力します。

ルーター アプライアンスの詳細を入力する

  1. [スポークタイプ] プルダウン リストを [ルーター アプライアンス] に設定します。
  2. スポークのリージョンを選択します。
  3. ルーター アプライアンス インスタンスを選択します。
    1. [インスタンスを追加] をクリックします。
    2. [インスタンス] プルダウン メニューから、既存のルーター アプライアンス インスタンスを選択します。
  4. このスポークにルーター アプライアンス インスタンスを追加するには、上記の手順を繰り返します。終了したら、[完了] をクリックして「スポークを保存する」に進みます。

スポークの保存

  1. さらにスポークを追加する場合は、[スポークを追加する] をクリックして手順をもう一度開始し、スポークの名前を入力します。
  2. スポークの追加が完了したら、[作成] をクリックします。Network Connectivity Center のページが更新され、作成したスポークの詳細が表示されます。

gcloud

ルーター アプライアンス インスタンスを含むスポークを作成するには、次のコマンドを入力します。

  gcloud alpha network-connectivity spokes create NAME \
    --hub=HUB_NAME \
    --description=DESCRIPTION \
    --router-appliance=ROUTER_APPLIANCE_DETAILS \
    --region=REGION \
    --labels=KEY=VALUE
 

次の値を置き換えます。

  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ名。URI 形式で指定します。例:
    projects/myproject/locations/global/hubs/us-west-to-uk
  • DESCRIPTION: スポークを説明するテキスト(省略可)。例: us-vpn-spoke
  • ROUTER_APPLIANCE_DETAILS: スポークに追加するルーター アプライアンス インスタンスの URI と IP アドレス。例:
    instance="https://www.googleapis.com/compute/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME",ip="INTERNAL_IP_ADDRESS" 
  • REGION: スポークが配置されている Google Cloud リージョン。例: us-west1
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

API

Router アプライアンスのスポークを作成するには、networkconnectivity.spokes.create メソッドを使用します。

API 呼び出しでスポークタイプを参照する場合は、名前ではなくリソース URI を使用します。

  POST https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes
  {
    "name": NAME,
    "hub": HUB_NAME,
    "labels": {
      "KEY": "VALUE"
    }
    "linkedRouterApplianceInstances": {
      "virtual_machine": ["ROUTER_APPLIANCE_NAME],
      "ip_address": INTERNAL_IP_ADDRESS,
      },
   }

次の値を置き換えます。

  • PROJECT_ID: スポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されている Google Cloud リージョン。例: us-west1
  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)
  • ROUTER_APPLIANCE_NAME: スポークに追加するルーター アプライアンス インスタンスの名前(URI 形式)
  • INTERNAL_IP_ADDRESS: ルーター アプライアンス VM 上のいずれかのネットワーク インターフェースの内部 IP アドレス

VLAN アタッチメント スポークの作成

VLAN アタッチメント スポークを作成する前に、次のガイドラインを考慮してください。

  • 同じサイトに対する冗長構成に Dedicated Interconnect 接続か、Partner Interconnect 接続が構成されている場合は、両方の接続を 1 つのスポークとして構成する必要があります。これらの Interconnect 接続に関連付けられた冗長 VLAN アタッチメントは、同じ Google Cloud リージョンに配置する必要があります。冗長構成の詳細については、Cloud Interconnect のベスト プラクティスをご覧ください。
  • 異なるリージョンの Interconnect 接続を使用する場合、それらは別々のスポークとして構成する必要があります。

VLAN アタッチメントのスポークの作成に必要なリソースの構成については、次のドキュメントをご覧ください。

VLAN アタッチメント リソースの検証については、次のドキュメントをご覧ください。

Console

スポークの基本情報を入力する

  1. Google Cloud Console で、[Network Connectivity Center] ページに移動します。
  2. Network Connectivity Center に移動
  3. プロジェクトのプルダウン メニューでプロジェクトを選択します。
  4. [スポーク] タブをクリックします。
  5. [スポークを追加する] をクリックします。
  6. [ネットワーク] プルダウン リストで、ネットワークを選択します。すべてのハブのスポークが同じ VPC ネットワーク内に存在する必要があります。
  7. [新しいスポーク] フォームに、スポーク名を入力します。必要であれば、説明も入力します。

VLAN アタッチメントの詳細を入力する

  1. [スポークタイプ] プルダウン リストを [VLAN アタッチメント] に設定します。
  2. スポークのリージョンを選択します。
  3. VLAN アタッチメントを選択します。
    1. [アタッチメントの追加] をクリックします。
    2. [VLAN アタッチメント] プルダウン メニューから、既存のアタッチメントを選択します。
  4. このスポークにさらにアタッチメントを追加するには、上の手順を繰り返します。終了したら、[完了] をクリックして「スポークを保存する」に進みます。

スポークの保存

  1. さらにスポークを追加する場合は、[スポークを追加する] をクリックして手順をもう一度開始し、スポークの名前を入力します。
  2. スポークの追加が完了したら、[作成] をクリックします。Network Connectivity Center のページが更新され、作成したスポークの詳細が表示されます。

gcloud

VLAN アタッチメントを含むスポークを作成するには、次のコマンドを入力します。

  gcloud alpha network-connectivity spokes create NAME \
    --hub=HUB_NAME \
    --description=DESCRIPTION \
    --interconnect-attachment=VLAN_ATTACHMENT_NAME \
    --region=REGION \
    --labels=KEY=VALUE

次の値を置き換えます。

  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ名。URI 形式で指定します。例:
    projects/myproject/locations/global/hubs/us-west-to-uk
  • DESCRIPTION: スポークを説明するテキスト(省略可)。例: us-vpn-spoke
  • VLAN_ATTACHMENT_NAME: スポークに追加する VLAN アタッチメントの名前
  • REGION: スポークが存在する Google Cloud リージョン
  • KEY: ラベルテキストの Key-Value ペアのキー
  • VALUE: ラベルテキストの Key-Value ペアの値

API

VLAN アタッチメントのスポークを作成するには、networkconnectivity.spokes.create メソッドを使用します。

  POST https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes
  {
    "name": NAME,
    "hub": HUB_NAME,
    "labels": {
      "KEY": "VALUE"
    }
    "linkedInterconnectAttachments": ["VLAN_ATTACHMENT_NAME"],
   }

次の値を置き換えます。

  • PROJECT_ID: スポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが存在する Google Cloud リージョン
  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)
  • VLAN_ATTACHMENT_NAME: スポークに追加する VLAN アタッチメントの名前

VPN スポークの作成

VPN スポークを作成する前に、次のガイドラインを検討してください。

  • HA VPN トンネルをスポークにリンクする際は、単一サイトに接続するすべてのトンネルを単一のスポークとして構成することをおすすめします。その逆も同様です。2 つの異なるサイトに接続する 2 つのトンネルは、異なるスポークに接続する必要があります。たとえば、ダラスにあるオフィスと東京のオフィスをつなぐとします。ダラスに接続するトンネルは、VPC ネットワークを東京に接続するトンネルとは異なるスポークに属している必要があります。

  • HA VPN トンネルをスポークに接続する場合、同じ Google Cloud プロジェクト内で異なるリージョンの HA VPN ゲートウェイを相互に接続することはできません。詳細については、ハブ、スポーク、VPC ネットワークをご覧ください。

VPN スポークの作成に必要なリソースの構成については、次のドキュメントをご覧ください。

VPN リソースの確認方法については、HA VPN のステータスの確認をご覧ください。

Console

スポークの基本情報を入力する

  1. Google Cloud Console で、[Network Connectivity Center] ページに移動します。
  2. Network Connectivity Center に移動
  3. プロジェクトのプルダウン メニューでプロジェクトを選択します。
  4. [スポーク] タブをクリックします。
  5. [スポークを追加する] をクリックします。
  6. [ネットワーク] プルダウン リストで、ネットワークを選択します。すべてのハブのスポークが同じ VPC ネットワーク内に存在する必要があります。
  7. [新しいスポーク] フォームに、スポーク名を入力します。必要であれば、説明も入力します。

VPN トンネルの詳細を入力する

  1. [スポークタイプ] プルダウン リストを [VPN トンネル] に設定します。
  2. スポークのリージョンを選択します。
  3. トンネルを選択します。
    1. [トンネルを追加] をクリックします。
    2. [VPN トンネル] プルダウン メニューから、既存のトンネルを選択します。
  4. このスポークにさらにトンネルを追加するには、前述のステップを繰り返します。終了したら、[完了] をクリックして「スポークを保存する」に進みます。

スポークの保存

  1. さらにスポークを追加する場合は、[スポークを追加する] をクリックして手順をもう一度開始し、スポークの名前を入力します。
  2. スポークの追加が完了したら、[作成] をクリックします。Network Connectivity Center のページが更新され、作成したスポークの詳細が表示されます。

gcloud

HA VPN トンネルを含むスポークを作成するには、次のコマンドを入力します。

  gcloud alpha network-connectivity spokes create NAME \
    --hub=HUB_NAME \
    --description=DESCRIPTION \
    --vpn-tunnel=TUNNEL_NAME \
    --region=REGION
    --labels=KEY=VALUE

次の値を置き換えます。

  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ名。URI 形式で指定します。例:
    projects/PROJECT_ID/locations/global/hubs/us-west-to-uk
  • DESCRIPTION: スポークを説明するテキスト(省略可)。例: us-vpn-spoke
  • TUNNEL_NAME: スポークに追加する HA VPN トンネルの名前
  • REGION: スポークが存在する Google Cloud リージョン
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

API

VPN スポークを作成するには、networkconnectivity.spokes.create メソッドを使用します。

API 呼び出しでスポークタイプを参照する場合は、名前ではなくリソース URI を使用します。

  POST https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes
  {
    "name": NAME,
    "hub": HUB_NAME,
    "labels": {
      "KEY": "VALUE"
    }
    "linkedVpnTunnels": ["TUNNEL_NAME"],
   }

次の値を置き換えます。

  • PROJECT_ID: スポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されている Google Cloud リージョン。例: us-west1
  • NAME: スポークの名前
  • HUB_NAME: スポークを接続するハブ
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)
  • TUNNEL_NAME: スポークに追加する HA VPN トンネルの名前。単純な名前ではなくリソース URI を使用します。

スポークの一覧表示

この一連のコマンドで、指定されたリージョンのスポークが一覧表示されます。Cloud Console で特定のハブのスポークを一覧表示するか、スポークを表示するには、ハブの説明をご覧ください。

gcloud

既存のスポークを一覧表示するには、次のコマンドを入力します。

gcloud alpha network-connectivity spokes list \
--region=REGION

REGION は、スポークが配置されているリージョンに置き換えます。

API

既存のスポークを一覧表示するには、networkconnectivity.spokes.list メソッドを使用します。

  GET https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes

次の値を置き換えます。

  • PROJECT_ID: 一覧表示するスポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されているリージョン。例: us-west1

各行の集計値を 1 つのサマリー値としてまとめた既存のスポークの集約リストを取得するには、ワイルドカードとして locations の後にハイフン(-)を付けて networkconnectivity.spokes.list メソッドを使用します。

  GET https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/-/spokes

スポークの説明

既存のスポークに関する詳細情報を入手するには、次のガイダンスに従ってください。

Console

  1. [Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択します。

  3. [スポーク] タブをクリックします。

  4. [スポーク名] 列でスポークを選択して、[スポークの詳細] ページを表示します。

gcloud

次のコマンドを入力します。

  gcloud alpha network-connectivity spokes describe NAME \
    --region=REGION

次の値を置き換えます。

  • NAME: スポークの名前
  • REGION: スポークが配置されているリージョン

API

networkconnectivity.spokes.get メソッドを使用します。

 GET https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE

次の値を置き換えます。

  • PROJECT_ID: スポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されているリージョン。例: us-west1
  • SPOKE: スポークの名前

ラベルまたは新しい説明でスポークを更新する

スポークを作成した後は、次のいずれかを追加または変更して、スポークを更新できます。

  • スポークに適用されたラベル
  • スポークの説明

ハブの作成で説明されているように、ハブの作成時にラベルまたは説明を設定することもできます。

ラベルの詳細については、ラベルの要件をご覧ください。

gcloud

既存のスポークに 1 つ以上のラベルを追加するには、次のコマンドを入力します。

  gcloud alpha network-connectivity spokes update NAME \
    --description=DESCRIPTION \
    --region=REGION
    --labels=KEY=VALUE

次の値を置き換えます。

  • NAME: スポークの名前
  • DESCRIPTION: スポークの新しい説明
  • REGION: スポークが配置されている Google Cloud リージョン。例: us-west1
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

API

既存のスポークにラベルを追加するには、updateMask=labels を指定して networkconnectivity.spokes.patch メソッドを使用します。

 PATCH https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE?updateMask=labels
 {
   "labels": {
     "KEY": "VALUE"
   }
 }

次の値を置き換えます。

  • PROJECT_ID: スポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されているリージョン。例: us-west1
  • SPOKE: スポークの名前
  • KEY: ラベルテキストの Key-Value ペアのキー(省略可)
  • VALUE: ラベルテキストの Key-Value ペアの値(省略可)

スポークの削除

スポークを削除すると、そのスポークからリソースが切断されます。スポークを削除してもリソースは削除されません。スポークとの関連付けが解除されるだけです。

Console

  1. [Network Connectivity Center] ページに移動します。

    [Network Connectivity Center] に移動

  2. プロジェクトのプルダウン メニューでプロジェクトを選択します。

  3. [スポーク] タブをクリックします。

  4. プロジェクトのスポーク名のリストを表示します。

  5. 削除するスポークのチェックボックスをオンにします。

  6. [ スポークを削除] をクリックします。

  7. 確認のダイアログで、次のいずれかを行います。

    • スポークを削除しない場合は、[キャンセル] をクリックします。
    • スポークを削除するには、[削除] をクリックします。

gcloud

スポークを削除するには、次のコマンドを入力します。

  gcloud alpha network-connectivity spokes delete NAME \
    --region=REGION

次の値を置き換えます。

  • NAME: スポークの名前。形式は projects/PROJECT_ID/regions/REGION/spokes/NAME です。
  • REGION: スポークが配置されているリージョン。このオプションは、完全なスポークの名前に表示されているリージョンに加えて必須です。

API

既存のスポークを削除するには、networkconnectivity.spokes.delete メソッドを使用します。

  DELETE https://networkconnectivity.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/spokes/SPOKE

次の値を置き換えます。

  • PROJECT_ID: 削除するスポークを含むプロジェクトのプロジェクト ID
  • REGION: スポークが配置されているリージョン。例: us-west1
  • SPOKE: 削除するスポークの名前

次のステップ