此页面由 Cloud Translation API 翻译。

更新或删除测试

按照此页面上的步骤，了解如何修改或删除测试。您可以修改或删除自己和他人创建的测试。

如需创建、查看或重新运行测试，请参阅创建和运行 Connectivity Tests。

如需了解 Connectivity Tests，请参阅概览。

准备工作

请先在 Google Cloud 中设置以下各项，然后才能使用 Connectivity Tests：

在 Google Cloud Console 中，转到项目选择器页面。

转到项目选择器

选择或创建 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 中的 Python 版 Google API 客户端库文档，其中包含安装和身份验证说明。
  - API Python 客户端的 Network Management API 参考文档。
获取运行和查看测试所需的权限。有关详情，请参阅分配访问权限。

更新测试

请按照本部分中的步骤更新测试。您可以更改测试的 name 以外的任何字段。

如需在 update 测试操作正在运行时检查其状态，请参阅检查正在运行的测试操作。

控制台

在“Connectivity Tests”的主页面上

在 Google Cloud 控制台中，前往 Connectivity Tests 页面。

转到 Connectivity Tests
要更新测试，请点击其名称。
在连接测试详情页面上，点击页面顶部的修改。
修改测试选项。
点击保存。

测试会自动重新运行。

在“网络接口详情”页面上

在 Google Cloud 控制台中，前往虚拟机实例页面。

转到虚拟机实例
如果尚未选择，请选择包含要为其更新测试的实例的项目。
点击您要更新测试的实例。
在网络接口下，选择您要为其更新测试的网络接口。
在网络分析下，点击连接测试。
点击要更新的测试的名称。
在连接测试详情页面上，点击页面顶部的修改。
修改测试选项。
点击保存。

测试会自动重新运行。

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：来源虚拟机的项目 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：您正在运行的连接测试对象（测试）的 ID。
SOURCE_IP_ADDRESS：您要测试的内部或外部源 IP 地址；仅当测试的目标是全局负载均衡器 VIP 时，才允许使用 IPv6 地址

updateMask 是必需参数，用于指定补丁程序更新的字段。此示例更新 source 字段。

删除一个或多个测试

请按照本部分中的步骤删除测试。

如需在 delete 测试操作正在运行时检查其状态，请参阅检查正在运行的测试操作。

控制台

在“Connectivity Tests”的主页面上

在 Google Cloud 控制台中，前往 Connectivity Tests 页面。

转到 Connectivity Tests
点击一个或多个要删除的测试左侧的复选框。
在 Google Cloud 控制台页面顶部，点击删除。

在“Connectivity Tests 测试详情”页面上

在连接测试主屏幕页面中，点击测试的名称。
在连接测试详情页面顶部，点击删除。

在“网络接口详情”页面上

在 Google Cloud 控制台中，前往虚拟机实例页面。

转到虚拟机实例
如果尚未选择，请选择包含要从中删除测试的实例的项目。
点击要从中删除测试的实例。
在网络接口下，选择要从中删除测试的网络接口。
在网络分析下，点击连接测试。
选中要删除的一个或多个测试左侧的复选框。
在测试列表的顶部，点击删除。

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：源虚拟机的项目 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

更新或删除测试

准备工作

更新测试

控制台

在“Connectivity Tests”的主页面上

在“网络接口详情”页面上

gcloud

API

Python

删除一个或多个测试

控制台

在“Connectivity Tests”的主页面上

在“Connectivity Tests 测试详情”页面上

在“网络接口详情”页面上

gcloud

API

Python

后续步骤