更新或刪除測試

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

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

如要瞭解 Connectivity Tests，請參閱「總覽」。

事前準備

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

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

前往專案選取器

選取或建立 Google Cloud 專案。
確認您已為 Google Cloud 專案啟用計費功能。
安裝 Google Cloud CLI，這是 Google Cloud CLI 的一部分。如要安裝最新版的 gcloud CLI，請參閱 gcloud CLI 說明文件。

如需所有指令的清單，請參閱 gcloud 指令參考資料。
啟用 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 用戶端，請參閱以下內容：
  - GitHub 中的 Google API 用戶端程式庫 (適用於 Python) 說明文件，其中包含安裝和驗證操作說明。
  - 適用於 API Python 用戶端的 Network Management API 參考說明文件。
取得執行及查看測試所需的權限。詳情請參閱「指派存取權」。

更新測試

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

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

控制台

從主要的 Connectivity Tests 頁面

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

前往 Connectivity Tests
如要更新測試，請按一下測試名稱。
在「Connectivity Test details」(Connectivity Tests 詳細資料) 頁面中，按一下頁面頂端的「Edit」(編輯)。
修改測試選項。
按一下「Save」(儲存)。

測試會自動重新執行。

從網路介面詳細資料頁面

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

前往 VM 執行個體
如果尚未選取，請選取包含要更新測試的執行個體專案。
按一下要更新測試的執行個體。
在「Network interfaces」(網路介面) 下方，選取要更新測試的網路介面。
在「Network analysis」(網路分析) 下方，按一下「Connectivity Tests」。
按一下要更新的測試名稱。
在「Connectivity Test details」(Connectivity Tests 詳細資料) 頁面中，按一下頁面頂端的「Edit」(編輯)。
修改測試選項。
按一下「Save」(儲存)。

測試會自動重新執行。

gcloud

如要更新測試，請使用要更新的測試 ID 和要變更的指令選項，輸入下列指令。以下範例會變更目的地 IP 位址。

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

替換下列值：

NAME：Connectivity Tests 的名稱
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 測試作業執行期間查看狀態，請參閱「檢查正在執行的測試作業」。

控制台

從主要的 Connectivity Tests 頁面

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

前往 Connectivity Tests
按一下要刪除的一或多項測試左側的核取方塊。
在 Google Cloud 控制台頁面頂端，按一下「Delete」(刪除) 。

從 Connectivity Tests 詳細資料頁面

在主要的「Connectivity Tests」頁面中，按一下測試名稱。
在「Connectivity Test details」(Connectivity Tests詳細資料) 頁面頂端，按一下「Delete」(刪除) 。

從網路介面詳細資料頁面

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

前往 VM 執行個體
如果尚未選取，請選取包含要刪除測試的執行個體專案。
按一下要刪除測試的執行個體。
在「Network interfaces」(網路介面) 下方，選取要刪除測試的網路介面。
在「Network analysis」(網路分析) 下方，按一下「Connectivity Tests」。
選取要刪除的一或多項測試左側的核取方塊。
按一下測試清單頂端的「Delete」(刪除) 。

gcloud

如要刪除測試，請輸入下列指令，使用要刪除的測試 ID。

  gcloud beta network-management connectivity-tests delete NAME

將 NAME 替換為 Connectivity Tests 的名稱。

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

更新或刪除測試 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

更新測試

控制台

從主要的 Connectivity Tests 頁面

從網路介面詳細資料頁面

gcloud

API

Python

刪除一或多項測試

控制台

從主要的 Connectivity Tests 頁面

從 Connectivity Tests 詳細資料頁面

從網路介面詳細資料頁面

gcloud

API

Python

後續步驟

更新或刪除測試