@googleapis/sqladmin 35.2.0 → 37.0.0

package/build/v1.d.ts

@@ -489,6 +489,14 @@ export declare namespace sqladmin_v1 {
          * Required. Name of the Cloud SQL instance to be created as a clone.
          */
         destinationInstanceName?: string | null;
+        /**
+         * Optional. The fully qualified URI of the VPC network to which the cloned instance will be connected via Private Services Access for private IP. For example:`projects/my-network-project/global/networks/my-network`. This field is only required for cross-project cloning.
+         */
+        destinationNetwork?: string | null;
+        /**
+         * Optional. The project ID of the destination project where the cloned instance will be created. To perform a cross-project clone, this field is required. If not specified, the clone is created in the same project as the source instance.
+         */
+        destinationProject?: string | null;
         /**
          * This is always `sql#cloneContext`.
          */
@@ -1081,7 +1089,7 @@ export declare namespace sqladmin_v1 {
          */
         application?: string | null;
         /**
-         * Optional. When set to true, the API caller identity associated with the request is used for database authentication. The API caller must be an IAM user in the database.
+         * Optional. When set to `true`, the API caller identity associated with the request is used for database authentication. The API caller must be an IAM user in the database.
          */
         autoIamAuthn?: boolean | null;
         /**
@@ -2155,31 +2163,31 @@ export declare namespace sqladmin_v1 {
         reuseInterval?: number | null;
     }
     /**
-     * Performance Capture configuration.
+     * Performance capture configuration.
      */
     export interface Schema$PerformanceCaptureConfig {
         /**
-         * Optional. Enable or disable the Performance Capture feature.
+         * Optional. Enables or disables the performance capture feature.
          */
         enabled?: boolean | null;
         /**
-         * Optional. The minimum number of consecutive readings above threshold that triggers instance state capture.
+         * Optional. Specifies the minimum number of consecutive probe threshold that triggers performance capture.
          */
         probeThreshold?: number | null;
         /**
-         * Optional. The time interval in seconds between any two probes.
+         * Optional. Specifies the interval in seconds between consecutive probes that check if any trigger condition thresholds have been reached.
          */
         probingIntervalSeconds?: number | null;
         /**
-         * Optional. The minimum number of server threads running to trigger the capture on primary.
+         * Optional. Specifies the minimum number of MySQL `Threads_running` to trigger the performance capture on the primary instance.
          */
         runningThreadsThreshold?: number | null;
         /**
-         * Optional. The minimum number of seconds replica must be lagging behind primary to trigger capture on replica.
+         * Optional. Specifies the minimum number of seconds replica must be lagging behind primary instance to trigger the performance capture on replica.
          */
         secondsBehindSourceThreshold?: number | null;
         /**
-         * Optional. The amount of time in seconds that a transaction needs to have been open before the watcher starts recording it.
+         * Optional. Specifies the amount of time in seconds that a transaction needs to have been open before the watcher starts recording it.
          */
         transactionDurationThreshold?: number | null;
     }
@@ -2220,10 +2228,22 @@ export declare namespace sqladmin_v1 {
          * Optional. The resource link for the VPC network from which the Cloud SQL instance is accessible for private IP. For example, `/projects/myProject/global/networks/default`.
          */
         privateNetwork?: string | null;
+        /**
+         * Optional. The region of the target instance where the datasource will be restored. For example: "us-central1".
+         */
+        region?: string | null;
         /**
          * Target instance name.
          */
         targetInstance?: string | null;
+        /**
+         * Optional. Specifies the instance settings that will be cleared from the source instance. This field is only applicable for cross project PITRs.
+         */
+        targetInstanceClearSettingsFieldNames?: string[] | null;
+        /**
+         * Optional. Specifies the instance settings that will be overridden from the source instance. This field is only applicable for cross project PITRs.
+         */
+        targetInstanceSettings?: Schema$DatabaseInstance;
     }
     /**
      * Details of a single read pool node of a read pool.
@@ -2309,7 +2329,7 @@ export declare namespace sqladmin_v1 {
          */
         consumerNetworkStatus?: string | null;
         /**
-         * Optional. This is the project ID of consumer service project of this consumer endpoint. Optional. This is only applicable if consumer_network is a shared vpc network.
+         * Optional. This is the project ID of consumer service project of this consumer endpoint. This is only applicable if `consumer_network` is a shared VPC network.
          */
         consumerProject?: string | null;
         /**
@@ -2337,10 +2357,18 @@ export declare namespace sqladmin_v1 {
          * Optional. The list of settings for requested Private Service Connect consumer endpoints that can be used to connect to this Cloud SQL instance.
          */
         pscAutoConnections?: Schema$PscAutoConnectionConfig[];
+        /**
+         * Optional. Indicates whether PSC DNS automation is enabled for this instance. When enabled, Cloud SQL provisions a universal DNS record across all networks configured with Private Service Connect (PSC) auto-connections. This will default to true for new instances when Private Service Connect is enabled.
+         */
+        pscAutoDnsEnabled?: boolean | null;
         /**
          * Whether PSC connectivity is enabled for this instance.
          */
         pscEnabled?: boolean | null;
+        /**
+         * Optional. Indicates whether PSC write endpoint DNS automation is enabled for this instance. When enabled, Cloud SQL provisions a universal global DNS record across all networks configured with Private Service Connect (PSC) auto-connections that always points to the cluster primary instance. This feature is only supported for Enterprise Plus edition. This will default to true for new Enterprise Plus instances when `psc_auto_dns_enabled` is enabled.
+         */
+        pscWriteEndpointDnsEnabled?: boolean | null;
     }
     /**
      * QueryResult contains the result of executing a single SQL statement.
@@ -2530,6 +2558,10 @@ export declare namespace sqladmin_v1 {
      * Database instance settings.
      */
     export interface Schema$Settings {
+        /**
+         * Optional. Whether the replica is in accelerated mode. This feature is in private preview and requires allowlisting to take effect.
+         */
+        acceleratedReplicaMode?: boolean | null;
         /**
          * The activation policy specifies when the instance is activated; it is applicable only when the instance state is RUNNABLE. Valid values: * `ALWAYS`: The instance is on, and remains so even in the absence of connection requests. * `NEVER`: The instance is off; it is not activated, even if a connection request arrives.
          */
@@ -2615,7 +2647,7 @@ export declare namespace sqladmin_v1 {
          */
         denyMaintenancePeriods?: Schema$DenyMaintenancePeriod[];
         /**
-         * Optional. The edition of the instance.
+         * Optional. The edition type of the Cloud SQL instance.
          */
         edition?: string | null;
         /**
@@ -2846,23 +2878,6 @@ export declare namespace sqladmin_v1 {
      */
     export interface Schema$SqlInstancesResetReplicaSizeRequest {
     }
-    /**
-     * Instance restore backup request for MCP.
-     */
-    export interface Schema$SqlInstancesRestoreBackupMcpRequest {
-        /**
-         * Required. The identifier of the backup to restore. This will be one of the following: 1. An int64 containing a backup_run_id. 2. A backup name of the format 'projects/{project\}/backups/{backup-uid\}'. 3. A backupDR name of the format 'projects/{project\}/locations/{location\}/backupVaults/{backupvault\}/dataSources/{datasource\}/backups/{backup-uid\}'.
-         */
-        backupId?: string | null;
-        /**
-         * Optional. The Cloud SQL instance ID of the source instance containing the backup. Only necessary if the backup_id is a backup_run_id.
-         */
-        sourceInstance?: string | null;
-        /**
-         * Required. The project ID of the source instance containing the backup.
-         */
-        sourceProject?: string | null;
-    }
     /**
      * Instance start external sync request.
      */
@@ -5558,7 +5573,7 @@ export declare namespace sqladmin_v1 {
          *   const res = await sql.instances.clone({
          *     // Required. The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
          *     instance: 'placeholder-value',
-         *     // Required. Project ID of the source as well as the clone Cloud SQL instance.
+         *     // Required. Project ID of the source Cloud SQL instance.
          *     project: 'placeholder-value',
          *
          *     // Request body metadata
@@ -6960,7 +6975,10 @@ export declare namespace sqladmin_v1 {
          *       //   "preferredSecondaryZone": "my_preferredSecondaryZone",
          *       //   "preferredZone": "my_preferredZone",
          *       //   "privateNetwork": "my_privateNetwork",
-         *       //   "targetInstance": "my_targetInstance"
+         *       //   "region": "my_region",
+         *       //   "targetInstance": "my_targetInstance",
+         *       //   "targetInstanceClearSettingsFieldNames": [],
+         *       //   "targetInstanceSettings": {}
          *       // }
          *     },
          *   });
@@ -7610,100 +7628,6 @@ export declare namespace sqladmin_v1 {
         restoreBackup(params: Params$Resource$Instances$Restorebackup, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
         restoreBackup(params: Params$Resource$Instances$Restorebackup, callback: BodyResponseCallback<Schema$Operation>): void;
         restoreBackup(callback: BodyResponseCallback<Schema$Operation>): void;
-        /**
-         * Restores a backup of a Cloud SQL instance for Model Context Protocol (MCP) server.
-         * @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('v1');
-         *
-         * 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.restoreBackupMcp({
-         *     // Required. Cloud SQL instance ID of the target. This does not include the project ID.
-         *     targetInstance: 'placeholder-value',
-         *     // Required. Project ID of the target project.
-         *     targetProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "backupId": "my_backupId",
-         *       //   "sourceInstance": "my_sourceInstance",
-         *       //   "sourceProject": "my_sourceProject"
-         *       // }
-         *     },
-         *   });
-         *   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.
-         */
-        restoreBackupMcp(params: Params$Resource$Instances$Restorebackupmcp, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
-        restoreBackupMcp(params?: Params$Resource$Instances$Restorebackupmcp, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
-        restoreBackupMcp(params: Params$Resource$Instances$Restorebackupmcp, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
-        restoreBackupMcp(params: Params$Resource$Instances$Restorebackupmcp, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
-        restoreBackupMcp(params: Params$Resource$Instances$Restorebackupmcp, callback: BodyResponseCallback<Schema$Operation>): void;
-        restoreBackupMcp(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Rotates the server certificate version to one previously added with the addEntraIdCertificate method.
          * @example
@@ -8519,7 +8443,7 @@ export declare namespace sqladmin_v1 {
          */
         instance?: string;
         /**
-         * Required. Project ID of the source as well as the clone Cloud SQL instance.
+         * Required. Project ID of the source Cloud SQL instance.
          */
         project?: string;
         /**
@@ -8819,20 +8743,6 @@ export declare namespace sqladmin_v1 {
          */
         requestBody?: Schema$InstancesRestoreBackupRequest;
     }
-    export interface Params$Resource$Instances$Restorebackupmcp extends StandardParameters {
-        /**
-         * Required. Cloud SQL instance ID of the target. This does not include the project ID.
-         */
-        targetInstance?: string;
-        /**
-         * Required. Project ID of the target project.
-         */
-        targetProject?: string;
-        /**
-         * Request body metadata
-         */
-        requestBody?: Schema$SqlInstancesRestoreBackupMcpRequest;
-    }
     export interface Params$Resource$Instances$Rotateentraidcertificate extends StandardParameters {
         /**
          * Required. Cloud SQL instance ID. This does not include the project ID.
@@ -10806,6 +10716,8 @@ export declare namespace sqladmin_v1 {
          *     name: 'placeholder-value',
          *     // Project ID of the project that contains the instance.
          *     project: 'placeholder-value',
+         *     // Optional. Specifies whether to revoke existing roles that are not present in the `database_roles` field. If `false` or unset, the database roles specified in `database_roles` are added to the user's existing roles.
+         *     revokeExistingRoles: 'placeholder-value',
          *
          *     // Request body metadata
          *     requestBody: {
@@ -10955,6 +10867,10 @@ export declare namespace sqladmin_v1 {
          * Project ID of the project that contains the instance.
          */
         project?: string;
+        /**
+         * Optional. Specifies whether to revoke existing roles that are not present in the `database_roles` field. If `false` or unset, the database roles specified in `database_roles` are added to the user's existing roles.
+         */
+        revokeExistingRoles?: boolean;
         /**
          * Request body metadata
          */

package/build/v1.js

@@ -1546,39 +1546,6 @@ var sqladmin_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
-        restoreBackupMcp(paramsOrCallback, optionsOrCallback, callback) {
-            let params = (paramsOrCallback ||
-                {});
-            let options = (optionsOrCallback || {});
-            if (typeof paramsOrCallback === 'function') {
-                callback = paramsOrCallback;
-                params = {};
-                options = {};
-            }
-            if (typeof optionsOrCallback === 'function') {
-                callback = optionsOrCallback;
-                options = {};
-            }
-            const rootUrl = options.rootUrl || 'https://sqladmin.googleapis.com/';
-            const parameters = {
-                options: Object.assign({
-                    url: (rootUrl +
-                        '/v1/projects/{targetProject}/instances/{targetInstance}:restoreBackupMcp').replace(/([^:]\/)\/+/g, '$1'),
-                    method: 'POST',
-                    apiVersion: '',
-                }, options),
-                params,
-                requiredParams: ['targetProject', 'targetInstance'],
-                pathParams: ['targetInstance', 'targetProject'],
-                context: this.context,
-            };
-            if (callback) {
-                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
-            }
-            else {
-                return (0, googleapis_common_1.createAPIRequest)(parameters);
-            }
-        }
         RotateEntraIdCertificate(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback ||
                 {});