google-apis-sqladmin_v1beta4 0.77.0 → 0.79.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f3be5314677afaf50779a60de2bb900c6e9e7b6e3c6fa998e2020126f8f468ad
4
- data.tar.gz: b95ed83e438f2381f977a053cac25e2006722ba1efa14380a8f6b3ced7406680
3
+ metadata.gz: b99b52407b5917b83cfb8f581f34094a95559dc0800245d30665f3eced59c629
4
+ data.tar.gz: 8d5203b89051fac0cd3f1850a3311053fcbda9ad59d93f33ef3d5a92db0b583f
5
5
  SHA512:
6
- metadata.gz: b4986c56c858363809f82d2fdb53dacc144d89d8088068c349bc8debddafb23f8e8142a019493a72e3936beca30b579aee9d12680dbac8ab7085ef154ef82224
7
- data.tar.gz: 372b0588589bbe3912f16482a0fe1df9552ece4027b19bb4ec442e263016ead88d6737ebc5121d7c2b301e9e40502c950b0db43d19d2f8e088a3456145d1a7ac
6
+ metadata.gz: 1cb6c7914ee6128e486d1048f2852be82cd6e965ac401613f78b3fc30eba41bf44607116a021bd5f3d4cf230ef29d37c6cb091b52f07c05d30ae854879ceacfc
7
+ data.tar.gz: de5234e002cfb75c28c43e62420f6599ce46477533ae7583e5714b043d3106ccd717597cca9beb117b0f822f55c26760e2d3406e3d57602ce931e332f6aec812
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-sqladmin_v1beta4
2
2
 
3
+ ### v0.79.0 (2025-03-09)
4
+
5
+ * Regenerated from discovery document revision 20250226
6
+
7
+ ### v0.78.0 (2025-03-02)
8
+
9
+ * Regenerated from discovery document revision 20250216
10
+ * Regenerated using generator version 0.16.0
11
+
3
12
  ### v0.77.0 (2025-01-05)
4
13
 
5
14
  * Regenerated from discovery document revision 20241210
@@ -181,6 +181,167 @@ module Google
181
181
  end
182
182
  end
183
183
 
184
+ # A backup resource.
185
+ class Backup
186
+ include Google::Apis::Core::Hashable
187
+
188
+ # Represents a time interval, encoded as a Timestamp start (inclusive) and a
189
+ # Timestamp end (exclusive). The start must be less than or equal to the end.
190
+ # When the start equals the end, the interval is empty (matches no time). When
191
+ # both start and end are unspecified, the interval matches any time.
192
+ # Corresponds to the JSON property `backupInterval`
193
+ # @return [Google::Apis::SqladminV1beta4::Interval]
194
+ attr_accessor :backup_interval
195
+
196
+ # Output only. Specifies the kind of backup, PHYSICAL or DEFAULT_SNAPSHOT.
197
+ # Corresponds to the JSON property `backupKind`
198
+ # @return [String]
199
+ attr_accessor :backup_kind
200
+
201
+ # Output only. The mapping to backup run resource used for IAM validations.
202
+ # Corresponds to the JSON property `backupRun`
203
+ # @return [String]
204
+ attr_accessor :backup_run
205
+
206
+ # The description of this backup.
207
+ # Corresponds to the JSON property `description`
208
+ # @return [String]
209
+ attr_accessor :description
210
+
211
+ # Database instance operation error.
212
+ # Corresponds to the JSON property `error`
213
+ # @return [Google::Apis::SqladminV1beta4::OperationError]
214
+ attr_accessor :error
215
+
216
+ # Backup expiration time. A UTC timestamp of when this resource expired.
217
+ # Corresponds to the JSON property `expiryTime`
218
+ # @return [String]
219
+ attr_accessor :expiry_time
220
+
221
+ # The name of the database instance.
222
+ # Corresponds to the JSON property `instance`
223
+ # @return [String]
224
+ attr_accessor :instance
225
+
226
+ # Optional. Output only. Timestamp in UTC of when the instance associated with
227
+ # this backup is deleted.
228
+ # Corresponds to the JSON property `instanceDeletionTime`
229
+ # @return [String]
230
+ attr_accessor :instance_deletion_time
231
+
232
+ # A Cloud SQL instance resource.
233
+ # Corresponds to the JSON property `instanceSettings`
234
+ # @return [Google::Apis::SqladminV1beta4::DatabaseInstance]
235
+ attr_accessor :instance_settings
236
+
237
+ # Output only. This is always `sql#backup`.
238
+ # Corresponds to the JSON property `kind`
239
+ # @return [String]
240
+ attr_accessor :kind
241
+
242
+ # Output only. This output contains the encryption configuration for a backup
243
+ # and the resource name of the KMS key for disk encryption.
244
+ # Corresponds to the JSON property `kmsKey`
245
+ # @return [String]
246
+ attr_accessor :kms_key
247
+
248
+ # Output only. This output contains the encryption status for a backup and the
249
+ # version of the KMS key that's used to encrypt the Cloud SQL instance.
250
+ # Corresponds to the JSON property `kmsKeyVersion`
251
+ # @return [String]
252
+ attr_accessor :kms_key_version
253
+
254
+ # The storage location of the backups. The location can be multi-regional.
255
+ # Corresponds to the JSON property `location`
256
+ # @return [String]
257
+ attr_accessor :location
258
+
259
+ # Output only. The maximum chargeable bytes for the backup.
260
+ # Corresponds to the JSON property `maxChargeableBytes`
261
+ # @return [Fixnum]
262
+ attr_accessor :max_chargeable_bytes
263
+
264
+ # Output only. The resource name of the backup. Format: projects/`project`/
265
+ # backups/`backup`.
266
+ # Corresponds to the JSON property `name`
267
+ # @return [String]
268
+ attr_accessor :name
269
+
270
+ # Output only. This status indicates whether the backup satisfies PZI. The
271
+ # status is reserved for future use.
272
+ # Corresponds to the JSON property `satisfiesPzi`
273
+ # @return [Boolean]
274
+ attr_accessor :satisfies_pzi
275
+ alias_method :satisfies_pzi?, :satisfies_pzi
276
+
277
+ # Output only. This status indicates whether the backup satisfies PZS. The
278
+ # status is reserved for future use.
279
+ # Corresponds to the JSON property `satisfiesPzs`
280
+ # @return [Boolean]
281
+ attr_accessor :satisfies_pzs
282
+ alias_method :satisfies_pzs?, :satisfies_pzs
283
+
284
+ # Output only. The URI of this resource.
285
+ # Corresponds to the JSON property `selfLink`
286
+ # @return [String]
287
+ attr_accessor :self_link
288
+
289
+ # Output only. The state of this backup.
290
+ # Corresponds to the JSON property `state`
291
+ # @return [String]
292
+ attr_accessor :state
293
+
294
+ # Output only. This output contains a backup time zone. If a Cloud SQL for SQL
295
+ # Server instance has a different time zone from the backup's time zone, then
296
+ # the restore to the instance doesn't happen.
297
+ # Corresponds to the JSON property `timeZone`
298
+ # @return [String]
299
+ attr_accessor :time_zone
300
+
301
+ # Input only. The time-to-live (TTL) interval for this resource (in days). For
302
+ # example: ttlDays:7, means 7 days from the current time. The expiration time
303
+ # can't exceed 365 days from the time that the backup is created.
304
+ # Corresponds to the JSON property `ttlDays`
305
+ # @return [Fixnum]
306
+ attr_accessor :ttl_days
307
+
308
+ # Output only. The type of this backup. The type can be "AUTOMATED", "ON_DEMAND",
309
+ # or “FINAL”.
310
+ # Corresponds to the JSON property `type`
311
+ # @return [String]
312
+ attr_accessor :type
313
+
314
+ def initialize(**args)
315
+ update!(**args)
316
+ end
317
+
318
+ # Update properties of this object
319
+ def update!(**args)
320
+ @backup_interval = args[:backup_interval] if args.key?(:backup_interval)
321
+ @backup_kind = args[:backup_kind] if args.key?(:backup_kind)
322
+ @backup_run = args[:backup_run] if args.key?(:backup_run)
323
+ @description = args[:description] if args.key?(:description)
324
+ @error = args[:error] if args.key?(:error)
325
+ @expiry_time = args[:expiry_time] if args.key?(:expiry_time)
326
+ @instance = args[:instance] if args.key?(:instance)
327
+ @instance_deletion_time = args[:instance_deletion_time] if args.key?(:instance_deletion_time)
328
+ @instance_settings = args[:instance_settings] if args.key?(:instance_settings)
329
+ @kind = args[:kind] if args.key?(:kind)
330
+ @kms_key = args[:kms_key] if args.key?(:kms_key)
331
+ @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
332
+ @location = args[:location] if args.key?(:location)
333
+ @max_chargeable_bytes = args[:max_chargeable_bytes] if args.key?(:max_chargeable_bytes)
334
+ @name = args[:name] if args.key?(:name)
335
+ @satisfies_pzi = args[:satisfies_pzi] if args.key?(:satisfies_pzi)
336
+ @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
337
+ @self_link = args[:self_link] if args.key?(:self_link)
338
+ @state = args[:state] if args.key?(:state)
339
+ @time_zone = args[:time_zone] if args.key?(:time_zone)
340
+ @ttl_days = args[:ttl_days] if args.key?(:ttl_days)
341
+ @type = args[:type] if args.key?(:type)
342
+ end
343
+ end
344
+
184
345
  # Database instance backup configuration.
185
346
  class BackupConfiguration
186
347
  include Google::Apis::Core::Hashable
@@ -277,6 +438,11 @@ module Google
277
438
  # @return [String]
278
439
  attr_accessor :kind
279
440
 
441
+ # The name of the backup. Format: projects/`project`/backups/`backup`
442
+ # Corresponds to the JSON property `name`
443
+ # @return [String]
444
+ attr_accessor :name
445
+
280
446
  def initialize(**args)
281
447
  update!(**args)
282
448
  end
@@ -285,6 +451,7 @@ module Google
285
451
  def update!(**args)
286
452
  @backup_id = args[:backup_id] if args.key?(:backup_id)
287
453
  @kind = args[:kind] if args.key?(:kind)
454
+ @name = args[:name] if args.key?(:name)
288
455
  end
289
456
  end
290
457
 
@@ -646,6 +813,11 @@ module Google
646
813
  # @return [String]
647
814
  attr_accessor :dns_name
648
815
 
816
+ # Output only. The list of DNS names used by this instance.
817
+ # Corresponds to the JSON property `dnsNames`
818
+ # @return [Array<Google::Apis::SqladminV1beta4::DnsNameMapping>]
819
+ attr_accessor :dns_names
820
+
649
821
  # The assigned IP addresses for the instance.
650
822
  # Corresponds to the JSON property `ipAddresses`
651
823
  # @return [Array<Google::Apis::SqladminV1beta4::IpMapping>]
@@ -688,6 +860,7 @@ module Google
688
860
  @custom_subject_alternative_names = args[:custom_subject_alternative_names] if args.key?(:custom_subject_alternative_names)
689
861
  @database_version = args[:database_version] if args.key?(:database_version)
690
862
  @dns_name = args[:dns_name] if args.key?(:dns_name)
863
+ @dns_names = args[:dns_names] if args.key?(:dns_names)
691
864
  @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
692
865
  @kind = args[:kind] if args.key?(:kind)
693
866
  @psc_enabled = args[:psc_enabled] if args.key?(:psc_enabled)
@@ -878,6 +1051,11 @@ module Google
878
1051
  # @return [String]
879
1052
  attr_accessor :dns_name
880
1053
 
1054
+ # Output only. The list of DNS names used by this instance.
1055
+ # Corresponds to the JSON property `dnsNames`
1056
+ # @return [Array<Google::Apis::SqladminV1beta4::DnsNameMapping>]
1057
+ attr_accessor :dns_names
1058
+
881
1059
  # This field is deprecated and will be removed from a future version of the API.
882
1060
  # Use the `settings.settingsVersion` field instead.
883
1061
  # Corresponds to the JSON property `etag`
@@ -902,6 +1080,14 @@ module Google
902
1080
  # @return [Google::Apis::SqladminV1beta4::GeminiInstanceConfig]
903
1081
  attr_accessor :gemini_config
904
1082
 
1083
+ # Input only. Determines whether an in-place major version upgrade of replicas
1084
+ # happens when an in-place major version upgrade of a primary instance is
1085
+ # initiated.
1086
+ # Corresponds to the JSON property `includeReplicasForMajorVersionUpgrade`
1087
+ # @return [Boolean]
1088
+ attr_accessor :include_replicas_for_major_version_upgrade
1089
+ alias_method :include_replicas_for_major_version_upgrade?, :include_replicas_for_major_version_upgrade
1090
+
905
1091
  # The instance type.
906
1092
  # Corresponds to the JSON property `instanceType`
907
1093
  # @return [String]
@@ -1106,10 +1292,12 @@ module Google
1106
1292
  @disk_encryption_configuration = args[:disk_encryption_configuration] if args.key?(:disk_encryption_configuration)
1107
1293
  @disk_encryption_status = args[:disk_encryption_status] if args.key?(:disk_encryption_status)
1108
1294
  @dns_name = args[:dns_name] if args.key?(:dns_name)
1295
+ @dns_names = args[:dns_names] if args.key?(:dns_names)
1109
1296
  @etag = args[:etag] if args.key?(:etag)
1110
1297
  @failover_replica = args[:failover_replica] if args.key?(:failover_replica)
1111
1298
  @gce_zone = args[:gce_zone] if args.key?(:gce_zone)
1112
1299
  @gemini_config = args[:gemini_config] if args.key?(:gemini_config)
1300
+ @include_replicas_for_major_version_upgrade = args[:include_replicas_for_major_version_upgrade] if args.key?(:include_replicas_for_major_version_upgrade)
1113
1301
  @instance_type = args[:instance_type] if args.key?(:instance_type)
1114
1302
  @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
1115
1303
  @ipv6_address = args[:ipv6_address] if args.key?(:ipv6_address)
@@ -1318,7 +1506,7 @@ module Google
1318
1506
  # @return [String]
1319
1507
  attr_accessor :client_certificate
1320
1508
 
1321
- # PEM representation of the replica's private key. The corresponsing public key
1509
+ # PEM representation of the replica's private key. The corresponding public key
1322
1510
  # is encoded in the client's certificate. The format of the replica's private
1323
1511
  # key can be either PKCS #1 or PKCS #8.
1324
1512
  # Corresponds to the JSON property `clientKey`
@@ -1444,6 +1632,37 @@ module Google
1444
1632
  end
1445
1633
  end
1446
1634
 
1635
+ # DNS metadata.
1636
+ class DnsNameMapping
1637
+ include Google::Apis::Core::Hashable
1638
+
1639
+ # Output only. The connection type of the DNS name.
1640
+ # Corresponds to the JSON property `connectionType`
1641
+ # @return [String]
1642
+ attr_accessor :connection_type
1643
+
1644
+ # Output only. The scope that the DNS name applies to.
1645
+ # Corresponds to the JSON property `dnsScope`
1646
+ # @return [String]
1647
+ attr_accessor :dns_scope
1648
+
1649
+ # The DNS name.
1650
+ # Corresponds to the JSON property `name`
1651
+ # @return [String]
1652
+ attr_accessor :name
1653
+
1654
+ def initialize(**args)
1655
+ update!(**args)
1656
+ end
1657
+
1658
+ # Update properties of this object
1659
+ def update!(**args)
1660
+ @connection_type = args[:connection_type] if args.key?(:connection_type)
1661
+ @dns_scope = args[:dns_scope] if args.key?(:dns_scope)
1662
+ @name = args[:name] if args.key?(:name)
1663
+ end
1664
+ end
1665
+
1447
1666
  # A generic empty message that you can re-use to avoid defining duplicated empty
1448
1667
  # messages in your APIs. A typical example is to use it as the request or the
1449
1668
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -1478,11 +1697,14 @@ module Google
1478
1697
  # database is specified, all databases are exported, except for the `mysql`
1479
1698
  # system database. If `fileType` is `CSV`, you can specify one database, either
1480
1699
  # by using this property or by using the `csvExportOptions.selectQuery` property,
1481
- # which takes precedence over this property. `PostgreSQL instances:` You must
1482
- # specify one database to be exported. If `fileType` is `CSV`, this database
1483
- # must match the one specified in the `csvExportOptions.selectQuery` property. `
1484
- # SQL Server instances:` You must specify one database to be exported, and the `
1485
- # fileType` must be `BAK`.
1700
+ # which takes precedence over this property. `PostgreSQL instances:` If you don'
1701
+ # t specify a database by name, all user databases in the instance are exported.
1702
+ # This excludes system databases and Cloud SQL databases used to manage internal
1703
+ # operations. Exporting all user databases is only available for directory-
1704
+ # formatted parallel export. If `fileType` is `CSV`, this database must match
1705
+ # the one specified in the `csvExportOptions.selectQuery` property. `SQL Server
1706
+ # instances:` You must specify one database to be exported, and the `fileType`
1707
+ # must be `BAK`.
1486
1708
  # Corresponds to the JSON property `databases`
1487
1709
  # @return [Array<String>]
1488
1710
  attr_accessor :databases
@@ -1508,6 +1730,11 @@ module Google
1508
1730
  # @return [Google::Apis::SqladminV1beta4::ExportContext::SqlExportOptions]
1509
1731
  attr_accessor :sql_export_options
1510
1732
 
1733
+ # Optional. Export parameters specific to SQL Server TDE certificates
1734
+ # Corresponds to the JSON property `tdeExportOptions`
1735
+ # @return [Google::Apis::SqladminV1beta4::ExportContext::TdeExportOptions]
1736
+ attr_accessor :tde_export_options
1737
+
1511
1738
  # The path to the file in Google Cloud Storage where the export will be stored.
1512
1739
  # The URI is in the form `gs://bucketName/fileName`. If the file already exists,
1513
1740
  # the request succeeds, but the operation fails. If `fileType` is `SQL` and the
@@ -1529,6 +1756,7 @@ module Google
1529
1756
  @kind = args[:kind] if args.key?(:kind)
1530
1757
  @offload = args[:offload] if args.key?(:offload)
1531
1758
  @sql_export_options = args[:sql_export_options] if args.key?(:sql_export_options)
1759
+ @tde_export_options = args[:tde_export_options] if args.key?(:tde_export_options)
1532
1760
  @uri = args[:uri] if args.key?(:uri)
1533
1761
  end
1534
1762
 
@@ -1750,6 +1978,47 @@ module Google
1750
1978
  end
1751
1979
  end
1752
1980
  end
1981
+
1982
+ # Optional. Export parameters specific to SQL Server TDE certificates
1983
+ class TdeExportOptions
1984
+ include Google::Apis::Core::Hashable
1985
+
1986
+ # Required. Path to the TDE certificate public key in the form gs://bucketName/
1987
+ # fileName. The instance must have write access to the location. Applicable only
1988
+ # for SQL Server instances.
1989
+ # Corresponds to the JSON property `certificatePath`
1990
+ # @return [String]
1991
+ attr_accessor :certificate_path
1992
+
1993
+ # Required. Certificate name. Applicable only for SQL Server instances.
1994
+ # Corresponds to the JSON property `name`
1995
+ # @return [String]
1996
+ attr_accessor :name
1997
+
1998
+ # Required. Password that encrypts the private key.
1999
+ # Corresponds to the JSON property `privateKeyPassword`
2000
+ # @return [String]
2001
+ attr_accessor :private_key_password
2002
+
2003
+ # Required. Path to the TDE certificate private key in the form gs://bucketName/
2004
+ # fileName. The instance must have write access to the location. Applicable only
2005
+ # for SQL Server instances.
2006
+ # Corresponds to the JSON property `privateKeyPath`
2007
+ # @return [String]
2008
+ attr_accessor :private_key_path
2009
+
2010
+ def initialize(**args)
2011
+ update!(**args)
2012
+ end
2013
+
2014
+ # Update properties of this object
2015
+ def update!(**args)
2016
+ @certificate_path = args[:certificate_path] if args.key?(:certificate_path)
2017
+ @name = args[:name] if args.key?(:name)
2018
+ @private_key_password = args[:private_key_password] if args.key?(:private_key_password)
2019
+ @private_key_path = args[:private_key_path] if args.key?(:private_key_path)
2020
+ end
2021
+ end
1753
2022
  end
1754
2023
 
1755
2024
  # The selected object that Cloud SQL migrates.
@@ -2035,8 +2304,10 @@ module Google
2035
2304
 
2036
2305
  # The target database for the import. If `fileType` is `SQL`, this field is
2037
2306
  # required only if the import file does not specify a database, and is
2038
- # overridden by any database specification in the import file. If `fileType` is `
2039
- # CSV`, one database must be specified.
2307
+ # overridden by any database specification in the import file. For entire
2308
+ # instance parallel import operations, the database is overridden by the
2309
+ # database name stored in subdirectory name. If `fileType` is `CSV`, one
2310
+ # database must be specified.
2040
2311
  # Corresponds to the JSON property `database`
2041
2312
  # @return [String]
2042
2313
  attr_accessor :database
@@ -2063,6 +2334,12 @@ module Google
2063
2334
  # @return [Google::Apis::SqladminV1beta4::ImportContext::SqlImportOptions]
2064
2335
  attr_accessor :sql_import_options
2065
2336
 
2337
+ # Optional. Import parameters specific to SQL Server .TDE files Import
2338
+ # parameters specific to SQL Server TDE certificates
2339
+ # Corresponds to the JSON property `tdeImportOptions`
2340
+ # @return [Google::Apis::SqladminV1beta4::ImportContext::TdeImportOptions]
2341
+ attr_accessor :tde_import_options
2342
+
2066
2343
  # Path to the import file in Cloud Storage, in the form `gs://bucketName/
2067
2344
  # fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`.
2068
2345
  # The instance must have write permissions to the bucket and read access to the
@@ -2084,6 +2361,7 @@ module Google
2084
2361
  @import_user = args[:import_user] if args.key?(:import_user)
2085
2362
  @kind = args[:kind] if args.key?(:kind)
2086
2363
  @sql_import_options = args[:sql_import_options] if args.key?(:sql_import_options)
2364
+ @tde_import_options = args[:tde_import_options] if args.key?(:tde_import_options)
2087
2365
  @uri = args[:uri] if args.key?(:uri)
2088
2366
  end
2089
2367
 
@@ -2165,6 +2443,12 @@ module Google
2165
2443
  # @return [String]
2166
2444
  attr_accessor :cert_path
2167
2445
 
2446
+ # Optional. Whether the imported file remains encrypted.
2447
+ # Corresponds to the JSON property `keepEncrypted`
2448
+ # @return [Boolean]
2449
+ attr_accessor :keep_encrypted
2450
+ alias_method :keep_encrypted?, :keep_encrypted
2451
+
2168
2452
  # Password that encrypts the private key
2169
2453
  # Corresponds to the JSON property `pvkPassword`
2170
2454
  # @return [String]
@@ -2184,6 +2468,7 @@ module Google
2184
2468
  # Update properties of this object
2185
2469
  def update!(**args)
2186
2470
  @cert_path = args[:cert_path] if args.key?(:cert_path)
2471
+ @keep_encrypted = args[:keep_encrypted] if args.key?(:keep_encrypted)
2187
2472
  @pvk_password = args[:pvk_password] if args.key?(:pvk_password)
2188
2473
  @pvk_path = args[:pvk_path] if args.key?(:pvk_path)
2189
2474
  end
@@ -2303,6 +2588,48 @@ module Google
2303
2588
  end
2304
2589
  end
2305
2590
  end
2591
+
2592
+ # Optional. Import parameters specific to SQL Server .TDE files Import
2593
+ # parameters specific to SQL Server TDE certificates
2594
+ class TdeImportOptions
2595
+ include Google::Apis::Core::Hashable
2596
+
2597
+ # Required. Path to the TDE certificate public key in the form gs://bucketName/
2598
+ # fileName. The instance must have read access to the file. Applicable only for
2599
+ # SQL Server instances.
2600
+ # Corresponds to the JSON property `certificatePath`
2601
+ # @return [String]
2602
+ attr_accessor :certificate_path
2603
+
2604
+ # Required. Certificate name. Applicable only for SQL Server instances.
2605
+ # Corresponds to the JSON property `name`
2606
+ # @return [String]
2607
+ attr_accessor :name
2608
+
2609
+ # Required. Password that encrypts the private key.
2610
+ # Corresponds to the JSON property `privateKeyPassword`
2611
+ # @return [String]
2612
+ attr_accessor :private_key_password
2613
+
2614
+ # Required. Path to the TDE certificate private key in the form gs://bucketName/
2615
+ # fileName. The instance must have read access to the file. Applicable only for
2616
+ # SQL Server instances.
2617
+ # Corresponds to the JSON property `privateKeyPath`
2618
+ # @return [String]
2619
+ attr_accessor :private_key_path
2620
+
2621
+ def initialize(**args)
2622
+ update!(**args)
2623
+ end
2624
+
2625
+ # Update properties of this object
2626
+ def update!(**args)
2627
+ @certificate_path = args[:certificate_path] if args.key?(:certificate_path)
2628
+ @name = args[:name] if args.key?(:name)
2629
+ @private_key_password = args[:private_key_password] if args.key?(:private_key_password)
2630
+ @private_key_path = args[:private_key_path] if args.key?(:private_key_path)
2631
+ end
2632
+ end
2306
2633
  end
2307
2634
 
2308
2635
  # Insights configuration. This specifies when Cloud SQL Insights feature is
@@ -2654,19 +2981,33 @@ module Google
2654
2981
  class RestoreInstancesBackupRequest
2655
2982
  include Google::Apis::Core::Hashable
2656
2983
 
2984
+ # The name of the backup that's used to restore a Cloud SQL instance: Format:
2985
+ # projects/`project-id`/backups/`backup-uid`. Only one of restore_backup_context,
2986
+ # backup, backupdr_backup can be passed to the input.
2987
+ # Corresponds to the JSON property `backup`
2988
+ # @return [String]
2989
+ attr_accessor :backup
2990
+
2657
2991
  # Database instance restore from backup context. Backup context contains source
2658
2992
  # instance id and project id.
2659
2993
  # Corresponds to the JSON property `restoreBackupContext`
2660
2994
  # @return [Google::Apis::SqladminV1beta4::RestoreBackupContext]
2661
2995
  attr_accessor :restore_backup_context
2662
2996
 
2997
+ # A Cloud SQL instance resource.
2998
+ # Corresponds to the JSON property `restoreInstanceSettings`
2999
+ # @return [Google::Apis::SqladminV1beta4::DatabaseInstance]
3000
+ attr_accessor :restore_instance_settings
3001
+
2663
3002
  def initialize(**args)
2664
3003
  update!(**args)
2665
3004
  end
2666
3005
 
2667
3006
  # Update properties of this object
2668
3007
  def update!(**args)
3008
+ @backup = args[:backup] if args.key?(:backup)
2669
3009
  @restore_backup_context = args[:restore_backup_context] if args.key?(:restore_backup_context)
3010
+ @restore_instance_settings = args[:restore_instance_settings] if args.key?(:restore_instance_settings)
2670
3011
  end
2671
3012
  end
2672
3013
 
@@ -2727,6 +3068,36 @@ module Google
2727
3068
  end
2728
3069
  end
2729
3070
 
3071
+ # Represents a time interval, encoded as a Timestamp start (inclusive) and a
3072
+ # Timestamp end (exclusive). The start must be less than or equal to the end.
3073
+ # When the start equals the end, the interval is empty (matches no time). When
3074
+ # both start and end are unspecified, the interval matches any time.
3075
+ class Interval
3076
+ include Google::Apis::Core::Hashable
3077
+
3078
+ # Optional. Exclusive end of the interval. If specified, a Timestamp matching
3079
+ # this interval will have to be before the end.
3080
+ # Corresponds to the JSON property `endTime`
3081
+ # @return [String]
3082
+ attr_accessor :end_time
3083
+
3084
+ # Optional. Inclusive start of the interval. If specified, a Timestamp matching
3085
+ # this interval will have to be the same or after the start.
3086
+ # Corresponds to the JSON property `startTime`
3087
+ # @return [String]
3088
+ attr_accessor :start_time
3089
+
3090
+ def initialize(**args)
3091
+ update!(**args)
3092
+ end
3093
+
3094
+ # Update properties of this object
3095
+ def update!(**args)
3096
+ @end_time = args[:end_time] if args.key?(:end_time)
3097
+ @start_time = args[:start_time] if args.key?(:start_time)
3098
+ end
3099
+ end
3100
+
2730
3101
  # IP Management configuration.
2731
3102
  class IpConfiguration
2732
3103
  include Google::Apis::Core::Hashable
@@ -2796,8 +3167,8 @@ module Google
2796
3167
  attr_accessor :server_ca_mode
2797
3168
 
2798
3169
  # Optional. The resource name of the server CA pool for an instance with `
2799
- # CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//
2800
- # caPools/
3170
+ # CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects/`PROJECT`/
3171
+ # locations/`REGION`/caPools/`CA_POOL_ID`
2801
3172
  # Corresponds to the JSON property `serverCaPool`
2802
3173
  # @return [String]
2803
3174
  attr_accessor :server_ca_pool
@@ -2875,6 +3246,39 @@ module Google
2875
3246
  end
2876
3247
  end
2877
3248
 
3249
+ # The response payload containing a list of the backups.
3250
+ class ListBackupsResponse
3251
+ include Google::Apis::Core::Hashable
3252
+
3253
+ # A list of backups.
3254
+ # Corresponds to the JSON property `backups`
3255
+ # @return [Array<Google::Apis::SqladminV1beta4::Backup>]
3256
+ attr_accessor :backups
3257
+
3258
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
3259
+ # field is omitted, then there aren't subsequent pages.
3260
+ # Corresponds to the JSON property `nextPageToken`
3261
+ # @return [String]
3262
+ attr_accessor :next_page_token
3263
+
3264
+ # If a region isn't unavailable or if an unknown error occurs, then a warning
3265
+ # message is returned.
3266
+ # Corresponds to the JSON property `warnings`
3267
+ # @return [Array<Google::Apis::SqladminV1beta4::ApiWarning>]
3268
+ attr_accessor :warnings
3269
+
3270
+ def initialize(**args)
3271
+ update!(**args)
3272
+ end
3273
+
3274
+ # Update properties of this object
3275
+ def update!(**args)
3276
+ @backups = args[:backups] if args.key?(:backups)
3277
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
3278
+ @warnings = args[:warnings] if args.key?(:warnings)
3279
+ end
3280
+ end
3281
+
2878
3282
  # Preferred location. This specifies where a Cloud SQL instance is located. Note
2879
3283
  # that if the preferred location is not available, the instance will be located
2880
3284
  # as close as possible within the region. Only one location may be specified.
@@ -2974,7 +3378,7 @@ module Google
2974
3378
  # @return [String]
2975
3379
  attr_accessor :client_certificate
2976
3380
 
2977
- # PEM representation of the replica's private key. The corresponsing public key
3381
+ # PEM representation of the replica's private key. The corresponding public key
2978
3382
  # is encoded in the client's certificate.
2979
3383
  # Corresponds to the JSON property `clientKey`
2980
3384
  # @return [String]
@@ -3079,7 +3483,7 @@ module Google
3079
3483
  # @return [String]
3080
3484
  attr_accessor :client_certificate
3081
3485
 
3082
- # PEM representation of the replica's private key. The corresponsing public key
3486
+ # PEM representation of the replica's private key. The corresponding public key
3083
3487
  # is encoded in the client's certificate.
3084
3488
  # Corresponds to the JSON property `clientKey`
3085
3489
  # @return [String]
@@ -3234,7 +3638,7 @@ module Google
3234
3638
  # @return [Google::Apis::SqladminV1beta4::SqlSubOperationType]
3235
3639
  attr_accessor :sub_operation_type
3236
3640
 
3237
- #
3641
+ # Name of the resource on which this operation runs.
3238
3642
  # Corresponds to the JSON property `targetId`
3239
3643
  # @return [String]
3240
3644
  attr_accessor :target_id
@@ -4014,6 +4418,12 @@ module Google
4014
4418
  # @return [String]
4015
4419
  attr_accessor :pricing_plan
4016
4420
 
4421
+ # Optional. Configuration value for recreation of replica after certain
4422
+ # replication lag
4423
+ # Corresponds to the JSON property `replicationLagMaxSeconds`
4424
+ # @return [Fixnum]
4425
+ attr_accessor :replication_lag_max_seconds
4426
+
4017
4427
  # The type of replication this instance uses. This can be either `ASYNCHRONOUS`
4018
4428
  # or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First
4019
4429
  # Generation instances.
@@ -4021,6 +4431,15 @@ module Google
4021
4431
  # @return [String]
4022
4432
  attr_accessor :replication_type
4023
4433
 
4434
+ # Optional. When this parameter is set to true, Cloud SQL retains backups of the
4435
+ # instance even after the instance is deleted. The ON_DEMAND backup will be
4436
+ # retained until customer deletes the backup or the project. The AUTOMATED
4437
+ # backup will be retained based on the backups retention setting.
4438
+ # Corresponds to the JSON property `retainBackupsOnDelete`
4439
+ # @return [Boolean]
4440
+ attr_accessor :retain_backups_on_delete
4441
+ alias_method :retain_backups_on_delete?, :retain_backups_on_delete
4442
+
4024
4443
  # The version of instance settings. This is a required field for update method
4025
4444
  # to make sure concurrent updates are handled properly. During update, use the
4026
4445
  # most recent settingsVersion value for this instance and do not try to update
@@ -4096,7 +4515,9 @@ module Google
4096
4515
  @maintenance_window = args[:maintenance_window] if args.key?(:maintenance_window)
4097
4516
  @password_validation_policy = args[:password_validation_policy] if args.key?(:password_validation_policy)
4098
4517
  @pricing_plan = args[:pricing_plan] if args.key?(:pricing_plan)
4518
+ @replication_lag_max_seconds = args[:replication_lag_max_seconds] if args.key?(:replication_lag_max_seconds)
4099
4519
  @replication_type = args[:replication_type] if args.key?(:replication_type)
4520
+ @retain_backups_on_delete = args[:retain_backups_on_delete] if args.key?(:retain_backups_on_delete)
4100
4521
  @settings_version = args[:settings_version] if args.key?(:settings_version)
4101
4522
  @sql_server_audit_config = args[:sql_server_audit_config] if args.key?(:sql_server_audit_config)
4102
4523
  @storage_auto_resize = args[:storage_auto_resize] if args.key?(:storage_auto_resize)
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SqladminV1beta4
18
18
  # Version of the google-apis-sqladmin_v1beta4 gem
19
- GEM_VERSION = "0.77.0"
19
+ GEM_VERSION = "0.79.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.15.1"
22
+ GENERATOR_VERSION = "0.16.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20241210"
25
+ REVISION = "20250226"
26
26
  end
27
27
  end
28
28
  end
@@ -52,6 +52,12 @@ module Google
52
52
  include Google::Apis::Core::JsonObjectSupport
53
53
  end
54
54
 
55
+ class Backup
56
+ class Representation < Google::Apis::Core::JsonRepresentation; end
57
+
58
+ include Google::Apis::Core::JsonObjectSupport
59
+ end
60
+
55
61
  class BackupConfiguration
56
62
  class Representation < Google::Apis::Core::JsonRepresentation; end
57
63
 
@@ -184,6 +190,12 @@ module Google
184
190
  include Google::Apis::Core::JsonObjectSupport
185
191
  end
186
192
 
193
+ class DnsNameMapping
194
+ class Representation < Google::Apis::Core::JsonRepresentation; end
195
+
196
+ include Google::Apis::Core::JsonObjectSupport
197
+ end
198
+
187
199
  class Empty
188
200
  class Representation < Google::Apis::Core::JsonRepresentation; end
189
201
 
@@ -222,6 +234,12 @@ module Google
222
234
 
223
235
  include Google::Apis::Core::JsonObjectSupport
224
236
  end
237
+
238
+ class TdeExportOptions
239
+ class Representation < Google::Apis::Core::JsonRepresentation; end
240
+
241
+ include Google::Apis::Core::JsonObjectSupport
242
+ end
225
243
 
226
244
  include Google::Apis::Core::JsonObjectSupport
227
245
  end
@@ -300,6 +318,12 @@ module Google
300
318
 
301
319
  include Google::Apis::Core::JsonObjectSupport
302
320
  end
321
+
322
+ class TdeImportOptions
323
+ class Representation < Google::Apis::Core::JsonRepresentation; end
324
+
325
+ include Google::Apis::Core::JsonObjectSupport
326
+ end
303
327
 
304
328
  include Google::Apis::Core::JsonObjectSupport
305
329
  end
@@ -406,6 +430,12 @@ module Google
406
430
  include Google::Apis::Core::JsonObjectSupport
407
431
  end
408
432
 
433
+ class Interval
434
+ class Representation < Google::Apis::Core::JsonRepresentation; end
435
+
436
+ include Google::Apis::Core::JsonObjectSupport
437
+ end
438
+
409
439
  class IpConfiguration
410
440
  class Representation < Google::Apis::Core::JsonRepresentation; end
411
441
 
@@ -418,6 +448,12 @@ module Google
418
448
  include Google::Apis::Core::JsonObjectSupport
419
449
  end
420
450
 
451
+ class ListBackupsResponse
452
+ class Representation < Google::Apis::Core::JsonRepresentation; end
453
+
454
+ include Google::Apis::Core::JsonObjectSupport
455
+ end
456
+
421
457
  class LocationPreference
422
458
  class Representation < Google::Apis::Core::JsonRepresentation; end
423
459
 
@@ -781,6 +817,37 @@ module Google
781
817
  end
782
818
  end
783
819
 
820
+ class Backup
821
+ # @private
822
+ class Representation < Google::Apis::Core::JsonRepresentation
823
+ property :backup_interval, as: 'backupInterval', class: Google::Apis::SqladminV1beta4::Interval, decorator: Google::Apis::SqladminV1beta4::Interval::Representation
824
+
825
+ property :backup_kind, as: 'backupKind'
826
+ property :backup_run, as: 'backupRun'
827
+ property :description, as: 'description'
828
+ property :error, as: 'error', class: Google::Apis::SqladminV1beta4::OperationError, decorator: Google::Apis::SqladminV1beta4::OperationError::Representation
829
+
830
+ property :expiry_time, as: 'expiryTime'
831
+ property :instance, as: 'instance'
832
+ property :instance_deletion_time, as: 'instanceDeletionTime'
833
+ property :instance_settings, as: 'instanceSettings', class: Google::Apis::SqladminV1beta4::DatabaseInstance, decorator: Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
834
+
835
+ property :kind, as: 'kind'
836
+ property :kms_key, as: 'kmsKey'
837
+ property :kms_key_version, as: 'kmsKeyVersion'
838
+ property :location, as: 'location'
839
+ property :max_chargeable_bytes, :numeric_string => true, as: 'maxChargeableBytes'
840
+ property :name, as: 'name'
841
+ property :satisfies_pzi, as: 'satisfiesPzi'
842
+ property :satisfies_pzs, as: 'satisfiesPzs'
843
+ property :self_link, as: 'selfLink'
844
+ property :state, as: 'state'
845
+ property :time_zone, as: 'timeZone'
846
+ property :ttl_days, :numeric_string => true, as: 'ttlDays'
847
+ property :type, as: 'type'
848
+ end
849
+ end
850
+
784
851
  class BackupConfiguration
785
852
  # @private
786
853
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -803,6 +870,7 @@ module Google
803
870
  class Representation < Google::Apis::Core::JsonRepresentation
804
871
  property :backup_id, :numeric_string => true, as: 'backupId'
805
872
  property :kind, as: 'kind'
873
+ property :name, as: 'name'
806
874
  end
807
875
  end
808
876
 
@@ -891,6 +959,8 @@ module Google
891
959
  collection :custom_subject_alternative_names, as: 'customSubjectAlternativeNames'
892
960
  property :database_version, as: 'databaseVersion'
893
961
  property :dns_name, as: 'dnsName'
962
+ collection :dns_names, as: 'dnsNames', class: Google::Apis::SqladminV1beta4::DnsNameMapping, decorator: Google::Apis::SqladminV1beta4::DnsNameMapping::Representation
963
+
894
964
  collection :ip_addresses, as: 'ipAddresses', class: Google::Apis::SqladminV1beta4::IpMapping, decorator: Google::Apis::SqladminV1beta4::IpMapping::Representation
895
965
 
896
966
  property :kind, as: 'kind'
@@ -948,12 +1018,15 @@ module Google
948
1018
  property :disk_encryption_status, as: 'diskEncryptionStatus', class: Google::Apis::SqladminV1beta4::DiskEncryptionStatus, decorator: Google::Apis::SqladminV1beta4::DiskEncryptionStatus::Representation
949
1019
 
950
1020
  property :dns_name, as: 'dnsName'
1021
+ collection :dns_names, as: 'dnsNames', class: Google::Apis::SqladminV1beta4::DnsNameMapping, decorator: Google::Apis::SqladminV1beta4::DnsNameMapping::Representation
1022
+
951
1023
  property :etag, as: 'etag'
952
1024
  property :failover_replica, as: 'failoverReplica', class: Google::Apis::SqladminV1beta4::DatabaseInstance::FailoverReplica, decorator: Google::Apis::SqladminV1beta4::DatabaseInstance::FailoverReplica::Representation
953
1025
 
954
1026
  property :gce_zone, as: 'gceZone'
955
1027
  property :gemini_config, as: 'geminiConfig', class: Google::Apis::SqladminV1beta4::GeminiInstanceConfig, decorator: Google::Apis::SqladminV1beta4::GeminiInstanceConfig::Representation
956
1028
 
1029
+ property :include_replicas_for_major_version_upgrade, as: 'includeReplicasForMajorVersionUpgrade'
957
1030
  property :instance_type, as: 'instanceType'
958
1031
  collection :ip_addresses, as: 'ipAddresses', class: Google::Apis::SqladminV1beta4::IpMapping, decorator: Google::Apis::SqladminV1beta4::IpMapping::Representation
959
1032
 
@@ -1082,6 +1155,15 @@ module Google
1082
1155
  end
1083
1156
  end
1084
1157
 
1158
+ class DnsNameMapping
1159
+ # @private
1160
+ class Representation < Google::Apis::Core::JsonRepresentation
1161
+ property :connection_type, as: 'connectionType'
1162
+ property :dns_scope, as: 'dnsScope'
1163
+ property :name, as: 'name'
1164
+ end
1165
+ end
1166
+
1085
1167
  class Empty
1086
1168
  # @private
1087
1169
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1101,6 +1183,8 @@ module Google
1101
1183
  property :offload, as: 'offload'
1102
1184
  property :sql_export_options, as: 'sqlExportOptions', class: Google::Apis::SqladminV1beta4::ExportContext::SqlExportOptions, decorator: Google::Apis::SqladminV1beta4::ExportContext::SqlExportOptions::Representation
1103
1185
 
1186
+ property :tde_export_options, as: 'tdeExportOptions', class: Google::Apis::SqladminV1beta4::ExportContext::TdeExportOptions, decorator: Google::Apis::SqladminV1beta4::ExportContext::TdeExportOptions::Representation
1187
+
1104
1188
  property :uri, as: 'uri'
1105
1189
  end
1106
1190
 
@@ -1156,6 +1240,16 @@ module Google
1156
1240
  end
1157
1241
  end
1158
1242
  end
1243
+
1244
+ class TdeExportOptions
1245
+ # @private
1246
+ class Representation < Google::Apis::Core::JsonRepresentation
1247
+ property :certificate_path, as: 'certificatePath'
1248
+ property :name, as: 'name'
1249
+ property :private_key_password, as: 'privateKeyPassword'
1250
+ property :private_key_path, as: 'privateKeyPath'
1251
+ end
1252
+ end
1159
1253
  end
1160
1254
 
1161
1255
  class ExternalSyncSelectedObject
@@ -1241,6 +1335,8 @@ module Google
1241
1335
  property :kind, as: 'kind'
1242
1336
  property :sql_import_options, as: 'sqlImportOptions', class: Google::Apis::SqladminV1beta4::ImportContext::SqlImportOptions, decorator: Google::Apis::SqladminV1beta4::ImportContext::SqlImportOptions::Representation
1243
1337
 
1338
+ property :tde_import_options, as: 'tdeImportOptions', class: Google::Apis::SqladminV1beta4::ImportContext::TdeImportOptions, decorator: Google::Apis::SqladminV1beta4::ImportContext::TdeImportOptions::Representation
1339
+
1244
1340
  property :uri, as: 'uri'
1245
1341
  end
1246
1342
 
@@ -1261,6 +1357,7 @@ module Google
1261
1357
  # @private
1262
1358
  class Representation < Google::Apis::Core::JsonRepresentation
1263
1359
  property :cert_path, as: 'certPath'
1360
+ property :keep_encrypted, as: 'keepEncrypted'
1264
1361
  property :pvk_password, as: 'pvkPassword'
1265
1362
  property :pvk_path, as: 'pvkPath'
1266
1363
  end
@@ -1296,6 +1393,16 @@ module Google
1296
1393
  end
1297
1394
  end
1298
1395
  end
1396
+
1397
+ class TdeImportOptions
1398
+ # @private
1399
+ class Representation < Google::Apis::Core::JsonRepresentation
1400
+ property :certificate_path, as: 'certificatePath'
1401
+ property :name, as: 'name'
1402
+ property :private_key_password, as: 'privateKeyPassword'
1403
+ property :private_key_path, as: 'privateKeyPath'
1404
+ end
1405
+ end
1299
1406
  end
1300
1407
 
1301
1408
  class InsightsConfig
@@ -1419,8 +1526,11 @@ module Google
1419
1526
  class RestoreInstancesBackupRequest
1420
1527
  # @private
1421
1528
  class Representation < Google::Apis::Core::JsonRepresentation
1529
+ property :backup, as: 'backup'
1422
1530
  property :restore_backup_context, as: 'restoreBackupContext', class: Google::Apis::SqladminV1beta4::RestoreBackupContext, decorator: Google::Apis::SqladminV1beta4::RestoreBackupContext::Representation
1423
1531
 
1532
+ property :restore_instance_settings, as: 'restoreInstanceSettings', class: Google::Apis::SqladminV1beta4::DatabaseInstance, decorator: Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
1533
+
1424
1534
  end
1425
1535
  end
1426
1536
 
@@ -1448,6 +1558,14 @@ module Google
1448
1558
  end
1449
1559
  end
1450
1560
 
1561
+ class Interval
1562
+ # @private
1563
+ class Representation < Google::Apis::Core::JsonRepresentation
1564
+ property :end_time, as: 'endTime'
1565
+ property :start_time, as: 'startTime'
1566
+ end
1567
+ end
1568
+
1451
1569
  class IpConfiguration
1452
1570
  # @private
1453
1571
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1476,6 +1594,17 @@ module Google
1476
1594
  end
1477
1595
  end
1478
1596
 
1597
+ class ListBackupsResponse
1598
+ # @private
1599
+ class Representation < Google::Apis::Core::JsonRepresentation
1600
+ collection :backups, as: 'backups', class: Google::Apis::SqladminV1beta4::Backup, decorator: Google::Apis::SqladminV1beta4::Backup::Representation
1601
+
1602
+ property :next_page_token, as: 'nextPageToken'
1603
+ collection :warnings, as: 'warnings', class: Google::Apis::SqladminV1beta4::ApiWarning, decorator: Google::Apis::SqladminV1beta4::ApiWarning::Representation
1604
+
1605
+ end
1606
+ end
1607
+
1479
1608
  class LocationPreference
1480
1609
  # @private
1481
1610
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1763,7 +1892,9 @@ module Google
1763
1892
  property :password_validation_policy, as: 'passwordValidationPolicy', class: Google::Apis::SqladminV1beta4::PasswordValidationPolicy, decorator: Google::Apis::SqladminV1beta4::PasswordValidationPolicy::Representation
1764
1893
 
1765
1894
  property :pricing_plan, as: 'pricingPlan'
1895
+ property :replication_lag_max_seconds, as: 'replicationLagMaxSeconds'
1766
1896
  property :replication_type, as: 'replicationType'
1897
+ property :retain_backups_on_delete, as: 'retainBackupsOnDelete'
1767
1898
  property :settings_version, :numeric_string => true, as: 'settingsVersion'
1768
1899
  property :sql_server_audit_config, as: 'sqlServerAuditConfig', class: Google::Apis::SqladminV1beta4::SqlServerAuditConfig, decorator: Google::Apis::SqladminV1beta4::SqlServerAuditConfig::Representation
1769
1900
 
@@ -203,6 +203,190 @@ module Google
203
203
  execute_or_queue_command(command, &block)
204
204
  end
205
205
 
206
+ # Creates a backup for a Cloud SQL instance. This API can be used only to create
207
+ # on-demand backups.
208
+ # @param [String] parent
209
+ # Required. The parent resource where this backup is created. Format: projects/`
210
+ # project`
211
+ # @param [Google::Apis::SqladminV1beta4::Backup] backup_object
212
+ # @param [String] fields
213
+ # Selector specifying which fields to include in a partial response.
214
+ # @param [String] quota_user
215
+ # Available to use for quota purposes for server-side applications. Can be any
216
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
217
+ # @param [Google::Apis::RequestOptions] options
218
+ # Request-specific options
219
+ #
220
+ # @yield [result, err] Result & error if block supplied
221
+ # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
222
+ # @yieldparam err [StandardError] error object if request failed
223
+ #
224
+ # @return [Google::Apis::SqladminV1beta4::Operation]
225
+ #
226
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
227
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
228
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
229
+ def create_backup_backup(parent, backup_object = nil, fields: nil, quota_user: nil, options: nil, &block)
230
+ command = make_simple_command(:post, 'sql/v1beta4/{+parent}/backups', options)
231
+ command.request_representation = Google::Apis::SqladminV1beta4::Backup::Representation
232
+ command.request_object = backup_object
233
+ command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
234
+ command.response_class = Google::Apis::SqladminV1beta4::Operation
235
+ command.params['parent'] = parent unless parent.nil?
236
+ command.query['fields'] = fields unless fields.nil?
237
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
238
+ execute_or_queue_command(command, &block)
239
+ end
240
+
241
+ # Deletes the backup.
242
+ # @param [String] name
243
+ # Required. The name of the backup to delete. Format: projects/`project`/backups/
244
+ # `backup`
245
+ # @param [String] fields
246
+ # Selector specifying which fields to include in a partial response.
247
+ # @param [String] quota_user
248
+ # Available to use for quota purposes for server-side applications. Can be any
249
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
250
+ # @param [Google::Apis::RequestOptions] options
251
+ # Request-specific options
252
+ #
253
+ # @yield [result, err] Result & error if block supplied
254
+ # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
255
+ # @yieldparam err [StandardError] error object if request failed
256
+ #
257
+ # @return [Google::Apis::SqladminV1beta4::Operation]
258
+ #
259
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
260
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
261
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
262
+ def delete_backup_backup(name, fields: nil, quota_user: nil, options: nil, &block)
263
+ command = make_simple_command(:delete, 'sql/v1beta4/{+name}', options)
264
+ command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
265
+ command.response_class = Google::Apis::SqladminV1beta4::Operation
266
+ command.params['name'] = name unless name.nil?
267
+ command.query['fields'] = fields unless fields.nil?
268
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
269
+ execute_or_queue_command(command, &block)
270
+ end
271
+
272
+ # Retrieves a resource containing information about a backup.
273
+ # @param [String] name
274
+ # Required. The name of the backup to retrieve. Format: projects/`project`/
275
+ # backups/`backup`
276
+ # @param [String] fields
277
+ # Selector specifying which fields to include in a partial response.
278
+ # @param [String] quota_user
279
+ # Available to use for quota purposes for server-side applications. Can be any
280
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
281
+ # @param [Google::Apis::RequestOptions] options
282
+ # Request-specific options
283
+ #
284
+ # @yield [result, err] Result & error if block supplied
285
+ # @yieldparam result [Google::Apis::SqladminV1beta4::Backup] parsed result object
286
+ # @yieldparam err [StandardError] error object if request failed
287
+ #
288
+ # @return [Google::Apis::SqladminV1beta4::Backup]
289
+ #
290
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
291
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
292
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
293
+ def get_backup_backup(name, fields: nil, quota_user: nil, options: nil, &block)
294
+ command = make_simple_command(:get, 'sql/v1beta4/{+name}', options)
295
+ command.response_representation = Google::Apis::SqladminV1beta4::Backup::Representation
296
+ command.response_class = Google::Apis::SqladminV1beta4::Backup
297
+ command.params['name'] = name unless name.nil?
298
+ command.query['fields'] = fields unless fields.nil?
299
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
300
+ execute_or_queue_command(command, &block)
301
+ end
302
+
303
+ # Lists all backups associated with the project.
304
+ # @param [String] parent
305
+ # Required. The parent that owns this collection of backups. Format: projects/`
306
+ # project`
307
+ # @param [String] filter
308
+ # Multiple filter queries are separated by spaces. For example, 'instance:abc
309
+ # AND type:FINAL, 'location:us', 'backupInterval.startTime>=1950-01-01T01:01:25.
310
+ # 771Z'. You can filter by type, instance, backupInterval.startTime (creation
311
+ # time), or location.
312
+ # @param [Fixnum] page_size
313
+ # The maximum number of backups to return per response. The service might return
314
+ # fewer backups than this value. If a value for this parameter isn't specified,
315
+ # then, at most, 500 backups are returned. The maximum value is 2,000. Any
316
+ # values that you set, which are greater than 2,000, are changed to 2,000.
317
+ # @param [String] page_token
318
+ # A page token, received from a previous `ListBackups` call. Provide this to
319
+ # retrieve the subsequent page. When paginating, all other parameters provided
320
+ # to `ListBackups` must match the call that provided the page token.
321
+ # @param [String] fields
322
+ # Selector specifying which fields to include in a partial response.
323
+ # @param [String] quota_user
324
+ # Available to use for quota purposes for server-side applications. Can be any
325
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
326
+ # @param [Google::Apis::RequestOptions] options
327
+ # Request-specific options
328
+ #
329
+ # @yield [result, err] Result & error if block supplied
330
+ # @yieldparam result [Google::Apis::SqladminV1beta4::ListBackupsResponse] parsed result object
331
+ # @yieldparam err [StandardError] error object if request failed
332
+ #
333
+ # @return [Google::Apis::SqladminV1beta4::ListBackupsResponse]
334
+ #
335
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
336
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
337
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
338
+ def list_backup_backups(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
339
+ command = make_simple_command(:get, 'sql/v1beta4/{+parent}/backups', options)
340
+ command.response_representation = Google::Apis::SqladminV1beta4::ListBackupsResponse::Representation
341
+ command.response_class = Google::Apis::SqladminV1beta4::ListBackupsResponse
342
+ command.params['parent'] = parent unless parent.nil?
343
+ command.query['filter'] = filter unless filter.nil?
344
+ command.query['pageSize'] = page_size unless page_size.nil?
345
+ command.query['pageToken'] = page_token unless page_token.nil?
346
+ command.query['fields'] = fields unless fields.nil?
347
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
348
+ execute_or_queue_command(command, &block)
349
+ end
350
+
351
+ # Updates the retention period and the description of the backup. You can use
352
+ # this API to update final backups only.
353
+ # @param [String] name
354
+ # Output only. The resource name of the backup. Format: projects/`project`/
355
+ # backups/`backup`.
356
+ # @param [Google::Apis::SqladminV1beta4::Backup] backup_object
357
+ # @param [String] update_mask
358
+ # The list of fields that you can update. You can update only the description
359
+ # and retention period of the final backup.
360
+ # @param [String] fields
361
+ # Selector specifying which fields to include in a partial response.
362
+ # @param [String] quota_user
363
+ # Available to use for quota purposes for server-side applications. Can be any
364
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
365
+ # @param [Google::Apis::RequestOptions] options
366
+ # Request-specific options
367
+ #
368
+ # @yield [result, err] Result & error if block supplied
369
+ # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
370
+ # @yieldparam err [StandardError] error object if request failed
371
+ #
372
+ # @return [Google::Apis::SqladminV1beta4::Operation]
373
+ #
374
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
375
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
376
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
377
+ def update_backup_backup(name, backup_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
378
+ command = make_simple_command(:patch, 'sql/v1beta4/{+name}', options)
379
+ command.request_representation = Google::Apis::SqladminV1beta4::Backup::Representation
380
+ command.request_object = backup_object
381
+ command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
382
+ command.response_class = Google::Apis::SqladminV1beta4::Operation
383
+ command.params['name'] = name unless name.nil?
384
+ command.query['updateMask'] = update_mask unless update_mask.nil?
385
+ command.query['fields'] = fields unless fields.nil?
386
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
387
+ execute_or_queue_command(command, &block)
388
+ end
389
+
206
390
  # Generates a short-lived X509 certificate containing the provided public key
207
391
  # and signed by a private key specific to the target instance. Users may use the
208
392
  # certificate to authenticate as themselves when connecting to the database.
@@ -764,6 +948,15 @@ module Google
764
948
  # Project ID of the project that contains the instance to be deleted.
765
949
  # @param [String] instance
766
950
  # Cloud SQL instance ID. This does not include the project ID.
951
+ # @param [Boolean] enable_final_backup
952
+ # Flag to opt-in for final backup. By default, it is turned off.
953
+ # @param [String] final_backup_description
954
+ # Optional. The description of the final backup.
955
+ # @param [String] final_backup_expiry_time
956
+ # Optional. Final Backup expiration time. Timestamp in UTC of when this resource
957
+ # is considered expired.
958
+ # @param [Fixnum] final_backup_ttl_days
959
+ # Optional. Retention period of the final backup.
767
960
  # @param [String] fields
768
961
  # Selector specifying which fields to include in a partial response.
769
962
  # @param [String] quota_user
@@ -781,12 +974,16 @@ module Google
781
974
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
782
975
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
783
976
  # @raise [Google::Apis::AuthorizationError] Authorization is required
784
- def delete_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
977
+ def delete_instance(project, instance, enable_final_backup: nil, final_backup_description: nil, final_backup_expiry_time: nil, final_backup_ttl_days: nil, fields: nil, quota_user: nil, options: nil, &block)
785
978
  command = make_simple_command(:delete, 'sql/v1beta4/projects/{project}/instances/{instance}', options)
786
979
  command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
787
980
  command.response_class = Google::Apis::SqladminV1beta4::Operation
788
981
  command.params['project'] = project unless project.nil?
789
982
  command.params['instance'] = instance unless instance.nil?
983
+ command.query['enableFinalBackup'] = enable_final_backup unless enable_final_backup.nil?
984
+ command.query['finalBackupDescription'] = final_backup_description unless final_backup_description.nil?
985
+ command.query['finalBackupExpiryTime'] = final_backup_expiry_time unless final_backup_expiry_time.nil?
986
+ command.query['finalBackupTtlDays'] = final_backup_ttl_days unless final_backup_ttl_days.nil?
790
987
  command.query['fields'] = fields unless fields.nil?
791
988
  command.query['quotaUser'] = quota_user unless quota_user.nil?
792
989
  execute_or_queue_command(command, &block)
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-sqladmin_v1beta4
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.77.0
4
+ version: 0.79.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2025-01-05 00:00:00.000000000 Z
10
+ date: 2025-03-09 00:00:00.000000000 Z
12
11
  dependencies:
13
12
  - !ruby/object:Gem::Dependency
14
13
  name: google-apis-core
@@ -58,9 +57,8 @@ licenses:
58
57
  metadata:
59
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1beta4/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.77.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.79.0
62
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1beta4
63
- post_install_message:
64
62
  rdoc_options: []
65
63
  require_paths:
66
64
  - lib
@@ -75,8 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
73
  - !ruby/object:Gem::Version
76
74
  version: '0'
77
75
  requirements: []
78
- rubygems_version: 3.5.23
79
- signing_key:
76
+ rubygems_version: 3.6.5
80
77
  specification_version: 4
81
78
  summary: Simple REST client for Cloud SQL Admin API V1beta4
82
79
  test_files: []