docs: mention that some fields are deprecated

Google APIs · copybara-github · commit 26b4d270d2c8 · 2023-03-27T10:06:01.000-07:00
PiperOrigin-RevId: 519755058
diff --git a/google/cloud/bigquery/reservation/v1/reservation.proto b/google/cloud/bigquery/reservation/v1/reservation.proto
@@ -32,7 +32,7 @@ option java_outer_classname = "ReservationProto";
 option java_package = "com.google.cloud.bigquery.reservation.v1";
 option php_namespace = "Google\\Cloud\\BigQuery\\Reservation\\V1";
 
-// This API allows users to manage their flat-rate BigQuery reservations.
+// This API allows users to manage their BigQuery reservations.
 //
 // A reservation provides computational resource guarantees, in the form of
 // [slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a
@@ -465,6 +465,9 @@ message Reservation {
   // If set to true, this reservation is placed in the organization's
   // secondary region which is designated for disaster recovery purposes.
   // If false, this reservation is placed in the organization's default region.
+  //
+  // NOTE: this is a preview feature. Project must be allow-listed in order to
+  // set this field.
   bool multi_region_auxiliary = 14;
 
   // Edition of the reservation.
@@ -501,7 +504,7 @@ message CapacityCommitment {
 
     // Same as FLEX, should only be used if flat-rate commitments are still
     // available.
-    FLEX_FLAT_RATE = 7;
+    FLEX_FLAT_RATE = 7 [deprecated = true];
 
     // Trial commitments have a committed period of 182 days after becoming
     // ACTIVE. After that, they are converted to a new commitment based on the
@@ -516,7 +519,7 @@ message CapacityCommitment {
 
     // Same as MONTHLY, should only be used if flat-rate commitments are still
     // available.
-    MONTHLY_FLAT_RATE = 8;
+    MONTHLY_FLAT_RATE = 8 [deprecated = true];
 
     // Annual commitments have a committed period of 365 days after becoming
     // ACTIVE. After that they are converted to a new commitment based on the
@@ -525,7 +528,7 @@ message CapacityCommitment {
 
     // Same as ANNUAL, should only be used if flat-rate commitments are still
     // available.
-    ANNUAL_FLAT_RATE = 9;
+    ANNUAL_FLAT_RATE = 9 [deprecated = true];
 
     // 3-year commitments have a committed period of 1095(3 * 365) days after
     // becoming ACTIVE. After that they are converted to a new commitment based
@@ -600,6 +603,9 @@ message CapacityCommitment {
   // If set to true, this commitment is placed in the organization's
   // secondary region which is designated for disaster recovery purposes.
   // If false, this commitment is placed in the organization's default region.
+  //
+  // NOTE: this is a preview feature. Project must be allow-listed in order to
+  // set this field.
   bool multi_region_auxiliary = 10;
 
   // Edition of the capacity commitment.
