@googleapis/sqladmin 35.2.0 → 36.0.0

package/v1.ts

@@ -553,6 +553,14 @@ export 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`.
      */
@@ -1139,7 +1147,7 @@ export 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;
     /**
@@ -2205,31 +2213,31 @@ export 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;
   }
@@ -2270,10 +2278,22 @@ export 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.
@@ -2359,7 +2379,7 @@ export 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;
     /**
@@ -2387,10 +2407,18 @@ export 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.
@@ -2580,6 +2608,10 @@ export 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.
      */
@@ -2893,23 +2925,6 @@ export namespace sqladmin_v1 {
    * Instance reset replica size request.
    */
   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.
    */
@@ -7328,7 +7343,7 @@ export 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
@@ -9901,7 +9916,10 @@ export namespace sqladmin_v1 {
      *       //   "preferredSecondaryZone": "my_preferredSecondaryZone",
      *       //   "preferredZone": "my_preferredZone",
      *       //   "privateNetwork": "my_privateNetwork",
-     *       //   "targetInstance": "my_targetInstance"
+     *       //   "region": "my_region",
+     *       //   "targetInstance": "my_targetInstance",
+     *       //   "targetInstanceClearSettingsFieldNames": [],
+     *       //   "targetInstanceSettings": {}
      *       // }
      *     },
      *   });
@@ -11177,177 +11195,6 @@ export namespace sqladmin_v1 {
       }
     }
 
-    /**
-     * 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;
-    restoreBackupMcp(
-      paramsOrCallback?:
-        | Params$Resource$Instances$Restorebackupmcp
-        | 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$Restorebackupmcp;
-      let options = (optionsOrCallback || {}) as MethodOptions;
-
-      if (typeof paramsOrCallback === 'function') {
-        callback = paramsOrCallback;
-        params = {} as Params$Resource$Instances$Restorebackupmcp;
-        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) {
-        createAPIRequest<Schema$Operation>(
-          parameters,
-          callback as BodyResponseCallback<unknown>
-        );
-      } else {
-        return createAPIRequest<Schema$Operation>(parameters);
-      }
-    }
-
     /**
      * Rotates the server certificate version to one previously added with the addEntraIdCertificate method.
      * @example
@@ -12781,7 +12628,7 @@ export 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;
 
@@ -13094,21 +12941,6 @@ export 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.
@@ -16679,6 +16511,8 @@ export 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: {
@@ -16904,6 +16738,10 @@ export 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/v1beta4.ts

@@ -553,6 +553,14 @@ export namespace sqladmin_v1beta4 {
      * 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`.
      */
@@ -2208,31 +2216,31 @@ export namespace sqladmin_v1beta4 {
     reuseInterval?: number | null;
   }
   /**
-   * Performance Capture configuration.
+   * Performance capture configuration.
    */
   export interface Schema$PerformanceCaptureConfig {
     /**
-     * Optional. Enable or disable the Performance Capture.
+     * 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;
   }
@@ -2273,10 +2281,22 @@ export namespace sqladmin_v1beta4 {
      * 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.
@@ -2390,10 +2410,18 @@ export namespace sqladmin_v1beta4 {
      * 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.
@@ -2583,6 +2611,10 @@ export namespace sqladmin_v1beta4 {
    * Database instance settings.
    */
   export interface Schema$Settings {
+    /**
+     * Optional. Configures 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.
      */
@@ -7321,7 +7353,7 @@ export namespace sqladmin_v1beta4 {
      *   const res = await sql.instances.clone({
      *     // The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.
      *     instance: 'placeholder-value',
-     *     // Project ID of the source as well as the clone Cloud SQL instance.
+     *     // Project ID of the source Cloud SQL instance.
      *     project: 'placeholder-value',
      *
      *     // Request body metadata
@@ -9898,7 +9930,10 @@ export namespace sqladmin_v1beta4 {
      *       //   "preferredSecondaryZone": "my_preferredSecondaryZone",
      *       //   "preferredZone": "my_preferredZone",
      *       //   "privateNetwork": "my_privateNetwork",
-     *       //   "targetInstance": "my_targetInstance"
+     *       //   "region": "my_region",
+     *       //   "targetInstance": "my_targetInstance",
+     *       //   "targetInstanceClearSettingsFieldNames": [],
+     *       //   "targetInstanceSettings": {}
      *       // }
      *     },
      *   });
@@ -12609,7 +12644,7 @@ export namespace sqladmin_v1beta4 {
      */
     instance?: string;
     /**
-     * Project ID of the source as well as the clone Cloud SQL instance.
+     * Project ID of the source Cloud SQL instance.
      */
     project?: string;
 
@@ -16497,7 +16532,7 @@ export namespace sqladmin_v1beta4 {
      *     name: 'placeholder-value',
      *     // Project ID of the project that contains the instance.
      *     project: 'placeholder-value',
-     *     // Optional. revoke the existing roles granted to the user.
+     *     // 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
@@ -16726,7 +16761,7 @@ export namespace sqladmin_v1beta4 {
      */
     project?: string;
     /**
-     * Optional. revoke the existing roles granted to the user.
+     * 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;