feat: add principal field to BigQuery Reservation Assignment

Google APIs · copybara-github · commit a5bd611f6a80 · 2026-04-13T13:31:44.000-07:00
docs: update the scaling mode documentation to correct an example math error

PiperOrigin-RevId: 899158032
diff --git a/google/cloud/bigquery/reservation/v1/reservation.proto b/google/cloud/bigquery/reservation/v1/reservation.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -560,7 +560,7 @@ message Reservation {
     // reservation will scale up to 1000 slots with 200 baseline and 800 idle
     // slots.
     // 2. if there are 500 idle slots available in other reservations, the
-    // reservation will scale up to 700 slots with 200 baseline and 300 idle
+    // reservation will scale up to 700 slots with 200 baseline and 500 idle
     // slots.
     // Please note, in this mode, the reservation might not be able to scale up
     // to max_slots.
@@ -1406,6 +1406,23 @@ message Assignment {
   // This feature is not yet generally available.
   SchedulingPolicy scheduling_policy = 11
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Represents the principal for this assignment. If not empty, jobs
+  // run by this principal will utilize the associated reservation. Otherwise,
+  // jobs will fall back to using the reservation assigned to the project,
+  // folder, or organization (in that order). If no reservation is assigned at
+  // any of these levels, on-demand capacity will be used.
+  //
+  // The supported formats are:
+  //
+  // * `principal://goog/subject/USER_EMAIL_ADDRESS` for users,
+  // * `principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS`
+  //   for service accounts,
+  // * `principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT_ID`
+  //   for workload identity pool identities.
+  // * The special value `unknown_or_deleted_user` represents principals which
+  //   cannot be read from the user info service, for example deleted users.
+  string principal = 12 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request for
