feat: add PeerInfo proto in Bigtable API

Google APIs · copybara-github · commit 1b5f8632487b · 2025-11-07T14:51:22.000-08:00
PiperOrigin-RevId: 829585900
diff --git a/google/bigtable/v2/BUILD.bazel b/google/bigtable/v2/BUILD.bazel
@@ -44,6 +44,7 @@ proto_library(
         "bigtable.proto",
         "data.proto",
         "feature_flags.proto",
+        "peer_info.proto",
         "request_stats.proto",
         "response_params.proto",
         "types.proto",
diff --git a/google/bigtable/v2/bigtable_v2.yaml b/google/bigtable/v2/bigtable_v2.yaml
@@ -8,6 +8,7 @@ apis:
 
 types:
 - name: google.bigtable.v2.FeatureFlags
+- name: google.bigtable.v2.PeerInfo
 - name: google.bigtable.v2.ProtoRows
 - name: google.bigtable.v2.RequestStats
 - name: google.bigtable.v2.ResponseParams
diff --git a/google/bigtable/v2/feature_flags.proto b/google/bigtable/v2/feature_flags.proto
@@ -67,4 +67,7 @@ message FeatureFlags {
 
   // Notify the server that the client explicitly opted in for Direct Access.
   bool direct_access_requested = 10;
+
+  // If the client can support using BigtablePeerInfo.
+  bool peer_info = 11;
 }
diff --git a/google/bigtable/v2/peer_info.proto b/google/bigtable/v2/peer_info.proto
@@ -0,0 +1,77 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.bigtable.v2;
+
+option csharp_namespace = "Google.Cloud.Bigtable.V2";
+option go_package = "cloud.google.com/go/bigtable/apiv2/bigtablepb;bigtablepb";
+option java_multiple_files = true;
+option java_outer_classname = "PeerInfoProto";
+option java_package = "com.google.bigtable.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\V2";
+option ruby_package = "Google::Cloud::Bigtable::V2";
+
+// PeerInfo contains information about the peer that the client is
+// connecting to.
+message PeerInfo {
+  // The transport type that the client used to connect to this peer.
+  enum TransportType {
+    // The transport type is unknown.
+    TRANSPORT_TYPE_UNKNOWN = 0;
+
+    // The client connected to this peer via an external network
+    // (e.g. outside Google Coud).
+    TRANSPORT_TYPE_EXTERNAL = 1;
+
+    // The client connected to this peer via CloudPath.
+    TRANSPORT_TYPE_CLOUD_PATH = 2;
+
+    // The client connected to this peer via DirectAccess.
+    TRANSPORT_TYPE_DIRECT_ACCESS = 3;
+
+    // The client connected to this peer via Bigtable Sessions using an unknown
+    // transport type.
+    TRANSPORT_TYPE_SESSION_UNKNOWN = 4;
+
+    // The client connected to this peer via Bigtable Sessions on an external
+    // network (e.g. outside Google Cloud).
+    TRANSPORT_TYPE_SESSION_EXTERNAL = 5;
+
+    // The client connected to this peer via Bigtable Sessions using CloudPath.
+    TRANSPORT_TYPE_SESSION_CLOUD_PATH = 6;
+
+    // The client connected to this peer via Bigtable Sessions using
+    // DirectAccess.
+    TRANSPORT_TYPE_SESSION_DIRECT_ACCESS = 7;
+  }
+
+  // An opaque identifier for the Google Frontend which serviced this request.
+  // Only set when not using DirectAccess.
+  int64 google_frontend_id = 1;
+
+  // An opaque identifier for the application frontend which serviced this
+  // request.
+  int64 application_frontend_id = 2;
+
+  // The Cloud zone of the application frontend that served this request.
+  string application_frontend_zone = 3;
+
+  // The subzone of the application frontend that served this request, e.g. an
+  // identifier for where within the zone the application frontend is.
+  string application_frontend_subzone = 4;
+
+  TransportType transport_type = 5;
+}
diff --git a/google/bigtable/v2/response_params.proto b/google/bigtable/v2/response_params.proto
@@ -32,4 +32,7 @@ message ResponseParams {
   // Identifier for a cluster that represents set of
   // bigtable resources.
   optional string cluster_id = 2;
+
+  // The AFE ID for the AFE that is served this request.
+  optional int64 afe_id = 3;
 }

Original file line number	Diff line number	Diff line change
`@@ -67,4 +67,7 @@ message FeatureFlags {`
`67`	`67`
`68`	`68`	`// Notify the server that the client explicitly opted in for Direct Access.`
`69`	`69`	`bool direct_access_requested = 10;`
	`70`	`+`
	`71`	`+ // If the client can support using BigtablePeerInfo.`
	`72`	`+ bool peer_info = 11;`
`70`	`73`	`}`
Original file line number	Diff line number	Diff line change
`@@ -32,4 +32,7 @@ message ResponseParams {`
`32`	`32`	`// Identifier for a cluster that represents set of`
`33`	`33`	`// bigtable resources.`
`34`	`34`	`optional string cluster_id = 2;`
	`35`	`+`
	`36`	`+ // The AFE ID for the AFE that is served this request.`
	`37`	`+ optional int64 afe_id = 3;`
`35`	`38`	`}`