@googleapis/sqladmin 32.0.0 → 34.1.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.
@@ -166,7 +166,7 @@ export declare namespace sqladmin_v1beta4 {
166
166
  name?: string | null;
167
167
  }
168
168
  /**
169
- * A backup resource. Next ID: 30
169
+ * A backup resource.
170
170
  */
171
171
  export interface Schema$Backup {
172
172
  /**
@@ -1083,6 +1083,10 @@ export declare namespace sqladmin_v1beta4 {
1083
1083
  * Optional. Name of the database on which the statement will be executed.
1084
1084
  */
1085
1085
  database?: string | null;
1086
+ /**
1087
+ * Optional. Controls how the API should respond when the SQL execution result is incomplete due to the size limit or another error. The default mode is to throw an error.
1088
+ */
1089
+ partialResultMode?: string | null;
1086
1090
  /**
1087
1091
  * Optional. The maximum number of rows returned per SQL statement.
1088
1092
  */
@@ -1091,6 +1095,10 @@ export declare namespace sqladmin_v1beta4 {
1091
1095
  * Required. SQL statements to run on the database. It can be a single statement or a sequence of statements separated by semicolons.
1092
1096
  */
1093
1097
  sqlStatement?: string | null;
1098
+ /**
1099
+ * Optional. The name of an existing database user to connect to the database. When `auto_iam_authn` is set to true, this field is ignored and the API caller's IAM user is used.
1100
+ */
1101
+ user?: string | null;
1094
1102
  }
1095
1103
  /**
1096
1104
  * Database instance export context.
@@ -1562,6 +1570,15 @@ export declare namespace sqladmin_v1beta4 {
1562
1570
  */
1563
1571
  serverCerts?: Schema$SslCert[];
1564
1572
  }
1573
+ /**
1574
+ * Request for Pre-checks for MVU
1575
+ */
1576
+ export interface Schema$InstancesPreCheckMajorVersionUpgradeRequest {
1577
+ /**
1578
+ * Required. Contains details about the pre-check major version upgrade operation.
1579
+ */
1580
+ preCheckMajorVersionUpgradeContext?: Schema$PreCheckMajorVersionUpgradeContext;
1581
+ }
1565
1582
  /**
1566
1583
  * Database Instance reencrypt request.
1567
1584
  */
@@ -1761,6 +1778,19 @@ export declare namespace sqladmin_v1beta4 {
1761
1778
  */
1762
1779
  updateTrack?: string | null;
1763
1780
  }
1781
+ /**
1782
+ * Represents a notice or warning message from the database.
1783
+ */
1784
+ export interface Schema$Message {
1785
+ /**
1786
+ * The full message string. For PostgreSQL, this is a formatted string that may include severity, code, and the notice/warning message. For MySQL, this contains the warning message.
1787
+ */
1788
+ message?: string | null;
1789
+ /**
1790
+ * The severity of the message (e.g., "NOTICE" for PostgreSQL, "WARNING" for MySQL).
1791
+ */
1792
+ severity?: string | null;
1793
+ }
1764
1794
  /**
1765
1795
  * The additional metadata information regarding the execution of the SQL statements.
1766
1796
  */
@@ -1925,6 +1955,10 @@ export declare namespace sqladmin_v1beta4 {
1925
1955
  * The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE`
1926
1956
  */
1927
1957
  operationType?: string | null;
1958
+ /**
1959
+ * The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found).
1960
+ */
1961
+ preCheckMajorVersionUpgradeContext?: Schema$PreCheckMajorVersionUpgradeContext;
1928
1962
  /**
1929
1963
  * The URI of this resource.
1930
1964
  */
@@ -2152,6 +2186,40 @@ export declare namespace sqladmin_v1beta4 {
2152
2186
  */
2153
2187
  state?: string | null;
2154
2188
  }
2189
+ /**
2190
+ * Pre-check major version upgrade context.
2191
+ */
2192
+ export interface Schema$PreCheckMajorVersionUpgradeContext {
2193
+ /**
2194
+ * Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.
2195
+ */
2196
+ kind?: string | null;
2197
+ /**
2198
+ * Output only. The responses from the precheck operation.
2199
+ */
2200
+ preCheckResponse?: Schema$PreCheckResponse[];
2201
+ /**
2202
+ * Required. The target database version to upgrade to.
2203
+ */
2204
+ targetDatabaseVersion?: string | null;
2205
+ }
2206
+ /**
2207
+ * Structured PreCheckResponse containing message, type, and required actions.
2208
+ */
2209
+ export interface Schema$PreCheckResponse {
2210
+ /**
2211
+ * The actions that the user needs to take. Use repeated for multiple actions.
2212
+ */
2213
+ actionsRequired?: string[] | null;
2214
+ /**
2215
+ * The message to be displayed to the user.
2216
+ */
2217
+ message?: string | null;
2218
+ /**
2219
+ * The type of message whether it is an info, warning, or error.
2220
+ */
2221
+ messageType?: string | null;
2222
+ }
2155
2223
  /**
2156
2224
  * Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.
2157
2225
  */
@@ -2211,13 +2279,50 @@ export declare namespace sqladmin_v1beta4 {
2211
2279
  */
2212
2280
  message?: string | null;
2213
2281
  /**
2214
- * Set to true if the SQL execution's result is truncated due to size limits.
2282
+ * Set to true if the SQL execution's result is truncated due to size limits or an error retrieving results.
2215
2283
  */
2216
2284
  partialResult?: boolean | null;
2217
2285
  /**
2218
2286
  * Rows returned by the SQL statement.
2219
2287
  */
2220
2288
  rows?: Schema$Row[];
2289
+ /**
2290
+ * If results were truncated due to an error, details of that error.
2291
+ */
2292
+ status?: Schema$Status;
2293
+ }
2294
+ /**
2295
+ * The read pool auto-scale configuration.
2296
+ */
2297
+ export interface Schema$ReadPoolAutoScaleConfig {
2298
+ /**
2299
+ * Indicates whether read pool auto scaling supports scale in operations (removing nodes).
2300
+ */
2301
+ disableScaleIn?: boolean | null;
2302
+ /**
2303
+ * Indicates whether read pool auto scaling is enabled.
2304
+ */
2305
+ enabled?: boolean | null;
2306
+ /**
2307
+ * Maximum number of read pool nodes to be maintained.
2308
+ */
2309
+ maxNodeCount?: number | null;
2310
+ /**
2311
+ * Minimum number of read pool nodes to be maintained.
2312
+ */
2313
+ minNodeCount?: number | null;
2314
+ /**
2315
+ * The cooldown period for scale in operations.
2316
+ */
2317
+ scaleInCooldownSeconds?: number | null;
2318
+ /**
2319
+ * The cooldown period for scale out operations.
2320
+ */
2321
+ scaleOutCooldownSeconds?: number | null;
2322
+ /**
2323
+ * Optional. Target metrics for read pool auto scaling.
2324
+ */
2325
+ targetMetrics?: Schema$TargetMetric[];
2221
2326
  }
2222
2327
  /**
2223
2328
  * Read-replica configuration for connecting to the primary instance.
@@ -2352,6 +2457,10 @@ export declare namespace sqladmin_v1beta4 {
2352
2457
  * The App Engine app IDs that can access this instance. (Deprecated) Applied to First Generation instances only.
2353
2458
  */
2354
2459
  authorizedGaeApplications?: string[] | null;
2460
+ /**
2461
+ * Optional. Cloud SQL for MySQL auto-upgrade configuration. When this parameter is set to true, auto-upgrade is enabled for MySQL 8.0 minor versions. The MySQL version must be 8.0.35 or higher.
2462
+ */
2463
+ autoUpgradeEnabled?: boolean | null;
2355
2464
  /**
2356
2465
  * Availability type. Potential values: * `ZONAL`: The instance serves data from only one zone. Outages in that zone affect data accessibility. * `REGIONAL`: The instance can serve data from more than one zone in a region (it is highly available)./ For more information, see [Overview of the High Availability Configuration](https://cloud.google.com/sql/docs/mysql/high-availability).
2357
2466
  */
@@ -2376,6 +2485,10 @@ export declare namespace sqladmin_v1beta4 {
2376
2485
  * Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.
2377
2486
  */
2378
2487
  crashSafeReplicationEnabled?: boolean | null;
2488
+ /**
2489
+ * This parameter controls whether to allow using Data API to connect to the instance. Not allowed by default.
2490
+ */
2491
+ dataApiAccess?: string | null;
2379
2492
  /**
2380
2493
  * The database flags passed to the instance at startup.
2381
2494
  */
@@ -2456,6 +2569,10 @@ export declare namespace sqladmin_v1beta4 {
2456
2569
  * The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.
2457
2570
  */
2458
2571
  pricingPlan?: string | null;
2572
+ /**
2573
+ * Optional. The read pool auto-scale configuration for the instance.
2574
+ */
2575
+ readPoolAutoScaleConfig?: Schema$ReadPoolAutoScaleConfig;
2459
2576
  /**
2460
2577
  * Optional. Configuration value for recreation of replica after certain replication lag.
2461
2578
  */
@@ -2558,6 +2675,10 @@ export declare namespace sqladmin_v1beta4 {
2558
2675
  * Execute SQL statements response.
2559
2676
  */
2560
2677
  export interface Schema$SqlInstancesExecuteSqlResponse {
2678
+ /**
2679
+ * A list of notices and warnings generated during query execution. For PostgreSQL, this includes all notices and warnings. For MySQL, this includes warnings generated by the last executed statement. To retrieve all warnings for a multi-statement query, `SHOW WARNINGS` must be executed after each statement.
2680
+ */
2681
+ messages?: Schema$Message[];
2561
2682
  /**
2562
2683
  * The additional metadata information regarding the execution of the SQL statements.
2563
2684
  */
@@ -2566,6 +2687,10 @@ export declare namespace sqladmin_v1beta4 {
2566
2687
  * The list of results after executing all the SQL statements.
2567
2688
  */
2568
2689
  results?: Schema$QueryResult[];
2690
+ /**
2691
+ * Contains the error from the database if the SQL execution failed.
2692
+ */
2693
+ status?: Schema$Status;
2569
2694
  }
2570
2695
  /**
2571
2696
  * Instance get disk shrink config response.
@@ -2588,6 +2713,10 @@ export declare namespace sqladmin_v1beta4 {
2588
2713
  * Instance get latest recovery time response.
2589
2714
  */
2590
2715
  export interface Schema$SqlInstancesGetLatestRecoveryTimeResponse {
2716
+ /**
2717
+ * Timestamp, identifies the earliest recovery time of the source instance.
2718
+ */
2719
+ earliestRecoveryTime?: string | null;
2591
2720
  /**
2592
2721
  * This is always `sql#getLatestRecoveryTime`.
2593
2722
  */
@@ -2890,6 +3019,25 @@ export declare namespace sqladmin_v1beta4 {
2890
3019
  */
2891
3020
  kind?: string | null;
2892
3021
  }
3022
+ /**
3023
+ * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
3024
+ */
3025
+ export interface Schema$Status {
3026
+ /**
3027
+ * The status code, which should be an enum value of google.rpc.Code.
3028
+ */
3029
+ code?: number | null;
3030
+ /**
3031
+ * A list of messages that carry the error details. There is a common set of message types for APIs to use.
3032
+ */
3033
+ details?: Array<{
3034
+ [key: string]: any;
3035
+ }> | null;
3036
+ /**
3037
+ * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
3038
+ */
3039
+ message?: string | null;
3040
+ }
2893
3041
  /**
2894
3042
  * Initial sync flags for certain Cloud SQL APIs. Currently used for the MySQL external server initial dump.
2895
3043
  */
@@ -2903,6 +3051,19 @@ export declare namespace sqladmin_v1beta4 {
2903
3051
  */
2904
3052
  value?: string | null;
2905
3053
  }
3054
+ /**
3055
+ * Target metric for read pool auto scaling.
3056
+ */
3057
+ export interface Schema$TargetMetric {
3058
+ /**
3059
+ * The metric name to be used for auto scaling.
3060
+ */
3061
+ metric?: string | null;
3062
+ /**
3063
+ * The target value for the metric.
3064
+ */
3065
+ targetValue?: number | null;
3066
+ }
2906
3067
  /**
2907
3068
  * A Google Cloud SQL service tier resource.
2908
3069
  */
@@ -2970,6 +3131,14 @@ export declare namespace sqladmin_v1beta4 {
2970
3131
  * Optional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.
2971
3132
  */
2972
3133
  host?: string | null;
3134
+ /**
3135
+ * Optional. The full email for an IAM user. For normal database users, this will not be filled. Only applicable to MySQL database users.
3136
+ */
3137
+ iamEmail?: string | null;
3138
+ /**
3139
+ * Indicates if a group is active or inactive for IAM database authentication.
3140
+ */
3141
+ iamStatus?: string | null;
2973
3142
  /**
2974
3143
  * The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for *update* because it is already specified on the URL.
2975
3144
  */
@@ -3114,6 +3283,7 @@ export declare namespace sqladmin_v1beta4 {
3114
3283
  * // "kind": "my_kind",
3115
3284
  * // "name": "my_name",
3116
3285
  * // "operationType": "my_operationType",
3286
+ * // "preCheckMajorVersionUpgradeContext": {},
3117
3287
  * // "selfLink": "my_selfLink",
3118
3288
  * // "startTime": "my_startTime",
3119
3289
  * // "status": "my_status",
@@ -3308,6 +3478,7 @@ export declare namespace sqladmin_v1beta4 {
3308
3478
  * // "kind": "my_kind",
3309
3479
  * // "name": "my_name",
3310
3480
  * // "operationType": "my_operationType",
3481
+ * // "preCheckMajorVersionUpgradeContext": {},
3311
3482
  * // "selfLink": "my_selfLink",
3312
3483
  * // "startTime": "my_startTime",
3313
3484
  * // "status": "my_status",
@@ -3554,6 +3725,7 @@ export declare namespace sqladmin_v1beta4 {
3554
3725
  * // "kind": "my_kind",
3555
3726
  * // "name": "my_name",
3556
3727
  * // "operationType": "my_operationType",
3728
+ * // "preCheckMajorVersionUpgradeContext": {},
3557
3729
  * // "selfLink": "my_selfLink",
3558
3730
  * // "startTime": "my_startTime",
3559
3731
  * // "status": "my_status",
@@ -3635,6 +3807,7 @@ export declare namespace sqladmin_v1beta4 {
3635
3807
  * // "kind": "my_kind",
3636
3808
  * // "name": "my_name",
3637
3809
  * // "operationType": "my_operationType",
3810
+ * // "preCheckMajorVersionUpgradeContext": {},
3638
3811
  * // "selfLink": "my_selfLink",
3639
3812
  * // "startTime": "my_startTime",
3640
3813
  * // "status": "my_status",
@@ -3904,6 +4077,7 @@ export declare namespace sqladmin_v1beta4 {
3904
4077
  * // "kind": "my_kind",
3905
4078
  * // "name": "my_name",
3906
4079
  * // "operationType": "my_operationType",
4080
+ * // "preCheckMajorVersionUpgradeContext": {},
3907
4081
  * // "selfLink": "my_selfLink",
3908
4082
  * // "startTime": "my_startTime",
3909
4083
  * // "status": "my_status",
@@ -4235,6 +4409,7 @@ export declare namespace sqladmin_v1beta4 {
4235
4409
  * // "kind": "my_kind",
4236
4410
  * // "name": "my_name",
4237
4411
  * // "operationType": "my_operationType",
4412
+ * // "preCheckMajorVersionUpgradeContext": {},
4238
4413
  * // "selfLink": "my_selfLink",
4239
4414
  * // "startTime": "my_startTime",
4240
4415
  * // "status": "my_status",
@@ -4409,6 +4584,7 @@ export declare namespace sqladmin_v1beta4 {
4409
4584
  * // "kind": "my_kind",
4410
4585
  * // "name": "my_name",
4411
4586
  * // "operationType": "my_operationType",
4587
+ * // "preCheckMajorVersionUpgradeContext": {},
4412
4588
  * // "selfLink": "my_selfLink",
4413
4589
  * // "startTime": "my_startTime",
4414
4590
  * // "status": "my_status",
@@ -4576,6 +4752,7 @@ export declare namespace sqladmin_v1beta4 {
4576
4752
  * // "kind": "my_kind",
4577
4753
  * // "name": "my_name",
4578
4754
  * // "operationType": "my_operationType",
4755
+ * // "preCheckMajorVersionUpgradeContext": {},
4579
4756
  * // "selfLink": "my_selfLink",
4580
4757
  * // "startTime": "my_startTime",
4581
4758
  * // "status": "my_status",
@@ -4677,6 +4854,7 @@ export declare namespace sqladmin_v1beta4 {
4677
4854
  * // "kind": "my_kind",
4678
4855
  * // "name": "my_name",
4679
4856
  * // "operationType": "my_operationType",
4857
+ * // "preCheckMajorVersionUpgradeContext": {},
4680
4858
  * // "selfLink": "my_selfLink",
4681
4859
  * // "startTime": "my_startTime",
4682
4860
  * // "status": "my_status",
@@ -5005,6 +5183,7 @@ export declare namespace sqladmin_v1beta4 {
5005
5183
  * // "kind": "my_kind",
5006
5184
  * // "name": "my_name",
5007
5185
  * // "operationType": "my_operationType",
5186
+ * // "preCheckMajorVersionUpgradeContext": {},
5008
5187
  * // "selfLink": "my_selfLink",
5009
5188
  * // "startTime": "my_startTime",
5010
5189
  * // "status": "my_status",
@@ -5088,6 +5267,7 @@ export declare namespace sqladmin_v1beta4 {
5088
5267
  * // "kind": "my_kind",
5089
5268
  * // "name": "my_name",
5090
5269
  * // "operationType": "my_operationType",
5270
+ * // "preCheckMajorVersionUpgradeContext": {},
5091
5271
  * // "selfLink": "my_selfLink",
5092
5272
  * // "startTime": "my_startTime",
5093
5273
  * // "status": "my_status",
@@ -5179,6 +5359,7 @@ export declare namespace sqladmin_v1beta4 {
5179
5359
  * // "kind": "my_kind",
5180
5360
  * // "name": "my_name",
5181
5361
  * // "operationType": "my_operationType",
5362
+ * // "preCheckMajorVersionUpgradeContext": {},
5182
5363
  * // "selfLink": "my_selfLink",
5183
5364
  * // "startTime": "my_startTime",
5184
5365
  * // "status": "my_status",
@@ -5270,6 +5451,7 @@ export declare namespace sqladmin_v1beta4 {
5270
5451
  * // "kind": "my_kind",
5271
5452
  * // "name": "my_name",
5272
5453
  * // "operationType": "my_operationType",
5454
+ * // "preCheckMajorVersionUpgradeContext": {},
5273
5455
  * // "selfLink": "my_selfLink",
5274
5456
  * // "startTime": "my_startTime",
5275
5457
  * // "status": "my_status",
@@ -5361,6 +5543,7 @@ export declare namespace sqladmin_v1beta4 {
5361
5543
  * // "kind": "my_kind",
5362
5544
  * // "name": "my_name",
5363
5545
  * // "operationType": "my_operationType",
5546
+ * // "preCheckMajorVersionUpgradeContext": {},
5364
5547
  * // "selfLink": "my_selfLink",
5365
5548
  * // "startTime": "my_startTime",
5366
5549
  * // "status": "my_status",
@@ -5452,6 +5635,7 @@ export declare namespace sqladmin_v1beta4 {
5452
5635
  * // "kind": "my_kind",
5453
5636
  * // "name": "my_name",
5454
5637
  * // "operationType": "my_operationType",
5638
+ * // "preCheckMajorVersionUpgradeContext": {},
5455
5639
  * // "selfLink": "my_selfLink",
5456
5640
  * // "startTime": "my_startTime",
5457
5641
  * // "status": "my_status",
@@ -5526,8 +5710,10 @@ export declare namespace sqladmin_v1beta4 {
5526
5710
  * // {
5527
5711
  * // "autoIamAuthn": false,
5528
5712
  * // "database": "my_database",
5713
+ * // "partialResultMode": "my_partialResultMode",
5529
5714
  * // "rowLimit": "my_rowLimit",
5530
- * // "sqlStatement": "my_sqlStatement"
5715
+ * // "sqlStatement": "my_sqlStatement",
5716
+ * // "user": "my_user"
5531
5717
  * // }
5532
5718
  * },
5533
5719
  * });
@@ -5535,8 +5721,10 @@ export declare namespace sqladmin_v1beta4 {
5535
5721
  *
5536
5722
  * // Example response
5537
5723
  * // {
5724
+ * // "messages": [],
5538
5725
  * // "metadata": {},
5539
- * // "results": []
5726
+ * // "results": [],
5727
+ * // "status": {}
5540
5728
  * // }
5541
5729
  * }
5542
5730
  *
@@ -5617,6 +5805,7 @@ export declare namespace sqladmin_v1beta4 {
5617
5805
  * // "kind": "my_kind",
5618
5806
  * // "name": "my_name",
5619
5807
  * // "operationType": "my_operationType",
5808
+ * // "preCheckMajorVersionUpgradeContext": {},
5620
5809
  * // "selfLink": "my_selfLink",
5621
5810
  * // "startTime": "my_startTime",
5622
5811
  * // "status": "my_status",
@@ -5708,6 +5897,7 @@ export declare namespace sqladmin_v1beta4 {
5708
5897
  * // "kind": "my_kind",
5709
5898
  * // "name": "my_name",
5710
5899
  * // "operationType": "my_operationType",
5900
+ * // "preCheckMajorVersionUpgradeContext": {},
5711
5901
  * // "selfLink": "my_selfLink",
5712
5902
  * // "startTime": "my_startTime",
5713
5903
  * // "status": "my_status",
@@ -5911,6 +6101,7 @@ export declare namespace sqladmin_v1beta4 {
5911
6101
  * // "kind": "my_kind",
5912
6102
  * // "name": "my_name",
5913
6103
  * // "operationType": "my_operationType",
6104
+ * // "preCheckMajorVersionUpgradeContext": {},
5914
6105
  * // "selfLink": "my_selfLink",
5915
6106
  * // "startTime": "my_startTime",
5916
6107
  * // "status": "my_status",
@@ -6050,6 +6241,7 @@ export declare namespace sqladmin_v1beta4 {
6050
6241
  * // "kind": "my_kind",
6051
6242
  * // "name": "my_name",
6052
6243
  * // "operationType": "my_operationType",
6244
+ * // "preCheckMajorVersionUpgradeContext": {},
6053
6245
  * // "selfLink": "my_selfLink",
6054
6246
  * // "startTime": "my_startTime",
6055
6247
  * // "status": "my_status",
@@ -6398,6 +6590,7 @@ export declare namespace sqladmin_v1beta4 {
6398
6590
  * // "kind": "my_kind",
6399
6591
  * // "name": "my_name",
6400
6592
  * // "operationType": "my_operationType",
6593
+ * // "preCheckMajorVersionUpgradeContext": {},
6401
6594
  * // "selfLink": "my_selfLink",
6402
6595
  * // "startTime": "my_startTime",
6403
6596
  * // "status": "my_status",
@@ -6493,6 +6686,7 @@ export declare namespace sqladmin_v1beta4 {
6493
6686
  * // "kind": "my_kind",
6494
6687
  * // "name": "my_name",
6495
6688
  * // "operationType": "my_operationType",
6689
+ * // "preCheckMajorVersionUpgradeContext": {},
6496
6690
  * // "selfLink": "my_selfLink",
6497
6691
  * // "startTime": "my_startTime",
6498
6692
  * // "status": "my_status",
@@ -6522,6 +6716,98 @@ export declare namespace sqladmin_v1beta4 {
6522
6716
  pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
6523
6717
  pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, callback: BodyResponseCallback<Schema$Operation>): void;
6524
6718
  pointInTimeRestore(callback: BodyResponseCallback<Schema$Operation>): void;
6719
+ /**
6720
+ * Execute MVU Pre-checks
6721
+ * @example
6722
+ * ```js
6723
+ * // Before running the sample:
6724
+ * // - Enable the API at:
6725
+ * // https://console.developers.google.com/apis/api/sqladmin.googleapis.com
6726
+ * // - Login into gcloud by running:
6727
+ * // ```sh
6728
+ * // $ gcloud auth application-default login
6729
+ * // ```
6730
+ * // - Install the npm module by running:
6731
+ * // ```sh
6732
+ * // $ npm install googleapis
6733
+ * // ```
6734
+ *
6735
+ * const {google} = require('googleapis');
6736
+ * const sqladmin = google.sqladmin('v1beta4');
6737
+ *
6738
+ * async function main() {
6739
+ * const auth = new google.auth.GoogleAuth({
6740
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6741
+ * scopes: [
6742
+ * 'https://www.googleapis.com/auth/cloud-platform',
6743
+ * 'https://www.googleapis.com/auth/sqlservice.admin',
6744
+ * ],
6745
+ * });
6746
+ *
6747
+ * // Acquire an auth client, and bind it to all future calls
6748
+ * const authClient = await auth.getClient();
6749
+ * google.options({auth: authClient});
6750
+ *
6751
+ * // Do the magic
6752
+ * const res = await sql.instances.preCheckMajorVersionUpgrade({
6753
+ * // Required. Cloud SQL instance ID. This does not include the project ID.
6754
+ * instance: 'placeholder-value',
6755
+ * // Required. Project ID of the project that contains the instance.
6756
+ * project: 'placeholder-value',
6757
+ *
6758
+ * // Request body metadata
6759
+ * requestBody: {
6760
+ * // request body parameters
6761
+ * // {
6762
+ * // "preCheckMajorVersionUpgradeContext": {}
6763
+ * // }
6764
+ * },
6765
+ * });
6766
+ * console.log(res.data);
6767
+ *
6768
+ * // Example response
6769
+ * // {
6770
+ * // "acquireSsrsLeaseContext": {},
6771
+ * // "apiWarning": {},
6772
+ * // "backupContext": {},
6773
+ * // "endTime": "my_endTime",
6774
+ * // "error": {},
6775
+ * // "exportContext": {},
6776
+ * // "importContext": {},
6777
+ * // "insertTime": "my_insertTime",
6778
+ * // "kind": "my_kind",
6779
+ * // "name": "my_name",
6780
+ * // "operationType": "my_operationType",
6781
+ * // "preCheckMajorVersionUpgradeContext": {},
6782
+ * // "selfLink": "my_selfLink",
6783
+ * // "startTime": "my_startTime",
6784
+ * // "status": "my_status",
6785
+ * // "subOperationType": {},
6786
+ * // "targetId": "my_targetId",
6787
+ * // "targetLink": "my_targetLink",
6788
+ * // "targetProject": "my_targetProject",
6789
+ * // "user": "my_user"
6790
+ * // }
6791
+ * }
6792
+ *
6793
+ * main().catch(e => {
6794
+ * console.error(e);
6795
+ * throw e;
6796
+ * });
6797
+ *
6798
+ * ```
6799
+ *
6800
+ * @param params - Parameters for request
6801
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6802
+ * @param callback - Optional callback that handles the response.
6803
+ * @returns A promise if used with async/await, or void if used with a callback.
6804
+ */
6805
+ preCheckMajorVersionUpgrade(params: Params$Resource$Instances$Precheckmajorversionupgrade, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6806
+ preCheckMajorVersionUpgrade(params?: Params$Resource$Instances$Precheckmajorversionupgrade, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
6807
+ preCheckMajorVersionUpgrade(params: Params$Resource$Instances$Precheckmajorversionupgrade, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6808
+ preCheckMajorVersionUpgrade(params: Params$Resource$Instances$Precheckmajorversionupgrade, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
6809
+ preCheckMajorVersionUpgrade(params: Params$Resource$Instances$Precheckmajorversionupgrade, callback: BodyResponseCallback<Schema$Operation>): void;
6810
+ preCheckMajorVersionUpgrade(callback: BodyResponseCallback<Schema$Operation>): void;
6525
6811
  /**
6526
6812
  * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
6527
6813
  * @example
@@ -6578,6 +6864,7 @@ export declare namespace sqladmin_v1beta4 {
6578
6864
  * // "kind": "my_kind",
6579
6865
  * // "name": "my_name",
6580
6866
  * // "operationType": "my_operationType",
6867
+ * // "preCheckMajorVersionUpgradeContext": {},
6581
6868
  * // "selfLink": "my_selfLink",
6582
6869
  * // "startTime": "my_startTime",
6583
6870
  * // "status": "my_status",
@@ -6669,6 +6956,7 @@ export declare namespace sqladmin_v1beta4 {
6669
6956
  * // "kind": "my_kind",
6670
6957
  * // "name": "my_name",
6671
6958
  * // "operationType": "my_operationType",
6959
+ * // "preCheckMajorVersionUpgradeContext": {},
6672
6960
  * // "selfLink": "my_selfLink",
6673
6961
  * // "startTime": "my_startTime",
6674
6962
  * // "status": "my_status",
@@ -6799,6 +7087,8 @@ export declare namespace sqladmin_v1beta4 {
6799
7087
  * const res = await sql.instances.resetSslConfig({
6800
7088
  * // Cloud SQL instance ID. This does not include the project ID.
6801
7089
  * instance: 'placeholder-value',
7090
+ * // Optional. Reset SSL mode to use.
7091
+ * mode: 'placeholder-value',
6802
7092
  * // Project ID of the project that contains the instance.
6803
7093
  * project: 'placeholder-value',
6804
7094
  * });
@@ -6817,6 +7107,7 @@ export declare namespace sqladmin_v1beta4 {
6817
7107
  * // "kind": "my_kind",
6818
7108
  * // "name": "my_name",
6819
7109
  * // "operationType": "my_operationType",
7110
+ * // "preCheckMajorVersionUpgradeContext": {},
6820
7111
  * // "selfLink": "my_selfLink",
6821
7112
  * // "startTime": "my_startTime",
6822
7113
  * // "status": "my_status",
@@ -6900,6 +7191,7 @@ export declare namespace sqladmin_v1beta4 {
6900
7191
  * // "kind": "my_kind",
6901
7192
  * // "name": "my_name",
6902
7193
  * // "operationType": "my_operationType",
7194
+ * // "preCheckMajorVersionUpgradeContext": {},
6903
7195
  * // "selfLink": "my_selfLink",
6904
7196
  * // "startTime": "my_startTime",
6905
7197
  * // "status": "my_status",
@@ -6995,6 +7287,7 @@ export declare namespace sqladmin_v1beta4 {
6995
7287
  * // "kind": "my_kind",
6996
7288
  * // "name": "my_name",
6997
7289
  * // "operationType": "my_operationType",
7290
+ * // "preCheckMajorVersionUpgradeContext": {},
6998
7291
  * // "selfLink": "my_selfLink",
6999
7292
  * // "startTime": "my_startTime",
7000
7293
  * // "status": "my_status",
@@ -7086,6 +7379,7 @@ export declare namespace sqladmin_v1beta4 {
7086
7379
  * // "kind": "my_kind",
7087
7380
  * // "name": "my_name",
7088
7381
  * // "operationType": "my_operationType",
7382
+ * // "preCheckMajorVersionUpgradeContext": {},
7089
7383
  * // "selfLink": "my_selfLink",
7090
7384
  * // "startTime": "my_startTime",
7091
7385
  * // "status": "my_status",
@@ -7177,6 +7471,7 @@ export declare namespace sqladmin_v1beta4 {
7177
7471
  * // "kind": "my_kind",
7178
7472
  * // "name": "my_name",
7179
7473
  * // "operationType": "my_operationType",
7474
+ * // "preCheckMajorVersionUpgradeContext": {},
7180
7475
  * // "selfLink": "my_selfLink",
7181
7476
  * // "startTime": "my_startTime",
7182
7477
  * // "status": "my_status",
@@ -7260,6 +7555,7 @@ export declare namespace sqladmin_v1beta4 {
7260
7555
  * // "kind": "my_kind",
7261
7556
  * // "name": "my_name",
7262
7557
  * // "operationType": "my_operationType",
7558
+ * // "preCheckMajorVersionUpgradeContext": {},
7263
7559
  * // "selfLink": "my_selfLink",
7264
7560
  * // "startTime": "my_startTime",
7265
7561
  * // "status": "my_status",
@@ -7343,6 +7639,7 @@ export declare namespace sqladmin_v1beta4 {
7343
7639
  * // "kind": "my_kind",
7344
7640
  * // "name": "my_name",
7345
7641
  * // "operationType": "my_operationType",
7642
+ * // "preCheckMajorVersionUpgradeContext": {},
7346
7643
  * // "selfLink": "my_selfLink",
7347
7644
  * // "startTime": "my_startTime",
7348
7645
  * // "status": "my_status",
@@ -7428,6 +7725,7 @@ export declare namespace sqladmin_v1beta4 {
7428
7725
  * // "kind": "my_kind",
7429
7726
  * // "name": "my_name",
7430
7727
  * // "operationType": "my_operationType",
7728
+ * // "preCheckMajorVersionUpgradeContext": {},
7431
7729
  * // "selfLink": "my_selfLink",
7432
7730
  * // "startTime": "my_startTime",
7433
7731
  * // "status": "my_status",
@@ -7519,6 +7817,7 @@ export declare namespace sqladmin_v1beta4 {
7519
7817
  * // "kind": "my_kind",
7520
7818
  * // "name": "my_name",
7521
7819
  * // "operationType": "my_operationType",
7820
+ * // "preCheckMajorVersionUpgradeContext": {},
7522
7821
  * // "selfLink": "my_selfLink",
7523
7822
  * // "startTime": "my_startTime",
7524
7823
  * // "status": "my_status",
@@ -7660,6 +7959,7 @@ export declare namespace sqladmin_v1beta4 {
7660
7959
  * // "kind": "my_kind",
7661
7960
  * // "name": "my_name",
7662
7961
  * // "operationType": "my_operationType",
7962
+ * // "preCheckMajorVersionUpgradeContext": {},
7663
7963
  * // "selfLink": "my_selfLink",
7664
7964
  * // "startTime": "my_startTime",
7665
7965
  * // "status": "my_status",
@@ -7930,6 +8230,20 @@ export declare namespace sqladmin_v1beta4 {
7930
8230
  */
7931
8231
  requestBody?: Schema$PointInTimeRestoreContext;
7932
8232
  }
8233
+ export interface Params$Resource$Instances$Precheckmajorversionupgrade extends StandardParameters {
8234
+ /**
8235
+ * Required. Cloud SQL instance ID. This does not include the project ID.
8236
+ */
8237
+ instance?: string;
8238
+ /**
8239
+ * Required. Project ID of the project that contains the instance.
8240
+ */
8241
+ project?: string;
8242
+ /**
8243
+ * Request body metadata
8244
+ */
8245
+ requestBody?: Schema$InstancesPreCheckMajorVersionUpgradeRequest;
8246
+ }
7933
8247
  export interface Params$Resource$Instances$Promotereplica extends StandardParameters {
7934
8248
  /**
7935
8249
  * Set to true to invoke a replica failover to the DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance.
@@ -7973,6 +8287,10 @@ export declare namespace sqladmin_v1beta4 {
7973
8287
  * Cloud SQL instance ID. This does not include the project ID.
7974
8288
  */
7975
8289
  instance?: string;
8290
+ /**
8291
+ * Optional. Reset SSL mode to use.
8292
+ */
8293
+ mode?: string;
7976
8294
  /**
7977
8295
  * Project ID of the project that contains the instance.
7978
8296
  */
@@ -8096,7 +8414,7 @@ export declare namespace sqladmin_v1beta4 {
8096
8414
  context: APIRequestContext;
8097
8415
  constructor(context: APIRequestContext);
8098
8416
  /**
8099
- * Cancels an instance operation that has been performed on an instance.
8417
+ * Cancels an instance operation that has been performed on an instance. Ordinarily, this method name should be `CancelSqlOperation`.
8100
8418
  * @example
8101
8419
  * ```js
8102
8420
  * // Before running the sample:
@@ -8212,6 +8530,7 @@ export declare namespace sqladmin_v1beta4 {
8212
8530
  * // "kind": "my_kind",
8213
8531
  * // "name": "my_name",
8214
8532
  * // "operationType": "my_operationType",
8533
+ * // "preCheckMajorVersionUpgradeContext": {},
8215
8534
  * // "selfLink": "my_selfLink",
8216
8535
  * // "startTime": "my_startTime",
8217
8536
  * // "status": "my_status",
@@ -8471,6 +8790,7 @@ export declare namespace sqladmin_v1beta4 {
8471
8790
  *
8472
8791
  * // Example response
8473
8792
  * // {
8793
+ * // "earliestRecoveryTime": "my_earliestRecoveryTime",
8474
8794
  * // "kind": "my_kind",
8475
8795
  * // "latestRecoveryTime": "my_latestRecoveryTime"
8476
8796
  * // }
@@ -8556,6 +8876,7 @@ export declare namespace sqladmin_v1beta4 {
8556
8876
  * // "kind": "my_kind",
8557
8877
  * // "name": "my_name",
8558
8878
  * // "operationType": "my_operationType",
8879
+ * // "preCheckMajorVersionUpgradeContext": {},
8559
8880
  * // "selfLink": "my_selfLink",
8560
8881
  * // "startTime": "my_startTime",
8561
8882
  * // "status": "my_status",
@@ -8647,6 +8968,7 @@ export declare namespace sqladmin_v1beta4 {
8647
8968
  * // "kind": "my_kind",
8648
8969
  * // "name": "my_name",
8649
8970
  * // "operationType": "my_operationType",
8971
+ * // "preCheckMajorVersionUpgradeContext": {},
8650
8972
  * // "selfLink": "my_selfLink",
8651
8973
  * // "startTime": "my_startTime",
8652
8974
  * // "status": "my_status",
@@ -8736,6 +9058,7 @@ export declare namespace sqladmin_v1beta4 {
8736
9058
  * // "kind": "my_kind",
8737
9059
  * // "name": "my_name",
8738
9060
  * // "operationType": "my_operationType",
9061
+ * // "preCheckMajorVersionUpgradeContext": {},
8739
9062
  * // "selfLink": "my_selfLink",
8740
9063
  * // "startTime": "my_startTime",
8741
9064
  * // "status": "my_status",
@@ -8832,6 +9155,7 @@ export declare namespace sqladmin_v1beta4 {
8832
9155
  * // "kind": "my_kind",
8833
9156
  * // "name": "my_name",
8834
9157
  * // "operationType": "my_operationType",
9158
+ * // "preCheckMajorVersionUpgradeContext": {},
8835
9159
  * // "selfLink": "my_selfLink",
8836
9160
  * // "startTime": "my_startTime",
8837
9161
  * // "status": "my_status",
@@ -9178,6 +9502,7 @@ export declare namespace sqladmin_v1beta4 {
9178
9502
  * // "kind": "my_kind",
9179
9503
  * // "name": "my_name",
9180
9504
  * // "operationType": "my_operationType",
9505
+ * // "preCheckMajorVersionUpgradeContext": {},
9181
9506
  * // "selfLink": "my_selfLink",
9182
9507
  * // "startTime": "my_startTime",
9183
9508
  * // "status": "my_status",
@@ -9626,6 +9951,7 @@ export declare namespace sqladmin_v1beta4 {
9626
9951
  * // "kind": "my_kind",
9627
9952
  * // "name": "my_name",
9628
9953
  * // "operationType": "my_operationType",
9954
+ * // "preCheckMajorVersionUpgradeContext": {},
9629
9955
  * // "selfLink": "my_selfLink",
9630
9956
  * // "startTime": "my_startTime",
9631
9957
  * // "status": "my_status",
@@ -9705,6 +10031,8 @@ export declare namespace sqladmin_v1beta4 {
9705
10031
  * // "dualPasswordType": "my_dualPasswordType",
9706
10032
  * // "etag": "my_etag",
9707
10033
  * // "host": "my_host",
10034
+ * // "iamEmail": "my_iamEmail",
10035
+ * // "iamStatus": "my_iamStatus",
9708
10036
  * // "instance": "my_instance",
9709
10037
  * // "kind": "my_kind",
9710
10038
  * // "name": "my_name",
@@ -9780,6 +10108,8 @@ export declare namespace sqladmin_v1beta4 {
9780
10108
  * // "dualPasswordType": "my_dualPasswordType",
9781
10109
  * // "etag": "my_etag",
9782
10110
  * // "host": "my_host",
10111
+ * // "iamEmail": "my_iamEmail",
10112
+ * // "iamStatus": "my_iamStatus",
9783
10113
  * // "instance": "my_instance",
9784
10114
  * // "kind": "my_kind",
9785
10115
  * // "name": "my_name",
@@ -9806,6 +10136,7 @@ export declare namespace sqladmin_v1beta4 {
9806
10136
  * // "kind": "my_kind",
9807
10137
  * // "name": "my_name",
9808
10138
  * // "operationType": "my_operationType",
10139
+ * // "preCheckMajorVersionUpgradeContext": {},
9809
10140
  * // "selfLink": "my_selfLink",
9810
10141
  * // "startTime": "my_startTime",
9811
10142
  * // "status": "my_status",
@@ -9952,6 +10283,8 @@ export declare namespace sqladmin_v1beta4 {
9952
10283
  * // "dualPasswordType": "my_dualPasswordType",
9953
10284
  * // "etag": "my_etag",
9954
10285
  * // "host": "my_host",
10286
+ * // "iamEmail": "my_iamEmail",
10287
+ * // "iamStatus": "my_iamStatus",
9955
10288
  * // "instance": "my_instance",
9956
10289
  * // "kind": "my_kind",
9957
10290
  * // "name": "my_name",
@@ -9978,6 +10311,7 @@ export declare namespace sqladmin_v1beta4 {
9978
10311
  * // "kind": "my_kind",
9979
10312
  * // "name": "my_name",
9980
10313
  * // "operationType": "my_operationType",
10314
+ * // "preCheckMajorVersionUpgradeContext": {},
9981
10315
  * // "selfLink": "my_selfLink",
9982
10316
  * // "startTime": "my_startTime",
9983
10317
  * // "status": "my_status",