更新或刪除測試

請按照本頁中的步驟瞭解如何編輯或刪除測驗。您可以編輯或刪除自己和他人建立的測驗。

如要建立、查看或重新執行測試，請參閱「建立及執行 Connectivity Tests」。

如要瞭解連線能力測試，請參閱總覽。

事前準備

如要使用 Connectivity Tests，請先在 Google Cloud中設定下列項目：

  1. 在 Google Cloud 控制台，前往專案選取器頁面。

    前往專案選取器

    選取或建立 Google Cloud 專案。

  2. 確認您已為 Google Cloud 專案啟用計費功能。

  3. 安裝 Google Cloud CLI，這是 Google Cloud CLI 的一部分。如要安裝最新版的 gcloud CLI，請參閱 gcloud CLI 說明文件。

    如需所有指令的清單，請參閱 gcloud 指令參考資料。

  4. 啟用 Network Management API。啟用 API 後，您將可享有下列功能：

    • 使用 Network Management API 的 API 呼叫範例

      您可以使用 API Explorer 測試 Network Management API 指令。在 Network Management API 參考文件中，使用 Try this API 欄探索 API 欄位並執行測試。

    • 使用 API Python 用戶端的程式碼範例

      範例程式碼假設您已建構名為 api 的資源，用於與 Network Management API 互動。如要建構資源，請使用 build 函式。請參閱以下範例：

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

      如要進一步瞭解 API Python 用戶端，請參閱以下內容：

  5. 取得執行及查看測試所需的權限。詳情請參閱「指派存取權」。

更新測試

請按照本節中的步驟更新測試。您可以變更任何欄位，但不能變更測試的 name。

如要在 update 測試作業執行期間查看其狀態，請參閱「檢查正在執行的測試作業」。

控制台

透過主要的「連線能力測試」頁面

  1. 前往 Google Cloud 控制台的「Connectivity Tests」頁面。

    前往「Connectivity Tests」頁面

  2. 如要更新測驗，請按一下測驗名稱。

  3. 在「連線測試詳細資料」頁面上，按一下頁面頂端的「編輯」圖示 。

  4. 修改測試選項。

  5. 按一下 [儲存]。

    系統會自動重新執行測試。

透過「網路介面詳細資料」頁面

  1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

  2. 如果尚未選取，請選取包含要更新測試的執行個體的專案。

  3. 按一下要更新測試的執行個體。

  4. 在「Network interfaces」下方，選取要更新測試的網路介面。

  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 位址；只有在測試目的地為全域負載平衡器 VIP 時，才允許使用 IPv6 位址

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：您執行的 Connectivity Tests 物件 (測試) ID
  • SOURCE_IP_ADDRESS：您要測試的內部或外部來源 IP 位址；只有在測試目的地為全球負載平衡器 VIP 時，才允許使用 IPv6 位址
  • 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：您執行的 Connectivity Tests 物件 (測試) ID
  • SOURCE_IP_ADDRESS：您要測試的內部或外部來源 IP 位址；只有在測試目的地為全球負載平衡器 VIP 時，才允許使用 IPv6 位址

updateMask 是必要參數，可指定修補程式更新的欄位。這個範例會更新 source 欄位。

刪除一或多項測試

請按照本節中的步驟刪除測試。

如要在 delete 測試作業執行期間查看其狀態，請參閱「檢查正在執行的測試作業」。

控制台

透過主要的「連線能力測試」頁面

  1. 前往 Google Cloud 控制台的「Connectivity Tests」頁面。

    前往「Connectivity Tests」頁面

  2. 按一下一或多項要刪除的測試左側核取方塊。

  3. 按一下 Google Cloud 控制台頁面頂端的「刪除」。

透過「連線能力測試」詳細資料頁面

  1. 在「Connectivity Tests」主頁面中，按一下測試名稱。
  2. 在「連線測試詳細資料」頁面頂端，按一下「刪除」圖示 。

透過「網路介面詳細資料」頁面

  1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

  2. 如果尚未選取，請選取含有您要刪除測試的執行個體的專案。

  3. 按一下要刪除測試的執行個體。

  4. 在「Network interfaces」(網路介面) 下方，選取要刪除測試的網路介面。

  5. 在「網路分析」下方，按一下「連線測試」。

  6. 勾選一或多個要刪除的測試左側核取方塊。

  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：您執行的 Connectivity Tests 物件 (測試) 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：您要刪除的「Connectivity Tests」物件 (測試) ID

後續步驟