feat: Automated regeneration of Spanner client (googleapis#12940)

Auto-created at 2025-02-08 13:09:29 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/spanner/lib/google_api/spanner/v1/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.Spanner.V1 do
   API client metadata for GoogleApi.Spanner.V1.
   """
 
-  @discovery_revision "20250123"
+  @discovery_revision "20250201"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/spanner/lib/google_api/spanner/v1/model/backup.ex

@@ -31,6 +31,7 @@ defmodule GoogleApi.Spanner.V1.Model.Backup do
   *   `expireTime` (*type:* `DateTime.t`, *default:* `nil`) - 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 request is processed. Once the `expire_time` has passed, the backup is eligible to be automatically deleted by Cloud Spanner to free the resources used by the backup.
   *   `freeableSizeBytes` (*type:* `String.t`, *default:* `nil`) - 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.
   *   `incrementalBackupChainId` (*type:* `String.t`, *default:* `nil`) - 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`.
+  *   `instancePartitions` (*type:* `list(GoogleApi.Spanner.V1.Model.BackupInstancePartition.t)`, *default:* `nil`) - Output only. The instance partition(s) storing the backup. This is the same as the list of the instance partition(s) that the database had footprint in at the backup's `version_time`.
   *   `maxExpireTime` (*type:* `DateTime.t`, *default:* `nil`) - 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, CopyBackup. When updating or copying an existing backup, the expiration time specified must be less than `Backup.max_expire_time`.
   *   `name` (*type:* `String.t`, *default:* `nil`) - Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects//instances/`.
   *   `oldestVersionTime` (*type:* `DateTime.t`, *default:* `nil`) - 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.
@@ -54,6 +55,8 @@ defmodule GoogleApi.Spanner.V1.Model.Backup do
           :expireTime => DateTime.t() | nil,
           :freeableSizeBytes => String.t() | nil,
           :incrementalBackupChainId => String.t() | nil,
+          :instancePartitions =>
+            list(GoogleApi.Spanner.V1.Model.BackupInstancePartition.t()) | nil,
           :maxExpireTime => DateTime.t() | nil,
           :name => String.t() | nil,
           :oldestVersionTime => DateTime.t() | nil,
@@ -74,6 +77,7 @@ defmodule GoogleApi.Spanner.V1.Model.Backup do
   field(:expireTime, as: DateTime)
   field(:freeableSizeBytes)
   field(:incrementalBackupChainId)
+  field(:instancePartitions, as: GoogleApi.Spanner.V1.Model.BackupInstancePartition, type: :list)
   field(:maxExpireTime, as: DateTime)
   field(:name)
   field(:oldestVersionTime, as: DateTime)

clients/spanner/lib/google_api/spanner/v1/model/backup_instance_partition.ex

@@ -0,0 +1,46 @@
+# Copyright 2019 Google LLC
+#
+# 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.
+
+# NOTE: This file is auto generated by the elixir code generator program.
+# Do not edit this file manually.
+
+defmodule GoogleApi.Spanner.V1.Model.BackupInstancePartition do
+  @moduledoc """
+  Instance partition information for the backup.
+
+  ## Attributes
+
+  *   `instancePartition` (*type:* `String.t`, *default:* `nil`) - A unique identifier for the instance partition. Values are of the form `projects//instances//instancePartitions/`
+  """
+
+  use GoogleApi.Gax.ModelBase
+
+  @type t :: %__MODULE__{
+          :instancePartition => String.t() | nil
+        }
+
+  field(:instancePartition)
+end
+
+defimpl Poison.Decoder, for: GoogleApi.Spanner.V1.Model.BackupInstancePartition do
+  def decode(value, options) do
+    GoogleApi.Spanner.V1.Model.BackupInstancePartition.decode(value, options)
+  end
+end
+
+defimpl Poison.Encoder, for: GoogleApi.Spanner.V1.Model.BackupInstancePartition do
+  def encode(value, options) do
+    GoogleApi.Gax.ModelBase.encode(value, options)
+  end
+end

clients/spanner/lib/google_api/spanner/v1/model/backup_schedule.ex

@@ -21,7 +21,7 @@ defmodule GoogleApi.Spanner.V1.Model.BackupSchedule do
 
   ## Attributes
 
-  *   `encryptionConfig` (*type:* `GoogleApi.Spanner.V1.Model.CreateBackupEncryptionConfig.t`, *default:* `nil`) - Optional. The encryption configuration that will be used to encrypt the backup. If this field is not specified, the backup will use the same encryption configuration as the database.
+  *   `encryptionConfig` (*type:* `GoogleApi.Spanner.V1.Model.CreateBackupEncryptionConfig.t`, *default:* `nil`) - Optional. The encryption configuration that is used to encrypt the backup. If this field is not specified, the backup uses the same encryption configuration as the database.
   *   `fullBackupSpec` (*type:* `GoogleApi.Spanner.V1.Model.FullBackupSpec.t`, *default:* `nil`) - The schedule creates only full backups.
   *   `incrementalBackupSpec` (*type:* `GoogleApi.Spanner.V1.Model.IncrementalBackupSpec.t`, *default:* `nil`) - The schedule creates incremental backup chains.
   *   `name` (*type:* `String.t`, *default:* `nil`) - Identifier. Output only for the CreateBackupSchedule operation. Required for the UpdateBackupSchedule operation. A globally unique identifier for the backup schedule which cannot be changed. Values are of the form `projects//instances//databases//backupSchedules/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length.

clients/spanner/lib/google_api/spanner/v1/model/crontab_spec.ex

@@ -17,13 +17,13 @@
 
 defmodule GoogleApi.Spanner.V1.Model.CrontabSpec do
   @moduledoc """
-  CrontabSpec can be used to specify the version time and frequency at which the backup should be created.
+  CrontabSpec can be used to specify the version time and frequency at which the backup is created.
 
   ## Attributes
 
-  *   `creationWindow` (*type:* `String.t`, *default:* `nil`) - Output only. Schedule backups will contain an externally consistent copy of the database at the version time specified in `schedule_spec.cron_spec`. However, Spanner may not initiate the creation of the scheduled backups at that version time. Spanner will initiate the creation of scheduled backups within the time window bounded by the version_time specified in `schedule_spec.cron_spec` and version_time + `creation_window`.
-  *   `text` (*type:* `String.t`, *default:* `nil`) - Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timezone. The backup will contain an externally consistent copy of the database at the version time. Full backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours past midnight in UTC. * `0 */4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past midnight in UTC.
-  *   `timeZone` (*type:* `String.t`, *default:* `nil`) - Output only. The time zone of the times in `CrontabSpec.text`. Currently only UTC is supported.
+  *   `creationWindow` (*type:* `String.t`, *default:* `nil`) - Output only. Scheduled backups contain an externally consistent copy of the database at the version time specified in `schedule_spec.cron_spec`. However, Spanner might not initiate the creation of the scheduled backups at that version time. Spanner initiates the creation of scheduled backups within the time window bounded by the version_time specified in `schedule_spec.cron_spec` and version_time + `creation_window`.
+  *   `text` (*type:* `String.t`, *default:* `nil`) - Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timezone. The backup will contain an externally consistent copy of the database at the version time. Full backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 */4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past midnight in UTC.
+  *   `timeZone` (*type:* `String.t`, *default:* `nil`) - Output only. The time zone of the times in `CrontabSpec.text`. Currently, only UTC is supported.
   """
 
   use GoogleApi.Gax.ModelBase