請按照本頁中的步驟瞭解如何編輯或刪除測驗。您可以編輯或刪除自己和他人建立的測驗。
如要建立、查看或重新執行測試,請參閱「建立及執行 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 測試作業執行期間查看其狀態,請參閱「檢查正在執行的測試作業」。
控制台
透過主要的「連線能力測試」頁面
前往 Google Cloud 控制台的「Connectivity Tests」頁面。
如要更新測驗,請按一下測驗名稱。
在「連線測試詳細資料」頁面上,按一下頁面頂端的「編輯」圖示 。
修改測試選項。
按一下 [儲存]。
系統會自動重新執行測試。
透過「網路介面詳細資料」頁面
前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。
如果尚未選取,請選取包含要更新測試的執行個體的專案。
按一下要更新測試的執行個體。
在「Network interfaces」下方,選取要更新測試的網路介面。
在「網路分析」下方,按一下「連線測試」。
按一下要更新的測試名稱。
在「連線測試詳細資料」頁面上,按一下頁面頂端的「編輯」圖示 。
修改測試選項。
按一下 [儲存]。
系統會自動重新執行測試。
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 的專案 IDTEST_ID:您執行的 Connectivity Tests 物件 (測試) IDSOURCE_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:建立測試的專案 IDTEST_ID:您執行的 Connectivity Tests 物件 (測試) IDSOURCE_IP_ADDRESS:您要測試的內部或外部來源 IP 位址;只有在測試目的地為全球負載平衡器 VIP 時,才允許使用 IPv6 位址
updateMask 是必要參數,可指定修補程式更新的欄位。這個範例會更新 source 欄位。
刪除一或多項測試
請按照本節中的步驟刪除測試。
如要在 delete 測試作業執行期間查看其狀態,請參閱「檢查正在執行的測試作業」。
控制台
透過主要的「連線能力測試」頁面
前往 Google Cloud 控制台的「Connectivity Tests」頁面。
按一下一或多項要刪除的測試左側核取方塊。
按一下 Google Cloud 控制台頁面頂端的「刪除」。
透過「連線能力測試」詳細資料頁面
- 在「Connectivity Tests」主頁面中,按一下測試名稱。
- 在「連線測試詳細資料」頁面頂端,按一下「刪除」圖示 。
透過「網路介面詳細資料」頁面
前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。
如果尚未選取,請選取含有您要刪除測試的執行個體的專案。
按一下要刪除測試的執行個體。
在「Network interfaces」(網路介面) 下方,選取要刪除測試的網路介面。
在「網路分析」下方,按一下「連線測試」。
勾選一或多個要刪除的測試左側核取方塊。
按一下測試清單頂端的「刪除」圖示 。
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 的專案 IDTEST_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:建立測試的專案 IDTEST_ID:您要刪除的「Connectivity Tests」物件 (測試) ID