chore: regenerate spanner client (googleapis#22610)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

clients/google-api-services-spanner/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-spanner</artifactId>
-      <version>v1-rev20240719-2.0.0</version>
+      <version>v1-rev20240731-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-spanner:v1-rev20240719-2.0.0'
+  implementation 'com.google.apis:google-api-services-spanner:v1-rev20240731-2.0.0'
 }
 ```
 

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/Spanner.java

@@ -7074,19 +7074,19 @@ public Databases databases() {
       public class Databases {
 
         /**
-         * ChangeQuorum is strictly restricted to databases that use dual region instance configurations.
-         * Initiates a background operation to change quorum a database from dual-region mode to single-
-         * region mode and vice versa. The returned long-running operation will have a name of the format
+         * `ChangeQuorum` is strictly restricted to databases that use dual-region instance configurations.
+         * Initiates a background operation to change the quorum of a database from dual-region mode to
+         * single-region mode or vice versa. The returned long-running operation has a name of the format
          * `projects//instances//databases//operations/` and can be used to track execution of the
-         * ChangeQuorum. The metadata field type is ChangeQuorumMetadata. Authorization requires
+         * `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires
          * `spanner.databases.changequorum` permission on the resource database.
          *
          * Create a request for the method "databases.changequorum".
          *
          * This request holds the parameters needed by the spanner server.  After setting any optional
          * parameters, call the {@link Changequorum#execute()} method to invoke the remote operation.
          *
-         * @param name Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+         * @param name Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
          *        `projects//instances//databases/`.
          * @param content the {@link com.google.api.services.spanner.v1.model.ChangeQuorumRequest}
          * @return the request
@@ -7105,11 +7105,11 @@ public class Changequorum extends SpannerRequest<com.google.api.services.spanner
               java.util.regex.Pattern.compile("^projects/[^/]+/instances/[^/]+/databases/[^/]+$");
 
           /**
-           * ChangeQuorum is strictly restricted to databases that use dual region instance configurations.
-           * Initiates a background operation to change quorum a database from dual-region mode to single-
-           * region mode and vice versa. The returned long-running operation will have a name of the format
-           * `projects//instances//databases//operations/` and can be used to track execution of the
-           * ChangeQuorum. The metadata field type is ChangeQuorumMetadata. Authorization requires
+           * `ChangeQuorum` is strictly restricted to databases that use dual-region instance
+           * configurations. Initiates a background operation to change the quorum of a database from dual-
+           * region mode to single-region mode or vice versa. The returned long-running operation has a name
+           * of the format `projects//instances//databases//operations/` and can be used to track execution
+           * of the `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires
            * `spanner.databases.changequorum` permission on the resource database.
            *
            * Create a request for the method "databases.changequorum".
@@ -7120,7 +7120,7 @@ public class Changequorum extends SpannerRequest<com.google.api.services.spanner
            * Changequorum#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)}
            * must be called to initialize this instance immediately after invoking the constructor. </p>
            *
-           * @param name Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+           * @param name Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
          *        `projects//instances//databases/`.
            * @param content the {@link com.google.api.services.spanner.v1.model.ChangeQuorumRequest}
            * @since 1.13
@@ -7191,22 +7191,22 @@ public Changequorum setUploadProtocol(java.lang.String uploadProtocol) {
           }
 
           /**
-           * Required. Name of the database in which to apply the ChangeQuorum. Values are of the
-           * form `projects//instances//databases/`.
+           * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
+           * `projects//instances//databases/`.
            */
           @com.google.api.client.util.Key
           private java.lang.String name;
 
-          /** Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+          /** Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
          `projects//instances//databases/`.
            */
           public java.lang.String getName() {
             return name;
           }
 
           /**
-           * Required. Name of the database in which to apply the ChangeQuorum. Values are of the
-           * form `projects//instances//databases/`.
+           * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
+           * `projects//instances//databases/`.
            */
           public Changequorum setName(java.lang.String name) {
             if (!getSuppressPatternChecks()) {

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/ChangeQuorumRequest.java

@@ -30,9 +30,9 @@
 public final class ChangeQuorumRequest extends com.google.api.client.json.GenericJson {
 
   /**
-   * Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be
-   * performed if the etag matches that of the QuorumInfo in the current database resource.
-   * Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency
+   * Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only
+   * performed if the etag matches that of the `QuorumInfo` in the current database resource.
+   * Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency
    * control as a way to help prevent simultaneous change quorum requests that could create a race
    * condition.
    * The value may be {@code null}.
@@ -41,24 +41,24 @@ public final class ChangeQuorumRequest extends com.google.api.client.json.Generi
   private java.lang.String etag;
 
   /**
-   * Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+   * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
    * `projects//instances//databases/`.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String name;
 
   /**
-   * Required. The type of this Quorum.
+   * Required. The type of this quorum.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private QuorumType quorumType;
 
   /**
-   * Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be
-   * performed if the etag matches that of the QuorumInfo in the current database resource.
-   * Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency
+   * Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only
+   * performed if the etag matches that of the `QuorumInfo` in the current database resource.
+   * Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency
    * control as a way to help prevent simultaneous change quorum requests that could create a race
    * condition.
    * @return value or {@code null} for none
@@ -68,9 +68,9 @@ public java.lang.String getEtag() {
   }
 
   /**
-   * Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be
-   * performed if the etag matches that of the QuorumInfo in the current database resource.
-   * Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency
+   * Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only
+   * performed if the etag matches that of the `QuorumInfo` in the current database resource.
+   * Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency
    * control as a way to help prevent simultaneous change quorum requests that could create a race
    * condition.
    * @param etag etag or {@code null} for none
@@ -81,7 +81,7 @@ public ChangeQuorumRequest setEtag(java.lang.String etag) {
   }
 
   /**
-   * Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+   * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
    * `projects//instances//databases/`.
    * @return value or {@code null} for none
    */
@@ -90,7 +90,7 @@ public java.lang.String getName() {
   }
 
   /**
-   * Required. Name of the database in which to apply the ChangeQuorum. Values are of the form
+   * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form
    * `projects//instances//databases/`.
    * @param name name or {@code null} for none
    */
@@ -100,15 +100,15 @@ public ChangeQuorumRequest setName(java.lang.String name) {
   }
 
   /**
-   * Required. The type of this Quorum.
+   * Required. The type of this quorum.
    * @return value or {@code null} for none
    */
   public QuorumType getQuorumType() {
     return quorumType;
   }
 
   /**
-   * Required. The type of this Quorum.
+   * Required. The type of this quorum.
    * @param quorumType quorumType or {@code null} for none
    */
   public ChangeQuorumRequest setQuorumType(QuorumType quorumType) {

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/Database.java

@@ -102,7 +102,7 @@ public final class Database extends com.google.api.client.json.GenericJson {
   private java.lang.String name;
 
   /**
-   * Output only. Applicable only for databases that use dual region instance configurations.
+   * Output only. Applicable only for databases that use dual-region instance configurations.
    * Contains information about the quorum.
    * The value may be {@code null}.
    */
@@ -310,7 +310,7 @@ public Database setName(java.lang.String name) {
   }
 
   /**
-   * Output only. Applicable only for databases that use dual region instance configurations.
+   * Output only. Applicable only for databases that use dual-region instance configurations.
    * Contains information about the quorum.
    * @return value or {@code null} for none
    */
@@ -319,7 +319,7 @@ public QuorumInfo getQuorumInfo() {
   }
 
   /**
-   * Output only. Applicable only for databases that use dual region instance configurations.
+   * Output only. Applicable only for databases that use dual-region instance configurations.
    * Contains information about the quorum.
    * @param quorumInfo quorumInfo or {@code null} for none
    */

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/InstancePartition.java

@@ -96,9 +96,9 @@ public final class InstancePartition extends com.google.api.client.json.GenericJ
   private java.lang.Integer processingUnits;
 
   /**
-   * Output only. The names of the backups that reference this instance partition. Referencing
-   * backups should share the parent instance. The existence of any referencing backup prevents the
-   * instance partition from being deleted.
+   * Output only. Deprecated: This field is not populated. Output only. The names of the backups
+   * that reference this instance partition. Referencing backups should share the parent instance.
+   * The existence of any referencing backup prevents the instance partition from being deleted.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -281,19 +281,19 @@ public InstancePartition setProcessingUnits(java.lang.Integer processingUnits) {
   }
 
   /**
-   * Output only. The names of the backups that reference this instance partition. Referencing
-   * backups should share the parent instance. The existence of any referencing backup prevents the
-   * instance partition from being deleted.
+   * Output only. Deprecated: This field is not populated. Output only. The names of the backups
+   * that reference this instance partition. Referencing backups should share the parent instance.
+   * The existence of any referencing backup prevents the instance partition from being deleted.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getReferencingBackups() {
     return referencingBackups;
   }
 
   /**
-   * Output only. The names of the backups that reference this instance partition. Referencing
-   * backups should share the parent instance. The existence of any referencing backup prevents the
-   * instance partition from being deleted.
+   * Output only. Deprecated: This field is not populated. Output only. The names of the backups
+   * that reference this instance partition. Referencing backups should share the parent instance.
+   * The existence of any referencing backup prevents the instance partition from being deleted.
    * @param referencingBackups referencingBackups or {@code null} for none
    */
   public InstancePartition setReferencingBackups(java.util.List<java.lang.String> referencingBackups) {

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/QuorumInfo.java

@@ -17,7 +17,7 @@
 package com.google.api.services.spanner.v1.model;
 
 /**
- * Information about the dual region quorum.
+ * Information about the dual-region quorum.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Spanner API. For a detailed explanation see:
@@ -31,14 +31,14 @@ public final class QuorumInfo extends com.google.api.client.json.GenericJson {
 
   /**
    * Output only. The etag is used for optimistic concurrency control as a way to help prevent
-   * simultaneous ChangeQuorum requests that could create a race condition.
+   * simultaneous `ChangeQuorum` requests that might create a race condition.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String etag;
 
   /**
-   * Output only. Whether this ChangeQuorum is a Google or User initiated.
+   * Output only. Whether this `ChangeQuorum` is Google or User initiated.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -61,7 +61,7 @@ public final class QuorumInfo extends com.google.api.client.json.GenericJson {
 
   /**
    * Output only. The etag is used for optimistic concurrency control as a way to help prevent
-   * simultaneous ChangeQuorum requests that could create a race condition.
+   * simultaneous `ChangeQuorum` requests that might create a race condition.
    * @return value or {@code null} for none
    */
   public java.lang.String getEtag() {
@@ -70,7 +70,7 @@ public java.lang.String getEtag() {
 
   /**
    * Output only. The etag is used for optimistic concurrency control as a way to help prevent
-   * simultaneous ChangeQuorum requests that could create a race condition.
+   * simultaneous `ChangeQuorum` requests that might create a race condition.
    * @param etag etag or {@code null} for none
    */
   public QuorumInfo setEtag(java.lang.String etag) {
@@ -79,15 +79,15 @@ public QuorumInfo setEtag(java.lang.String etag) {
   }
 
   /**
-   * Output only. Whether this ChangeQuorum is a Google or User initiated.
+   * Output only. Whether this `ChangeQuorum` is Google or User initiated.
    * @return value or {@code null} for none
    */
   public java.lang.String getInitiator() {
     return initiator;
   }
 
   /**
-   * Output only. Whether this ChangeQuorum is a Google or User initiated.
+   * Output only. Whether this `ChangeQuorum` is Google or User initiated.
    * @param initiator initiator or {@code null} for none
    */
   public QuorumInfo setInitiator(java.lang.String initiator) {

clients/google-api-services-spanner/v1/2.0.0/com/google/api/services/spanner/v1/model/QuorumType.java

@@ -17,7 +17,7 @@
 package com.google.api.services.spanner.v1.model;
 
 /**
- * Information about the database quorum type. this applies only for dual region instance configs.
+ * Information about the database quorum type. This only applies to dual-region instance configs.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Spanner API. For a detailed explanation see:
@@ -30,29 +30,29 @@
 public final class QuorumType extends com.google.api.client.json.GenericJson {
 
   /**
-   * Dual region quorum type.
+   * Dual-region quorum type.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private DualRegionQuorum dualRegion;
 
   /**
-   * Single region quorum type.
+   * Single-region quorum type.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private SingleRegionQuorum singleRegion;
 
   /**
-   * Dual region quorum type.
+   * Dual-region quorum type.
    * @return value or {@code null} for none
    */
   public DualRegionQuorum getDualRegion() {
     return dualRegion;
   }
 
   /**
-   * Dual region quorum type.
+   * Dual-region quorum type.
    * @param dualRegion dualRegion or {@code null} for none
    */
   public QuorumType setDualRegion(DualRegionQuorum dualRegion) {
@@ -61,15 +61,15 @@ public QuorumType setDualRegion(DualRegionQuorum dualRegion) {
   }
 
   /**
-   * Single region quorum type.
+   * Single-region quorum type.
    * @return value or {@code null} for none
    */
   public SingleRegionQuorum getSingleRegion() {
     return singleRegion;
   }
 
   /**
-   * Single region quorum type.
+   * Single-region quorum type.
    * @param singleRegion singleRegion or {@code null} for none
    */
   public QuorumType setSingleRegion(SingleRegionQuorum singleRegion) {