chore: regenerate spanner client (googleapis#22669)

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-rev20240731-2.0.0</version>
+      <version>v1-rev20240807-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-spanner:v1-rev20240731-2.0.0'
+  implementation 'com.google.apis:google-api-services-spanner:v1-rev20240807-2.0.0'
 }
 ```
 

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

@@ -83,6 +83,18 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private java.util.List<EncryptionInfo> encryptionInformation;
 
+  /**
+   * Output only. For a backup in an incremental backup chain, this is the storage space needed to
+   * keep the data that has changed since the previous backup. For all other backups, this is always
+   * the size of the backup. This value may change if backups on the same chain get deleted or
+   * expired. This field can be used to calculate the total storage space used by a set of backups.
+   * For example, the total space used by all backups of a database can be computed by summing up
+   * this field.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key @com.google.api.client.json.JsonString
+  private java.lang.Long exclusiveSizeBytes;
+
   /**
    * Required for the CreateBackup operation. The expiration time of the backup, with microseconds
    * granularity that must be at least 6 hours and at most 366 days from the time the CreateBackup
@@ -93,6 +105,27 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private String expireTime;
 
+  /**
+   * Output only. The number of bytes that will be freed by deleting this backup. This value will be
+   * zero if, for example, this backup is part of an incremental backup chain and younger backups in
+   * the chain require that we keep its data. For backups not in an incremental backup chain, this
+   * is always the size of the backup. This value may change if backups on the same chain get
+   * created, deleted or expired.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key @com.google.api.client.json.JsonString
+  private java.lang.Long freeableSizeBytes;
+
+  /**
+   * Output only. Populated only for backups in an incremental backup chain. Backups share the same
+   * chain id if and only if they belong to the same incremental backup chain. Use this field to
+   * determine which backups are part of the same incremental backup chain. The ordering of backups
+   * in the chain can be determined by ordering the backup `version_time`.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String incrementalBackupChainId;
+
   /**
    * Output only. The max allowed expiration time of the backup, with microseconds granularity. A
    * backup's expiration time can be configured in multiple APIs: CreateBackup, UpdateBackup,
@@ -115,6 +148,17 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private java.lang.String name;
 
+  /**
+   * Output only. Data deleted at a time older than this is guaranteed not to be retained in order
+   * to support this backup. For a backup in an incremental backup chain, this is the version time
+   * of the oldest backup that exists or ever existed in the chain. For all other backups, this is
+   * the version time of the backup. This field can be used to understand what data is being
+   * retained by the backup system.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private String oldestVersionTime;
+
   /**
    * Output only. The names of the destination backups being created by copying this source backup.
    * The backup names are of the form `projects//instances//backups/`. Referencing backups may exist
@@ -138,7 +182,8 @@ public final class Backup extends com.google.api.client.json.GenericJson {
   private java.util.List<java.lang.String> referencingDatabases;
 
   /**
-   * Output only. Size of the backup in bytes.
+   * Output only. Size of the backup in bytes. For a backup in an incremental backup chain, this is
+   * the sum of the `exclusive_size_bytes` of itself and all older backups in the chain.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key @com.google.api.client.json.JsonString
@@ -286,6 +331,33 @@ public Backup setEncryptionInformation(java.util.List<EncryptionInfo> encryption
     return this;
   }
 
+  /**
+   * Output only. For a backup in an incremental backup chain, this is the storage space needed to
+   * keep the data that has changed since the previous backup. For all other backups, this is always
+   * the size of the backup. This value may change if backups on the same chain get deleted or
+   * expired. This field can be used to calculate the total storage space used by a set of backups.
+   * For example, the total space used by all backups of a database can be computed by summing up
+   * this field.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Long getExclusiveSizeBytes() {
+    return exclusiveSizeBytes;
+  }
+
+  /**
+   * Output only. For a backup in an incremental backup chain, this is the storage space needed to
+   * keep the data that has changed since the previous backup. For all other backups, this is always
+   * the size of the backup. This value may change if backups on the same chain get deleted or
+   * expired. This field can be used to calculate the total storage space used by a set of backups.
+   * For example, the total space used by all backups of a database can be computed by summing up
+   * this field.
+   * @param exclusiveSizeBytes exclusiveSizeBytes or {@code null} for none
+   */
+  public Backup setExclusiveSizeBytes(java.lang.Long exclusiveSizeBytes) {
+    this.exclusiveSizeBytes = exclusiveSizeBytes;
+    return this;
+  }
+
   /**
    * Required for the CreateBackup operation. The expiration time of the backup, with microseconds
    * granularity that must be at least 6 hours and at most 366 days from the time the CreateBackup
@@ -309,6 +381,54 @@ public Backup setExpireTime(String expireTime) {
     return this;
   }
 
+  /**
+   * Output only. The number of bytes that will be freed by deleting this backup. This value will be
+   * zero if, for example, this backup is part of an incremental backup chain and younger backups in
+   * the chain require that we keep its data. For backups not in an incremental backup chain, this
+   * is always the size of the backup. This value may change if backups on the same chain get
+   * created, deleted or expired.
+   * @return value or {@code null} for none
+   */
+  public java.lang.Long getFreeableSizeBytes() {
+    return freeableSizeBytes;
+  }
+
+  /**
+   * Output only. The number of bytes that will be freed by deleting this backup. This value will be
+   * zero if, for example, this backup is part of an incremental backup chain and younger backups in
+   * the chain require that we keep its data. For backups not in an incremental backup chain, this
+   * is always the size of the backup. This value may change if backups on the same chain get
+   * created, deleted or expired.
+   * @param freeableSizeBytes freeableSizeBytes or {@code null} for none
+   */
+  public Backup setFreeableSizeBytes(java.lang.Long freeableSizeBytes) {
+    this.freeableSizeBytes = freeableSizeBytes;
+    return this;
+  }
+
+  /**
+   * Output only. Populated only for backups in an incremental backup chain. Backups share the same
+   * chain id if and only if they belong to the same incremental backup chain. Use this field to
+   * determine which backups are part of the same incremental backup chain. The ordering of backups
+   * in the chain can be determined by ordering the backup `version_time`.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getIncrementalBackupChainId() {
+    return incrementalBackupChainId;
+  }
+
+  /**
+   * Output only. Populated only for backups in an incremental backup chain. Backups share the same
+   * chain id if and only if they belong to the same incremental backup chain. Use this field to
+   * determine which backups are part of the same incremental backup chain. The ordering of backups
+   * in the chain can be determined by ordering the backup `version_time`.
+   * @param incrementalBackupChainId incrementalBackupChainId or {@code null} for none
+   */
+  public Backup setIncrementalBackupChainId(java.lang.String incrementalBackupChainId) {
+    this.incrementalBackupChainId = incrementalBackupChainId;
+    return this;
+  }
+
   /**
    * Output only. The max allowed expiration time of the backup, with microseconds granularity. A
    * backup's expiration time can be configured in multiple APIs: CreateBackup, UpdateBackup,
@@ -359,6 +479,31 @@ public Backup setName(java.lang.String name) {
     return this;
   }
 
+  /**
+   * Output only. Data deleted at a time older than this is guaranteed not to be retained in order
+   * to support this backup. For a backup in an incremental backup chain, this is the version time
+   * of the oldest backup that exists or ever existed in the chain. For all other backups, this is
+   * the version time of the backup. This field can be used to understand what data is being
+   * retained by the backup system.
+   * @return value or {@code null} for none
+   */
+  public String getOldestVersionTime() {
+    return oldestVersionTime;
+  }
+
+  /**
+   * Output only. Data deleted at a time older than this is guaranteed not to be retained in order
+   * to support this backup. For a backup in an incremental backup chain, this is the version time
+   * of the oldest backup that exists or ever existed in the chain. For all other backups, this is
+   * the version time of the backup. This field can be used to understand what data is being
+   * retained by the backup system.
+   * @param oldestVersionTime oldestVersionTime or {@code null} for none
+   */
+  public Backup setOldestVersionTime(String oldestVersionTime) {
+    this.oldestVersionTime = oldestVersionTime;
+    return this;
+  }
+
   /**
    * Output only. The names of the destination backups being created by copying this source backup.
    * The backup names are of the form `projects//instances//backups/`. Referencing backups may exist
@@ -410,15 +555,17 @@ public Backup setReferencingDatabases(java.util.List<java.lang.String> referenci
   }
 
   /**
-   * Output only. Size of the backup in bytes.
+   * Output only. Size of the backup in bytes. For a backup in an incremental backup chain, this is
+   * the sum of the `exclusive_size_bytes` of itself and all older backups in the chain.
    * @return value or {@code null} for none
    */
   public java.lang.Long getSizeBytes() {
     return sizeBytes;
   }
 
   /**
-   * Output only. Size of the backup in bytes.
+   * Output only. Size of the backup in bytes. For a backup in an incremental backup chain, this is
+   * the sum of the `exclusive_size_bytes` of itself and all older backups in the chain.
    * @param sizeBytes sizeBytes or {@code null} for none
    */
   public Backup setSizeBytes(java.lang.Long sizeBytes) {

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

@@ -45,6 +45,13 @@ public final class BackupSchedule extends com.google.api.client.json.GenericJson
   @com.google.api.client.util.Key
   private FullBackupSpec fullBackupSpec;
 
+  /**
+   * The schedule creates incremental backup chains.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private IncrementalBackupSpec incrementalBackupSpec;
+
   /**
    * Identifier. Output only for the CreateBackupSchedule operation. Required for the
    * UpdateBackupSchedule operation. A globally unique identifier for the backup schedule which
@@ -115,6 +122,23 @@ public BackupSchedule setFullBackupSpec(FullBackupSpec fullBackupSpec) {
     return this;
   }
 
+  /**
+   * The schedule creates incremental backup chains.
+   * @return value or {@code null} for none
+   */
+  public IncrementalBackupSpec getIncrementalBackupSpec() {
+    return incrementalBackupSpec;
+  }
+
+  /**
+   * The schedule creates incremental backup chains.
+   * @param incrementalBackupSpec incrementalBackupSpec or {@code null} for none
+   */
+  public BackupSchedule setIncrementalBackupSpec(IncrementalBackupSpec incrementalBackupSpec) {
+    this.incrementalBackupSpec = incrementalBackupSpec;
+    return this;
+  }
+
   /**
    * Identifier. Output only for the CreateBackupSchedule operation. Required for the
    * UpdateBackupSchedule operation. A globally unique identifier for the backup schedule which

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

@@ -30,9 +30,9 @@
 public final class CreateInstanceConfigRequest extends com.google.api.client.json.GenericJson {
 
   /**
-   * Required. The InstanceConfig proto of the configuration to create. instance_config.name must be
-   * `/instanceConfigs/`. instance_config.base_config must be a Google-managed configuration name,
-   * e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
+   * Required. The `InstanceConfig` proto of the configuration to create. `instance_config.name`
+   * must be `/instanceConfigs/`. `instance_config.base_config` must be a Google-managed
+   * configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -55,19 +55,19 @@ public final class CreateInstanceConfigRequest extends com.google.api.client.jso
   private java.lang.Boolean validateOnly;
 
   /**
-   * Required. The InstanceConfig proto of the configuration to create. instance_config.name must be
-   * `/instanceConfigs/`. instance_config.base_config must be a Google-managed configuration name,
-   * e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
+   * Required. The `InstanceConfig` proto of the configuration to create. `instance_config.name`
+   * must be `/instanceConfigs/`. `instance_config.base_config` must be a Google-managed
+   * configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
    * @return value or {@code null} for none
    */
   public InstanceConfig getInstanceConfig() {
     return instanceConfig;
   }
 
   /**
-   * Required. The InstanceConfig proto of the configuration to create. instance_config.name must be
-   * `/instanceConfigs/`. instance_config.base_config must be a Google-managed configuration name,
-   * e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
+   * Required. The `InstanceConfig` proto of the configuration to create. `instance_config.name`
+   * must be `/instanceConfigs/`. `instance_config.base_config` must be a Google-managed
+   * configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3.
    * @param instanceConfig instanceConfig or {@code null} for none
    */
   public CreateInstanceConfigRequest setInstanceConfig(InstanceConfig instanceConfig) {

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

@@ -0,0 +1,45 @@
+/*
+ * 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.
+ */
+/*
+ * This code was generated by https://github.com/googleapis/google-api-java-client-services/
+ * Modify at your own risk.
+ */
+
+package com.google.api.services.spanner.v1.model;
+
+/**
+ * The specification for incremental backup chains. An incremental backup stores the delta of
+ * changes between a previous backup and the database contents at a given version time. An
+ * incremental backup chain consists of a full backup and zero or more successive incremental
+ * backups. The first backup created for an incremental backup chain is always a full backup.
+ *
+ * <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:
+ * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a>
+ * </p>
+ *
+ * @author Google, Inc.
+ */
+@SuppressWarnings("javadoc")
+public final class IncrementalBackupSpec extends com.google.api.client.json.GenericJson {
+
+  @Override
+  public IncrementalBackupSpec set(String fieldName, Object value) {
+    return (IncrementalBackupSpec) super.set(fieldName, value);
+  }
+
+  @Override
+  public IncrementalBackupSpec clone() {
+    return (IncrementalBackupSpec) super.clone();
+  }
+
+}