google-apis-sqladmin_v1 0.72.0 → 0.74.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: 662f37bb6595df03fbf2020b038c7f1406ff713d46af56c182c6809638a2d712
4
- data.tar.gz: 439cba28cab931187e3a91a40e8f9520ac045e260be3c8f530d0ee3c1508e887
3
+ metadata.gz: 459c5a687b46cba0224108b010b1aaafa4ab6d61ed107d1ea6398e1ddf722faf
4
+ data.tar.gz: bc9ee89c7b50398646a122f29c4eead7562f58ede432c6a61f717113199bb5ce
5
5
  SHA512:
6
- metadata.gz: 17017b020b1864a83d91cf1a3b86a6174b69e201ff4060705c4ae8a9b4208e0e9f8ec5e4ca57b85c8aa0c34fa964c58c344cfc92c90b92e5b863af5b8e776b59
7
- data.tar.gz: 4cf83298de907a7cdbaa98f7101d8a5e686337680b37e317862e9d368da6a972539af5bc92d37a2dcd12260f38390cfcf19c4873e9e0d04010e9970858386255
6
+ metadata.gz: eda7520249c133a286fe20c3a5b89839de6f5469e97a370b271d5f5143ebec3644a613c9d3b2058ce694958366fb3808dcda94c1f46ca2d9dbb4ae382e07c75b
7
+ data.tar.gz: af59effdd0004746151517799c23ddb33bdf6aeeba98629251017a08a4393230bb6dd140aabc2fccea705bbd28bfad28ee696592fa4d9c60d80107ee6ed49d70
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-sqladmin_v1
2
2
 
3
+ ### v0.74.0 (2025-03-09)
4
+
5
+ * Regenerated from discovery document revision 20250226
6
+
7
+ ### v0.73.0 (2025-03-02)
8
+
9
+ * Regenerated from discovery document revision 20250216
10
+ * Regenerated using generator version 0.16.0
11
+
3
12
  ### v0.72.0 (2025-01-08)
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::SqladminV1::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::SqladminV1::OperationError]
214
+ attr_accessor :error
215
+
216
+ # Backup expiration time. A UTC timestamp of when this backup expired.
217
+ # Corresponds to the JSON property `expiryTime`
218
+ # @return [String]
219
+ attr_accessor :expiry_time
220
+
221
+ # The name of the source 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::SqladminV1::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 status 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
 
@@ -647,6 +814,11 @@ module Google
647
814
  # @return [String]
648
815
  attr_accessor :dns_name
649
816
 
817
+ # Output only. The list of DNS names used by this instance.
818
+ # Corresponds to the JSON property `dnsNames`
819
+ # @return [Array<Google::Apis::SqladminV1::DnsNameMapping>]
820
+ attr_accessor :dns_names
821
+
650
822
  # The assigned IP addresses for the instance.
651
823
  # Corresponds to the JSON property `ipAddresses`
652
824
  # @return [Array<Google::Apis::SqladminV1::IpMapping>]
@@ -689,6 +861,7 @@ module Google
689
861
  @custom_subject_alternative_names = args[:custom_subject_alternative_names] if args.key?(:custom_subject_alternative_names)
690
862
  @database_version = args[:database_version] if args.key?(:database_version)
691
863
  @dns_name = args[:dns_name] if args.key?(:dns_name)
864
+ @dns_names = args[:dns_names] if args.key?(:dns_names)
692
865
  @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
693
866
  @kind = args[:kind] if args.key?(:kind)
694
867
  @psc_enabled = args[:psc_enabled] if args.key?(:psc_enabled)
@@ -879,6 +1052,11 @@ module Google
879
1052
  # @return [String]
880
1053
  attr_accessor :dns_name
881
1054
 
1055
+ # Output only. The list of DNS names used by this instance.
1056
+ # Corresponds to the JSON property `dnsNames`
1057
+ # @return [Array<Google::Apis::SqladminV1::DnsNameMapping>]
1058
+ attr_accessor :dns_names
1059
+
882
1060
  # This field is deprecated and will be removed from a future version of the API.
883
1061
  # Use the `settings.settingsVersion` field instead.
884
1062
  # Corresponds to the JSON property `etag`
@@ -903,6 +1081,14 @@ module Google
903
1081
  # @return [Google::Apis::SqladminV1::GeminiInstanceConfig]
904
1082
  attr_accessor :gemini_config
905
1083
 
1084
+ # Input only. Determines whether an in-place major version upgrade of replicas
1085
+ # happens when an in-place major version upgrade of a primary instance is
1086
+ # initiated.
1087
+ # Corresponds to the JSON property `includeReplicasForMajorVersionUpgrade`
1088
+ # @return [Boolean]
1089
+ attr_accessor :include_replicas_for_major_version_upgrade
1090
+ alias_method :include_replicas_for_major_version_upgrade?, :include_replicas_for_major_version_upgrade
1091
+
906
1092
  # The instance type.
907
1093
  # Corresponds to the JSON property `instanceType`
908
1094
  # @return [String]
@@ -1108,10 +1294,12 @@ module Google
1108
1294
  @disk_encryption_configuration = args[:disk_encryption_configuration] if args.key?(:disk_encryption_configuration)
1109
1295
  @disk_encryption_status = args[:disk_encryption_status] if args.key?(:disk_encryption_status)
1110
1296
  @dns_name = args[:dns_name] if args.key?(:dns_name)
1297
+ @dns_names = args[:dns_names] if args.key?(:dns_names)
1111
1298
  @etag = args[:etag] if args.key?(:etag)
1112
1299
  @failover_replica = args[:failover_replica] if args.key?(:failover_replica)
1113
1300
  @gce_zone = args[:gce_zone] if args.key?(:gce_zone)
1114
1301
  @gemini_config = args[:gemini_config] if args.key?(:gemini_config)
1302
+ @include_replicas_for_major_version_upgrade = args[:include_replicas_for_major_version_upgrade] if args.key?(:include_replicas_for_major_version_upgrade)
1115
1303
  @instance_type = args[:instance_type] if args.key?(:instance_type)
1116
1304
  @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
1117
1305
  @ipv6_address = args[:ipv6_address] if args.key?(:ipv6_address)
@@ -1320,7 +1508,7 @@ module Google
1320
1508
  # @return [String]
1321
1509
  attr_accessor :client_certificate
1322
1510
 
1323
- # PEM representation of the replica's private key. The corresponsing public key
1511
+ # PEM representation of the replica's private key. The corresponding public key
1324
1512
  # is encoded in the client's certificate. The format of the replica's private
1325
1513
  # key can be either PKCS #1 or PKCS #8.
1326
1514
  # Corresponds to the JSON property `clientKey`
@@ -1446,6 +1634,37 @@ module Google
1446
1634
  end
1447
1635
  end
1448
1636
 
1637
+ # DNS metadata.
1638
+ class DnsNameMapping
1639
+ include Google::Apis::Core::Hashable
1640
+
1641
+ # Output only. The connection type of the DNS name.
1642
+ # Corresponds to the JSON property `connectionType`
1643
+ # @return [String]
1644
+ attr_accessor :connection_type
1645
+
1646
+ # Output only. The scope that the DNS name applies to.
1647
+ # Corresponds to the JSON property `dnsScope`
1648
+ # @return [String]
1649
+ attr_accessor :dns_scope
1650
+
1651
+ # The DNS name.
1652
+ # Corresponds to the JSON property `name`
1653
+ # @return [String]
1654
+ attr_accessor :name
1655
+
1656
+ def initialize(**args)
1657
+ update!(**args)
1658
+ end
1659
+
1660
+ # Update properties of this object
1661
+ def update!(**args)
1662
+ @connection_type = args[:connection_type] if args.key?(:connection_type)
1663
+ @dns_scope = args[:dns_scope] if args.key?(:dns_scope)
1664
+ @name = args[:name] if args.key?(:name)
1665
+ end
1666
+ end
1667
+
1449
1668
  # A generic empty message that you can re-use to avoid defining duplicated empty
1450
1669
  # messages in your APIs. A typical example is to use it as the request or the
1451
1670
  # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -1480,11 +1699,14 @@ module Google
1480
1699
  # database is specified, all databases are exported, except for the `mysql`
1481
1700
  # system database. If `fileType` is `CSV`, you can specify one database, either
1482
1701
  # by using this property or by using the `csvExportOptions.selectQuery` property,
1483
- # which takes precedence over this property. `PostgreSQL instances:` You must
1484
- # specify one database to be exported. If `fileType` is `CSV`, this database
1485
- # must match the one specified in the `csvExportOptions.selectQuery` property. `
1486
- # SQL Server instances:` You must specify one database to be exported, and the `
1487
- # fileType` must be `BAK`.
1702
+ # which takes precedence over this property. `PostgreSQL instances:` If you don'
1703
+ # t specify a database by name, all user databases in the instance are exported.
1704
+ # This excludes system databases and Cloud SQL databases used to manage internal
1705
+ # operations. Exporting all user databases is only available for directory-
1706
+ # formatted parallel export. If `fileType` is `CSV`, this database must match
1707
+ # the one specified in the `csvExportOptions.selectQuery` property. `SQL Server
1708
+ # instances:` You must specify one database to be exported, and the `fileType`
1709
+ # must be `BAK`.
1488
1710
  # Corresponds to the JSON property `databases`
1489
1711
  # @return [Array<String>]
1490
1712
  attr_accessor :databases
@@ -1510,6 +1732,11 @@ module Google
1510
1732
  # @return [Google::Apis::SqladminV1::ExportContext::SqlExportOptions]
1511
1733
  attr_accessor :sql_export_options
1512
1734
 
1735
+ # Optional. Export parameters specific to SQL Server TDE certificates
1736
+ # Corresponds to the JSON property `tdeExportOptions`
1737
+ # @return [Google::Apis::SqladminV1::ExportContext::TdeExportOptions]
1738
+ attr_accessor :tde_export_options
1739
+
1513
1740
  # The path to the file in Google Cloud Storage where the export will be stored.
1514
1741
  # The URI is in the form `gs://bucketName/fileName`. If the file already exists,
1515
1742
  # the request succeeds, but the operation fails. If `fileType` is `SQL` and the
@@ -1531,6 +1758,7 @@ module Google
1531
1758
  @kind = args[:kind] if args.key?(:kind)
1532
1759
  @offload = args[:offload] if args.key?(:offload)
1533
1760
  @sql_export_options = args[:sql_export_options] if args.key?(:sql_export_options)
1761
+ @tde_export_options = args[:tde_export_options] if args.key?(:tde_export_options)
1534
1762
  @uri = args[:uri] if args.key?(:uri)
1535
1763
  end
1536
1764
 
@@ -1752,6 +1980,47 @@ module Google
1752
1980
  end
1753
1981
  end
1754
1982
  end
1983
+
1984
+ # Optional. Export parameters specific to SQL Server TDE certificates
1985
+ class TdeExportOptions
1986
+ include Google::Apis::Core::Hashable
1987
+
1988
+ # Required. Path to the TDE certificate public key in the form gs://bucketName/
1989
+ # fileName. The instance must have write access to the bucket. Applicable only
1990
+ # for SQL Server instances.
1991
+ # Corresponds to the JSON property `certificatePath`
1992
+ # @return [String]
1993
+ attr_accessor :certificate_path
1994
+
1995
+ # Required. Certificate name. Applicable only for SQL Server instances.
1996
+ # Corresponds to the JSON property `name`
1997
+ # @return [String]
1998
+ attr_accessor :name
1999
+
2000
+ # Required. Password that encrypts the private key.
2001
+ # Corresponds to the JSON property `privateKeyPassword`
2002
+ # @return [String]
2003
+ attr_accessor :private_key_password
2004
+
2005
+ # Required. Path to the TDE certificate private key in the form gs://bucketName/
2006
+ # fileName. The instance must have write access to the location. Applicable only
2007
+ # for SQL Server instances.
2008
+ # Corresponds to the JSON property `privateKeyPath`
2009
+ # @return [String]
2010
+ attr_accessor :private_key_path
2011
+
2012
+ def initialize(**args)
2013
+ update!(**args)
2014
+ end
2015
+
2016
+ # Update properties of this object
2017
+ def update!(**args)
2018
+ @certificate_path = args[:certificate_path] if args.key?(:certificate_path)
2019
+ @name = args[:name] if args.key?(:name)
2020
+ @private_key_password = args[:private_key_password] if args.key?(:private_key_password)
2021
+ @private_key_path = args[:private_key_path] if args.key?(:private_key_path)
2022
+ end
2023
+ end
1755
2024
  end
1756
2025
 
1757
2026
  # The selected object that Cloud SQL migrates.
@@ -2037,8 +2306,10 @@ module Google
2037
2306
 
2038
2307
  # The target database for the import. If `fileType` is `SQL`, this field is
2039
2308
  # required only if the import file does not specify a database, and is
2040
- # overridden by any database specification in the import file. If `fileType` is `
2041
- # CSV`, one database must be specified.
2309
+ # overridden by any database specification in the import file. For entire
2310
+ # instance parallel import operations, the database is overridden by the
2311
+ # database name stored in subdirectory name. If `fileType` is `CSV`, one
2312
+ # database must be specified.
2042
2313
  # Corresponds to the JSON property `database`
2043
2314
  # @return [String]
2044
2315
  attr_accessor :database
@@ -2064,6 +2335,11 @@ module Google
2064
2335
  # @return [Google::Apis::SqladminV1::ImportContext::SqlImportOptions]
2065
2336
  attr_accessor :sql_import_options
2066
2337
 
2338
+ # Optional. Import parameters specific to SQL Server TDE certificates
2339
+ # Corresponds to the JSON property `tdeImportOptions`
2340
+ # @return [Google::Apis::SqladminV1::ImportContext::TdeImportOptions]
2341
+ attr_accessor :tde_import_options
2342
+
2067
2343
  # Path to the import file in Cloud Storage, in the form `gs://bucketName/
2068
2344
  # fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`.
2069
2345
  # The instance must have write permissions to the bucket and read access to the
@@ -2085,6 +2361,7 @@ module Google
2085
2361
  @import_user = args[:import_user] if args.key?(:import_user)
2086
2362
  @kind = args[:kind] if args.key?(:kind)
2087
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)
2088
2365
  @uri = args[:uri] if args.key?(:uri)
2089
2366
  end
2090
2367
 
@@ -2166,6 +2443,12 @@ module Google
2166
2443
  # @return [String]
2167
2444
  attr_accessor :cert_path
2168
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
+
2169
2452
  # Password that encrypts the private key
2170
2453
  # Corresponds to the JSON property `pvkPassword`
2171
2454
  # @return [String]
@@ -2185,6 +2468,7 @@ module Google
2185
2468
  # Update properties of this object
2186
2469
  def update!(**args)
2187
2470
  @cert_path = args[:cert_path] if args.key?(:cert_path)
2471
+ @keep_encrypted = args[:keep_encrypted] if args.key?(:keep_encrypted)
2188
2472
  @pvk_password = args[:pvk_password] if args.key?(:pvk_password)
2189
2473
  @pvk_path = args[:pvk_path] if args.key?(:pvk_path)
2190
2474
  end
@@ -2304,6 +2588,47 @@ module Google
2304
2588
  end
2305
2589
  end
2306
2590
  end
2591
+
2592
+ # Optional. Import parameters specific to SQL Server TDE certificates
2593
+ class TdeImportOptions
2594
+ include Google::Apis::Core::Hashable
2595
+
2596
+ # Required. Path to the TDE certificate public key in the form gs://bucketName/
2597
+ # fileName. The instance must have read access to the file. Applicable only for
2598
+ # SQL Server instances.
2599
+ # Corresponds to the JSON property `certificatePath`
2600
+ # @return [String]
2601
+ attr_accessor :certificate_path
2602
+
2603
+ # Required. Certificate name. Applicable only for SQL Server instances.
2604
+ # Corresponds to the JSON property `name`
2605
+ # @return [String]
2606
+ attr_accessor :name
2607
+
2608
+ # Required. Password that encrypts the private key.
2609
+ # Corresponds to the JSON property `privateKeyPassword`
2610
+ # @return [String]
2611
+ attr_accessor :private_key_password
2612
+
2613
+ # Required. Path to the TDE certificate private key in the form gs://bucketName/
2614
+ # fileName. The instance must have read access to the file. Applicable only for
2615
+ # SQL Server instances.
2616
+ # Corresponds to the JSON property `privateKeyPath`
2617
+ # @return [String]
2618
+ attr_accessor :private_key_path
2619
+
2620
+ def initialize(**args)
2621
+ update!(**args)
2622
+ end
2623
+
2624
+ # Update properties of this object
2625
+ def update!(**args)
2626
+ @certificate_path = args[:certificate_path] if args.key?(:certificate_path)
2627
+ @name = args[:name] if args.key?(:name)
2628
+ @private_key_password = args[:private_key_password] if args.key?(:private_key_password)
2629
+ @private_key_path = args[:private_key_path] if args.key?(:private_key_path)
2630
+ end
2631
+ end
2307
2632
  end
2308
2633
 
2309
2634
  # Insights configuration. This specifies when Cloud SQL Insights feature is
@@ -2655,19 +2980,33 @@ module Google
2655
2980
  class InstancesRestoreBackupRequest
2656
2981
  include Google::Apis::Core::Hashable
2657
2982
 
2983
+ # The name of the backup that's used to restore a Cloud SQL instance: Format:
2984
+ # projects/`project-id`/backups/`backup-uid`. Only one of restore_backup_context,
2985
+ # backup, backupdr_backup can be passed to the input.
2986
+ # Corresponds to the JSON property `backup`
2987
+ # @return [String]
2988
+ attr_accessor :backup
2989
+
2658
2990
  # Database instance restore from backup context. Backup context contains source
2659
2991
  # instance id and project id.
2660
2992
  # Corresponds to the JSON property `restoreBackupContext`
2661
2993
  # @return [Google::Apis::SqladminV1::RestoreBackupContext]
2662
2994
  attr_accessor :restore_backup_context
2663
2995
 
2996
+ # A Cloud SQL instance resource.
2997
+ # Corresponds to the JSON property `restoreInstanceSettings`
2998
+ # @return [Google::Apis::SqladminV1::DatabaseInstance]
2999
+ attr_accessor :restore_instance_settings
3000
+
2664
3001
  def initialize(**args)
2665
3002
  update!(**args)
2666
3003
  end
2667
3004
 
2668
3005
  # Update properties of this object
2669
3006
  def update!(**args)
3007
+ @backup = args[:backup] if args.key?(:backup)
2670
3008
  @restore_backup_context = args[:restore_backup_context] if args.key?(:restore_backup_context)
3009
+ @restore_instance_settings = args[:restore_instance_settings] if args.key?(:restore_instance_settings)
2671
3010
  end
2672
3011
  end
2673
3012
 
@@ -2728,6 +3067,36 @@ module Google
2728
3067
  end
2729
3068
  end
2730
3069
 
3070
+ # Represents a time interval, encoded as a Timestamp start (inclusive) and a
3071
+ # Timestamp end (exclusive). The start must be less than or equal to the end.
3072
+ # When the start equals the end, the interval is empty (matches no time). When
3073
+ # both start and end are unspecified, the interval matches any time.
3074
+ class Interval
3075
+ include Google::Apis::Core::Hashable
3076
+
3077
+ # Optional. Exclusive end of the interval. If specified, a Timestamp matching
3078
+ # this interval will have to be before the end.
3079
+ # Corresponds to the JSON property `endTime`
3080
+ # @return [String]
3081
+ attr_accessor :end_time
3082
+
3083
+ # Optional. Inclusive start of the interval. If specified, a Timestamp matching
3084
+ # this interval will have to be the same or after the start.
3085
+ # Corresponds to the JSON property `startTime`
3086
+ # @return [String]
3087
+ attr_accessor :start_time
3088
+
3089
+ def initialize(**args)
3090
+ update!(**args)
3091
+ end
3092
+
3093
+ # Update properties of this object
3094
+ def update!(**args)
3095
+ @end_time = args[:end_time] if args.key?(:end_time)
3096
+ @start_time = args[:start_time] if args.key?(:start_time)
3097
+ end
3098
+ end
3099
+
2731
3100
  # IP Management configuration.
2732
3101
  class IpConfiguration
2733
3102
  include Google::Apis::Core::Hashable
@@ -2797,8 +3166,8 @@ module Google
2797
3166
  attr_accessor :server_ca_mode
2798
3167
 
2799
3168
  # Optional. The resource name of the server CA pool for an instance with `
2800
- # CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//
2801
- # caPools/
3169
+ # CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects/`PROJECT`/
3170
+ # locations/`REGION`/caPools/`CA_POOL_ID`
2802
3171
  # Corresponds to the JSON property `serverCaPool`
2803
3172
  # @return [String]
2804
3173
  attr_accessor :server_ca_pool
@@ -2876,6 +3245,39 @@ module Google
2876
3245
  end
2877
3246
  end
2878
3247
 
3248
+ # The response payload containing a list of the backups.
3249
+ class ListBackupsResponse
3250
+ include Google::Apis::Core::Hashable
3251
+
3252
+ # A list of backups.
3253
+ # Corresponds to the JSON property `backups`
3254
+ # @return [Array<Google::Apis::SqladminV1::Backup>]
3255
+ attr_accessor :backups
3256
+
3257
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
3258
+ # field is omitted, then there aren't subsequent pages.
3259
+ # Corresponds to the JSON property `nextPageToken`
3260
+ # @return [String]
3261
+ attr_accessor :next_page_token
3262
+
3263
+ # If a region isn't unavailable or if an unknown error occurs, then a warning
3264
+ # message is returned.
3265
+ # Corresponds to the JSON property `warnings`
3266
+ # @return [Array<Google::Apis::SqladminV1::ApiWarning>]
3267
+ attr_accessor :warnings
3268
+
3269
+ def initialize(**args)
3270
+ update!(**args)
3271
+ end
3272
+
3273
+ # Update properties of this object
3274
+ def update!(**args)
3275
+ @backups = args[:backups] if args.key?(:backups)
3276
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
3277
+ @warnings = args[:warnings] if args.key?(:warnings)
3278
+ end
3279
+ end
3280
+
2879
3281
  # Preferred location. This specifies where a Cloud SQL instance is located. Note
2880
3282
  # that if the preferred location is not available, the instance will be located
2881
3283
  # as close as possible within the region. Only one location may be specified.
@@ -2975,7 +3377,7 @@ module Google
2975
3377
  # @return [String]
2976
3378
  attr_accessor :client_certificate
2977
3379
 
2978
- # PEM representation of the replica's private key. The corresponsing public key
3380
+ # PEM representation of the replica's private key. The corresponding public key
2979
3381
  # is encoded in the client's certificate.
2980
3382
  # Corresponds to the JSON property `clientKey`
2981
3383
  # @return [String]
@@ -3080,7 +3482,7 @@ module Google
3080
3482
  # @return [String]
3081
3483
  attr_accessor :client_certificate
3082
3484
 
3083
- # PEM representation of the replica's private key. The corresponsing public key
3485
+ # PEM representation of the replica's private key. The corresponding public key
3084
3486
  # is encoded in the client's certificate.
3085
3487
  # Corresponds to the JSON property `clientKey`
3086
3488
  # @return [String]
@@ -3235,7 +3637,7 @@ module Google
3235
3637
  # @return [Google::Apis::SqladminV1::SqlSubOperationType]
3236
3638
  attr_accessor :sub_operation_type
3237
3639
 
3238
- #
3640
+ # Name of the resource on which this operation runs.
3239
3641
  # Corresponds to the JSON property `targetId`
3240
3642
  # @return [String]
3241
3643
  attr_accessor :target_id
@@ -4015,6 +4417,12 @@ module Google
4015
4417
  # @return [String]
4016
4418
  attr_accessor :pricing_plan
4017
4419
 
4420
+ # Optional. Configuration value for recreation of replica after certain
4421
+ # replication lag
4422
+ # Corresponds to the JSON property `replicationLagMaxSeconds`
4423
+ # @return [Fixnum]
4424
+ attr_accessor :replication_lag_max_seconds
4425
+
4018
4426
  # The type of replication this instance uses. This can be either `ASYNCHRONOUS`
4019
4427
  # or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First
4020
4428
  # Generation instances.
@@ -4022,6 +4430,15 @@ module Google
4022
4430
  # @return [String]
4023
4431
  attr_accessor :replication_type
4024
4432
 
4433
+ # Optional. When this parameter is set to true, Cloud SQL retains backups of the
4434
+ # instance even after the instance is deleted. The ON_DEMAND backup will be
4435
+ # retained until customer deletes the backup or the project. The AUTOMATED
4436
+ # backup will be retained based on the backups retention setting.
4437
+ # Corresponds to the JSON property `retainBackupsOnDelete`
4438
+ # @return [Boolean]
4439
+ attr_accessor :retain_backups_on_delete
4440
+ alias_method :retain_backups_on_delete?, :retain_backups_on_delete
4441
+
4025
4442
  # The version of instance settings. This is a required field for update method
4026
4443
  # to make sure concurrent updates are handled properly. During update, use the
4027
4444
  # most recent settingsVersion value for this instance and do not try to update
@@ -4097,7 +4514,9 @@ module Google
4097
4514
  @maintenance_window = args[:maintenance_window] if args.key?(:maintenance_window)
4098
4515
  @password_validation_policy = args[:password_validation_policy] if args.key?(:password_validation_policy)
4099
4516
  @pricing_plan = args[:pricing_plan] if args.key?(:pricing_plan)
4517
+ @replication_lag_max_seconds = args[:replication_lag_max_seconds] if args.key?(:replication_lag_max_seconds)
4100
4518
  @replication_type = args[:replication_type] if args.key?(:replication_type)
4519
+ @retain_backups_on_delete = args[:retain_backups_on_delete] if args.key?(:retain_backups_on_delete)
4101
4520
  @settings_version = args[:settings_version] if args.key?(:settings_version)
4102
4521
  @sql_server_audit_config = args[:sql_server_audit_config] if args.key?(:sql_server_audit_config)
4103
4522
  @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 SqladminV1
18
18
  # Version of the google-apis-sqladmin_v1 gem
19
- GEM_VERSION = "0.72.0"
19
+ GEM_VERSION = "0.74.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::SqladminV1::Interval, decorator: Google::Apis::SqladminV1::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::SqladminV1::OperationError, decorator: Google::Apis::SqladminV1::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::SqladminV1::DatabaseInstance, decorator: Google::Apis::SqladminV1::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::SqladminV1::DnsNameMapping, decorator: Google::Apis::SqladminV1::DnsNameMapping::Representation
963
+
894
964
  collection :ip_addresses, as: 'ipAddresses', class: Google::Apis::SqladminV1::IpMapping, decorator: Google::Apis::SqladminV1::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::SqladminV1::DiskEncryptionStatus, decorator: Google::Apis::SqladminV1::DiskEncryptionStatus::Representation
949
1019
 
950
1020
  property :dns_name, as: 'dnsName'
1021
+ collection :dns_names, as: 'dnsNames', class: Google::Apis::SqladminV1::DnsNameMapping, decorator: Google::Apis::SqladminV1::DnsNameMapping::Representation
1022
+
951
1023
  property :etag, as: 'etag'
952
1024
  property :failover_replica, as: 'failoverReplica', class: Google::Apis::SqladminV1::DatabaseInstance::FailoverReplica, decorator: Google::Apis::SqladminV1::DatabaseInstance::FailoverReplica::Representation
953
1025
 
954
1026
  property :gce_zone, as: 'gceZone'
955
1027
  property :gemini_config, as: 'geminiConfig', class: Google::Apis::SqladminV1::GeminiInstanceConfig, decorator: Google::Apis::SqladminV1::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::SqladminV1::IpMapping, decorator: Google::Apis::SqladminV1::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::SqladminV1::ExportContext::SqlExportOptions, decorator: Google::Apis::SqladminV1::ExportContext::SqlExportOptions::Representation
1103
1185
 
1186
+ property :tde_export_options, as: 'tdeExportOptions', class: Google::Apis::SqladminV1::ExportContext::TdeExportOptions, decorator: Google::Apis::SqladminV1::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::SqladminV1::ImportContext::SqlImportOptions, decorator: Google::Apis::SqladminV1::ImportContext::SqlImportOptions::Representation
1243
1337
 
1338
+ property :tde_import_options, as: 'tdeImportOptions', class: Google::Apis::SqladminV1::ImportContext::TdeImportOptions, decorator: Google::Apis::SqladminV1::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 InstancesRestoreBackupRequest
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::SqladminV1::RestoreBackupContext, decorator: Google::Apis::SqladminV1::RestoreBackupContext::Representation
1423
1531
 
1532
+ property :restore_instance_settings, as: 'restoreInstanceSettings', class: Google::Apis::SqladminV1::DatabaseInstance, decorator: Google::Apis::SqladminV1::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::SqladminV1::Backup, decorator: Google::Apis::SqladminV1::Backup::Representation
1601
+
1602
+ property :next_page_token, as: 'nextPageToken'
1603
+ collection :warnings, as: 'warnings', class: Google::Apis::SqladminV1::ApiWarning, decorator: Google::Apis::SqladminV1::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::SqladminV1::PasswordValidationPolicy, decorator: Google::Apis::SqladminV1::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::SqladminV1::SqlServerAuditConfig, decorator: Google::Apis::SqladminV1::SqlServerAuditConfig::Representation
1769
1900
 
@@ -51,6 +51,190 @@ module Google
51
51
  @batch_path = 'batch'
52
52
  end
53
53
 
54
+ # Creates a backup for a Cloud SQL instance. This API can be used only to create
55
+ # on-demand backups.
56
+ # @param [String] parent
57
+ # Required. The parent resource where this backup is created. Format: projects/`
58
+ # project`
59
+ # @param [Google::Apis::SqladminV1::Backup] backup_object
60
+ # @param [String] fields
61
+ # Selector specifying which fields to include in a partial response.
62
+ # @param [String] quota_user
63
+ # Available to use for quota purposes for server-side applications. Can be any
64
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
65
+ # @param [Google::Apis::RequestOptions] options
66
+ # Request-specific options
67
+ #
68
+ # @yield [result, err] Result & error if block supplied
69
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
70
+ # @yieldparam err [StandardError] error object if request failed
71
+ #
72
+ # @return [Google::Apis::SqladminV1::Operation]
73
+ #
74
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
75
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
76
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
77
+ def create_backup_backup(parent, backup_object = nil, fields: nil, quota_user: nil, options: nil, &block)
78
+ command = make_simple_command(:post, 'v1/{+parent}/backups', options)
79
+ command.request_representation = Google::Apis::SqladminV1::Backup::Representation
80
+ command.request_object = backup_object
81
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
82
+ command.response_class = Google::Apis::SqladminV1::Operation
83
+ command.params['parent'] = parent unless parent.nil?
84
+ command.query['fields'] = fields unless fields.nil?
85
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
86
+ execute_or_queue_command(command, &block)
87
+ end
88
+
89
+ # Deletes the backup.
90
+ # @param [String] name
91
+ # Required. The name of the backup to delete. Format: projects/`project`/backups/
92
+ # `backup`
93
+ # @param [String] fields
94
+ # Selector specifying which fields to include in a partial response.
95
+ # @param [String] quota_user
96
+ # Available to use for quota purposes for server-side applications. Can be any
97
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
98
+ # @param [Google::Apis::RequestOptions] options
99
+ # Request-specific options
100
+ #
101
+ # @yield [result, err] Result & error if block supplied
102
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
103
+ # @yieldparam err [StandardError] error object if request failed
104
+ #
105
+ # @return [Google::Apis::SqladminV1::Operation]
106
+ #
107
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
108
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
109
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
110
+ def delete_backup_backup(name, fields: nil, quota_user: nil, options: nil, &block)
111
+ command = make_simple_command(:delete, 'v1/{+name}', options)
112
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
113
+ command.response_class = Google::Apis::SqladminV1::Operation
114
+ command.params['name'] = name unless name.nil?
115
+ command.query['fields'] = fields unless fields.nil?
116
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
117
+ execute_or_queue_command(command, &block)
118
+ end
119
+
120
+ # Retrieves a resource containing information about a backup.
121
+ # @param [String] name
122
+ # Required. The name of the backup to retrieve. Format: projects/`project`/
123
+ # backups/`backup`
124
+ # @param [String] fields
125
+ # Selector specifying which fields to include in a partial response.
126
+ # @param [String] quota_user
127
+ # Available to use for quota purposes for server-side applications. Can be any
128
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
129
+ # @param [Google::Apis::RequestOptions] options
130
+ # Request-specific options
131
+ #
132
+ # @yield [result, err] Result & error if block supplied
133
+ # @yieldparam result [Google::Apis::SqladminV1::Backup] parsed result object
134
+ # @yieldparam err [StandardError] error object if request failed
135
+ #
136
+ # @return [Google::Apis::SqladminV1::Backup]
137
+ #
138
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
139
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
140
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
141
+ def get_backup_backup(name, fields: nil, quota_user: nil, options: nil, &block)
142
+ command = make_simple_command(:get, 'v1/{+name}', options)
143
+ command.response_representation = Google::Apis::SqladminV1::Backup::Representation
144
+ command.response_class = Google::Apis::SqladminV1::Backup
145
+ command.params['name'] = name unless name.nil?
146
+ command.query['fields'] = fields unless fields.nil?
147
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
148
+ execute_or_queue_command(command, &block)
149
+ end
150
+
151
+ # Lists all backups associated with the project.
152
+ # @param [String] parent
153
+ # Required. The parent that owns this collection of backups. Format: projects/`
154
+ # project`
155
+ # @param [String] filter
156
+ # Multiple filter queries are separated by spaces. For example, 'instance:abc
157
+ # AND type:FINAL, 'location:us', 'backupInterval.startTime>=1950-01-01T01:01:25.
158
+ # 771Z'. You can filter by type, instance, backupInterval.startTime (creation
159
+ # time), or location.
160
+ # @param [Fixnum] page_size
161
+ # The maximum number of backups to return per response. The service might return
162
+ # fewer backups than this value. If a value for this parameter isn't specified,
163
+ # then, at most, 500 backups are returned. The maximum value is 2,000. Any
164
+ # values that you set, which are greater than 2,000, are changed to 2,000.
165
+ # @param [String] page_token
166
+ # A page token, received from a previous `ListBackups` call. Provide this to
167
+ # retrieve the subsequent page. When paginating, all other parameters provided
168
+ # to `ListBackups` must match the call that provided the page token.
169
+ # @param [String] fields
170
+ # Selector specifying which fields to include in a partial response.
171
+ # @param [String] quota_user
172
+ # Available to use for quota purposes for server-side applications. Can be any
173
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
174
+ # @param [Google::Apis::RequestOptions] options
175
+ # Request-specific options
176
+ #
177
+ # @yield [result, err] Result & error if block supplied
178
+ # @yieldparam result [Google::Apis::SqladminV1::ListBackupsResponse] parsed result object
179
+ # @yieldparam err [StandardError] error object if request failed
180
+ #
181
+ # @return [Google::Apis::SqladminV1::ListBackupsResponse]
182
+ #
183
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
184
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
185
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
186
+ def list_backup_backups(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
187
+ command = make_simple_command(:get, 'v1/{+parent}/backups', options)
188
+ command.response_representation = Google::Apis::SqladminV1::ListBackupsResponse::Representation
189
+ command.response_class = Google::Apis::SqladminV1::ListBackupsResponse
190
+ command.params['parent'] = parent unless parent.nil?
191
+ command.query['filter'] = filter unless filter.nil?
192
+ command.query['pageSize'] = page_size unless page_size.nil?
193
+ command.query['pageToken'] = page_token unless page_token.nil?
194
+ command.query['fields'] = fields unless fields.nil?
195
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
196
+ execute_or_queue_command(command, &block)
197
+ end
198
+
199
+ # Updates the retention period and description of the backup. You can use this
200
+ # API to update final backups only.
201
+ # @param [String] name
202
+ # Output only. The resource name of the backup. Format: projects/`project`/
203
+ # backups/`backup`.
204
+ # @param [Google::Apis::SqladminV1::Backup] backup_object
205
+ # @param [String] update_mask
206
+ # The list of fields that you can update. You can update only the description
207
+ # and retention period of the final backup.
208
+ # @param [String] fields
209
+ # Selector specifying which fields to include in a partial response.
210
+ # @param [String] quota_user
211
+ # Available to use for quota purposes for server-side applications. Can be any
212
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
213
+ # @param [Google::Apis::RequestOptions] options
214
+ # Request-specific options
215
+ #
216
+ # @yield [result, err] Result & error if block supplied
217
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
218
+ # @yieldparam err [StandardError] error object if request failed
219
+ #
220
+ # @return [Google::Apis::SqladminV1::Operation]
221
+ #
222
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
223
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
224
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
225
+ def update_backup_backup(name, backup_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
226
+ command = make_simple_command(:patch, 'v1/{+name}', options)
227
+ command.request_representation = Google::Apis::SqladminV1::Backup::Representation
228
+ command.request_object = backup_object
229
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
230
+ command.response_class = Google::Apis::SqladminV1::Operation
231
+ command.params['name'] = name unless name.nil?
232
+ command.query['updateMask'] = update_mask unless update_mask.nil?
233
+ command.query['fields'] = fields unless fields.nil?
234
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
235
+ execute_or_queue_command(command, &block)
236
+ end
237
+
54
238
  # Deletes the backup taken by a backup run.
55
239
  # @param [String] project
56
240
  # Project ID of the project that contains the instance.
@@ -765,6 +949,15 @@ module Google
765
949
  # Project ID of the project that contains the instance to be deleted.
766
950
  # @param [String] instance
767
951
  # Cloud SQL instance ID. This does not include the project ID.
952
+ # @param [Boolean] enable_final_backup
953
+ # Flag to opt-in for final backup. By default, it is turned off.
954
+ # @param [String] final_backup_description
955
+ # Optional. The description of the final backup.
956
+ # @param [String] final_backup_expiry_time
957
+ # Optional. Final Backup expiration time. Timestamp in UTC of when this resource
958
+ # is considered expired.
959
+ # @param [Fixnum] final_backup_ttl_days
960
+ # Optional. Retention period of the final backup.
768
961
  # @param [String] fields
769
962
  # Selector specifying which fields to include in a partial response.
770
963
  # @param [String] quota_user
@@ -782,12 +975,16 @@ module Google
782
975
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
783
976
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
784
977
  # @raise [Google::Apis::AuthorizationError] Authorization is required
785
- def delete_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
978
+ 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)
786
979
  command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}', options)
787
980
  command.response_representation = Google::Apis::SqladminV1::Operation::Representation
788
981
  command.response_class = Google::Apis::SqladminV1::Operation
789
982
  command.params['project'] = project unless project.nil?
790
983
  command.params['instance'] = instance unless instance.nil?
984
+ command.query['enableFinalBackup'] = enable_final_backup unless enable_final_backup.nil?
985
+ command.query['finalBackupDescription'] = final_backup_description unless final_backup_description.nil?
986
+ command.query['finalBackupExpiryTime'] = final_backup_expiry_time unless final_backup_expiry_time.nil?
987
+ command.query['finalBackupTtlDays'] = final_backup_ttl_days unless final_backup_ttl_days.nil?
791
988
  command.query['fields'] = fields unless fields.nil?
792
989
  command.query['quotaUser'] = quota_user unless quota_user.nil?
793
990
  execute_or_queue_command(command, &block)
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-sqladmin_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.72.0
4
+ version: 0.74.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-12 00:00:00.000000000 Z
10
+ date: 2025-03-09 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.72.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.74.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1
62
62
  rdoc_options: []
63
63
  require_paths:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
73
73
  - !ruby/object:Gem::Version
74
74
  version: '0'
75
75
  requirements: []
76
- rubygems_version: 3.6.2
76
+ rubygems_version: 3.6.5
77
77
  specification_version: 4
78
78
  summary: Simple REST client for Cloud SQL Admin API V1
79
79
  test_files: []