@@ -316,6 +316,19 @@ message Step {
316316
317317// For display only. Metadata associated with a Compute Engine instance.
318318message InstanceInfo {
319+ // The status of the instance. We treat all states other than "RUNNING" as
320+ // not running.
321+ enum Status {
322+ // Default unspecified value.
323+ STATUS_UNSPECIFIED = 0 ;
324+
325+ // The instance is running.
326+ RUNNING = 1 ;
327+
328+ // The instance has any status other than "RUNNING".
329+ NOT_RUNNING = 2 ;
330+ }
331+
319332 // Name of a Compute Engine instance.
320333 string display_name = 1 ;
321334
@@ -342,10 +355,16 @@ message InstanceInfo {
342355
343356 // URI of the PSC network attachment the NIC is attached to (if relevant).
344357 string psc_network_attachment_uri = 9 ;
358+
359+ // Indicates whether the Compute Engine instance is running.
360+ // Deprecated: use the `status` field instead.
361+ bool running = 10 [deprecated = true ];
362+
363+ // The status of the instance.
364+ Status status = 11 ;
345365}
346366
347367// For display only. Metadata associated with a Compute Engine network.
348- // Next ID: 7
349368message NetworkInfo {
350369 // Name of a Compute Engine network.
351370 string display_name = 1 ;
@@ -459,6 +478,11 @@ message FirewallInfo {
459478
460479 // The firewall rule's type.
461480 FirewallRuleType firewall_rule_type = 10 ;
481+
482+ // The priority of the firewall policy that this rule is associated with.
483+ // This field is not applicable to VPC firewall rules and implied VPC firewall
484+ // rules.
485+ int32 policy_priority = 12 ;
462486}
463487
464488// For display only. Metadata associated with a Compute Engine route.
@@ -544,6 +568,9 @@ message RouteInfo {
544568 // Next hop is an NCC hub. This scenario only happens when the user doesn't
545569 // have permissions to the project where the next hop resource is located.
546570 NEXT_HOP_NCC_HUB = 12 ;
571+
572+ // Next hop is Secure Web Proxy Gateway.
573+ SECURE_WEB_PROXY_GATEWAY = 13 ;
547574 }
548575
549576 // Indicates where routes are applicable.
@@ -986,6 +1013,35 @@ message DeliverInfo {
9861013 REDIS_CLUSTER = 17 ;
9871014 }
9881015
1016+ // Recognized type of a Google Service.
1017+ enum GoogleServiceType {
1018+ // Unspecified Google Service.
1019+ GOOGLE_SERVICE_TYPE_UNSPECIFIED = 0 ;
1020+
1021+ // Identity aware proxy.
1022+ // https://cloud.google.com/iap/docs/using-tcp-forwarding
1023+ IAP = 1 ;
1024+
1025+ // One of two services sharing IP ranges:
1026+ // * Load Balancer proxy
1027+ // * Centralized Health Check prober
1028+ // https://cloud.google.com/load-balancing/docs/firewall-rules
1029+ GFE_PROXY_OR_HEALTH_CHECK_PROBER = 2 ;
1030+
1031+ // Connectivity from Cloud DNS to forwarding targets or alternate name
1032+ // servers that use private routing.
1033+ // https://cloud.google.com/dns/docs/zones/forwarding-zones#firewall-rules
1034+ // https://cloud.google.com/dns/docs/policies#firewall-rules
1035+ CLOUD_DNS = 3 ;
1036+
1037+ // private.googleapis.com and restricted.googleapis.com
1038+ PRIVATE_GOOGLE_ACCESS = 4 ;
1039+
1040+ // Google API via Serverless VPC Access.
1041+ // https://cloud.google.com/vpc/docs/serverless-vpc-access
1042+ SERVERLESS_VPC_ACCESS = 5 ;
1043+ }
1044+
9891045 // Target type where the packet is delivered to.
9901046 Target target = 1 ;
9911047
@@ -1001,6 +1057,10 @@ message DeliverInfo {
10011057
10021058 // PSC Google API target the packet is delivered to (if applicable).
10031059 string psc_google_api_target = 5 ;
1060+
1061+ // Recognized type of a Google Service the packet is delivered to (if
1062+ // applicable).
1063+ GoogleServiceType google_service_type = 6 ;
10041064}
10051065
10061066// Details of the final state "forward" and associated resource.
@@ -1036,6 +1096,9 @@ message ForwardInfo {
10361096
10371097 // Forwarded to a router appliance.
10381098 ROUTER_APPLIANCE = 9 ;
1099+
1100+ // Forwarded to a Secure Web Proxy Gateway.
1101+ SECURE_WEB_PROXY_GATEWAY = 10 ;
10391102 }
10401103
10411104 // Target type where this packet is forwarded to.
@@ -1162,10 +1225,14 @@ message AbortInfo {
11621225 // Aborted because expected route configuration was missing.
11631226 ROUTE_CONFIG_NOT_FOUND = 27 ;
11641227
1165- // Aborted because a PSC endpoint selection for the Google-managed service
1228+ // Aborted because PSC endpoint selection for the Google-managed service
11661229 // is ambiguous (several PSC endpoints satisfy test input).
11671230 GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT = 19 ;
11681231
1232+ // Aborted because endpoint selection for the Google-managed service is
1233+ // ambiguous (several endpoints satisfy test input).
1234+ GOOGLE_MANAGED_SERVICE_AMBIGUOUS_ENDPOINT = 39 ;
1235+
11691236 // Aborted because tests with a PSC-based Cloud SQL instance as a source are
11701237 // not supported.
11711238 SOURCE_PSC_CLOUD_SQL_UNSUPPORTED = 20 ;
@@ -1265,9 +1332,14 @@ message DropInfo {
12651332 // rule of the internal passthrough load balancer).
12661333 ROUTE_NEXT_HOP_FORWARDING_RULE_TYPE_INVALID = 53 ;
12671334
1268- // Packet is sent from the Internet to the private IPv6 address.
1335+ // Packet is sent from the Internet or Google service to the private IPv6
1336+ // address.
12691337 NO_ROUTE_FROM_INTERNET_TO_PRIVATE_IPV6_ADDRESS = 44 ;
12701338
1339+ // Packet is sent from the external IPv6 source address of an instance to
1340+ // the private IPv6 address of an instance.
1341+ NO_ROUTE_FROM_EXTERNAL_IPV6_SOURCE_TO_PRIVATE_IPV6_ADDRESS = 98 ;
1342+
12711343 // The packet does not match a policy-based VPN tunnel local selector.
12721344 VPN_TUNNEL_LOCAL_SELECTOR_MISMATCH = 45 ;
12731345
@@ -1277,18 +1349,18 @@ message DropInfo {
12771349 // Packet with internal destination address sent to the internet gateway.
12781350 PRIVATE_TRAFFIC_TO_INTERNET = 7 ;
12791351
1280- // Instance with only an internal IP address tries to access Google API and
1281- // services, but private Google access is not enabled in the subnet.
1352+ // Endpoint with only an internal IP address tries to access Google API and
1353+ // services, but Private Google Access is not enabled in the subnet or is
1354+ // not applicable.
12821355 PRIVATE_GOOGLE_ACCESS_DISALLOWED = 8 ;
12831356
12841357 // Source endpoint tries to access Google API and services through the VPN
12851358 // tunnel to another network, but Private Google Access needs to be enabled
12861359 // in the source endpoint network.
12871360 PRIVATE_GOOGLE_ACCESS_VIA_VPN_TUNNEL_UNSUPPORTED = 47 ;
12881361
1289- // Instance with only an internal IP address tries to access external hosts,
1290- // but Cloud NAT is not enabled in the subnet, unless special configurations
1291- // on a VM allow this connection.
1362+ // Endpoint with only an internal IP address tries to access external hosts,
1363+ // but there is no matching Cloud NAT gateway in the subnet.
12921364 NO_EXTERNAL_ADDRESS = 9 ;
12931365
12941366 // Destination internal address cannot be resolved to a known target. If
@@ -1563,6 +1635,22 @@ message DropInfo {
15631635 // Packet with destination IP address within the reserved NAT64 range is
15641636 // dropped due to matching a route of an unsupported type.
15651637 UNSUPPORTED_ROUTE_MATCHED_FOR_NAT64_DESTINATION = 88 ;
1638+
1639+ // Packet could be dropped because hybrid endpoint like a VPN gateway or
1640+ // Interconnect is not allowed to send traffic to the Internet.
1641+ TRAFFIC_FROM_HYBRID_ENDPOINT_TO_INTERNET_DISALLOWED = 89 ;
1642+
1643+ // Packet with destination IP address within the reserved NAT64 range is
1644+ // dropped due to no matching NAT gateway in the subnet.
1645+ NO_MATCHING_NAT64_GATEWAY = 90 ;
1646+
1647+ // Packet is dropped due to being sent to a backend of a passthrough load
1648+ // balancer that doesn't use the same IP version as the frontend.
1649+ LOAD_BALANCER_BACKEND_IP_VERSION_MISMATCH = 96 ;
1650+
1651+ // Packet from the unknown NCC network is dropped due to no known route
1652+ // from the source network to the destination IP address.
1653+ NO_KNOWN_ROUTE_FROM_NCC_NETWORK_TO_DESTINATION = 97 ;
15661654 }
15671655
15681656 // Cause that the packet is dropped.
0 commit comments