REST Resource: projects.locations.global.connectivityTests

string

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

string

用户提供的连接测试说明。最多 512 个字符。

object (Endpoint)

必需。连接测试的来源规范。

您可以使用来源 IP 地址、虚拟机实例或 Compute Engine 网络的组合来唯一标识来源位置。

示例：如果来源 IP 地址是 Google Cloud Virtual Private Cloud (VPC) 网络中的内部 IP 地址，那么您还必须指定 VPC 网络。否则，请指定虚拟机实例，该实例已包含其内部 IP 地址和 VPC 网络信息。

如果测试的来源位于本地网络内，则您必须提供目标 VPC 网络。

如果来源端点是具有多个网络接口的 Compute Engine 虚拟机实例，则该实例本身不足以标识此端点。因此，您还必须指定来源 IP 地址或 VPC 网络。

即使来源位置不明确，也会进行可达性分析。但是，测试结果可能包含您不打算测试的端点。

object (Endpoint)

必需。连接测试的目标规范。

您可以结合使用目标 IP 地址、Compute Engine 虚拟机实例或 VPC 网络来唯一标识目标位置。

即使目标 IP 地址不是唯一的，来源 IP 位置也是唯一的。通常，分析可以根据路由信息推断目标端点。

如果您指定的目标是虚拟机实例，并且该实例具有多个网络接口，则您还必须指定目标 IP 地址或 VPC 网络以标识目标接口。

即使目标位置不明确，也会进行可达性分析。但是，结果可能包含您不打算测试的端点。

string

测试的 IP 协议。如果未提供，则假定为“TCP”。

string

与可达性分析可能相关的其他项目。这适用于测试可能跨越项目边界的情景。

string

仅供输出。连接测试的显示名称。

map (key: string, value: string)

用于表示用户提供的元数据的资源标签。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

string (Timestamp format)

仅供输出。测试的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

仅限输出。测试配置的更新时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (ReachabilityDetails)

仅限输出。最近一次运行该测试的可达性详情。在创建新测试，更新现有测试或触发现有测试的一次性重新运行时，系统将更新该详情。

object (ProbingDetails)

仅限输出。最近一次运行该测试的探测详情，仅适用于适用的测试。在创建新测试，更新现有测试或触发现有测试的一次性重新运行时，系统将更新该详情。

boolean

测试是否应跳过防火墙检查。如果未提供，我们会假定为 false。

string

端点的 IP 地址，可以是外部 IP 或内部 IP。

integer

端点的 IP 协议端口。仅在协议为 TCP 或 UDP 时适用。

string

Compute Engine 实例 URI。

string

转发规则及其对应的 IP 地址构成 Google Cloud 负载均衡器的前端配置。转发规则还用于协议转发、Private Service Connect 和其他网络服务，以在控制平面中提供转发信息。格式：projects/{project}/global/forwardingRules/{id} 或 projects/{project}/区域/区域/forwardingRules/{id}

string

Google Kubernetes Engine 主服务器的集群 URI。

string

Cloud SQL 实例 URI。

object (CloudFunctionEndpoint)

Cloud Functions 函数。

object (AppEngineVersionEndpoint)

App Engine 服务版本。

object (CloudRunRevisionEndpoint)

Cloud Run 修订版本

string

Compute Engine 网络 URI。

enum (NetworkType)

端点所在的网络的类型。仅适用于来源端点，因为可以从来源推断出目标网络类型。

string

端点所在的项目 ID。如果提供了虚拟机实例或网络 URI，则可以从 URI 派生项目 ID。以下是必须提供项目 ID 的两种情况：1. 仅指定了 IP 地址，并且该 IP 地址在 Google Cloud 项目中。2. 使用共享 VPC 时，您提供的 IP 地址来自服务项目。在这种情况下，将在宿主项目中定义 IP 地址所在的网络。

enum (ForwardingRuleTarget)

仅限输出。指定转发规则的目标类型。

string

仅限输出。转发规则指向的负载均衡器的 ID。对于与负载平衡器无关的转发规则，此字段为空。

enum (LoadBalancerType)

仅限输出。转发规则指向的负载均衡器的类型。

string

Cloud Functions 函数名称。

string

App Engine 服务版本名称。

string

Cloud Run 修订版本 URI。格式为：projects/{project}/locations/{location}/revisions/{revision}

enum (Result)

测试配置分析的总体结果。

string (Timestamp format)

配置分析的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Status)

可达性分析失败或取消可达性分析的详细信息。

object (Trace)

如果一项测试在网络中具有多个可能的路径（例如当目标端点是具有多个后端的负载平衡器时），则结果可能包含跟踪记录列表。

object (EndpointInfo)

从用户请求指定的源端点和目标端点定义派生，并由数据平面模型验证。如果存在从不同来源位置开始的多个跟踪记录，则跟踪记录之间的 endpointInfo 可能会有所不同。

object (Step)

测试的跟踪记录包含从初始状态到最终状态（已递送、已丢弃、已转发或已中止）的多个步骤。

这些步骤按模拟网络状态机内的处理顺序排序。保留这些步骤的顺序，并避免对它们进行重新排列或排序，这一点至关重要。

integer

轨迹的 ID。对于正向轨迹，每个轨迹的此 ID 都是唯一的。对于返回轨迹，它与关联的正向轨迹的 ID 匹配。单个正向轨迹可以与零个、一个或多个返回轨迹相关联。

string

来源 IP 地址。

string

目标 IP 地址。

string

字符串格式的 IP 协议，例如：“TCP”、“UDP”、“ICMP”。

integer

来源端口。仅在协议为 TCP 或 UDP 时有效。

integer

目标端口。仅在协议为 TCP 或 UDP 时有效。

string

此数据包源自的网络的 URI。

string

此数据包发送到的网络的 URI。

string

此数据包源自的来源遥测代理的 URI。

string

步骤说明。通常，这是状态的摘要。

enum (State)

每个步骤都处于某种预定义状态。

boolean

这是通向最终状态“丢弃”的步骤。

string

包含此步骤正在验证的配置的项目 ID。

object (InstanceInfo)

显示 Compute Engine 实例的信息。

object (FirewallInfo)

显示 Compute Engine 防火墙规则的信息。

object (RouteInfo)

显示 Compute Engine 路由的信息。

object (EndpointInfo)

显示正在分析的来源和目标的信息。处于中间状态的端点信息可能与初始输入有所不同，因为它可能会被 NAT 或连接代理之类的状态所修改。

object (GoogleServiceInfo)

显示 Google 服务的信息

object (ForwardingRuleInfo)

显示 Compute Engine 转发规则的信息。

object (VpnGatewayInfo)

显示 Compute Engine VPN 网关的信息。

object (VpnTunnelInfo)

显示 Compute Engine VPN 隧道的信息。

object (VpcConnectorInfo)

显示 VPC 连接器的信息。

object (DeliverInfo)

显示最终状态“递送”和原因的信息。

object (ForwardInfo)

显示最终状态“转发”和原因的信息。

object (AbortInfo)

显示最终状态“中止”和原因的信息。

object (DropInfo)

显示最终状态“丢弃”和原因的信息。

object (LoadBalancerInfo)

显示负载平衡器的信息。已废弃，取而代之的是 loadBalancerBackendInfo 字段，不会在新测试中使用。

object (NetworkInfo)

显示 Google Cloud 网络的信息。

object (GKEMasterInfo)

显示 Google Kubernetes Engine 集群主服务器实例的信息。

object (CloudSQLInstanceInfo)

显示 Cloud SQL 实例的信息。

object (CloudFunctionInfo)

显示 Cloud Function 的信息。

object (AppEngineVersionInfo)

显示 App Engine 服务版本的信息。

object (CloudRunRevisionInfo)

显示 Cloud Run 修订版本的信息。

object (NatInfo)

显示 NAT 的信息。

object (ProxyConnectionInfo)

显示 ProxyConnection 的信息。

object (LoadBalancerBackendInfo)

显示特定负载均衡器后端的信息。

object (StorageBucketInfo)

显示存储分区的信息。仅用于返回轨迹。

object (ServerlessNegInfo)

显示无服务器网络端点组后端的信息。仅用于返回轨迹。

string

Compute Engine 实例的名称。

string

Compute Engine 实例的 URI。

string

Compute Engine 实例的网络接口的名称。

string

Compute Engine 网络的 URI。

string

网络接口的内部 IP 地址。

string

网络接口的外部 IP 地址。

string

在实例上配置的网络标记。

string

为实例授权的服务账号。

string

NIC 连接到的 PSC 网络连接的 URI（如果适用）。

string

防火墙规则的显示名称。对于防火墙政策规则，此字段可能为空。

string

防火墙规则的 URI。此字段不适用于隐式 VPC 防火墙规则。

string

可能的值：INGRESS、EGRESS

string

可能的值：ALLOW、DENY、APPLY_SECURITY_PROFILE_GROUP

integer

防火墙规则的优先级。

string

防火墙规则关联的 VPC 网络的 URI。此字段不适用于分层防火墙政策规则。

string

VPC 防火墙规则定义的目标标记。此字段不适用于防火墙政策规则。

string

防火墙规则指定的目标服务账号。

string

与此规则关联的防火墙政策的名称。此字段不适用于 VPC 防火墙规则和隐含的 VPC 防火墙规则。

string

与此规则关联的防火墙政策的 URI。此字段不适用于 VPC 防火墙规则和隐含的 VPC 防火墙规则。

enum (FirewallRuleType)

防火墙规则的类型。

enum (RouteType)

路由类型。

enum (NextHopType)

下一个跃点的类型。

enum (RouteScope)

指明路线适用的地理位置。

string

路线的名称。

string

路线的 URI。动态路由、对等互连静态路由和对等互连动态路由没有 URI。从 Google Cloud VPC 到本地网络的通告路由也没有 URI。

string

路由的目标 IP 范围。

string

路由的下一个跃点。

string

Compute Engine 网络的 URI。仅限影音平台路线。

integer

路由的优先级。

string

路由的实例标记。

string

路由的来源 IP 地址范围。仅限基于政策的路由。

string

路由的目标端口范围。仅限基于政策的路由。

string

路线的来源端口范围。仅限基于政策的路由。

string

路由的协议。仅限基于政策的路由。

string

NCC Hub 的 URI。仅限 NCC_HUB 路线。

string

NCC Spoke 的 URI。仅限 NCC_HUB 路线。

string

来源 IP 地址。

enum (GoogleServiceType)

识别到的 Google 服务类型。

string

转发规则的名称。

string

转发规则的 URI。

string

在转发规则中定义的与数据包匹配的协议。

string

在转发规则中定义的与数据包匹配的端口范围。

string

转发规则的 VIP。

string

转发规则的目标类型。

string

网络 URI。

string

转发规则的区域。仅适用于地区转发规则。

string

转发规则所属的负载均衡器的名称。对于与负载平衡器无关的转发规则（例如 PSC 转发规则），请留空。

string

此转发规则定位到的 PSC 服务连接的 URI（如果适用）。

string

此转发规则的 PSC Google API 目标（如果适用）。

string

VPN 网关的名称。

string

VPN 网关的 URI。

string

配置了 VPN 网关的 Compute Engine 网络的 URI。

string

VPN 网关的 IP 地址。

string

与该 VPN 网关关联的 VPN 隧道。一个 VPN 网关上可能配置了多个 VPN 隧道，并且仅显示与测试相关的那个。

string

配置了此 VPN 网关的 Google Cloud 区域的名称。

string

VPN 隧道的名称。

string

VPN 隧道的 URI。

string

隧道本地端 VPN 网关的 URI。

string

隧道远程端 VPN 网关的 URI。

string

远程 VPN 网关的 IP 地址。

string

本地 VPN 网关的 IP 地址。

string

配置了 VPN 隧道的 Compute Engine 网络的 URI。

string

配置了此 VPN 隧道的 Google Cloud 区域的名称。

enum (RoutingType)

路由政策的类型。

string

VPC 连接器的名称。

string

VPC 连接器的 URI。

string

VPC 连接器的部署位置。

enum (Target)

数据包递送到的目标类型。

string

数据包递送到的资源的 URI。

string

目标的 IP 地址（如果适用）。

string

要将数据包传送到的 Cloud Storage 存储分区的名称（如果适用）。

string

数据包传送到的 PSC Google API 目标（如果适用）。

enum (Target)

该数据包转发到的目标类型。

string

数据包转发到的资源的 URI。

string

目标的 IP 地址（如果适用）。

enum (Cause)

导致分析中止的原因。

string

导致中止的资源的 URI。

string

导致中止的 IP 地址。

string

用户在请求中指定但缺少访问权限的项目 ID 的列表。在这种情况下，分析会因 PERMISSION_DENIED 原因而中止。

enum (Cause)

导致数据包被丢弃的原因。

string

导致丢弃的资源的 URI。

string

丢弃的数据包的源 IP 地址（如果适用）。

string

丢弃的数据包的目标 IP 地址（如果适用）。

string

丢弃数据包的区域（如果适用）。

enum (LoadBalancerType)

负载平衡器的类型。

string

针对负载均衡器的健康检查的 URI。已废弃，不再填充，因为不同的负载均衡器后端可能具有不同的健康检查。

object (LoadBalancerBackend)

负载平衡器后端的信息。

enum (BackendType)

负载平衡器的后端配置类型。

string

后端配置 URI。

string

Compute Engine 实例或网络端点的名称。

string

Compute Engine 实例或网络端点的 URI。

enum (HealthCheckFirewallState)

健康检查防火墙配置的状态。

string

允许从健康检查 IP 范围进行探测的防火墙规则 URI 的列表。

string

禁止从健康检查 IP 范围进行探测的防火墙规则 URI 的列表。

string

Compute Engine 网络的名称。

string

Compute Engine 网络的 URI。

string

与测试匹配的 IP 范围。

string

GKE 集群的 URI。

string

GKE 集群网络的 URI。

string

GKE 集群主服务器的内部 IP 地址。

string

GKE 集群主服务器实例的外部 IP 地址。

string

Cloud SQL 实例的名称。

string

Cloud SQL 实例的 URI。

string

Cloud SQL 实例网络的 URI，如果实例没有网络，则为空字符串。

string

Cloud SQL 实例的内部 IP 地址。

string

Cloud SQL 实例的外部 IP 地址。

string

Cloud SQL 实例运行的区域。

string

Cloud Function 的名称。

string

Cloud Function 的 URI。

string

Cloud Function 的部署位置。

string (int64 format)

Cloud Function 的最新成功部署版本 ID。

string

App Engine 版本的名称。

string

App Engine 版本的 URI。

string

App Engine 版本的运行时。

string

版本的 App Engine 执行环境。

string

Cloud Run 修订版本的名称。

string

Cloud Run 修订版本的 URI。

string

此修订版本的部署位置。

string

此修订版本所属的 Cloud Run 服务的 URI。

enum (Type)

NAT 类型。

string

字符串格式的 IP 协议，例如：“TCP”、“UDP”、“ICMP”。

string

进行 NAT 转换的网络的 URI。

string

NAT 转换前的来源 IP 地址。

string

NAT 转换后的来源 IP 地址。

string

NAT 转换前的目标 IP 地址。

string

NAT 转换后的目标 IP 地址。

integer

NAT 转换前的源端口。仅在协议为 TCP 或 UDP 时有效。

integer

NAT 转换后的来源端口。仅在协议为 TCP 或 UDP 时有效。

integer

NAT 转换前的目标端口。仅在协议为 TCP 或 UDP 时有效。

integer

NAT 转换后的目标端口。仅在协议为 TCP 或 UDP 时有效。

string

Cloud Router 的 URI。仅当 type 为 CLOUD_NAT 时有效。

string

Cloud NAT 网关的名称。仅当 type 为 CLOUD_NAT 时有效。

string

字符串格式的 IP 协议，例如：“TCP”、“UDP”、“ICMP”。

string

原始连接的来源 IP 地址。

string

新连接的来源 IP 地址。

string

原始连接的目标 IP 地址

string

新连接的目标 IP 地址。

integer

原始连接的来源端口。仅在协议为 TCP 或 UDP 时有效。

integer

新连接的来源端口。仅在协议为 TCP 或 UDP 时有效。

integer

原始连接的目标端口。仅在协议为 TCP 或 UDP 时有效。

integer

新连接的目标端口。仅在协议为 TCP 或 UDP 时有效。

string

代理子网的 URI。

string

代理连接的网络的 URI。

string

后端的显示名称。例如，它可以是实例组后端的实例名称，也可以是区域网络端点组后端的 IP 地址和端口。

string

后端实例的 URI（如果适用）。系统会为实例组后端和区域 NEG 后端填充此值。

string

此后端所属的后端服务的 URI（如果适用）。

string

此后端所属的实例组的 URI（如果适用）。

string

此后端所属的网络端点组的 URI（如果适用）。

string

此后端定位到的后端存储桶的 URI（如果适用）。

string

此 PSC NEG 后端定位到的 PSC 服务连接的 URI（如果适用）。

string

PSC Google API 目标，此 PSC NEG 后端的目标（如果适用）。

string

附加到此后端的健康检查的 URI（如果适用）。

enum (HealthCheckFirewallsConfigState)

仅限输出。后端的健康检查防火墙配置状态。这是静态防火墙分析（用于验证是否允许从必需 IP 地址范围到后端的健康检查流量）的结果。即使配置了这些防火墙，后端可能仍处于不健康状态。如需了解详情，请参阅文档：https://cloud.google.com/load-balancing/docs/firewall-rules

string

Cloud Storage 存储分区名称。

string

无服务器网络端点组的 URI。

enum (ProbingResult)

主动探测的总体结果。

string (Timestamp format)

通过主动探测评估可达性的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (Status)

有关内部故障或取消主动探测的详细信息。

enum (ProbingAbortCause)

探测中止的原因。

integer

发送的探测次数。

integer

到达目的地的探测次数。

object (EndpointInfo)

从测试输入派生的源端点和目标端点，用于主动探测。

object (LatencyDistribution)

通过主动探测测量的一方向延迟时间：从源端点到目标端点。

object (EdgeLocation)

指目的地/来源为互联网的数据包将从中出站/入站的 EdgeLocation。只有具有互联网目标/来源地址的连接性测试才会填充此字段。不得将此字段的缺失视为目标/来源属于 Google 广告联盟的标志。

object (LatencyPercentile)

代表性延迟时间百分位数。

integer

此数据点适用的样本所占的百分比。

string (int64 format)

观察到的延迟时间的第 1 到 100 个百分位数（以微秒为单位）。延迟时间低于或等于此字段值的样本所占的百分比/100。

string

大都市区的名称。