@googleapis/sqladmin 25.0.0 → 27.0.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.
@@ -69,6 +69,7 @@ export declare namespace sqladmin_v1beta4 {
69
69
  export class Sqladmin {
70
70
  context: APIRequestContext;
71
71
  backupRuns: Resource$Backupruns;
72
+ backups: Resource$Backups;
72
73
  connect: Resource$Connect;
73
74
  databases: Resource$Databases;
74
75
  flags: Resource$Flags;
@@ -165,6 +166,103 @@ export declare namespace sqladmin_v1beta4 {
165
166
  */
166
167
  name?: string | null;
167
168
  }
169
+ /**
170
+ * A backup resource.
171
+ */
172
+ export interface Schema$Backup {
173
+ /**
174
+ * Output only. This output contains the following values: start_time: All database writes up to this time are available. end_time: Any database writes after this time aren't available.
175
+ */
176
+ backupInterval?: Schema$Interval;
177
+ /**
178
+ * Output only. Specifies the kind of backup, PHYSICAL or DEFAULT_SNAPSHOT.
179
+ */
180
+ backupKind?: string | null;
181
+ /**
182
+ * Output only. The mapping to backup run resource used for IAM validations.
183
+ */
184
+ backupRun?: string | null;
185
+ /**
186
+ * Output only. The database version of the instance of when this backup was made.
187
+ */
188
+ databaseVersion?: string | null;
189
+ /**
190
+ * The description of this backup.
191
+ */
192
+ description?: string | null;
193
+ /**
194
+ * Output only. Information about why the backup operation fails (for example, when the backup state fails).
195
+ */
196
+ error?: Schema$OperationError;
197
+ /**
198
+ * Backup expiration time. A UTC timestamp of when this resource expired.
199
+ */
200
+ expiryTime?: string | null;
201
+ /**
202
+ * The name of the database instance.
203
+ */
204
+ instance?: string | null;
205
+ /**
206
+ * Optional. Output only. Timestamp in UTC of when the instance associated with this backup is deleted.
207
+ */
208
+ instanceDeletionTime?: string | null;
209
+ /**
210
+ * Optional. Output only. Instance setting of the source instance that's associated with this backup.
211
+ */
212
+ instanceSettings?: Schema$DatabaseInstance;
213
+ /**
214
+ * Output only. This is always `sql#backup`.
215
+ */
216
+ kind?: string | null;
217
+ /**
218
+ * Output only. This output contains the encryption configuration for a backup and the resource name of the KMS key for disk encryption.
219
+ */
220
+ kmsKey?: string | null;
221
+ /**
222
+ * Output only. This output contains the encryption status for a backup and the version of the KMS key that's used to encrypt the Cloud SQL instance.
223
+ */
224
+ kmsKeyVersion?: string | null;
225
+ /**
226
+ * The storage location of the backups. The location can be multi-regional.
227
+ */
228
+ location?: string | null;
229
+ /**
230
+ * Output only. The maximum chargeable bytes for the backup.
231
+ */
232
+ maxChargeableBytes?: string | null;
233
+ /**
234
+ * Output only. The resource name of the backup. Format: projects/{project\}/backups/{backup\}.
235
+ */
236
+ name?: string | null;
237
+ /**
238
+ * Output only. This status indicates whether the backup satisfies PZI. The status is reserved for future use.
239
+ */
240
+ satisfiesPzi?: boolean | null;
241
+ /**
242
+ * Output only. This status indicates whether the backup satisfies PZS. The status is reserved for future use.
243
+ */
244
+ satisfiesPzs?: boolean | null;
245
+ /**
246
+ * Output only. The URI of this resource.
247
+ */
248
+ selfLink?: string | null;
249
+ /**
250
+ * Output only. The state of this backup.
251
+ */
252
+ state?: string | null;
253
+ /**
254
+ * Output only. This output contains a backup time zone. If a Cloud SQL for SQL Server instance has a different time zone from the backup's time zone, then the restore to the instance doesn't happen.
255
+ */
256
+ timeZone?: string | null;
257
+ /**
258
+ * Input only. The time-to-live (TTL) interval for this resource (in days). For example: ttlDays:7, means 7 days from the current time. The expiration time can't exceed 365 days from the time that the backup is created.
259
+ */
260
+ ttlDays?: string | null;
261
+ /**
262
+ * Output only. The type of this backup. The type can be "AUTOMATED", "ON_DEMAND", or “FINAL”.
263
+ */
264
+ type?: string | null;
265
+ }
168
266
  /**
169
267
  * Database instance backup configuration.
170
268
  */
@@ -222,6 +320,10 @@ export declare namespace sqladmin_v1beta4 {
222
320
  * This is always `sql#backupContext`.
223
321
  */
224
322
  kind?: string | null;
323
+ /**
324
+ * The name of the backup. Format: projects/{project\}/backups/{backup\}
325
+ */
326
+ name?: string | null;
225
327
  }
226
328
  /**
227
329
  * Backup Reencryption Config
@@ -257,6 +359,10 @@ export declare namespace sqladmin_v1beta4 {
257
359
  * Specifies the kind of backup, PHYSICAL or DEFAULT_SNAPSHOT.
258
360
  */
259
361
  backupKind?: string | null;
362
+ /**
363
+ * Output only. The instance database version when this backup was made.
364
+ */
365
+ databaseVersion?: string | null;
260
366
  /**
261
367
  * The description of this run, only applicable to on-demand backups.
262
368
  */
@@ -401,6 +507,77 @@ export declare namespace sqladmin_v1beta4 {
401
507
  */
402
508
  preferredZone?: string | null;
403
509
  }
510
+ /**
511
+ * The managed connection pooling configuration.
512
+ */
513
+ export interface Schema$ConnectionPoolConfig {
514
+ /**
515
+ * Client idle timeout.
516
+ */
517
+ clientConnectionIdleTimeout?: string | null;
518
+ /**
519
+ * Whether managed connection pooling is enabled.
520
+ */
521
+ connectionPoolingEnabled?: boolean | null;
522
+ /**
523
+ * Managed connection pool size.
524
+ */
525
+ connPoolSize?: number | null;
526
+ /**
527
+ * Optional. List of connection pool configuration flags
528
+ */
529
+ flags?: Schema$ConnectionPoolFlags[];
530
+ /**
531
+ * Maximum number of client connections in connection pool.
532
+ */
533
+ maxClientConnections?: number | null;
534
+ /**
535
+ * The managed connection pool mode for the instance.
536
+ */
537
+ poolMode?: string | null;
538
+ /**
539
+ * Query wait timeout.
540
+ */
541
+ queryWaitTimeout?: string | null;
542
+ /**
543
+ * Server idle timeout.
544
+ */
545
+ serverConnectionIdleTimeout?: string | null;
546
+ }
547
+ /**
548
+ * Connection pool flags for Cloud SQL instances managed connection pool configuration.
549
+ */
550
+ export interface Schema$ConnectionPoolFlags {
551
+ /**
552
+ * Required. The name of the flag.
553
+ */
554
+ name?: string | null;
555
+ /**
556
+ * Required. The value of the flag. Boolean flags are set to `on` for true and `off` for false. This field must be omitted if the flag doesn't take a value.
557
+ */
558
+ value?: string | null;
559
+ }
560
+ /**
561
+ * Details of a single node of a read pool.
562
+ */
563
+ export interface Schema$ConnectPoolNodeConfig {
564
+ /**
565
+ * Output only. The DNS name of the node.
566
+ */
567
+ dnsName?: string | null;
568
+ /**
569
+ * Output only. The list of DNS names used by this instance.
570
+ */
571
+ dnsNames?: Schema$DnsNameMapping[];
572
+ /**
573
+ * Output only. Mappings containing IP addresses that can be used to connect to the node.
574
+ */
575
+ ipAddresses?: Schema$IpMapping[];
576
+ /**
577
+ * Output only. The name of the node. Doesn't include the project ID.
578
+ */
579
+ name?: string | null;
580
+ }
404
581
  /**
405
582
  * Connect settings retrieval response.
406
583
  */
@@ -421,6 +598,10 @@ export declare namespace sqladmin_v1beta4 {
421
598
  * The dns name of the instance.
422
599
  */
423
600
  dnsName?: string | null;
601
+ /**
602
+ * Output only. The list of DNS names used by this instance.
603
+ */
604
+ dnsNames?: Schema$DnsNameMapping[];
424
605
  /**
425
606
  * The assigned IP addresses for the instance.
426
607
  */
@@ -429,6 +610,14 @@ export declare namespace sqladmin_v1beta4 {
429
610
  * This is always `sql#connectSettings`.
430
611
  */
431
612
  kind?: string | null;
613
+ /**
614
+ * The number of nodes in a read pool.
615
+ */
616
+ nodeCount?: number | null;
617
+ /**
618
+ * Output only. Entries containing information about each node of the read pool.
619
+ */
620
+ nodes?: Schema$ConnectPoolNodeConfig[];
432
621
  /**
433
622
  * Whether PSC connectivity is enabled for this instance.
434
623
  */
@@ -541,6 +730,10 @@ export declare namespace sqladmin_v1beta4 {
541
730
  * Output only. The dns name of the instance.
542
731
  */
543
732
  dnsName?: string | null;
733
+ /**
734
+ * Output only. The list of DNS names used by this instance.
735
+ */
736
+ dnsNames?: Schema$DnsNameMapping[];
544
737
  /**
545
738
  * This field is deprecated and will be removed from a future version of the API. Use the `settings.settingsVersion` field instead.
546
739
  */
@@ -560,6 +753,10 @@ export declare namespace sqladmin_v1beta4 {
560
753
  * Gemini instance configuration.
561
754
  */
562
755
  geminiConfig?: Schema$GeminiInstanceConfig;
756
+ /**
757
+ * Input only. Determines whether an in-place major version upgrade of replicas happens when an in-place major version upgrade of a primary instance is initiated.
758
+ */
759
+ includeReplicasForMajorVersionUpgrade?: boolean | null;
563
760
  /**
564
761
  * The instance type.
565
762
  */
@@ -592,6 +789,14 @@ export declare namespace sqladmin_v1beta4 {
592
789
  * Name of the Cloud SQL instance. This does not include the project ID.
593
790
  */
594
791
  name?: string | null;
792
+ /**
793
+ * The number of nodes in a read pool.
794
+ */
795
+ nodeCount?: number | null;
796
+ /**
797
+ * Output only. Entries containing information about each node of the read pool.
798
+ */
799
+ nodes?: Schema$PoolNodeConfig[];
595
800
  /**
596
801
  * Configuration specific to on-premises instances.
597
802
  */
@@ -781,7 +986,7 @@ export declare namespace sqladmin_v1beta4 {
781
986
  */
782
987
  clientCertificate?: string | null;
783
988
  /**
784
- * PEM representation of the replica's private key. The corresponsing public key is encoded in the client's certificate. The format of the replica's private key can be either PKCS #1 or PKCS #8.
989
+ * PEM representation of the replica's private key. The corresponding public key is encoded in the client's certificate. The format of the replica's private key can be either PKCS #1 or PKCS #8.
785
990
  */
786
991
  clientKey?: string | null;
787
992
  /**
@@ -840,6 +1045,23 @@ export declare namespace sqladmin_v1beta4 {
840
1045
  */
841
1046
  kmsKeyVersionName?: string | null;
842
1047
  }
1048
+ /**
1049
+ * DNS metadata.
1050
+ */
1051
+ export interface Schema$DnsNameMapping {
1052
+ /**
1053
+ * Output only. The connection type of the DNS name.
1054
+ */
1055
+ connectionType?: string | null;
1056
+ /**
1057
+ * Output only. The scope that the DNS name applies to.
1058
+ */
1059
+ dnsScope?: string | null;
1060
+ /**
1061
+ * The DNS name.
1062
+ */
1063
+ name?: string | null;
1064
+ }
843
1065
  /**
844
1066
  * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \}
845
1067
  */
@@ -872,7 +1094,7 @@ export declare namespace sqladmin_v1beta4 {
872
1094
  selectQuery?: string;
873
1095
  } | null;
874
1096
  /**
875
- * Databases to be exported. `MySQL instances:` If `fileType` is `SQL` and no database is specified, all databases are exported, except for the `mysql` system database. If `fileType` is `CSV`, you can specify one database, either by using this property or by using the `csvExportOptions.selectQuery` property, which takes precedence over this property. `PostgreSQL instances:` You must specify one database to be exported. If `fileType` is `CSV`, this database must match the one specified in the `csvExportOptions.selectQuery` property. `SQL Server instances:` You must specify one database to be exported, and the `fileType` must be `BAK`.
1097
+ * Databases to be exported. `MySQL instances:` If `fileType` is `SQL` and no database is specified, all databases are exported, except for the `mysql` system database. If `fileType` is `CSV`, you can specify one database, either by using this property or by using the `csvExportOptions.selectQuery` property, which takes precedence over this property. `PostgreSQL instances:` If you don't specify a database by name, all user databases in the instance are exported. This excludes system databases and Cloud SQL databases used to manage internal operations. Exporting all user databases is only available for directory-formatted parallel export. If `fileType` is `CSV`, this database must match the one specified in the `csvExportOptions.selectQuery` property. `SQL Server instances:` You must specify one database to be exported, and the `fileType` must be `BAK`.
876
1098
  */
877
1099
  databases?: string[] | null;
878
1100
  /**
@@ -903,6 +1125,15 @@ export declare namespace sqladmin_v1beta4 {
903
1125
  tables?: string[];
904
1126
  threads?: number;
905
1127
  } | null;
1128
+ /**
1129
+ * Optional. Export parameters specific to SQL Server TDE certificates
1130
+ */
1131
+ tdeExportOptions?: {
1132
+ certificatePath?: string;
1133
+ name?: string;
1134
+ privateKeyPassword?: string;
1135
+ privateKeyPath?: string;
1136
+ } | null;
906
1137
  /**
907
1138
  * The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/fileName`. If the file already exists, the request succeeds, but the operation fails. If `fileType` is `SQL` and the filename ends with .gz, the contents are compressed.
908
1139
  */
@@ -946,6 +1177,10 @@ export declare namespace sqladmin_v1beta4 {
946
1177
  * The database version this flag applies to. Can be MySQL instances: `MYSQL_8_0`, `MYSQL_8_0_18`, `MYSQL_8_0_26`, `MYSQL_5_7`, or `MYSQL_5_6`. PostgreSQL instances: `POSTGRES_9_6`, `POSTGRES_10`, `POSTGRES_11` or `POSTGRES_12`. SQL Server instances: `SQLSERVER_2017_STANDARD`, `SQLSERVER_2017_ENTERPRISE`, `SQLSERVER_2017_EXPRESS`, `SQLSERVER_2017_WEB`, `SQLSERVER_2019_STANDARD`, `SQLSERVER_2019_ENTERPRISE`, `SQLSERVER_2019_EXPRESS`, or `SQLSERVER_2019_WEB`. See [the complete list](/sql/docs/mysql/admin-api/rest/v1/SqlDatabaseVersion).
947
1178
  */
948
1179
  appliesTo?: string[] | null;
1180
+ /**
1181
+ * Scope of flag.
1182
+ */
1183
+ flagScope?: string | null;
949
1184
  /**
950
1185
  * Whether or not the flag is considered in beta.
951
1186
  */
@@ -966,6 +1201,14 @@ export declare namespace sqladmin_v1beta4 {
966
1201
  * This is the name of the flag. Flag names always use underscores, not hyphens, for example: `max_allowed_packet`
967
1202
  */
968
1203
  name?: string | null;
1204
+ /**
1205
+ * Recommended flag value in integer format for UI display.
1206
+ */
1207
+ recommendedIntValue?: string | null;
1208
+ /**
1209
+ * Recommended flag value in string format for UI display.
1210
+ */
1211
+ recommendedStringValue?: string | null;
969
1212
  /**
970
1213
  * Indicates whether changing this flag will trigger a database restart. Only applicable to Second Generation instances.
971
1214
  */
@@ -1058,6 +1301,7 @@ export declare namespace sqladmin_v1beta4 {
1058
1301
  bakType?: string;
1059
1302
  encryptionOptions?: {
1060
1303
  certPath?: string;
1304
+ keepEncrypted?: boolean;
1061
1305
  pvkPassword?: string;
1062
1306
  pvkPath?: string;
1063
1307
  };
@@ -1079,7 +1323,7 @@ export declare namespace sqladmin_v1beta4 {
1079
1323
  table?: string;
1080
1324
  } | null;
1081
1325
  /**
1082
- * The target database for the import. If `fileType` is `SQL`, this field is required only if the import file does not specify a database, and is overridden by any database specification in the import file. If `fileType` is `CSV`, one database must be specified.
1326
+ * The target database for the import. If `fileType` is `SQL`, this field is required only if the import file does not specify a database, and is overridden by any database specification in the import file. For entire instance parallel import operations, the database is overridden by the database name stored in subdirectory name. If `fileType` is `CSV`, one database must be specified.
1083
1327
  */
1084
1328
  database?: string | null;
1085
1329
  /**
@@ -1105,6 +1349,15 @@ export declare namespace sqladmin_v1beta4 {
1105
1349
  };
1106
1350
  threads?: number;
1107
1351
  } | null;
1352
+ /**
1353
+ * Optional. Import parameters specific to SQL Server .TDE files Import parameters specific to SQL Server TDE certificates
1354
+ */
1355
+ tdeImportOptions?: {
1356
+ certificatePath?: string;
1357
+ name?: string;
1358
+ privateKeyPassword?: string;
1359
+ privateKeyPath?: string;
1360
+ } | null;
1108
1361
  /**
1109
1362
  * Path to the import file in Cloud Storage, in the form `gs://bucketName/fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`. The instance must have write permissions to the bucket and read access to the file.
1110
1363
  */
@@ -1284,10 +1537,18 @@ export declare namespace sqladmin_v1beta4 {
1284
1537
  * Database instance restore backup request.
1285
1538
  */
1286
1539
  export interface Schema$InstancesRestoreBackupRequest {
1540
+ /**
1541
+ * The name of the backup that's used to restore a Cloud SQL instance: Format: projects/{project-id\}/backups/{backup-uid\}. Only one of restore_backup_context, backup, backupdr_backup can be passed to the input.
1542
+ */
1543
+ backup?: string | null;
1287
1544
  /**
1288
1545
  * Parameters required to perform the restore backup operation.
1289
1546
  */
1290
1547
  restoreBackupContext?: Schema$RestoreBackupContext;
1548
+ /**
1549
+ * Optional. By using this parameter, Cloud SQL overrides any instance settings stored in the backup you are restoring from. You can't change the instance's major database version and you can only increase the disk size. You can use this field to restore new instances only. This field is not applicable for restore to existing instances.
1550
+ */
1551
+ restoreInstanceSettings?: Schema$DatabaseInstance;
1291
1552
  }
1292
1553
  /**
1293
1554
  * Rotate Server CA request.
@@ -1316,6 +1577,19 @@ export declare namespace sqladmin_v1beta4 {
1316
1577
  */
1317
1578
  truncateLogContext?: Schema$TruncateLogContext;
1318
1579
  }
1580
+ /**
1581
+ * Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.
1582
+ */
1583
+ export interface Schema$Interval {
1584
+ /**
1585
+ * Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
1586
+ */
1587
+ endTime?: string | null;
1588
+ /**
1589
+ * Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
1590
+ */
1591
+ startTime?: string | null;
1592
+ }
1319
1593
  /**
1320
1594
  * IP Management configuration.
1321
1595
  */
@@ -1357,7 +1631,7 @@ export declare namespace sqladmin_v1beta4 {
1357
1631
  */
1358
1632
  serverCaMode?: string | null;
1359
1633
  /**
1360
- * Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/
1634
+ * Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects/{PROJECT\}/locations/{REGION\}/caPools/{CA_POOL_ID\}
1361
1635
  */
1362
1636
  serverCaPool?: string | null;
1363
1637
  /**
@@ -1382,6 +1656,23 @@ export declare namespace sqladmin_v1beta4 {
1382
1656
  */
1383
1657
  type?: string | null;
1384
1658
  }
1659
+ /**
1660
+ * The response payload containing a list of the backups.
1661
+ */
1662
+ export interface Schema$ListBackupsResponse {
1663
+ /**
1664
+ * A list of backups.
1665
+ */
1666
+ backups?: Schema$Backup[];
1667
+ /**
1668
+ * A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, then there aren't subsequent pages.
1669
+ */
1670
+ nextPageToken?: string | null;
1671
+ /**
1672
+ * If a region isn't unavailable or if an unknown error occurs, then a warning message is returned.
1673
+ */
1674
+ warnings?: Schema$ApiWarning[];
1675
+ }
1385
1676
  /**
1386
1677
  * Preferred location. This specifies where a Cloud SQL instance is located. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified.
1387
1678
  */
@@ -1437,7 +1728,7 @@ export declare namespace sqladmin_v1beta4 {
1437
1728
  */
1438
1729
  clientCertificate?: string | null;
1439
1730
  /**
1440
- * PEM representation of the replica's private key. The corresponsing public key is encoded in the client's certificate.
1731
+ * PEM representation of the replica's private key. The corresponding public key is encoded in the client's certificate.
1441
1732
  */
1442
1733
  clientKey?: string | null;
1443
1734
  /**
@@ -1495,7 +1786,7 @@ export declare namespace sqladmin_v1beta4 {
1495
1786
  */
1496
1787
  clientCertificate?: string | null;
1497
1788
  /**
1498
- * PEM representation of the replica's private key. The corresponsing public key is encoded in the client's certificate.
1789
+ * PEM representation of the replica's private key. The corresponding public key is encoded in the client's certificate.
1499
1790
  */
1500
1791
  clientKey?: string | null;
1501
1792
  /**
@@ -1595,6 +1886,9 @@ export declare namespace sqladmin_v1beta4 {
1595
1886
  * Optional. The sub operation based on the operation type.
1596
1887
  */
1597
1888
  subOperationType?: Schema$SqlSubOperationType;
1889
+ /**
1890
+ * Name of the resource on which this operation runs.
1891
+ */
1598
1892
  targetId?: string | null;
1599
1893
  targetLink?: string | null;
1600
1894
  /**
@@ -1741,6 +2035,35 @@ export declare namespace sqladmin_v1beta4 {
1741
2035
  */
1742
2036
  targetSizeGb?: string | null;
1743
2037
  }
2038
+ /**
2039
+ * Details of a single node of a read pool.
2040
+ */
2041
+ export interface Schema$PoolNodeConfig {
2042
+ /**
2043
+ * Output only. The DNS name of the node.
2044
+ */
2045
+ dnsName?: string | null;
2046
+ /**
2047
+ * Output only. The list of DNS names used by this node.
2048
+ */
2049
+ dnsNames?: Schema$DnsNameMapping[];
2050
+ /**
2051
+ * Output only. The serving zone of the node.
2052
+ */
2053
+ gceZone?: string | null;
2054
+ /**
2055
+ * Output only. Mappings containing IP addresses that can be used to connect to the node.
2056
+ */
2057
+ ipAddresses?: Schema$IpMapping[];
2058
+ /**
2059
+ * Output only. The name of the node, to be used for retrieving metrics and logs for the node.
2060
+ */
2061
+ name?: string | null;
2062
+ /**
2063
+ * Output only. The current state of the node.
2064
+ */
2065
+ state?: string | null;
2066
+ }
1744
2067
  /**
1745
2068
  * Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.
1746
2069
  */
@@ -1919,6 +2242,10 @@ export declare namespace sqladmin_v1beta4 {
1919
2242
  * The name of server Instance collation.
1920
2243
  */
1921
2244
  collation?: string | null;
2245
+ /**
2246
+ * Optional. The managed connection pooling configuration for the instance.
2247
+ */
2248
+ connectionPoolConfig?: Schema$ConnectionPoolConfig;
1922
2249
  /**
1923
2250
  * Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance.
1924
2251
  */
@@ -1939,6 +2266,14 @@ export declare namespace sqladmin_v1beta4 {
1939
2266
  * Configuration for data cache.
1940
2267
  */
1941
2268
  dataCacheConfig?: Schema$DataCacheConfig;
2269
+ /**
2270
+ * Optional. Provisioned number of I/O operations per second for the data disk. This field is only used for hyperdisk-balanced disk types.
2271
+ */
2272
+ dataDiskProvisionedIops?: string | null;
2273
+ /**
2274
+ * Optional. Provisioned throughput measured in MiB per second for the data disk. This field is only used for hyperdisk-balanced disk types.
2275
+ */
2276
+ dataDiskProvisionedThroughput?: string | null;
1942
2277
  /**
1943
2278
  * The size of data disk, in GB. The data disk size minimum is 10GB.
1944
2279
  */
@@ -2003,6 +2338,10 @@ export declare namespace sqladmin_v1beta4 {
2003
2338
  * The type of replication this instance uses. This can be either `ASYNCHRONOUS` or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First Generation instances.
2004
2339
  */
2005
2340
  replicationType?: string | null;
2341
+ /**
2342
+ * Optional. When this parameter is set to true, Cloud SQL retains backups of the instance even after the instance is deleted. The ON_DEMAND backup will be retained until customer deletes the backup or the project. The AUTOMATED backup will be retained based on the backups retention setting.
2343
+ */
2344
+ retainBackupsOnDelete?: boolean | null;
2006
2345
  /**
2007
2346
  * The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
2008
2347
  */
@@ -2664,6 +3003,134 @@ export declare namespace sqladmin_v1beta4 {
2664
3003
  */
2665
3004
  project?: string;
2666
3005
  }
3006
+ export class Resource$Backups {
3007
+ context: APIRequestContext;
3008
+ constructor(context: APIRequestContext);
3009
+ /**
3010
+ * Creates a backup for a Cloud SQL instance. This API can be used only to create on-demand backups.
3011
+ *
3012
+ * @param params - Parameters for request
3013
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3014
+ * @param callback - Optional callback that handles the response.
3015
+ * @returns A promise if used with async/await, or void if used with a callback.
3016
+ */
3017
+ createBackup(params: Params$Resource$Backups$Createbackup, options: StreamMethodOptions): GaxiosPromise<Readable>;
3018
+ createBackup(params?: Params$Resource$Backups$Createbackup, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
3019
+ createBackup(params: Params$Resource$Backups$Createbackup, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
3020
+ createBackup(params: Params$Resource$Backups$Createbackup, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
3021
+ createBackup(params: Params$Resource$Backups$Createbackup, callback: BodyResponseCallback<Schema$Operation>): void;
3022
+ createBackup(callback: BodyResponseCallback<Schema$Operation>): void;
3023
+ /**
3024
+ * Deletes the backup.
3025
+ *
3026
+ * @param params - Parameters for request
3027
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3028
+ * @param callback - Optional callback that handles the response.
3029
+ * @returns A promise if used with async/await, or void if used with a callback.
3030
+ */
3031
+ deleteBackup(params: Params$Resource$Backups$Deletebackup, options: StreamMethodOptions): GaxiosPromise<Readable>;
3032
+ deleteBackup(params?: Params$Resource$Backups$Deletebackup, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
3033
+ deleteBackup(params: Params$Resource$Backups$Deletebackup, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
3034
+ deleteBackup(params: Params$Resource$Backups$Deletebackup, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
3035
+ deleteBackup(params: Params$Resource$Backups$Deletebackup, callback: BodyResponseCallback<Schema$Operation>): void;
3036
+ deleteBackup(callback: BodyResponseCallback<Schema$Operation>): void;
3037
+ /**
3038
+ * Retrieves a resource containing information about a backup.
3039
+ *
3040
+ * @param params - Parameters for request
3041
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3042
+ * @param callback - Optional callback that handles the response.
3043
+ * @returns A promise if used with async/await, or void if used with a callback.
3044
+ */
3045
+ getBackup(params: Params$Resource$Backups$Getbackup, options: StreamMethodOptions): GaxiosPromise<Readable>;
3046
+ getBackup(params?: Params$Resource$Backups$Getbackup, options?: MethodOptions): GaxiosPromise<Schema$Backup>;
3047
+ getBackup(params: Params$Resource$Backups$Getbackup, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
3048
+ getBackup(params: Params$Resource$Backups$Getbackup, options: MethodOptions | BodyResponseCallback<Schema$Backup>, callback: BodyResponseCallback<Schema$Backup>): void;
3049
+ getBackup(params: Params$Resource$Backups$Getbackup, callback: BodyResponseCallback<Schema$Backup>): void;
3050
+ getBackup(callback: BodyResponseCallback<Schema$Backup>): void;
3051
+ /**
3052
+ * Lists all backups associated with the project.
3053
+ *
3054
+ * @param params - Parameters for request
3055
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3056
+ * @param callback - Optional callback that handles the response.
3057
+ * @returns A promise if used with async/await, or void if used with a callback.
3058
+ */
3059
+ listBackups(params: Params$Resource$Backups$Listbackups, options: StreamMethodOptions): GaxiosPromise<Readable>;
3060
+ listBackups(params?: Params$Resource$Backups$Listbackups, options?: MethodOptions): GaxiosPromise<Schema$ListBackupsResponse>;
3061
+ listBackups(params: Params$Resource$Backups$Listbackups, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
3062
+ listBackups(params: Params$Resource$Backups$Listbackups, options: MethodOptions | BodyResponseCallback<Schema$ListBackupsResponse>, callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
3063
+ listBackups(params: Params$Resource$Backups$Listbackups, callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
3064
+ listBackups(callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
3065
+ /**
3066
+ * Updates the retention period and the description of the backup. You can use this API to update final backups only.
3067
+ *
3068
+ * @param params - Parameters for request
3069
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
3070
+ * @param callback - Optional callback that handles the response.
3071
+ * @returns A promise if used with async/await, or void if used with a callback.
3072
+ */
3073
+ updateBackup(params: Params$Resource$Backups$Updatebackup, options: StreamMethodOptions): GaxiosPromise<Readable>;
3074
+ updateBackup(params?: Params$Resource$Backups$Updatebackup, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
3075
+ updateBackup(params: Params$Resource$Backups$Updatebackup, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
3076
+ updateBackup(params: Params$Resource$Backups$Updatebackup, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
3077
+ updateBackup(params: Params$Resource$Backups$Updatebackup, callback: BodyResponseCallback<Schema$Operation>): void;
3078
+ updateBackup(callback: BodyResponseCallback<Schema$Operation>): void;
3079
+ }
3080
+ export interface Params$Resource$Backups$Createbackup extends StandardParameters {
3081
+ /**
3082
+ * Required. The parent resource where this backup is created. Format: projects/{project\}
3083
+ */
3084
+ parent?: string;
3085
+ /**
3086
+ * Request body metadata
3087
+ */
3088
+ requestBody?: Schema$Backup;
3089
+ }
3090
+ export interface Params$Resource$Backups$Deletebackup extends StandardParameters {
3091
+ /**
3092
+ * Required. The name of the backup to delete. Format: projects/{project\}/backups/{backup\}
3093
+ */
3094
+ name?: string;
3095
+ }
3096
+ export interface Params$Resource$Backups$Getbackup extends StandardParameters {
3097
+ /**
3098
+ * Required. The name of the backup to retrieve. Format: projects/{project\}/backups/{backup\}
3099
+ */
3100
+ name?: string;
3101
+ }
3102
+ export interface Params$Resource$Backups$Listbackups extends StandardParameters {
3103
+ /**
3104
+ * Multiple filter queries are separated by spaces. For example, 'instance:abc AND type:FINAL, 'location:us', 'backupInterval.startTime\>=1950-01-01T01:01:25.771Z'. You can filter by type, instance, backupInterval.startTime (creation time), or location.
3105
+ */
3106
+ filter?: string;
3107
+ /**
3108
+ * The maximum number of backups to return per response. The service might return fewer backups than this value. If a value for this parameter isn't specified, then, at most, 500 backups are returned. The maximum value is 2,000. Any values that you set, which are greater than 2,000, are changed to 2,000.
3109
+ */
3110
+ pageSize?: number;
3111
+ /**
3112
+ * A page token, received from a previous `ListBackups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListBackups` must match the call that provided the page token.
3113
+ */
3114
+ pageToken?: string;
3115
+ /**
3116
+ * Required. The parent that owns this collection of backups. Format: projects/{project\}
3117
+ */
3118
+ parent?: string;
3119
+ }
3120
+ export interface Params$Resource$Backups$Updatebackup extends StandardParameters {
3121
+ /**
3122
+ * Output only. The resource name of the backup. Format: projects/{project\}/backups/{backup\}.
3123
+ */
3124
+ name?: string;
3125
+ /**
3126
+ * The list of fields that you can update. You can update only the description and retention period of the final backup.
3127
+ */
3128
+ updateMask?: string;
3129
+ /**
3130
+ * Request body metadata
3131
+ */
3132
+ requestBody?: Schema$Backup;
3133
+ }
2667
3134
  export class Resource$Connect {
2668
3135
  context: APIRequestContext;
2669
3136
  constructor(context: APIRequestContext);
@@ -2923,6 +3390,10 @@ export declare namespace sqladmin_v1beta4 {
2923
3390
  * Database type and version you want to retrieve flags for. By default, this method returns flags for all database types and versions.
2924
3391
  */
2925
3392
  databaseVersion?: string;
3393
+ /**
3394
+ * Optional. Specify the scope of flags to be returned by SqlFlagsListService. Return list of database flags if unspecified.
3395
+ */
3396
+ flagScope?: string;
2926
3397
  }
2927
3398
  export class Resource$Instances {
2928
3399
  context: APIRequestContext;
@@ -3383,6 +3854,22 @@ export declare namespace sqladmin_v1beta4 {
3383
3854
  requestBody?: Schema$InstancesCloneRequest;
3384
3855
  }
3385
3856
  export interface Params$Resource$Instances$Delete extends StandardParameters {
3857
+ /**
3858
+ * Flag to opt-in for final backup. By default, it is turned off.
3859
+ */
3860
+ enableFinalBackup?: boolean;
3861
+ /**
3862
+ * Optional. The description of the final backup.
3863
+ */
3864
+ finalBackupDescription?: string;
3865
+ /**
3866
+ * Optional. Final Backup expiration time. Timestamp in UTC of when this resource is considered expired.
3867
+ */
3868
+ finalBackupExpiryTime?: string;
3869
+ /**
3870
+ * Optional. Retention period of the final backup.
3871
+ */
3872
+ finalBackupTtlDays?: string;
3386
3873
  /**
3387
3874
  * Cloud SQL instance ID. This does not include the project ID.
3388
3875
  */