MCP Tools Reference: networkmanagement.googleapis.com

工具：create_connectivity_test

创建并运行从来源到目标端点的连接测试。项目超出免费限额后，测试运行会产生费用。请注意，只有结果不是“UNDETERMINED”的测试运行才会产生费用。AI 代理应使用 get_connectivity_test 轮询结果，然后使用 delete_connectivity_test 删除测试资源。

以下示例演示了如何使用 curl 调用 create_connectivity_test MCP 工具。

Curl 请求 
                  
curl --location 'https://networkmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_connectivity_test",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

对 CreateConnectivityTest 方法的请求。

CreateConnectivityTestRequest

JSON 表示法 
{
  "parent": string,
  "testId": string,
  "resource": {
    object (ConnectivityTest)
  }
}
字段
parent

string

必需。要创建的连接测试的父级资源：projects/{project_id}/locations/global
testId

string

必需。项目中连接测试的逻辑名称具有以下限制：

  • 只能包含小写字母、数字和连字符。
  • 必须以字母开头。
  • 必须介于 1 到 40 个字符之间。
  • 必须以数字或字母结尾。
  • 在客户项目中必须是唯一的
resource

object (ConnectivityTest)

必需。ConnectivityTest 资源

ConnectivityTest

JSON 表示法 
{
  "name": string,
  "description": string,
  "source": {
    object (Endpoint)
  },
  "destination": {
    object (Endpoint)
  },
  "protocol": string,
  "relatedProjects": [
    string
  ],
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "reachabilityDetails": {
    object (ReachabilityDetails)
  },
  "probingDetails": {
    object (ProbingDetails)
  },
  "roundTrip": boolean,
  "returnReachabilityDetails": {
    object (ReachabilityDetails)
  },
  "bypassFirewallChecks": boolean
}
字段
name

string

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

string

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

object (Endpoint)

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

您可以结合使用来源 IP 地址、受支持端点的 URI、项目 ID 或 VPC 网络来标识来源位置。

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

object (Endpoint)

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

您可以结合使用目标 IP 地址、受支持端点的 URI、项目 ID 或 VPC 网络来标识目标位置。

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

string

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

string

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

string

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

map (key: string, value: string)

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

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

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
reachabilityDetails

object (ReachabilityDetails)

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

object (ProbingDetails)

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

boolean

是否运行从目的地到来源的返回路径分析。默认值为 false。
returnReachabilityDetails

object (ReachabilityDetails)

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

boolean

分析是否应跳过防火墙检查。默认值为 false。

端点

JSON 表示法 
{
  "ipAddress": string,
  "port": integer,
  "instance": string,
  "forwardingRule": string,
  "gkeMasterCluster": string,
  "fqdn": string,
  "cloudSqlInstance": string,
  "redisInstance": string,
  "redisCluster": string,
  "gkePod": string,
  "cloudFunction": {
    object (CloudFunctionEndpoint)
  },
  "appEngineVersion": {
    object (AppEngineVersionEndpoint)
  },
  "cloudRunRevision": {
    object (CloudRunRevisionEndpoint)
  },
  "network": string,
  "networkType": enum (NetworkType),
  "projectId": string,

  // Union field _forwarding_rule_target can be only one of the following:
  "forwardingRuleTarget": enum (ForwardingRuleTarget)
  // End of list of possible types for union field _forwarding_rule_target.

  // Union field _load_balancer_id can be only one of the following:
  "loadBalancerId": string
  // End of list of possible types for union field _load_balancer_id.

  // Union field _load_balancer_type can be only one of the following:
  "loadBalancerType": enum (LoadBalancerType)
  // End of list of possible types for union field _load_balancer_type.
}
字段
ipAddress

string

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

integer

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

string

Compute Engine 实例 URI。
forwardingRule

string

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

string

Google Kubernetes Engine 集群控制平面的集群 URI。
fqdn

string

Google Kubernetes Engine 集群控制平面的 DNS 端点。需要设置 gke_master_cluster，不能同时与 ip_address 或 network 搭配使用。仅适用于目标端点。
cloudSqlInstance

string

Cloud SQL 实例 URI。
redisInstance

string

Redis 实例 URI。仅适用于目标端点。
redisCluster

string

Redis 集群 URI。仅适用于目标端点。
gkePod

string

GKE Pod URI。
cloudFunction

object (CloudFunctionEndpoint)

Cloud Functions 函数。仅适用于来源端点。
appEngineVersion

object (AppEngineVersionEndpoint)

App Engine 服务版本。仅适用于来源端点。
cloudRunRevision

object (CloudRunRevisionEndpoint)

Cloud Run 修订版本。仅适用于来源端点。
network

string

VPC 网络 URI。对于源端点，根据 network_type 使用。对于目标端点，仅当来源是外部 IP 地址端点，而目标是内部 IP 地址端点时使用。
networkType

enum (NetworkType)

对于来源端点，端点所在的网络的类型。与目标端点无关。
projectId

string

对于源端点，为端点项目 ID。根据 network_type 使用。与目标端点无关。

联合字段 _forwarding_rule_target。

_forwarding_rule_target 只能是下列其中一项：
forwardingRuleTarget

enum (ForwardingRuleTarget)

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

联合字段 _load_balancer_id。

_load_balancer_id 只能是下列其中一项：
loadBalancerId

string

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

联合字段 _load_balancer_type。

_load_balancer_type 只能是下列其中一项：
loadBalancerType

enum (LoadBalancerType)

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

CloudFunctionEndpoint

JSON 表示法 
{
  "uri": string
}
字段
uri

string

Cloud Functions 函数名称。

AppEngineVersionEndpoint

JSON 表示法 
{
  "uri": string
}
字段
uri

string

App Engine 服务版本名称。

CloudRunRevisionEndpoint

JSON 表示法 
{
  "uri": string,
  "serviceUri": string
}
字段
uri

string

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

string

仅限输出。相应修订版本所属的 Cloud Run 服务的 URI。格式为：projects/{project}/locations/{location}/services/{service}

LabelsEntry

JSON 表示法 
{
  "key": string,
  "value": string
}
字段
key

string
value

string

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

ReachabilityDetails

JSON 表示法 
{
  "result": enum (Result),
  "verifyTime": string,
  "error": {
    object (Status)
  },
  "traces": [
    {
      object (Trace)
    }
  ]
}
字段
result

enum (Result)

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

string (Timestamp format)

配置分析的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
error

object (Status)

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

object (Trace)

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

状态

JSON 表示法 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
code

integer

状态代码，应为 google.rpc.Code 的枚举值。
message

string

面向开发者的错误消息（应采用英语）。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送，或者由客户端进行本地化。
details[]

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

不限

JSON 表示法 
{
  "typeUrl": string,
  "value": string
}
字段
typeUrl

string

通过 URI 引用（包含以斜杠结尾的前缀和完全限定的类型名称）来标识序列化 Protobuf 消息的类型。

示例：type.googleapis.com/google.protobuf.StringValue

此字符串必须包含至少一个 / 字符，并且最后一个 / 之后的内容必须是规范形式的完全限定名，不含前导点。请勿在这些 URI 引用中写入方案，以免客户端尝试联系它们。

前缀是任意的，Protobuf 实现应仅剥离最后一个 / 之前（包括）的所有内容，以识别类型。type.googleapis.com/ 是某些旧版实现所需的常见默认前缀。此前缀并不表示类型的来源，包含该前缀的 URI 不应响应任何请求。

所有类型网址字符串都必须是合法的 URI 引用，并且（对于文本格式）还必须满足以下额外限制：引用的内容只能包含字母数字字符、百分号编码的转义字符以及以下集合中的字符（不包括外侧的反引号）：/-.~_!$&()*+,;=。尽管我们允许使用百分比编码，但实现不应将其转义，以免与现有解析器混淆。例如，应拒绝 type.googleapis.com%2FFoo。

在 Any 的原始设计中，曾考虑过在这些类型网址上启动类型解析服务的可能性，但 Protobuf 从未实现过此类服务，并且认为联系这些网址存在问题，可能会导致安全问题。不尝试联系人类型网址。
value

string (bytes format)

包含由 type_url 描述的类型的 Protobuf 序列化。

使用 base64 编码的字符串。

Trace

JSON 表示法 
{
  "endpointInfo": {
    object (EndpointInfo)
  },
  "steps": [
    {
      object (Step)
    }
  ],
  "forwardTraceId": integer
}
字段
endpointInfo

object (EndpointInfo)

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

object (Step)

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

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

integer

轨迹的 ID。对于转发跟踪记录，此 ID 对每个跟踪记录都是唯一的。对于返回跟踪记录，它会与关联的转发跟踪记录的 ID 匹配。单个转发跟踪记录可以与一个或多个返回跟踪记录相关联，也可以与任何返回跟踪记录都不关联。

EndpointInfo

JSON 表示法 
{
  "sourceIp": string,
  "destinationIp": string,
  "protocol": string,
  "sourcePort": integer,
  "destinationPort": integer,
  "sourceNetworkUri": string,
  "destinationNetworkUri": string,
  "sourceAgentUri": string
}
字段
sourceIp

string

来源 IP 地址。
destinationIp

string

目标 IP 地址。
protocol

string

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

integer

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

integer

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

string

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

string

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

string

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

步骤

JSON 表示法 
{
  "description": string,
  "state": enum (State),
  "causesDrop": boolean,
  "projectId": string,

  // Union field step_info can be only one of the following:
  "instance": {
    object (InstanceInfo)
  },
  "firewall": {
    object (FirewallInfo)
  },
  "route": {
    object (RouteInfo)
  },
  "endpoint": {
    object (EndpointInfo)
  },
  "googleService": {
    object (GoogleServiceInfo)
  },
  "forwardingRule": {
    object (ForwardingRuleInfo)
  },
  "hybridSubnet": {
    object (HybridSubnetInfo)
  },
  "vpnGateway": {
    object (VpnGatewayInfo)
  },
  "vpnTunnel": {
    object (VpnTunnelInfo)
  },
  "interconnectAttachment": {
    object (InterconnectAttachmentInfo)
  },
  "vpcConnector": {
    object (VpcConnectorInfo)
  },
  "directVpcEgressConnection": {
    object (DirectVpcEgressConnectionInfo)
  },
  "serverlessExternalConnection": {
    object (ServerlessExternalConnectionInfo)
  },
  "deliver": {
    object (DeliverInfo)
  },
  "forward": {
    object (ForwardInfo)
  },
  "abort": {
    object (AbortInfo)
  },
  "drop": {
    object (DropInfo)
  },
  "loadBalancer": {
    object (LoadBalancerInfo)
  },
  "network": {
    object (NetworkInfo)
  },
  "gkeMaster": {
    object (GKEMasterInfo)
  },
  "gkePod": {
    object (GkePodInfo)
  },
  "ipMasqueradingSkipped": {
    object (IpMasqueradingSkippedInfo)
  },
  "gkeNetworkPolicy": {
    object (GkeNetworkPolicyInfo)
  },
  "gkeNetworkPolicySkipped": {
    object (GkeNetworkPolicySkippedInfo)
  },
  "cloudSqlInstance": {
    object (CloudSQLInstanceInfo)
  },
  "redisInstance": {
    object (RedisInstanceInfo)
  },
  "redisCluster": {
    object (RedisClusterInfo)
  },
  "cloudFunction": {
    object (CloudFunctionInfo)
  },
  "appEngineVersion": {
    object (AppEngineVersionInfo)
  },
  "cloudRunRevision": {
    object (CloudRunRevisionInfo)
  },
  "nat": {
    object (NatInfo)
  },
  "proxyConnection": {
    object (ProxyConnectionInfo)
  },
  "loadBalancerBackendInfo": {
    object (LoadBalancerBackendInfo)
  },
  "storageBucket": {
    object (StorageBucketInfo)
  },
  "serverlessNeg": {
    object (ServerlessNegInfo)
  },
  "ngfwPacketInspection": {
    object (NgfwPacketInspectionInfo)
  }
  // End of list of possible types for union field step_info.
}
字段
description

string

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

enum (State)

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

boolean

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

string

包含此步骤正在验证的配置的项目 ID。
联合字段 step_info。与每个步骤关联的配置或元数据。根据查看者的许可过滤配置。如果查看者无权在此步骤中查看相应配置，则对于非最终状态，将填充特殊状态 (VIEWER_PERMISSION_MISSING)；对于最终状态，将清除该配置。step_info 只能是下列其中一项：
instance

object (InstanceInfo)

显示 Compute Engine 实例的信息。
firewall

object (FirewallInfo)

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

object (RouteInfo)

显示 Compute Engine 路由的信息。
endpoint

object (EndpointInfo)

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

object (GoogleServiceInfo)

显示 Google 服务的信息
forwardingRule

object (ForwardingRuleInfo)

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

object (HybridSubnetInfo)

显示混合子网的信息。
vpnGateway

object (VpnGatewayInfo)

显示 Compute Engine VPN 网关的信息。
vpnTunnel

object (VpnTunnelInfo)

显示 Compute Engine VPN 隧道的信息。
interconnectAttachment

object (InterconnectAttachmentInfo)

显示互连连接的信息。
vpcConnector

object (VpcConnectorInfo)

显示 VPC 连接器的信息。
directVpcEgressConnection

object (DirectVpcEgressConnectionInfo)

显示无服务器直接 VPC 出站流量连接的信息。
serverlessExternalConnection

object (ServerlessExternalConnectionInfo)

显示无服务器公共（外部）连接的信息。
deliver

object (DeliverInfo)

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

object (ForwardInfo)

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

object (AbortInfo)

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

object (DropInfo)

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

object (LoadBalancerInfo)

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

object (NetworkInfo)

显示 Google Cloud 网络的信息。
gkeMaster

object (GKEMasterInfo)

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

object (GkePodInfo)

显示 Google Kubernetes Engine Pod 的信息。
ipMasqueradingSkipped

object (IpMasqueradingSkippedInfo)

显示跳过 GKE Pod IP 伪装的原因信息。
gkeNetworkPolicy

object (GkeNetworkPolicyInfo)

显示 GKE 网络政策的信息。
gkeNetworkPolicySkipped

object (GkeNetworkPolicySkippedInfo)

显示跳过 GKE 网络政策评估的原因的相关信息。
cloudSqlInstance

object (CloudSQLInstanceInfo)

显示 Cloud SQL 实例的信息。
redisInstance

object (RedisInstanceInfo)

显示 Redis 实例的信息。
redisCluster

object (RedisClusterInfo)

显示 Redis 集群的信息。
cloudFunction

object (CloudFunctionInfo)

显示 Cloud Functions 函数的信息。
appEngineVersion

object (AppEngineVersionInfo)

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

object (CloudRunRevisionInfo)

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

object (NatInfo)

显示 NAT 的信息。
proxyConnection

object (ProxyConnectionInfo)

显示 ProxyConnection 的信息。
loadBalancerBackendInfo

object (LoadBalancerBackendInfo)

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

object (StorageBucketInfo)

显示存储桶的信息。仅用于返回跟踪记录。
serverlessNeg

object (ServerlessNegInfo)

显示无服务器网络端点群组后端的信息。仅用于返回跟踪记录。
ngfwPacketInspection

object (NgfwPacketInspectionInfo)

显示防火墙执行的第 7 层数据包检查的相关信息。

InstanceInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "interface": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "networkTags": [
    string
  ],
  "serviceAccount": string,
  "pscNetworkAttachmentUri": string,
  "running": boolean,
  "status": enum (Status)
}
字段
displayName

string

Compute Engine 实例的名称。
uri

string

Compute Engine 实例的 URI。
interface

string

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

string

Compute Engine 网络的 URI。
internalIp

string

网络接口的内部 IP 地址。
externalIp

string

网络接口的外部 IP 地址。
networkTags[]

string

在实例上配置的网络标记。
serviceAccount
(deprecated)

string

为实例授权的服务账号。
pscNetworkAttachmentUri

string

NIC 连接到的 PSC 网络的 URI（如果相关）。
running
(deprecated)

boolean

指示 Compute Engine 实例是否正在运行。已弃用：请改用 status 字段。
status

enum (Status)

实例的状态。

FirewallInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "direction": string,
  "action": string,
  "priority": integer,
  "networkUri": string,
  "targetTags": [
    string
  ],
  "targetServiceAccounts": [
    string
  ],
  "policy": string,
  "policyUri": string,
  "firewallRuleType": enum (FirewallRuleType),
  "policyPriority": integer,
  "targetType": enum (TargetType)
}
字段
displayName

string

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

string

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

string

可能的值：INGRESS、EGRESS
action

string

可能的值：ALLOW、DENY、APPLY_SECURITY_PROFILE_GROUP
priority

integer

防火墙规则的优先级。
networkUri

string

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

string

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

string

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

string

相应规则所关联的防火墙政策的名称。此字段不适用于 VPC 防火墙规则和隐式 VPC 防火墙规则。
policyUri

string

相应规则所关联的防火墙政策的 URI。此字段不适用于 VPC 防火墙规则和隐式 VPC 防火墙规则。
firewallRuleType

enum (FirewallRuleType)

防火墙规则的类型。
policyPriority

integer

相应规则所关联的防火墙政策的优先级。此字段不适用于 VPC 防火墙规则和隐式 VPC 防火墙规则。
targetType

enum (TargetType)

防火墙规则的目标类型。

RouteInfo

JSON 表示法 
{
  "routeType": enum (RouteType),
  "nextHopType": enum (NextHopType),
  "routeScope": enum (RouteScope),
  "displayName": string,
  "uri": string,
  "region": string,
  "destIpRange": string,
  "nextHop": string,
  "networkUri": string,
  "priority": integer,
  "instanceTags": [
    string
  ],
  "srcIpRange": string,
  "destPortRanges": [
    string
  ],
  "srcPortRanges": [
    string
  ],
  "protocols": [
    string
  ],
  "nextHopUri": string,
  "nextHopNetworkUri": string,
  "originatingRouteUri": string,
  "originatingRouteDisplayName": string,
  "nccHubRouteUri": string,

  // Union field _ncc_hub_uri can be only one of the following:
  "nccHubUri": string
  // End of list of possible types for union field _ncc_hub_uri.

  // Union field _ncc_spoke_uri can be only one of the following:
  "nccSpokeUri": string
  // End of list of possible types for union field _ncc_spoke_uri.

  // Union field _advertised_route_source_router_uri can be only one of the
  // following:
  "advertisedRouteSourceRouterUri": string
  // End of list of possible types for union field
  // _advertised_route_source_router_uri.

  // Union field _advertised_route_next_hop_uri can be only one of the following:
  "advertisedRouteNextHopUri": string
  // End of list of possible types for union field
  // _advertised_route_next_hop_uri.
}
字段
routeType

enum (RouteType)

路由类型。
nextHopType

enum (NextHopType)

下一个跃点的类型。
routeScope
(deprecated)

enum (RouteScope)

指明路由适用的位置。已弃用，在新的测试中，具有 NCC_HUB 范围的路由不会包含在跟踪记录中。
displayName

string

路由的名称。
uri

string

路由的 URI。仅限 SUBNET、STATIC、PEERING_SUBNET（仅适用于对等互连网络）和 POLICY_BASED 路由。
region

string

路由所在的区域。仅限 DYNAMIC、PEERING_DYNAMIC、POLICY_BASED 和 ADVERTISED 路由。如果为 POLICY_BASED 路由设置，则表示该路由适用的 Cloud Interconnect 的 VLAN 连接的区域。如果为 POLICY_BASED 路由设置为“all”，则表示该路由适用于所有区域中 Cloud Interconnect 的 VLAN 连接。
destIpRange

string

路由的目标 IP 范围。
nextHop
(deprecated)

string

路由的下一个跃点的字符串类型（例如，“VPN 隧道”）。已弃用，改为使用 next_hop_type 和 next_hop_uri 字段，在新测试中不使用。
networkUri

string

路由所在的 VPC 网络的 URI。
priority

integer

路由的优先级。
instanceTags[]

string

路由的实例标记。
srcIpRange

string

相应路由的来源 IP 地址范围。仅适用于 POLICY_BASED 路由。
destPortRanges[]

string

相应路由的目标端口范围。仅适用于 POLICY_BASED 路由。
srcPortRanges[]

string

相应路由的源端口范围。仅适用于 POLICY_BASED 路由。
protocols[]

string

路由的协议。仅适用于 POLICY_BASED 路由。
nextHopUri

string

下一个跃点资源的 URI。
nextHopNetworkUri

string

下一个跃点资源所在的 VPC 网络的 URI。
originatingRouteUri

string

对于 PEERING_SUBNET 和 PEERING_STATIC 路由，为发起 SUBNET/STATIC 路由的 URI。
originatingRouteDisplayName

string

对于 PEERING_SUBNET、PEERING_STATIC 和 PEERING_DYNAMIC 路由，为发起 SUBNET/STATIC/DYNAMIC 路由的名称。
nccHubRouteUri

string

对于由 NCC Hub 通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由，为 NCC Hub 路由表中相应路由的 URI。

联合字段 _ncc_hub_uri。

_ncc_hub_uri 只能是下列其中一项：
nccHubUri

string

通告路由的 NCC Hub 的 URI。仅由 NCC Hub 通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由。

联合字段 _ncc_spoke_uri。

_ncc_spoke_uri 只能是下列其中一项：
nccSpokeUri

string

目标 NCC Spoke 的 URI。仅由 NCC Hub 通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由。

联合字段 _advertised_route_source_router_uri。

_advertised_route_source_router_uri 只能是下列其中一项：
advertisedRouteSourceRouterUri

string

对于 ADVERTISED 动态路由，是通告相应 IP 前缀的 Cloud Router 路由器的 URI。

联合字段 _advertised_route_next_hop_uri。

_advertised_route_next_hop_uri 只能是下列其中一项：
advertisedRouteNextHopUri
(deprecated)

string

对于 ADVERTISED 路由，其下一个跃点的 URI，即通告前缀的混合端点（VPN 隧道、互连连接、NCC 路由器设备）的 URI，或来源对等互连网络的 URI。已弃用，改为使用 next_hop_uri 字段，在新测试中不使用。

GoogleServiceInfo

JSON 表示法 
{
  "sourceIp": string,
  "googleServiceType": enum (GoogleServiceType)
}
字段
sourceIp

string

来源 IP 地址。
googleServiceType

enum (GoogleServiceType)

已识别的 Google 服务类型。

ForwardingRuleInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "matchedProtocol": string,
  "matchedPortRange": string,
  "vip": string,
  "target": string,
  "networkUri": string,
  "region": string,
  "loadBalancerName": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string
}
字段
displayName

string

转发规则的名称。
uri

string

转发规则的 URI。
matchedProtocol

string

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

string

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

string

转发规则的 VIP。
target

string

转发规则的目标类型。
networkUri

string

网络 URI。
region

string

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

string

转发规则所属的负载均衡器的名称。对于与负载均衡器无关的转发规则（例如 PSC 转发规则），此字段为空。
pscServiceAttachmentUri

string

此转发规则的目标 PSC 服务连接的 URI（如果适用）。
pscGoogleApiTarget

string

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

HybridSubnetInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "region": string
}
字段
displayName

string

混合子网的名称。
uri

string

混合子网的 URI。
region

string

配置了混合子网的 Google Cloud 区域的名称。

VpnGatewayInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "ipAddress": string,
  "vpnTunnelUri": string,
  "region": string
}
字段
displayName

string

VPN 网关的名称。
uri

string

VPN 网关的 URI。
networkUri

string

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

string

VPN 网关的 IP 地址。
vpnTunnelUri

string

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

string

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

VpnTunnelInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "sourceGateway": string,
  "remoteGateway": string,
  "remoteGatewayIp": string,
  "sourceGatewayIp": string,
  "networkUri": string,
  "region": string,
  "routingType": enum (RoutingType)
}
字段
displayName

string

VPN 隧道的名称。
uri

string

VPN 隧道的 URI。
sourceGateway

string

隧道本地端 VPN 网关的 URI。
remoteGateway

string

隧道远程端 VPN 网关的 URI。
remoteGatewayIp

string

远程 VPN 网关的 IP 地址。
sourceGatewayIp

string

本地 VPN 网关的 IP 地址。
networkUri

string

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

string

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

enum (RoutingType)

路由政策的类型。

InterconnectAttachmentInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "interconnectUri": string,
  "region": string,
  "cloudRouterUri": string,
  "type": enum (Type),
  "l2AttachmentMatchedIpAddress": string
}
字段
displayName

string

互连连接的名称。
uri

string

互连连接的 URI。
interconnectUri

string

配置互连连接的互连的 URI。
region

string

配置了互连连接的 Google Cloud 区域的名称。
cloudRouterUri

string

用于动态路由的 Cloud Router 的 URI。
type

enum (Type)

互连附件的类型。
l2AttachmentMatchedIpAddress

string

为 L2_DEDICATED 连接匹配的设备 IP 地址。

VpcConnectorInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "location": string
}
字段
displayName

string

VPC 连接器的名称。
uri

string

VPC 连接器的 URI。
location

string

VPC 连接器的部署位置。

DirectVpcEgressConnectionInfo

JSON 表示法 
{
  "networkUri": string,
  "subnetworkUri": string,
  "selectedIpRange": string,
  "selectedIpAddress": string,
  "region": string
}
字段
networkUri

string

直接访问网络的 URI。
subnetworkUri

string

直接访问子网的 URI。
selectedIpRange

string

所选 IP 范围。
selectedIpAddress

string

从所选 IP 范围中选择的起始 IP 地址。
region

string

直接 VPC 出站流量的部署区域。

ServerlessExternalConnectionInfo

JSON 表示法 
{
  "selectedIpAddress": string
}
字段
selectedIpAddress

string

从 Google 动态地址池中选择的起始 IP 地址。

DeliverInfo

JSON 表示法 
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string,
  "storageBucket": string,
  "pscGoogleApiTarget": string,
  "googleServiceType": enum (GoogleServiceType)
}
字段
target

enum (Target)

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

string

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

string

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

string

数据包传输到的 Cloud Storage 存储桶的名称（如果适用）。
pscGoogleApiTarget

string

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

enum (GoogleServiceType)

数据包递送到的 Google 服务的已识别类型（如果适用）。

ForwardInfo

JSON 表示法 
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string
}
字段
target

enum (Target)

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

string

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

string

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

AbortInfo

JSON 表示法 
{
  "cause": enum (Cause),
  "resourceUri": string,
  "ipAddress": string,
  "projectsMissingPermission": [
    string
  ]
}
字段
cause

enum (Cause)

导致分析中止的原因。
resourceUri

string

导致中止的资源的 URI。
ipAddress

string

导致中止的 IP 地址。
projectsMissingPermission[]

string

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

DropInfo

JSON 表示法 
{
  "cause": enum (Cause),
  "resourceUri": string,
  "sourceIp": string,
  "destinationIp": string,
  "region": string,
  "sourceGeolocationCode": string,
  "destinationGeolocationCode": string
}
字段
cause

enum (Cause)

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

string

导致丢弃的资源的 URI。
sourceIp

string

丢弃的数据包的来源 IP 地址（如果相关）。
destinationIp

string

丢弃的数据包的目标 IP 地址（如果相关）。
region

string

丢弃的数据包的区域（如果相关）。
sourceGeolocationCode

string

来源 IP 地址的地理定位（区域代码，如果相关）。
destinationGeolocationCode

string

目标 IP 地址的地理定位（区域代码，如果相关）。

LoadBalancerInfo

JSON 表示法 
{
  "loadBalancerType": enum (LoadBalancerType),
  "healthCheckUri": string,
  "backends": [
    {
      object (LoadBalancerBackend)
    }
  ],
  "backendType": enum (BackendType),
  "backendUri": string
}
字段
loadBalancerType

enum (LoadBalancerType)

负载平衡器的类型。
healthCheckUri
(deprecated)

string

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

object (LoadBalancerBackend)

负载平衡器后端的信息。
backendType

enum (BackendType)

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

string

后端配置 URI。

LoadBalancerBackend

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "healthCheckFirewallState": enum (HealthCheckFirewallState),
  "healthCheckAllowingFirewallRules": [
    string
  ],
  "healthCheckBlockingFirewallRules": [
    string
  ]
}
字段
displayName

string

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

string

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

enum (HealthCheckFirewallState)

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

string

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

string

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

NetworkInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "matchedSubnetUri": string,
  "matchedIpRange": string,
  "region": string
}
字段
displayName

string

Compute Engine 网络的名称。
uri

string

Compute Engine 网络的 URI。
matchedSubnetUri

string

与测试的来源 IP 地址匹配的子网的 URI。
matchedIpRange

string

与测试的来源 IP 地址匹配的子网的 IP 范围。
region

string

与测试的来源 IP 地址匹配的子网的区域。

GKEMasterInfo

JSON 表示法 
{
  "clusterUri": string,
  "clusterNetworkUri": string,
  "internalIp": string,
  "externalIp": string,
  "dnsEndpoint": string
}
字段
clusterUri

string

GKE 集群的 URI。
clusterNetworkUri

string

GKE 集群网络的 URI。
internalIp

string

GKE 集群控制平面的内部 IP 地址。
externalIp

string

GKE 集群控制平面的外部 IP 地址。
dnsEndpoint

string

GKE 集群控制平面的 DNS 端点。

GkePodInfo

JSON 表示法 
{
  "podUri": string,
  "ipAddress": string,
  "networkUri": string
}
字段
podUri

string

GKE Pod 的 URI。对于区域集群中的 Pod，URI 格式为：projects/{project}/locations/{location}/clusters/{cluster}/k8s/namespaces/{namespace}/pods/{pod}对于可用区集群中的 Pod，URI 格式为：projects/{project}/zones/{zone}/clusters/{cluster}/k8s/namespaces/{namespace}/pods/{pod}
ipAddress

string

GKE Pod 的 IP 地址。如果 Pod 是双栈，则这是与轨迹相关的 IP 地址。
networkUri

string

包含 GKE Pod 的网络的 URI。

IpMasqueradingSkippedInfo

JSON 表示法 
{
  "reason": enum (Reason),
  "nonMasqueradeRange": string
}
字段
reason

enum (Reason)

未应用 IP 伪装的原因。
nonMasqueradeRange

string

匹配的非伪装 IP 范围。仅当原因是 DESTINATION_IP_IN_CONFIGURED_NON_MASQUERADE_RANGE 或 DESTINATION_IP_IN_DEFAULT_NON_MASQUERADE_RANGE 时设置。

GkeNetworkPolicyInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "direction": string,
  "action": string
}
字段
displayName

string

网络政策的名称。
uri

string

网络政策的 URI。区域集群中的网络政策格式：projects/<project_id>/zones/<zone>/clusters/<cluster>/k8s/namespaces/<namespace>/networking.k8s.io/networkpolicies/<networkpolicy> 区域集群中的网络政策格式：projects/<project_id>/locations/<location>/clusters/<cluster>/k8s/namespaces/<namespace>/networking.k8s.io/networkpolicies/<networkpolicy>
direction

string

可能的值：INGRESS、EGRESS
action

string

可能的值：ALLOW、DENY

GkeNetworkPolicySkippedInfo

JSON 表示法 
{
  "reason": enum (Reason)
}
字段
reason

enum (Reason)

跳过网络政策评估的原因。

CloudSQLInstanceInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "region": string
}
字段
displayName

string

Cloud SQL 实例的名称。
uri

string

Cloud SQL 实例的 URI。
networkUri

string

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

string

Cloud SQL 实例的内部 IP 地址。
externalIp

string

Cloud SQL 实例的外部 IP 地址。
region

string

Cloud SQL 实例运行的区域。

RedisInstanceInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "primaryEndpointIp": string,
  "readEndpointIp": string,
  "region": string
}
字段
displayName

string

Cloud Redis 实例的名称。
uri

string

Cloud Redis 实例的 URI。
networkUri

string

Cloud Redis 实例网络的 URI。
primaryEndpointIp

string

Cloud Redis 实例的主端点 IP 地址。
readEndpointIp

string

Cloud Redis 实例的读取端点 IP 地址（如果适用）。
region

string

在其中定义 Cloud Redis 实例的区域。

RedisClusterInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "discoveryEndpointIpAddress": string,
  "secondaryEndpointIpAddress": string,
  "location": string
}
字段
displayName

string

Redis 集群的名称。
uri

string

Redis 集群的 URI，格式为“projects/{project_id}/locations/{location}/clusters/{cluster_id}”
networkUri

string

包含 Redis 集群端点的网络的 URI，格式为“projects/{project_id}/global/networks/{network_id}”。
discoveryEndpointIpAddress

string

Redis 集群的发现端点 IP 地址。
secondaryEndpointIpAddress

string

Redis 集群的次要端点 IP 地址。
location

string

定义 Redis 集群的区域的名称。例如：“us-central1”。

CloudFunctionInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "location": string,
  "versionId": string
}
字段
displayName

string

Cloud Functions 函数的名称。
uri

string

Cloud Functions 函数的 URI。
location

string

Cloud Functions 函数的部署位置。
versionId

string (int64 format)

最新成功部署的 Cloud Functions 函数版本 ID。

AppEngineVersionInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "runtime": string,
  "environment": string
}
字段
displayName

string

App Engine 版本的名称。
uri

string

App Engine 版本的 URI。
runtime

string

App Engine 版本的运行时。
environment

string

版本的 App Engine 执行环境。

CloudRunRevisionInfo

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "location": string,
  "serviceUri": string
}
字段
displayName

string

Cloud Run 修订版本的名称。
uri

string

Cloud Run 修订版本的 URI。
location

string

相应修订版本的部署位置。
serviceUri

string

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

NatInfo

JSON 表示法 
{
  "type": enum (Type),
  "protocol": string,
  "networkUri": string,
  "oldSourceIp": string,
  "newSourceIp": string,
  "oldDestinationIp": string,
  "newDestinationIp": string,
  "oldSourcePort": integer,
  "newSourcePort": integer,
  "oldDestinationPort": integer,
  "newDestinationPort": integer,
  "routerUri": string,
  "natGatewayName": string,
  "cloudNatGatewayType": enum (CloudNatGatewayType)
}
字段
type

enum (Type)

NAT 类型。
protocol

string

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

string

发生 NAT 转换的网络的 URI。
oldSourceIp

string

NAT 转换之前的来源 IP 地址。
newSourceIp

string

NAT 转换后的来源 IP 地址。
oldDestinationIp

string

NAT 转换之前的目标 IP 地址。
newDestinationIp

string

NAT 转换后的目标 IP 地址。
oldSourcePort

integer

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

integer

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

integer

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

integer

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

string

Cloud Router 的 URI。仅在类型为 CLOUD_NAT 时有效。
natGatewayName

string

Cloud NAT 网关的名称。仅在类型为 CLOUD_NAT 时有效。
cloudNatGatewayType

enum (CloudNatGatewayType)

Cloud NAT 网关的类型。仅在 type 为 CLOUD_NAT 时有效。

ProxyConnectionInfo

JSON 表示法 
{
  "protocol": string,
  "oldSourceIp": string,
  "newSourceIp": string,
  "oldDestinationIp": string,
  "newDestinationIp": string,
  "oldSourcePort": integer,
  "newSourcePort": integer,
  "oldDestinationPort": integer,
  "newDestinationPort": integer,
  "subnetUri": string,
  "networkUri": string
}
字段
protocol

string

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

string

原始连接的来源 IP 地址。
newSourceIp

string

新连接的来源 IP 地址。
oldDestinationIp

string

原始连接的目标 IP 地址
newDestinationIp

string

新连接的目标 IP 地址。
oldSourcePort

integer

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

integer

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

integer

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

integer

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

string

代理子网的 URI。
networkUri

string

连接代理的网络的 URI。

LoadBalancerBackendInfo

JSON 表示法 
{
  "name": string,
  "instanceUri": string,
  "backendServiceUri": string,
  "instanceGroupUri": string,
  "networkEndpointGroupUri": string,
  "backendBucketUri": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string,
  "healthCheckUri": string,
  "healthCheckFirewallsConfigState": enum (HealthCheckFirewallsConfigState)
}
字段
name

string

后端的显示名称。例如，对于实例组后端，它可能是实例名称；对于可用区网络端点组后端，它可能是 IP 地址和端口。
instanceUri

string

后端实例的 URI（如果适用）。针对实例群组后端和可用区级 NEG 后端填充。
backendServiceUri

string

相应后端所属的后端服务的 URI（如果适用）。
instanceGroupUri

string

相应后端所属的实例群组的 URI（如果适用）。
networkEndpointGroupUri

string

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

string

此后端的目标后端存储桶的 URI（如果适用）。
pscServiceAttachmentUri

string

相应 PSC NEG 后端所针对的 PSC 服务连接的 URI（如果适用）。
pscGoogleApiTarget

string

相应 PSC NEG 后端所针对的 PSC Google API 目标（如果适用）。
healthCheckUri

string

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

enum (HealthCheckFirewallsConfigState)

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

StorageBucketInfo

JSON 表示法 
{
  "bucket": string
}
字段
bucket

string

Cloud Storage 存储桶名称。

ServerlessNegInfo

JSON 表示法 
{
  "negUri": string
}
字段
negUri

string

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

NgfwPacketInspectionInfo

JSON 表示法 
{
  "securityProfileGroupUri": string
}
字段
securityProfileGroupUri

string

与此防火墙数据包检查关联的安全配置文件组的 URI。

ProbingDetails

JSON 表示法 
{
  "result": enum (ProbingResult),
  "verifyTime": string,
  "error": {
    object (Status)
  },
  "abortCause": enum (ProbingAbortCause),
  "sentProbeCount": integer,
  "successfulProbeCount": integer,
  "endpointInfo": {
    object (EndpointInfo)
  },
  "probingLatency": {
    object (LatencyDistribution)
  },
  "destinationEgressLocation": {
    object (EdgeLocation)
  },
  "edgeResponses": [
    {
      object (SingleEdgeResponse)
    }
  ],
  "probedAllDevices": boolean
}
字段
result

enum (ProbingResult)

主动探测的总体结果。
verifyTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
error

object (Status)

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

enum (ProbingAbortCause)

探测中止的原因。
sentProbeCount

integer

已发送的探测次数。
successfulProbeCount

integer

到达目标的探测次数。
endpointInfo

object (EndpointInfo)

从测试输入中提取并用于主动探测的来源端点和目标端点。
probingLatency

object (LatencyDistribution)

通过单向主动探测测得的延迟时间：从源端点到目标端点。
destinationEgressLocation

object (EdgeLocation)

数据包（以互联网为目的地）将从 Google 网络传出的边缘位置。仅当连接测试具有互联网目标地址时，才会填充此字段。不得将缺少此字段作为表明目标属于 Google 网络的指示。
edgeResponses[]

object (SingleEdgeResponse)

所有边缘设备的探测结果。
probedAllDevices

boolean

是否探测了所有相关的边缘设备。

LatencyDistribution

JSON 表示法 
{
  "latencyPercentiles": [
    {
      object (LatencyPercentile)
    }
  ]
}
字段
latencyPercentiles[]

object (LatencyPercentile)

代表性延迟时间百分位。

LatencyPercentile

JSON 表示法 
{
  "percent": integer,
  "latencyMicros": string
}
字段
percent

integer

相应数据点适用的示例百分比。
latencyMicros

string (int64 format)

观察到的延迟时间的百分位（以微秒为单位）。样本中延迟时间低于或等于此字段值的百分比。

EdgeLocation

JSON 表示法 
{
  "metropolitanArea": string
}
字段
metropolitanArea

string

都市区域的名称。

SingleEdgeResponse

JSON 表示法 
{
  "result": enum (ProbingResult),
  "sentProbeCount": integer,
  "successfulProbeCount": integer,
  "probingLatency": {
    object (LatencyDistribution)
  },
  "destinationEgressLocation": {
    object (EdgeLocation)
  },
  "destinationRouter": string
}
字段
result

enum (ProbingResult)

相应出站流量设备的主动探测的总体结果。
sentProbeCount

integer

已发送的探测次数。
successfulProbeCount

integer

到达目标的探测次数。
probingLatency

object (LatencyDistribution)

通过单向主动探测测得的延迟时间：从源端点到目标端点。
destinationEgressLocation

object (EdgeLocation)

数据包（以互联网为目的地）将从 Google 网络传出的边缘位置。仅当连接测试具有互联网目标地址时，才会填充此字段。不得将缺少此字段作为表明目标属于 Google 网络的指示。
destinationRouter

string

路由器的名称，格式为“{router}.{metroshard}”。例如：pf01.aaa01、pr02.aaa01。

输出架构

此资源表示由网络 API 调用引发的长时间运行的操作。

操作

JSON 表示法 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
字段
name

string

由服务器分配的名称，该名称仅在最初返回它的那项服务中是唯一的。如果您使用默认 HTTP 映射，则 name 应是以 operations/{unique_id} 结尾的资源名称。
metadata

object

与操作关联的服务专属元数据。它通常包含进度信息和常见元数据（如创建时间）。一些服务可能不会提供此类元数据。任何返回长时间运行操作的方法都应记录元数据类型（如果有的话）。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。
done

boolean

如果值为 false，则表示操作仍在进行中。如果为 true，则表示操作已完成，其结果不是 error 就是 response。
联合字段 result。操作结果，可以是 error，也可以是有效的 response。如果 done == false，则既不会设置 error，也不会设置 response。如果 done == true，则只能设置 error 或 response 中的一项。部分服务可能不会提供结果。result 只能是下列其中一项：
error

object (Status)

操作失败或被取消时表示有错误发生的结果。
response

object

操作的常规成功响应。如果原始方法在成功时不返回任何数据（如 Delete），则响应为 google.protobuf.Empty。如果原始方法为标准 Get/Create/Update 方法，则响应应该为资源。对于其他方法，响应类型应为 XxxResponse，其中 Xxx 是原始方法的名称。例如，如果原始方法名称为 TakeSnapshot()，则推断的响应类型为 TakeSnapshotResponse。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

不限

JSON 表示法 
{
  "typeUrl": string,
  "value": string
}
字段
typeUrl

string

通过 URI 引用（包含以斜杠结尾的前缀和完全限定的类型名称）来标识序列化 Protobuf 消息的类型。

示例：type.googleapis.com/google.protobuf.StringValue

此字符串必须包含至少一个 / 字符，并且最后一个 / 之后的内容必须是规范形式的完全限定名，不含前导点。请勿在这些 URI 引用中写入方案，以免客户端尝试联系它们。

前缀是任意的，Protobuf 实现应仅剥离最后一个 / 之前（包括）的所有内容，以识别类型。type.googleapis.com/ 是某些旧版实现所需的常见默认前缀。此前缀并不表示类型的来源，包含该前缀的 URI 不应响应任何请求。

所有类型网址字符串都必须是合法的 URI 引用，并且（对于文本格式）还必须满足以下额外限制：引用的内容只能包含字母数字字符、百分号编码的转义字符以及以下集合中的字符（不包括外侧的反引号）：/-.~_!$&()*+,;=。尽管我们允许使用百分比编码，但实现不应将其转义，以免与现有解析器混淆。例如，应拒绝 type.googleapis.com%2FFoo。

在 Any 的原始设计中，曾考虑过在这些类型网址上启动类型解析服务的可能性，但 Protobuf 从未实现过此类服务，并且认为联系这些网址存在问题，可能会导致安全问题。不尝试联系人类型网址。
value

string (bytes format)

包含由 type_url 描述的类型的 Protobuf 序列化。

使用 base64 编码的字符串。

状态

JSON 表示法 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
code

integer

状态代码，应为 google.rpc.Code 的枚举值。
message

string

面向开发者的错误消息（应采用英语）。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送，或者由客户端进行本地化。
details[]

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

工具注释

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：❌