テストの更新または削除

Note: Connectivity Tests performs a static analysis of the resource configurations in your VPC network. This analysis does not represent the actual condition of the network data plane.

このページの手順に沿って、テストを編集または削除する方法をご確認ください。自分や他のユーザーが作成したテストを編集したり、削除できます。

テストを作成、表示、または再実施するには、接続テストを作成して実行するをご覧ください。

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

始める前に

Before you can use Connectivity Tests, set up the following items in Google Cloud:

1. In the Google Cloud console, go to the project selector page.

   Go to the project selector

   Select or create a Google Cloud project.

2. Ensure that billing is enabled for your Google Cloud project.

3. Install the Google Cloud CLI, which is part of the Google Cloud CLI. To install the latest version of the gcloud CLI, see the gcloud CLI documentation.

   For a list of all commands, see the gcloud command reference.

4. Enable the Network Management API. Enabling the API provides you with the following:

   • Example API calls that use the Network Management API

     You can test Network Management API commands by using the API Explorer. In the Network Management API reference document, use the Try this API column to explore API fields and run a test.

   • Sample code that uses the API Python client

     The example code assumes that you have constructed a resource named api to interact with the Network Management API. To construct a resource, use the build function. See the following example:

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

     For more information about the API Python client, see the following:

     • Google API Client Library for Python Docs in GitHub, which includes installation and authentication instructions.
     • The Network Management API reference documentation for the API Python client.
5. Obtain the permissions that you need to run and view tests. For details, see Assign access.

テストの更新

このセクションの手順に沿って、テストを更新します。テストの name を除くすべてのフィールドを変更できます。

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

Console

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

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

   [接続テスト] に移動

2. テストを更新するには、テストの名前をクリックします。

3. [接続テストの詳細] ページで、ページの上部にある [編集] をクリックします。

4. テストのオプションを変更します。

5. [保存] をクリックします。

   テストが自動的に再実施されます。

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

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

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

2. まだ選択していない場合は、テストを更新するインスタンスを含むプロジェクトを選択します。

3. テストを更新するインスタンスをクリックします。

4. [ネットワーク インターフェース] で、テストを更新するネットワーク インターフェースを選択します。

5. [ネットワーク分析] で、[接続テスト] をクリックします。

6. 更新するテストの名前をクリックします。

7. [接続テストの詳細] ページで、ページの上部にある [編集] をクリックします。

8. テストのオプションを変更します。

9. [保存] をクリックします。

   テストが自動的に再実施されます。

gcloud

テストを更新するには、更新するテスト ID と変更するコマンド オプションを使用して次のコマンドを入力します。次の例では、宛先 IP アドレスを変更します。

  gcloud network-management connectivity-tests update NAME \
    --destination-ip-address= DESTINATION_IP_ADDRESS

次の値を置き換えます。

• NAME: 接続テストの名前
• DESTINATION_IP_ADDRESS: テストの宛先となる内部または外部の送信先 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。

API

networkmanagement.connectivitytests.patch メソッドを使用してテストを更新（編集）します。

  PATCH https: //networkmanagement.googleapis.com/v1/{resource.name=projects/PROJECT_ID/locations/global/connectivityTests/TEST_ID}
    {
      "source": {
        "ipAddress": "SOURCE_IP_ADDRESS",
        "projectId": "SOURCE_PROJECT",
      },
    }

次の値を置き換えます。

• PROJECT_ID: ソース VM のプロジェクト ID
• TEST_ID: 実行中の接続テスト オブジェクト（テスト）の ID
• SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。
• SOURCE_PROJECT: 送信元エンドポイントのプロジェクト ID

Python

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

project_id = "PROJECT_ID"
test_id = "TEST_ID"
test_input = {
  "source": {
    "ipAddress": "SOURCE_IP_ADDRESS"
  },
}

request = api.projects().locations().global_().connectivityTests().patch(
  name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id),
  body=test_input,
  updateMask="source")


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

次の値を置き換えます。

• PROJECT_ID: テストが作成されたプロジェクトのプロジェクト ID
• TEST_ID: 実行中の接続テスト オブジェクト（テスト）の ID
• SOURCE_IP_ADDRESS: テストの起点となる内部または外部の送信元 IP アドレス。IPv6 アドレスは、テストの宛先がグローバル ロードバランサの VIP である場合にのみ許可されます。

updateMask は、更新を適用するフィールドを指定する必須パラメータです。この例では、source フィールドを更新します。

1 つ以上のテストを削除する

このセクションの手順に沿って、テストを削除します。

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

Console

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

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

   [接続テスト] に移動

2. 削除する 1 つ以上のテストの左側にあるチェックボックスをオンにします。

3. Google Cloud コンソールのページ上部にある [削除] をクリックします。

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

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

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

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

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

2. まだ選択していない場合は、テストを削除するインスタンスを含むプロジェクトを選択します。

3. テストを削除するインスタンスをクリックします。

4. [ネットワーク インターフェース] で、テストを削除するネットワーク インターフェースを選択します。

5. [ネットワーク分析] で、[接続テスト] をクリックします。

6. 削除する 1 つ以上のテストの左側にあるチェックボックスをオンにします。

7. テストの一覧の上部にある [削除] をクリックします。

gcloud

テストを削除するには、次のコマンドを入力します。削除するテストのテスト ID を使用します。

  gcloud beta network-management connectivity-tests delete NAME

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

API

networkmanagement.connectivitytests.delete メソッドを使用して、テストを削除します。

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

次の値を置き換えます。

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

Python

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

project_id = "PROJECT_ID"
test_id = "TEST_ID"
request = api.projects().locations().global_().connectivityTests().delete(
          name='projects/%s/locations/global/connectivityTests/%s' % (project_id, test_id))


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

次の値を置き換えます。

• PROJECT_ID: テストが作成されたプロジェクトのプロジェクト ID
• TEST_ID: 削除する接続テスト オブジェクト（テスト）の ID

次のステップ

• 構成分析の状態
• 接続テストのトラブルシューティング