@googleapis/sqladmin 32.0.0 → 34.1.0

package/v1beta4.ts

@@ -230,7 +230,7 @@ export namespace sqladmin_v1beta4 {
     name?: string | null;
   }
   /**
-   * A backup resource. Next ID: 30
+   * A backup resource.
    */
   export interface Schema$Backup {
     /**
@@ -1141,6 +1141,10 @@ export namespace sqladmin_v1beta4 {
      * Optional. Name of the database on which the statement will be executed.
      */
     database?: string | null;
+    /**
+     * 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.
+     */
+    partialResultMode?: string | null;
     /**
      * Optional. The maximum number of rows returned per SQL statement.
      */
@@ -1149,6 +1153,10 @@ export namespace sqladmin_v1beta4 {
      * Required. SQL statements to run on the database. It can be a single statement or a sequence of statements separated by semicolons.
      */
     sqlStatement?: string | null;
+    /**
+     * 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.
+     */
+    user?: string | null;
   }
   /**
    * Database instance export context.
@@ -1612,6 +1620,15 @@ export namespace sqladmin_v1beta4 {
      */
     serverCerts?: Schema$SslCert[];
   }
+  /**
+   * Request for Pre-checks for MVU
+   */
+  export interface Schema$InstancesPreCheckMajorVersionUpgradeRequest {
+    /**
+     * Required. Contains details about the pre-check major version upgrade operation.
+     */
+    preCheckMajorVersionUpgradeContext?: Schema$PreCheckMajorVersionUpgradeContext;
+  }
   /**
    * Database Instance reencrypt request.
    */
@@ -1811,6 +1828,19 @@ export namespace sqladmin_v1beta4 {
      */
     updateTrack?: string | null;
   }
+  /**
+   * Represents a notice or warning message from the database.
+   */
+  export interface Schema$Message {
+    /**
+     * 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.
+     */
+    message?: string | null;
+    /**
+     * The severity of the message (e.g., "NOTICE" for PostgreSQL, "WARNING" for MySQL).
+     */
+    severity?: string | null;
+  }
   /**
    * The additional metadata information regarding the execution of the SQL statements.
    */
@@ -1975,6 +2005,10 @@ export namespace sqladmin_v1beta4 {
      * 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`
      */
     operationType?: string | null;
+    /**
+     * 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).
+     */
+    preCheckMajorVersionUpgradeContext?: Schema$PreCheckMajorVersionUpgradeContext;
     /**
      * The URI of this resource.
      */
@@ -2202,6 +2236,40 @@ export namespace sqladmin_v1beta4 {
      */
     state?: string | null;
   }
+  /**
+   * Pre-check major version upgrade context.
+   */
+  export interface Schema$PreCheckMajorVersionUpgradeContext {
+    /**
+     * Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.
+     */
+    kind?: string | null;
+    /**
+     * Output only. The responses from the precheck operation.
+     */
+    preCheckResponse?: Schema$PreCheckResponse[];
+    /**
+     * Required. The target database version to upgrade to.
+     */
+    targetDatabaseVersion?: string | null;
+  }
+  /**
+   * Structured PreCheckResponse containing message, type, and required actions.
+   */
+  export interface Schema$PreCheckResponse {
+    /**
+     * The actions that the user needs to take. Use repeated for multiple actions.
+     */
+    actionsRequired?: string[] | null;
+    /**
+     * The message to be displayed to the user.
+     */
+    message?: string | null;
+    /**
+     * The type of message whether it is an info, warning, or error.
+     */
+    messageType?: string | null;
+  }
   /**
    * Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.
    */
@@ -2261,13 +2329,50 @@ export namespace sqladmin_v1beta4 {
      */
     message?: string | null;
     /**
-     * Set to true if the SQL execution's result is truncated due to size limits.
+     * Set to true if the SQL execution's result is truncated due to size limits or an error retrieving results.
      */
     partialResult?: boolean | null;
     /**
      * Rows returned by the SQL statement.
      */
     rows?: Schema$Row[];
+    /**
+     * If results were truncated due to an error, details of that error.
+     */
+    status?: Schema$Status;
+  }
+  /**
+   * The read pool auto-scale configuration.
+   */
+  export interface Schema$ReadPoolAutoScaleConfig {
+    /**
+     * Indicates whether read pool auto scaling supports scale in operations (removing nodes).
+     */
+    disableScaleIn?: boolean | null;
+    /**
+     * Indicates whether read pool auto scaling is enabled.
+     */
+    enabled?: boolean | null;
+    /**
+     * Maximum number of read pool nodes to be maintained.
+     */
+    maxNodeCount?: number | null;
+    /**
+     * Minimum number of read pool nodes to be maintained.
+     */
+    minNodeCount?: number | null;
+    /**
+     * The cooldown period for scale in operations.
+     */
+    scaleInCooldownSeconds?: number | null;
+    /**
+     * The cooldown period for scale out operations.
+     */
+    scaleOutCooldownSeconds?: number | null;
+    /**
+     * Optional. Target metrics for read pool auto scaling.
+     */
+    targetMetrics?: Schema$TargetMetric[];
   }
   /**
    * Read-replica configuration for connecting to the primary instance.
@@ -2402,6 +2507,10 @@ export namespace sqladmin_v1beta4 {
      * The App Engine app IDs that can access this instance. (Deprecated) Applied to First Generation instances only.
      */
     authorizedGaeApplications?: string[] | null;
+    /**
+     * 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.
+     */
+    autoUpgradeEnabled?: boolean | null;
     /**
      * 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).
      */
@@ -2426,6 +2535,10 @@ export namespace sqladmin_v1beta4 {
      * 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.
      */
     crashSafeReplicationEnabled?: boolean | null;
+    /**
+     * This parameter controls whether to allow using Data API to connect to the instance. Not allowed by default.
+     */
+    dataApiAccess?: string | null;
     /**
      * The database flags passed to the instance at startup.
      */
@@ -2506,6 +2619,10 @@ export namespace sqladmin_v1beta4 {
      * The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.
      */
     pricingPlan?: string | null;
+    /**
+     * Optional. The read pool auto-scale configuration for the instance.
+     */
+    readPoolAutoScaleConfig?: Schema$ReadPoolAutoScaleConfig;
     /**
      * Optional. Configuration value for recreation of replica after certain replication lag.
      */
@@ -2606,6 +2723,10 @@ export namespace sqladmin_v1beta4 {
    * Execute SQL statements response.
    */
   export interface Schema$SqlInstancesExecuteSqlResponse {
+    /**
+     * 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.
+     */
+    messages?: Schema$Message[];
     /**
      * The additional metadata information regarding the execution of the SQL statements.
      */
@@ -2614,6 +2735,10 @@ export namespace sqladmin_v1beta4 {
      * The list of results after executing all the SQL statements.
      */
     results?: Schema$QueryResult[];
+    /**
+     * Contains the error from the database if the SQL execution failed.
+     */
+    status?: Schema$Status;
   }
   /**
    * Instance get disk shrink config response.
@@ -2636,6 +2761,10 @@ export namespace sqladmin_v1beta4 {
    * Instance get latest recovery time response.
    */
   export interface Schema$SqlInstancesGetLatestRecoveryTimeResponse {
+    /**
+     * Timestamp, identifies the earliest recovery time of the source instance.
+     */
+    earliestRecoveryTime?: string | null;
     /**
      * This is always `sql#getLatestRecoveryTime`.
      */
@@ -2937,6 +3066,23 @@ export namespace sqladmin_v1beta4 {
      */
     kind?: string | null;
   }
+  /**
+   * 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).
+   */
+  export interface Schema$Status {
+    /**
+     * The status code, which should be an enum value of google.rpc.Code.
+     */
+    code?: number | null;
+    /**
+     * A list of messages that carry the error details. There is a common set of message types for APIs to use.
+     */
+    details?: Array<{[key: string]: any}> | null;
+    /**
+     * 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.
+     */
+    message?: string | null;
+  }
   /**
    * Initial sync flags for certain Cloud SQL APIs. Currently used for the MySQL external server initial dump.
    */
@@ -2950,6 +3096,19 @@ export namespace sqladmin_v1beta4 {
      */
     value?: string | null;
   }
+  /**
+   * Target metric for read pool auto scaling.
+   */
+  export interface Schema$TargetMetric {
+    /**
+     * The metric name to be used for auto scaling.
+     */
+    metric?: string | null;
+    /**
+     * The target value for the metric.
+     */
+    targetValue?: number | null;
+  }
   /**
    * A Google Cloud SQL service tier resource.
    */
@@ -3017,6 +3176,14 @@ export namespace sqladmin_v1beta4 {
      * 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.
      */
     host?: string | null;
+    /**
+     * Optional. The full email for an IAM user. For normal database users, this will not be filled. Only applicable to MySQL database users.
+     */
+    iamEmail?: string | null;
+    /**
+     * Indicates if a group is active or inactive for IAM database authentication.
+     */
+    iamStatus?: string | null;
     /**
      * 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.
      */
@@ -3165,6 +3332,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -3512,6 +3680,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -3920,6 +4089,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -4078,6 +4248,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -4580,6 +4751,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -5164,6 +5336,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -5490,6 +5663,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -5811,6 +5985,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -5988,6 +6163,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -6563,6 +6739,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -6723,6 +6900,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -6893,6 +7071,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -7060,6 +7239,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -7226,6 +7406,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -7393,6 +7574,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -7544,8 +7726,10 @@ export namespace sqladmin_v1beta4 {
      *       // {
      *       //   "autoIamAuthn": false,
      *       //   "database": "my_database",
+     *       //   "partialResultMode": "my_partialResultMode",
      *       //   "rowLimit": "my_rowLimit",
-     *       //   "sqlStatement": "my_sqlStatement"
+     *       //   "sqlStatement": "my_sqlStatement",
+     *       //   "user": "my_user"
      *       // }
      *     },
      *   });
@@ -7553,8 +7737,10 @@ export namespace sqladmin_v1beta4 {
      *
      *   // Example response
      *   // {
+     *   //   "messages": [],
      *   //   "metadata": {},
-     *   //   "results": []
+     *   //   "results": [],
+     *   //   "status": {}
      *   // }
      * }
      *
@@ -7718,6 +7904,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -7885,6 +8072,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -8240,6 +8428,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -8455,6 +8644,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -9125,6 +9315,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -9295,6 +9486,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -9400,6 +9592,177 @@ export namespace sqladmin_v1beta4 {
       }
     }
 
+    /**
+     * Execute MVU Pre-checks
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/sqladmin.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const sqladmin = google.sqladmin('v1beta4');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: [
+     *       'https://www.googleapis.com/auth/cloud-platform',
+     *       'https://www.googleapis.com/auth/sqlservice.admin',
+     *     ],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await sql.instances.preCheckMajorVersionUpgrade({
+     *     // Required. Cloud SQL instance ID. This does not include the project ID.
+     *     instance: 'placeholder-value',
+     *     // Required. Project ID of the project that contains the instance.
+     *     project: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "preCheckMajorVersionUpgradeContext": {}
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "acquireSsrsLeaseContext": {},
+     *   //   "apiWarning": {},
+     *   //   "backupContext": {},
+     *   //   "endTime": "my_endTime",
+     *   //   "error": {},
+     *   //   "exportContext": {},
+     *   //   "importContext": {},
+     *   //   "insertTime": "my_insertTime",
+     *   //   "kind": "my_kind",
+     *   //   "name": "my_name",
+     *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
+     *   //   "selfLink": "my_selfLink",
+     *   //   "startTime": "my_startTime",
+     *   //   "status": "my_status",
+     *   //   "subOperationType": {},
+     *   //   "targetId": "my_targetId",
+     *   //   "targetLink": "my_targetLink",
+     *   //   "targetProject": "my_targetProject",
+     *   //   "user": "my_user"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
+     *
+     * @param params - Parameters for request
+     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param callback - Optional callback that handles the response.
+     * @returns A promise if used with async/await, or void if used with a callback.
+     */
+    preCheckMajorVersionUpgrade(
+      params: Params$Resource$Instances$Precheckmajorversionupgrade,
+      options: StreamMethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
+    preCheckMajorVersionUpgrade(
+      params?: Params$Resource$Instances$Precheckmajorversionupgrade,
+      options?: MethodOptions
+    ): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+    preCheckMajorVersionUpgrade(
+      params: Params$Resource$Instances$Precheckmajorversionupgrade,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    preCheckMajorVersionUpgrade(
+      params: Params$Resource$Instances$Precheckmajorversionupgrade,
+      options: MethodOptions | BodyResponseCallback<Schema$Operation>,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    preCheckMajorVersionUpgrade(
+      params: Params$Resource$Instances$Precheckmajorversionupgrade,
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    preCheckMajorVersionUpgrade(
+      callback: BodyResponseCallback<Schema$Operation>
+    ): void;
+    preCheckMajorVersionUpgrade(
+      paramsOrCallback?:
+        | Params$Resource$Instances$Precheckmajorversionupgrade
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$Operation>
+        | BodyResponseCallback<Readable>
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Instances$Precheckmajorversionupgrade;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Instances$Precheckmajorversionupgrade;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl = options.rootUrl || 'https://sqladmin.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (
+              rootUrl +
+              '/sql/v1beta4/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade'
+            ).replace(/([^:]\/)\/+/g, '$1'),
+            method: 'POST',
+            apiVersion: '',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['project', 'instance'],
+        pathParams: ['instance', 'project'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$Operation>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$Operation>(parameters);
+      }
+    }
+
     /**
      * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
      * @example
@@ -9456,6 +9819,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -9624,6 +9988,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -9918,6 +10283,8 @@ export namespace sqladmin_v1beta4 {
      *   const res = await sql.instances.resetSslConfig({
      *     // Cloud SQL instance ID. This does not include the project ID.
      *     instance: 'placeholder-value',
+     *     // Optional. Reset SSL mode to use.
+     *     mode: 'placeholder-value',
      *     // Project ID of the project that contains the instance.
      *     project: 'placeholder-value',
      *   });
@@ -9936,6 +10303,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10096,6 +10464,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10268,6 +10637,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10436,6 +10806,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10604,6 +10975,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10766,6 +11138,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -10926,6 +11299,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -11088,6 +11462,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -11256,6 +11631,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -11474,6 +11850,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -11839,6 +12216,22 @@ export namespace sqladmin_v1beta4 {
      */
     requestBody?: Schema$PointInTimeRestoreContext;
   }
+  export interface Params$Resource$Instances$Precheckmajorversionupgrade
+    extends StandardParameters {
+    /**
+     * Required. Cloud SQL instance ID. This does not include the project ID.
+     */
+    instance?: string;
+    /**
+     * Required. Project ID of the project that contains the instance.
+     */
+    project?: string;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$InstancesPreCheckMajorVersionUpgradeRequest;
+  }
   export interface Params$Resource$Instances$Promotereplica
     extends StandardParameters {
     /**
@@ -11887,6 +12280,10 @@ export namespace sqladmin_v1beta4 {
      * Cloud SQL instance ID. This does not include the project ID.
      */
     instance?: string;
+    /**
+     * Optional. Reset SSL mode to use.
+     */
+    mode?: string;
     /**
      * Project ID of the project that contains the instance.
      */
@@ -12027,7 +12424,7 @@ export namespace sqladmin_v1beta4 {
     }
 
     /**
-     * Cancels an instance operation that has been performed on an instance.
+     * Cancels an instance operation that has been performed on an instance. Ordinarily, this method name should be `CancelSqlOperation`.
      * @example
      * ```js
      * // Before running the sample:
@@ -12220,6 +12617,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -12727,6 +13125,7 @@ export namespace sqladmin_v1beta4 {
      *
      *   // Example response
      *   // {
+     *   //   "earliestRecoveryTime": "my_earliestRecoveryTime",
      *   //   "kind": "my_kind",
      *   //   "latestRecoveryTime": "my_latestRecoveryTime"
      *   // }
@@ -12899,6 +13298,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -13067,6 +13467,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -13235,6 +13636,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -13408,6 +13810,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -14012,6 +14415,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -14855,6 +15259,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -15010,6 +15415,8 @@ export namespace sqladmin_v1beta4 {
      *   //   "dualPasswordType": "my_dualPasswordType",
      *   //   "etag": "my_etag",
      *   //   "host": "my_host",
+     *   //   "iamEmail": "my_iamEmail",
+     *   //   "iamStatus": "my_iamStatus",
      *   //   "instance": "my_instance",
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
@@ -15161,6 +15568,8 @@ export namespace sqladmin_v1beta4 {
      *       //   "dualPasswordType": "my_dualPasswordType",
      *       //   "etag": "my_etag",
      *       //   "host": "my_host",
+     *       //   "iamEmail": "my_iamEmail",
+     *       //   "iamStatus": "my_iamStatus",
      *       //   "instance": "my_instance",
      *       //   "kind": "my_kind",
      *       //   "name": "my_name",
@@ -15187,6 +15596,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",
@@ -15485,6 +15895,8 @@ export namespace sqladmin_v1beta4 {
      *       //   "dualPasswordType": "my_dualPasswordType",
      *       //   "etag": "my_etag",
      *       //   "host": "my_host",
+     *       //   "iamEmail": "my_iamEmail",
+     *       //   "iamStatus": "my_iamStatus",
      *       //   "instance": "my_instance",
      *       //   "kind": "my_kind",
      *       //   "name": "my_name",
@@ -15511,6 +15923,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "kind": "my_kind",
      *   //   "name": "my_name",
      *   //   "operationType": "my_operationType",
+     *   //   "preCheckMajorVersionUpgradeContext": {},
      *   //   "selfLink": "my_selfLink",
      *   //   "startTime": "my_startTime",
      *   //   "status": "my_status",