接続テストを作成して実行する

このページの手順に沿って、接続テストを実施する方法を習得します。

1 つ以上のテストを編集または削除するには、接続テストを更新または削除するをご覧ください。

接続テストの詳細については、概要をご覧ください。

始める前に

接続テストを行う前に、Google Cloud で次の項目を設定します。

  1. Google Cloud Console でプロジェクト セレクタ ページに移動します。

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

    Google Cloud プロジェクトを選択または作成します。

  2. Google Cloud プロジェクトで課金が有効になっていることを確認します。
  3. Cloud SDK に含まれている gcloud コマンドライン ツールをインストールします。gcloud ツールの最新バージョンをインストールするには、Cloud SDK のドキュメントをご覧ください。

    全コマンドの一覧については、gcloud コマンド リファレンスをご覧ください。

  4. Network Management API を有効にします。API を有効にすると、次のものが提供されます。

    • Network Management API を使用した API 呼び出しのサンプル

      API Explorer を使用すると、Network Management API コマンドをテストできます。Network Management API リファレンス ドキュメントで、Try this API 列を使用して API フィールドを調べ、テストを実施します。

    • API Python クライアントを使用したサンプルコード

      このサンプルコードは、Network Management API とやり取りする api という名前のリソースを作成していることを前提としています。リソースを作成するには、build 関数を使用します。次の例をご覧ください。

      from googleapiclient.discovery import build
      api = build('networkmanagement', 'v1')
      

      API Python クライアントの詳細については、次をご覧ください。

  5. テストの実行と確認に必要な権限を取得します。詳しくは、アクセス権の割り当てをご覧ください。

接続テストを実施する

接続テストを実施するときは、テスト入力を送信元ポートのない 5 タプルとして提供します。

次のセクションでは、一般的な使用例で説明されている送信元エンドポイントと宛先エンドポイントのテストを実施する方法を示します。

Google Cloud Console で、次のいずれかを使用して接続テストを実施できます。

  • [ネットワーキング] > [Network Intelligence Center] メニューからアクセスできる [接続テスト] ページ

  • Compute Engine 仮想マシン(VM)インスタンスのネットワーク インターフェースの [ネットワーク インターフェースの詳細] ページ。このページを使用する場合は、テストのソースまたは宛先として、現在のネットワーク インターフェースを使用する必要があります。このページには、現在のネットワーク インターフェースに関連するテストのみが一覧表示されます。

作成した各テストは、作成した直後に実施され、接続テストリソースに保存されます。テストは削除されるまで存在します。

テスト オペレーションの実行中にそのステータスを確認するには、実行中のテスト オペレーションのチェックをご覧ください。テスト オペレーションには、たとえば creatererun があります。

送信元または宛先エンドポイントに IP アドレスを使用する場合は、追加のフィールドを指定する必要があります。

ベスト プラクティス

  • 共有 VPC サービス プロジェクトにあるエンドポイント(VM または IP アドレス)をテストする際は、サービス プロジェクトからテストを実施する方が便利です。これは、Cloud Console のプルダウン ボックスで VM または IP アドレスを選択できるためです。

    ただし、ネットワークがホスト プロジェクト内にあるため、Virtual Private Cloud(VPC)ネットワークを指定する前にホスト プロジェクトを指定する必要があります。詳細については、共有 VPC ネットワークで IP アドレスをテストするをご覧ください。

  • VPC ネットワークとピア ネットワークまたはオンプレミス ネットワークの間でテストを実施する場合、オンプレミスの IP アドレスを送信元として使用し、VPC ネットワーク内の VM インスタンスまたは IP アドレスを宛先として使用することで、別の接続テストの実施時に役立ちます。

    このタイプのテストにより、Google Cloud がオンプレミス ネットワークに想定どおりにルートをアドバタイジングしていることが確認されます。ただし、接続テストでは、オンプレミス ネットワークがこれらのルートを受信して実装したかどうかは確認されません。

  • 接続テストが構成の更新を受信して分析に組み入れるまでには、20~120 秒かかります。構成を変更してすぐにテストを実行した場合、期待する結果が得られない可能性があります。構成を変更した後は、十分に待ってからテストを行うようにしてください。

    この遅延の発生は、ダイナミック検証については該当しません。そのため、ダイナミック検証と構成分析が示す結果の間に、一時的に不整合が生じる場合があります。たとえば、ファイアウォール ルールを追加した場合に、ダイナミック検証に関してはアクセスできる一方で、構成分析に関しては、アクセスできるようになるまでしばらく待たなければならない場合があります。

複数のネットワーク インターフェースを持つ VM との間のテスト

このセクションでは、VM のプライマリ以外のネットワーク インターフェースとの間でテストを行う方法について説明します。

Console

複数のネットワーク インターフェースを持つ VM インスタンスをテストのソースまたは宛先として指定すると、接続テストでは、プルダウンメニューからネットワーク インターフェースを選択するよう求められます。

または、[ネットワーク インターフェースの詳細] ページから、Compute Engine VM インスタンスのネットワーク インターフェースのテストを行えます。このページを使用する場合は、テストのソースまたは宛先として、現在のネットワーク インターフェースを使用する必要があります。

gcloud と API

次のいずれかの方法で、テストに使用するネットワーク インターフェースを指定する必要があります。

  • IP アドレスとネットワーク URI
  • IP アドレスと VM URI
  • ネットワーク URI と VM URI

複数のインターフェースを持つ VM の URI のみを提供すると、VM のプライマリ インターフェースのみが選択されます。

プロジェクトのすべてのテストを一覧表示する

Console

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. ページ上部のプルダウン プロジェクト メニューからプロジェクトを選択します。
  3. [接続テスト] ページが更新され、そのプロジェクトのテストが表示されます。

gcloud

プロジェクトが所有するすべてのテストを一覧表示するには、次の gcloud コマンドを入力します。このコマンドにより、現在選択されているプロジェクトのテストが表示されます。

  gcloud network-management connectivity-tests list

特定のプロジェクトのテストを一覧表示するには、PROJECT_ID を指定します。

  gcloud network-management connectivity-tests list --project=PROJECT_ID

API

プロジェクトが所有する既存の全テストを一覧表示するには、networkmanagement.connectivitytests.list メソッドを使用します。

GET https://networkmanagement.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/global}/connectivityTests
  • PROJECT_ID は、一覧表示するテストが含まれているプロジェクトのプロジェクト ID に置き換えます。

Python

次のサンプルコードは、プロジェクトが所有する既存のすべてのテストを一覧表示します。詳細については、API Python クライアント リファレンス ドキュメントの list をご覧ください。

project_id = "PROJECT_ID"
parent = 'projects/%s/locations/global' % project_id
request = api.projects().locations().global_().connectivityTests().list(parent=parent)
print(json.dumps(request.execute(), indent=4))

PROJECT_ID は、一覧表示するテストが含まれているプロジェクトのプロジェクト ID に置き換えます。

VPC ネットワークの VM インスタンス間のテスト

この手順は、両方の VM インスタンスが同じ Google Cloud プロジェクトにあることを前提としています。

Console

接続テストのメインページから

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [接続テストを作成] を選択します。
  3. テスト名を入力します。
  4. プロトコルを選択します。
  5. [ソース] で、プルダウン メニューから [送信元 VM インスタンス] を選択します。
    • VM インスタンスに複数のネットワーク インターフェースがある場合はソースの場所を一意に識別する VM ネットワーク インターフェースを選択します。
  6. [宛先] で、プルダウン メニューから [宛先 VM インスタンス] を選択します。
    • VM インスタンスに複数のネットワーク インターフェースがある場合は、VM ネットワーク インターフェースを選択して、出力先の場所を一意に識別します。
  7. 宛先ポートを入力します。
  8. [作成] をクリックします。
  9. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

ネットワーク インターフェースの詳細ページから

  1. Cloud Console で、[VM インスタンス] ページに移動します。

    [VM インスタンス] に移動

  2. まだ選択していない場合は、テスト対象のインスタンスを含むプロジェクトを選択します。
  3. テストの実施に使用するインスタンスをクリックします。
  4. [ネットワーク インターフェース] で、テストの実施に使用するネットワーク インターフェースを選択します。
  5. [ネットワーク分析] で、[接続テスト]、[作成] とクリックします。
  6. テスト名を入力します。
  7. プロトコルを選択します。
  8. 現在のネットワーク インターフェースをソースとして使用する場合は、[ソース] で、[現在のネットワーク インターフェース] を選択します。それ以外の場合は、[宛先] で、[現在のネットワーク インターフェース] を選択します。
  9. 展開した [その他] フィールドのプルダウン メニューから、[VM インスタンス] を選択します。
    • VM インスタンスに複数のネットワーク インターフェースがある場合は、VM ネットワーク インターフェースを選択して、出力先の場所を一意に識別します。
  10. 指定した宛先の宛先ポートを入力します。
  11. [作成] をクリックします。
  12. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

gcloud

同じクラウド プロジェクト内の VM をテストするには、次のコマンドを入力します。サンプル値は、実際の VPC ネットワークの値で置き換えてください。

  gcloud network-management connectivity-tests create NAME \
  --source-instance=SOURCE_INSTANCE
  --destination-instance=DESTINATION_INSTANCE
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • DESTINATION_INSTANCE: 宛先 VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-2
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

API

次のテストの例では、既存のネットワーク構成で VM instance1 が VM instance2 に ping できるかどうかを確認します。

networkmanagement.connectivitytests.create メソッドを使用してテストを作成します。

 POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
     "instance": "SOURCE_INSTANCE",
   },
     "destination": {
     "instance": "DESTINATION_INSTANCE",
   },
     "protocol": "PROTOCOL",
   }'

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID
  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • DESTINATION_INSTANCE: 宛先 VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-2
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

Python

次のサンプルコードは、2 つの VM インスタンス間でテストを作成します。詳細については、API Python クライアント リファレンス ドキュメントの create をご覧ください。

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "instance":
          "DESTINATION_INSTANCE",
      "projectId": "DESTINATION_INSTANCE_PROJECT_ID"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • SOURCE_INSTANCE_PROJECT_ID: ソース VM のプロジェクト ID
  • DESTINATION_INSTANCE: 宛先 VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-2
  • DESTINATION_INSTANCE_PROJECT_ID: 宛先 VM のプロジェクト ID
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です
  • PROJECT_ID: テストを作成するプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

VPC ネットワーク内のプライベート IP アドレス間のテスト

この例では、両方の IP アドレスが同じ Cloud プロジェクトおよび同じ VPC ネットワーク内のプライベート IP アドレスであることを前提としています。

ピアリングされた VPC ネットワーク間でテストする場合は、各ピアのソース ネットワークと宛先ネットワークを選択します。

Console

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [接続テストを作成] を選択します。
  3. テスト名を入力します。
  4. プロトコルを選択します。
  5. [ソース IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです] チェックボックスを選択します。
    2. これが内部 IP アドレスであり、インターネットからアクセスできない場合は、アドレスが存在する VPC ネットワークを選択します。
  6. [送信先 IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです] チェックボックスを選択します。
    2. これが内部 IP アドレスであり、インターネットからアクセスできない場合は、アドレスが存在する VPC ネットワークを選択します。
  7. 宛先ポートを入力します。
  8. [作成] をクリックします。
  9. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

gcloud

次のコマンドを入力して、同じプロジェクトで同じネットワーク内の 2 つの内部 IP アドレス間でテストを行います。コマンド オプションの変数は、VPC ネットワークの値に置き換えてください。

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network=SOURCE_NETWORK
  --destination-ip-address=DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK \
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK: ソース IP アドレスがある VPC ネットワークの URI(たとえば、projects/myproject/global/networks/default
  • DESTINATION_IP_ADDRESS: テストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_NETWORK: 宛先 IP アドレスがある VPC ネットワークの URI(たとえば、projects/myproject/global/networks/network-a
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

ネットワークが不明の場合、またはネットワークにアクセスする権限がない場合は、ネットワーク URI を指定する代わりに、ネットワークを GCP_NETWORK として指定できます。

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network-type=GCP_NETWORK \
  --destination-instance=DESTINATION_INSTANCE  \
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK_TYPE: ソースがあるネットワークのタイプ。この場合は、GCP_NETWORK という値を使用します
  • DESTINATION_INSTANCE: 宛先 VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-2
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

Google Cloud の外部からプライベート IP アドレスをソース IP アドレスとして指定する場合、networkType には NON_GCP_NETWORK を指定する必要があります。次のコマンドで、各値は実際の VPC ネットワークの値に置き換えてください。

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-network-type=NON_GCP_NETWORK \
  --destination-ip-address= DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK_TYPE: ソースがあるネットワークのタイプ。この場合は、NON_GCP_NETWORK という値を使用します
  • DESTINATION_IP_ADDRESS: テストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_NETWORK: 宛先 IP アドレスがある VPC ネットワークの URI(たとえば、projects/myproject/global/networks/default
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

API

この例では、送信元 IP アドレスから宛先 IP アドレスに ping が届くかどうかをテストします。

networkmanagement.connectivitytests.create メソッドを使用してテストを作成します。

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "network": "SOURCE_NETWORK"
    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
      "protocol": "PROTOCOL".
  }'

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK: ソース IP アドレスがある VPC ネットワークの URI(たとえば、projects/myproject/global/networks/default
  • DESTINATION_IP_ADDRESS: テストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_NETWORK: 宛先 IP アドレスがある VPC ネットワークの URI(たとえば、projects/myproject/global/networks/network-a
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

VPC ネットワークが不明の場合、またはネットワークにアクセスする権限がない場合は、ネットワーク URI を指定する代わりに、ネットワークを GCP_NETWORK として指定できます。

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?connectivityTestId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "GCP_NETWORK"
    },
    "destination": {
      "instance": "projects/myproject/zones/us-east1-b/instances/instance-2 ",
    },
    "protocol": "PROTOCOL"
  }'

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK_TYPE: ソースがあるネットワークのタイプ。この場合は、GCP_NETWORK という値を使用します
  • DESTINATION_INSTANCE: 宛先 VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-2
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

Google Cloud の外部からプライベート IP アドレスをソース IP アドレスとして指定する場合、networkType には NON_GCP_NETWORK を指定する必要があります。次のコマンドで、各値は Google Cloud ネットワークの値に置き換えてください。

  POST https://reachability.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
  {
    "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "networkType": "NON_GCP_NETWORK",

    },
    "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
    },
    "protocol": "PROTOCOL",
  }'

Python

次のサンプルコードは、2 つの IP アドレス間のテストを作成します。詳細については、API Python クライアント リファレンス ドキュメントの create をご覧ください。

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "port": "DESTINATION_PORT",
      "projectId": "DESTINATION_IP_PROJECT_ID"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_IP_PROJECT_ID: ソース IP アドレスのプロジェクト ID
  • DESTINATION_IP_ADDRESS: テストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • DESTINATION_IP_PROJECT_ID: 宛先 IP アドレスのプロジェクト ID
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です
  • PROJECT_ID: テストを作成するプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

VPC ネットワークが不明の場合、またはネットワークにアクセスする権限がない場合は、ネットワーク URI を指定する代わりに、ネットワークを GCP_NETWORK として指定できます。次のサンプルコードをご覧ください。

test_input = {
    "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "networkType": "GCP_NETWORK"
    },
    "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "port": "DESTINATION_PORT",
        "projectId": "DESTINATION_IP_PROJECT_ID"
    },
    "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
  parent="projects/PROJECT_ID/locations/global",
  testId="TEST_ID",
  body=test_input)

print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_NETWORK_TYPE: ソースがあるネットワークのタイプ。この場合は、GCP_NETWORK という値を使用します
  • DESTINATION_IP_ADDRESS: 宛先 VM の IP アドレス
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • DESTINATION_IP_PROJECT_ID: 宛先 IP アドレスのプロジェクト ID
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です
  • PROJECT_ID: テストを作成するプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

Google Cloud の外部からプライベート IP アドレスを送信元 IP アドレスとして指定する場合、networkType には NON_GCP_NETWORK を指定する必要があります。

共有 VPC ネットワークでの IP アドレスのテスト

共有 VPC ネットワークがある場合は、ホスト プロジェクトまたはサービス プロジェクトからテストを作成して実施できます。

以下の例では、両方の場合について、サービス プロジェクトで割り振られた宛先 IP アドレスを使用して説明します。Cloud Console のフィールド値は、状況ごとに少し異なります。ただし、gcloud コマンドライン ツールと API 呼び出しのコマンド オプションは同じです。

Console: ホストから

  1. Cloud Console で、ホスト プロジェクトから [接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [接続テストを作成] を選択します。
  3. テスト名を入力します。
  4. プロトコルを選択します。
  5. [ソース IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです。] チェックボックスが選択されていることを確認します。
    2. ソース IP またはインスタンスを選択します。
  6. [送信先 IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです。] チェックボックスが選択されていることを確認します。
    2. その IP アドレスがあるサービス プロジェクトを指定します。
    3. IP アドレスがあるホスト(現在の)プロジェクトで [ネットワーク] を選択します。
  7. 宛先ポートを入力します。
  8. [作成] をクリックします。
  9. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

Console: サービスから

  1. Cloud Console で、サービス プロジェクトから [接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [接続テストを作成] を選択します。
  3. テスト名を入力します。
  4. プロトコルを選択します。ベータ期間中は、メニューに表示されるプロトコルのみを使用できます。
  5. [ソース IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです。] チェックボックスが選択されていることを確認します。
  6. [送信先 IP またはインスタンス] で [IP アドレス] を選択し、IP アドレスを入力します。
    1. [これは GCP で使用される IP アドレスです。] チェックボックスが選択されていることを確認します。
    2. その IP アドレスがあるサービス プロジェクトを指定します。
    3. [Network is in a project other than the current project] チェックボックスをオンにします。
    4. ホスト プロジェクトを選択します。
    5. その IP アドレスがあるネットワークを選択します。
  7. 宛先ポートを入力します。
  8. [作成] をクリックします。
  9. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

gcloud

次のコマンドを入力して、宛先 IP アドレスが存在するサービス プロジェクト内のホストと、そのサービス プロジェクト内の 2 つのプライベート IP アドレス間をテストします。コマンド オプションの変数は、VPC ネットワークの値に置き換えてください。

宛先 IP アドレスはサービス プロジェクト内にあるため、サービス プロジェクトとホスト プロジェクトのネットワーク URI を指定します。この場合、defaulthost-project のデフォルト VPC ネットワークを表します。

  gcloud network-management connectivity-tests create NAME \
  --source-ip-address=SOURCE_IP_ADDRESS \
  --source-project=SOURCE_PROJECT \
  --destination-ip-address=DESTINATION_IP_ADDRESS \
  --destination-network=DESTINATION_NETWORK  \
  --destination-project=DESTINATION_PROJECT \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_PROJECT: 送信元エンドポイントのプロジェクト ID
  • DESTINATION_IP_ADDRESS: サービス プロジェクト内でテストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_NETWORK: ホスト プロジェクトの VPC ネットワークの URI(たとえば、projects/host-project/global/networks/default
  • DESTINATION_PROJECT: 宛先エンドポイントのプロジェクト ID(この共有 VPC ネットワークで使用されるサービス プロジェクトを表す service-project という名前のプロジェクトなど)。
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

API

networkmanagement.connectivitytests.create メソッドを使用してテストを作成します。

  POST https: //networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
      "destination": {
        "ipAddress": "DESTINATION_IP_ADDRESS",
        "projectId": "DESTINATION_PROJECT",
        "network": "DESTINATION_NETWORK",
        "port": "DESTINATION_PORT",
      },
      "protocol": "PROTOCOL",
    }'

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID
  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_PROJECT: 送信元エンドポイントのプロジェクト ID
  • DESTINATION_IP_ADDRESS: サービス プロジェクト内でテストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_PROJECT: 宛先エンドポイントのプロジェクト ID(この共有 VPC ネットワークで使用されるサービス プロジェクトを表す service-project という名前のプロジェクトなど)。
  • DESTINATION_NETWORK: ホスト プロジェクトの VPC ネットワークの URI(たとえば、projects/host-project/global/networks/default
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

Python

次のサンプルコードは、2 つの IP アドレス間のテストを作成します。詳細については、API Python クライアント リファレンス ドキュメントの create をご覧ください。

test_input = {
  "source": {
      "ipAddress": "SOURCE_IP_ADDRESS",
      "projectId": "SOURCE_IP_PROJECT_ID"
  },
  "destination": {
      "ipAddress": "DESTINATION_IP_ADDRESS",
      "projectId": "DESTINATION_IP_PROJECT_ID",
      "network": "DESTINATION_NETWORK",
      "port": "DESTINATION_PORT",
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • SOURCE_IP_PROJECT_ID: 送信元エンドポイントのプロジェクト ID
  • DESTINATION_IP_ADDRESS: サービス プロジェクト内でテストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
  • DESTINATION_IP_PROJECT_ID: 宛先エンドポイントのプロジェクト ID(この共有 VPC ネットワークで使用されるサービス プロジェクトを表す service-project という名前のプロジェクトなど)。
  • DESTINATION_NETWORK: ホスト プロジェクトの VPC ネットワークの URI(たとえば、projects/host-project/global/networks/default
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です
  • PROJECT_ID: テストを作成するプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

VM から Google マネージド サービスへのテスト

このセクションでは、VPC ネットワーク内の VM から Google 所有の VPC ネットワークで実行されるサービスへの接続をテストする方法について説明します。このセクションの手順に沿って操作すると、Cloud SQL インスタンスまたは GKE マスターへの接続をテストできます。また、ソースとして Google マネージド サービス エンドポイントを使用し、宛先として VPC ネットワーク内のエンドポイントを使用してテストを行うこともできます。

デフォルトの接続テストでは、Google マネージド サービス エンドポイントのプライベート IP アドレスを使用してテストが行われます。エンドポイントにプライベート IP アドレスが割り振られていない場合はパブリック IP アドレスが使用されます。接続テストでは、パケットがエンドポイントに到達可能かどうかが分析されますが、Google 所有の VPC ネットワーク内の構成も分析されます。プロジェクト内の構成で問題が見つかると、Google 所有のネットワーク構成を分析する前に処理が停止します。

VM から Google マネージド サービスへの接続をテストする方法は次のとおりです。

Console

接続テストのメインページから

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [接続テストを作成] を選択します。
  3. テスト名を入力します。
  4. プロトコルを選択します。
  5. [ソース] で、プルダウン メニューから [送信元 VM インスタンス] を選択します。
    • VM インスタンスに複数のネットワーク インターフェースがある場合はソースの場所を一意に識別する VM ネットワーク インターフェースを選択します。
  6. [宛先] で、[宛先エンドポイント] プルダウン メニューから GKE マスター クラスタなどの Google マネージド サービス リソースの種類を選択します。
    1. 右側にあるプルダウン メニューを使用して、特定のエンドポイントを選択します。たとえば、GKE マスター クラスタを選択した場合は、クラスタ マスターとの接続をテストするクラスタを選択します。
  7. 宛先ポートを入力します。
  8. [作成] をクリックします。
  9. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

ネットワーク インターフェースの詳細ページから

  1. Cloud Console で、[VM インスタンス] ページに移動します。

    [VM インスタンス] に移動

  2. まだ選択していない場合は、テスト対象のインスタンスを含むプロジェクトを選択します。
  3. テストの実施に使用するインスタンスをクリックします。
  4. [ネットワーク インターフェース] で、テストの実施に使用するネットワーク インターフェースを選択します。
  5. [ネットワーク分析] で、[接続テスト]、[作成] とクリックします。
  6. テスト名を入力します。
  7. プロトコルを選択します。
  8. [ソース] で [現在のネットワーク インターフェース] を選択します。
  9. [宛先] で、[宛先エンドポイント] プルダウン メニューから GKE マスター クラスタなどの Google マネージド サービス リソースの種類を選択します。
    1. 右側にあるプルダウン メニューを使用して、特定のエンドポイントを選択します。たとえば、GKE マスター クラスタを選択した場合は、クラスタ マスターとの接続をテストするクラスタを選択します。
  10. 指定した宛先の宛先ポートを入力します。
  11. [作成] をクリックします。
  12. テストが終了すると、[接続テスト] のメインページが読み込まれ、このテストと他のテストを含むリストが表示されます。テスト結果を表示するに進みます。

gcloud

次のコマンドを入力して、VPC ネットワーク内の VM から Google マネージド サービスへの接続テストを行います。次のガイダンスに従って、コマンド オプションの変数を置き換えます。

  gcloud beta network-management connectivity-tests create NAME \
  --source-instance=SOURCE_INSTANCE \
  DESTINATION_RESOURCE_FLAG=DESTINATION_ENDPOINT \
  --destination-port=DESTINATION_PORT \
  --protocol=PROTOCOL

次の値を置き換えます。

  • NAME: 接続テストの名前
  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • DESTINATION_RESOURCE_FLAG: Google マネージド サービス リソースの種類を指定するフラグ。使用可能なオプションと詳細については、gcloud beta network-management connectivity-tests create リファレンスをご覧ください。
    • --destination-gke-master-cluster
    • --destination-cloud-sql-instance
  • DESTINATION_ENDPOINT: 宛先エンドポイントの URI(たとえば、--destination-gke-master-cluster フラグの場合は projects/myproject/locations/us-central1/clusters/cluster-1)。
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

API

次の例では、VPC ネットワーク内の VM から Google マネージド サービスへの接続をテストします。

networkmanagement.connectivitytests.create メソッドを使用してテストを作成します。

 POST https: //networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/connectivityTests?testId=TEST_ID'
   {
     "source": {
     "instance": "SOURCE_INSTANCE",
   },
     "destination": {
     "DESTINATION_RESOURCE_FIELD": "DESTINATION_ENDPOINT",
     "port": DESTINATION_PORT
   },
     "protocol": "PROTOCOL",
   }'

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID
  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • DESTINATION_RESOURCE_FIELD: Google マネージド サービス リソースの種類を指定するフィールド。使用可能なオプションについては、次のリストをご覧ください。また、詳細については、エンドポイントのリファレンスをご覧ください。
    • gkeMasterCluster
    • cloudSqlInstance
  • DESTINATION_ENDPOINT: 宛先エンドポイントの URI(たとえば、gkeMasterCluster フィールドの場合は projects/myproject/locations/us-central1/clusters/cluster-1
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です

Python

次のサンプルコードでは、VM インスタンスと Google マネージド サービス エンドポイントの間の接続をテストします。詳細については、API Python クライアント リファレンス ドキュメントの create をご覧ください。

test_input = {
  "source": {
      "instance":
          "SOURCE_INSTANCE",
      "projectId":
          "SOURCE_INSTANCE_PROJECT_ID"
  },
  "destination": {
      "DESTINATION_RESOURCE_FIELD":
          "DESTINATION_ENDPOINT",
      "port": "DESTINATION_PORT"
  },
  "protocol": "PROTOCOL",
}

request = api.projects().locations().global_().connectivityTests().create(
    parent="projects/PROJECT_ID/locations/global",
    testId="TEST_ID",
    body=test_input)

print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • SOURCE_INSTANCE: ソース VM の URI(たとえば、projects/myproject/zones/us-east1-b/instances/instance-1
  • SOURCE_INSTANCE_PROJECT_ID: ソース VM のプロジェクト ID
  • DESTINATION_RESOURCE_FIELD: Google マネージド サービス リソースの種類を指定するフィールド。使用可能なオプションについては、次のリストをご覧ください。また、詳細については、エンドポイントのリファレンスをご覧ください。
    • gkeMasterCluster
    • cloudSqlInstance
  • DESTINATION_ENDPOINT: 宛先エンドポイントの URI(たとえば、gkeMasterCluster フィールドの場合は projects/myproject/locations/us-central1/clusters/cluster-1
  • DESTINATION_PORT: 宛先の IP プロトコル ポート。このオプションは、TCP プロトコルまたは UDP プロトコルに対してのみ有効です。デフォルトはポート 80 です
  • PROTOCOL: 接続テストでサポートされているプロトコル。デフォルトのプロトコルは TCP です
  • PROJECT_ID: テストを作成するプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

VPC ネットワークから Google Cloud 以外のネットワークへのテスト

この手順は、次の手順を除き、VPC ネットワーク内のプライベート IP アドレス間のテストと同じです。この手順は、Cloud Console、gcloud コマンドライン ツール、API の例、Python の例で使用します。

  1. 宛先 IP アドレスの外部 IP アドレスを指定します。
  2. Cloud Console で、[これは GCP で使用される IP アドレスです] チェックボックスはオフのままにします。

Google Cloud 以外のネットワークから VPC ネットワークへのテスト

この手順は、次の手順を除き、VPC ネットワーク内のプライベート IP アドレス間のテストと同じです。この手順は、Cloud Console、gcloud コマンドライン ツール、API の例、Python の例で使用します。

  1. 送信元アドレスが Google Cloud になく、ピア(オンプレミス)ネットワークからのものでもない場合は、外部 IP アドレスを指定します。
  2. 送信元アドレスがピア(オンプレミス)ネットワークからのものである場合は、[Other non-Google Cloud network] を選択する必要があります。

Google Cloud 以外のネットワークから Google Cloud 以外のネットワークへのテスト

この手順は、次の手順を除き、VPC ネットワーク内のプライベート IP アドレス間のテストと同じです。この手順は、Cloud Console、gcloud コマンドライン ツール、API の例、Python の例で使用します。

  1. 送信元 IP アドレスと宛先 IP アドレスの外部 IP アドレスを指定します。
  2. Cloud Console で、[これは GCP で使用される IP アドレスです] チェックボックスはオフのままにします。

テスト結果を表示する

このセクションでは、接続テストの結果の確認方法について説明します。

Console

複数のページからテストを確認できます。

接続テストのメインページから

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. [結果の詳細] 列で、テストを選択して [表示] をクリックします。
  3. テストの情報パネルが表示されます。テストパスで、各 Google Cloud リソースの全体的な結果と結果カードを確認できます。VM インスタンスやルートなど、一部の Google Cloud リソースの詳細ページへのリンクをクリックできます。テストに複数のトレースが含まれている場合は、[トレースの結果] プルダウン メニューからトレースを選択できます。
  4. 結果カードを展開するか閉じるには、カードの右側にある矢印をクリックします。
  5. テスト結果を解釈するには、構成分析の状態の解釈するをご覧ください。
  6. 情報パネルを閉じるには、ページの右上にある [情報パネルを非表示] をクリックします。

接続テストの詳細ページから

または、Cloud Console のメインページでテストの名前をクリックし、[接続テストの詳細] ページで結果を確認します。

ネットワーク インターフェースの詳細ページから

また、Compute Engine VM インスタンスのネットワーク インターフェースの [ネットワーク インターフェースの詳細] ページで、結果を確認することもできます。このページには、現在のネットワーク インターフェースをソースまたは宛先として使用するテストのみが表示されます。

結果を表示するには、[結果の詳細] 列で、[表示] を選択するか、テストの名前をクリックします。

gcloud

テスト結果を表示するには、次のコマンドを入力します。表示するテスト ID を使用します。

  gcloud network-management connectivity-tests describe NAME

NAME を接続テストの名前に置き換えます。

API

networkmanagement.connectivitytests.get メソッドを使用して、テストの結果を表示します。

GET https://networkmanagement.googleapis.com/v1/{name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

Python

次のサンプルコードは、テスト結果を出力します。詳細については、API Python クライアント リファレンス ドキュメントの get をご覧ください。

project_id = "PROJECT_ID"
test_id= "TEST_ID"
request = api.projects().locations().global_().connectivityTests().get(
      name='projects/%s/locations/global/connectivityTests/%s' %
      (project_id, test_id))
print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • PROJECT_ID: テストが作成されたプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

1 つ以上のテストを再実施する

テストパスで Google Cloud リソースの構成を変更し、最新のネットワーク構成の結果を確認したい場合は、接続テストを再実施することをおすすめします。1 つ以上のテストを同時に実施できます。

接続テストは、実施時のネットワーク構成のスナップショットに基づきます。テストを再実施すると、以前のテスト結果が上書きされます。古い結果を保持する場合は、代わりに新しいテストを作成します。

rerun テスト オペレーションの実行中にステータスを確認するには、実行中のテスト オペレーションのチェックをご覧ください。

Console

接続テストのメインページから

  1. Cloud Console で、[接続テスト] ページに移動します。

    [接続テスト] に移動

  2. 再実施する 1 つ以上のテストの左側にあるチェックボックスをオンにします。
  3. ページの上部にある [再実行] をクリックします。

接続テストの詳細ページから

  1. 前の [接続テスト] のメインページで、テストの名前をクリックします。
  2. [接続テストの詳細] ページの上部にある [再実行] をクリックします。

ネットワーク インターフェースの詳細ページから

  1. Cloud Console で、[VM インスタンス] ページに移動します。

    [VM インスタンス] に移動

  2. まだ選択していない場合は、テストを再実施するインスタンスを含むプロジェクトを選択します。
  3. テストの再実施に使用するインスタンスをクリックします。
  4. [ネットワーク インターフェース] で、テストの再実施に使用するネットワーク インターフェースを選択します。
  5. [ネットワーク分析] で、[接続テスト] をクリックします。
  6. 再実施する 1 つ以上のテストの左側にあるチェックボックスをオンにします。
  7. テストの一覧の上部にある [再実行] をクリックします。

gcloud

接続テストを再実施するには、次のコマンドを入力します。再実施するテスト ID を使用します。

  gcloud network-management connectivity-tests rerun NAME

NAME を接続テストの名前に置き換えます。

API

Network Management API が connectivityTests リソースを作成すると、削除するまでそのテストリソースが保持されます。このため、テストを再実施できます。

永続的なテストを作成したくない場合は、API を使用してテストを作成すると、テスト結果の表示後に削除できます。

networkmanagement.connectivitytests.rerun メソッドを使用してテストを再実施します。

  POST https://networkmanagement.googleapis.com/v1/{name=projects/*/locations/global/connectivityTests/*}:rerun
    {
      "name": {projects/PROJECT_ID/connectivityTests/{TEST_ID}
    }

次の値を置き換えます。

  • PROJECT_ID: ソース VM のプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

Python

次のサンプルコードではテストを再実行します。詳細については、API Python クライアント リファレンス ドキュメントの rerun をご覧ください。

project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().rerun(name='projects/%s/locations/global/connectivityTests/%s' %       (project_id, test_id))
print(json.dumps(request.execute(), indent=4))

次の値を置き換えます。

  • PROJECT_ID: テストが作成されたプロジェクトのプロジェクト ID
  • TEST_ID: 実行中の接続テスト オブジェクト(テスト)の ID

次のステップ