Method: projects.locations.global.connectivityTests.patch

更新现有 ConnectivityTest 的配置。更新测试后,将作为长期运行的操作的一部分执行可达性分析,该操作将在分析完成后完成。测试资源中的可达性状态将使用新结果进行更新。

如果 ConnectivityTest 中的端点规范无效(例如,它们在网络中包含不存在的资源,或者用户没有对所列项目的网络配置的读取权限),那么可达性结果将返回值

UNKNOWN

如果 ConnectivityTest 中的端点规范不完整,则可达性结果将返回值 AMBIGUOUS。如需了解详情,请参阅 ConnectivityTest 中的文档。

HTTP 请求

PATCH https://networkmanagement.googleapis.com/v1/{resource.name=projects/*/locations/global/connectivityTests/*}

网址采用 gRPC 转码语法。

路径参数

参数
resource.name

string

标识符。资源的唯一名称,格式为:projects/{projectId}/locations/global/connectivityTests/{testId}

查询参数

参数
updateMask

string (FieldMask format)

必需。要更新的字段掩码。此字段中必须提供至少一个路径。

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

必须对指定的资源 updateMask 具有以下 IAM 权限才能进行授权:

  • networkmanagement.connectivitytests.update

请求正文

请求正文包含一个 ConnectivityTest 实例。

响应正文

如果成功,则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅身份验证概览