From 4c364f4b61ac1c4771a17f3ba96dd0bdb0bab0a1 Mon Sep 17 00:00:00 2001
From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com>
Date: Thu, 6 Apr 2023 16:35:39 +0000
Subject: [PATCH] docs: use deprecated=true for deprecated fields (#6024)

PiperOrigin-RevId: 521675703
Source-Link: https://github.com/googleapis/googleapis/commit/8bc5a83d9759f2153f2e62d79dc2a024bcf7a3ac
Source-Link: https://github.com/googleapis/googleapis-gen/commit/3a4cf08318827b8ce36d2e6471ca24ae88c0900f
Copy-Tag: eyJwIjoiQ29tbW9uUHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiIzYTRjZjA4MzE4ODI3YjhjZTM2ZDJlNjQ3MWNhMjRhZTg4YzA5MDBmIn0=

docs: mark ReservationResourceUsage field as deprecated
PiperOrigin-RevId: 521058593
Source-Link: https://github.com/googleapis/googleapis/commit/4c3b682f501bb965d34c3d4fc3461edfccf962db
Source-Link: https://github.com/googleapis/googleapis-gen/commit/9d3275bce3ee4c6b2f6a4529d3cff7e7cdff1ce5
Copy-Tag: eyJwIjoiQ29tbW9uUHJvdG9zLy5Pd2xCb3QueWFtbCIsImgiOiI5ZDMyNzViY2UzZWU0YzZiMmY2YTQ1MjlkM2NmZjdlN2NkZmYxY2U1In0=
---
 .../metadata/Audit/BigqueryAuditMetadata.php  | Bin 15350 -> 15354 bytes
 .../Audit/BigQueryAuditMetadata/JobStats.php  |  23 +++++++++++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/CommonProtos/metadata/Audit/BigqueryAuditMetadata.php b/CommonProtos/metadata/Audit/BigqueryAuditMetadata.php
index 499a2a3cdae51d2e5847cbaa7fadda124d42ac68..c5170cae26d673fc41b80afa571f23bf3192f4e2 100644
GIT binary patch
delta 43
zcmV+`0M!5Xclvj*%>n`Alg<L70hY6I1Gy&wm9r}=rvU+KlhZ6_1VREB0kb(Ry$-Mt
B5Yzww

delta 38
wcmV+>0NMZgclLL%%>n`6lg<L70g|(E1Gy&wk+Ul+rvU+GlhZ6_vpp@n4r1XDX8-^I

diff --git a/CommonProtos/src/Audit/BigQueryAuditMetadata/JobStats.php b/CommonProtos/src/Audit/BigQueryAuditMetadata/JobStats.php
index 60bb387cdff..3b60e8cc6db 100644
--- a/CommonProtos/src/Audit/BigQueryAuditMetadata/JobStats.php
+++ b/CommonProtos/src/Audit/BigQueryAuditMetadata/JobStats.php
@@ -41,8 +41,12 @@ class JobStats extends \Google\Protobuf\Internal\Message
     protected $total_slot_ms = 0;
     /**
      * Reservation usage attributed from each tier of a reservation hierarchy.
+     * This field reported misleading information and will no longer be
+     * populated. Aggregate usage of all jobs submitted to a reservation
+     * should provide a more reliable indicator of reservation imbalance.
      *
-     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11;</code>
+     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11 [deprecated = true];</code>
+     * @deprecated
      */
     private $reservation_usage;
     /**
@@ -75,6 +79,9 @@ class JobStats extends \Google\Protobuf\Internal\Message
      *           The total number of slot-ms consumed by the query job.
      *     @type array<\Google\Cloud\Audit\BigQueryAuditMetadata\JobStats\ReservationResourceUsage>|\Google\Protobuf\Internal\RepeatedField $reservation_usage
      *           Reservation usage attributed from each tier of a reservation hierarchy.
+     *           This field reported misleading information and will no longer be
+     *           populated. Aggregate usage of all jobs submitted to a reservation
+     *           should provide a more reliable indicator of reservation imbalance.
      *     @type string $parent_job_name
      *           Parent job name. Only present for child jobs.
      * }
@@ -313,24 +320,34 @@ public function setTotalSlotMs($var)
 
     /**
      * Reservation usage attributed from each tier of a reservation hierarchy.
+     * This field reported misleading information and will no longer be
+     * populated. Aggregate usage of all jobs submitted to a reservation
+     * should provide a more reliable indicator of reservation imbalance.
      *
-     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11;</code>
+     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11 [deprecated = true];</code>
      * @return \Google\Protobuf\Internal\RepeatedField
+     * @deprecated
      */
     public function getReservationUsage()
     {
+        @trigger_error('reservation_usage is deprecated.', E_USER_DEPRECATED);
         return $this->reservation_usage;
     }
 
     /**
      * Reservation usage attributed from each tier of a reservation hierarchy.
+     * This field reported misleading information and will no longer be
+     * populated. Aggregate usage of all jobs submitted to a reservation
+     * should provide a more reliable indicator of reservation imbalance.
      *
-     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11;</code>
+     * Generated from protobuf field <code>repeated .google.cloud.audit.BigQueryAuditMetadata.JobStats.ReservationResourceUsage reservation_usage = 11 [deprecated = true];</code>
      * @param array<\Google\Cloud\Audit\BigQueryAuditMetadata\JobStats\ReservationResourceUsage>|\Google\Protobuf\Internal\RepeatedField $var
      * @return $this
+     * @deprecated
      */
     public function setReservationUsage($var)
     {
+        @trigger_error('reservation_usage is deprecated.', E_USER_DEPRECATED);
         $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Audit\BigQueryAuditMetadata\JobStats\ReservationResourceUsage::class);
         $this->reservation_usage = $arr;