@googleapis/sqladmin 28.0.0 → 29.0.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [29.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/sqladmin-v28.0.0...sqladmin-v29.0.0) (2025-05-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* **sqladmin:** This release has breaking changes.
+* **sqladmin:** This release has breaking changes.
+
+### Features
+
+* **sqladmin:** update the API ([9755a1f](https://github.com/googleapis/google-api-nodejs-client/commit/9755a1f1636059eb3dc7764d06e070ac6889100d))
+* **sqladmin:** update the API ([0a3a02e](https://github.com/googleapis/google-api-nodejs-client/commit/0a3a02e9b423dd32b85f564f62dbe16811843789))
+
 ## [28.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/sqladmin-v27.0.0...sqladmin-v28.0.0) (2025-04-18)
 
 

package/build/v1.d.ts

@@ -167,7 +167,7 @@ export declare namespace sqladmin_v1 {
         name?: string | null;
     }
     /**
-     * A backup resource.
+     * A backup resource. Next ID: 30
      */
     export interface Schema$Backup {
         /**
@@ -183,7 +183,7 @@ export declare namespace sqladmin_v1 {
          */
         backupRun?: string | null;
         /**
-         * Output only. The database version of the instance of when this backup was made.
+         * Output only. The database version of the instance of at the time this backup was made.
          */
         databaseVersion?: string | null;
         /**
@@ -271,6 +271,10 @@ export declare namespace sqladmin_v1 {
          * Backup retention settings.
          */
         backupRetentionSettings?: Schema$BackupRetentionSettings;
+        /**
+         * Output only. Backup tier that manages the backups for the instance.
+         */
+        backupTier?: string | null;
         /**
          * (MySQL only) Whether binary log is enabled. If backup configuration is disabled, binarylog must be disabled as well.
          */
@@ -360,7 +364,7 @@ export declare namespace sqladmin_v1 {
          */
         backupKind?: string | null;
         /**
-         * Output only. The instance database version when this backup was made.
+         * Output only. The instance database version at the time this backup was made.
          */
         databaseVersion?: string | null;
         /**
@@ -511,38 +515,14 @@ export declare namespace sqladmin_v1 {
      * The managed connection pooling configuration.
      */
     export interface Schema$ConnectionPoolConfig {
-        /**
-         * Client idle timeout.
-         */
-        clientConnectionIdleTimeout?: string | null;
         /**
          * Whether managed connection pooling is enabled.
          */
         connectionPoolingEnabled?: boolean | null;
-        /**
-         * Managed connection pool size.
-         */
-        connPoolSize?: number | null;
         /**
          * Optional. List of connection pool configuration flags
          */
         flags?: Schema$ConnectionPoolFlags[];
-        /**
-         * Maximum number of client connections in connection pool.
-         */
-        maxClientConnections?: number | null;
-        /**
-         * The managed connection pool mode for the instance.
-         */
-        poolMode?: string | null;
-        /**
-         * Query wait timeout.
-         */
-        queryWaitTimeout?: string | null;
-        /**
-         * Server idle timeout.
-         */
-        serverConnectionIdleTimeout?: string | null;
     }
     /**
      * Connection pool flags for Cloud SQL instances managed connection pool configuration.
@@ -558,23 +538,23 @@ export declare namespace sqladmin_v1 {
         value?: string | null;
     }
     /**
-     * Details of a single node of a read pool.
+     * Details of a single read pool node of a read pool.
      */
     export interface Schema$ConnectPoolNodeConfig {
         /**
-         * Output only. The DNS name of the node.
+         * Output only. The DNS name of the read pool node.
          */
         dnsName?: string | null;
         /**
-         * Output only. The list of DNS names used by this node.
+         * Output only. The list of DNS names used by this read pool node.
          */
         dnsNames?: Schema$DnsNameMapping[];
         /**
-         * Output only. Mappings containing IP addresses that can be used to connect to the node.
+         * Output only. Mappings containing IP addresses that can be used to connect to the read pool node.
          */
         ipAddresses?: Schema$IpMapping[];
         /**
-         * Output only. The name of the node. Doesn't include the project ID.
+         * Output only. The name of the read pool node. Doesn't include the project ID.
          */
         name?: string | null;
     }
@@ -611,11 +591,11 @@ export declare namespace sqladmin_v1 {
          */
         kind?: string | null;
         /**
-         * The number of nodes in a read pool.
+         * The number of read pool nodes in a read pool.
          */
         nodeCount?: number | null;
         /**
-         * Output only. Entries containing information about each node of the read pool.
+         * Output only. Entries containing information about each read pool node of the read pool.
          */
         nodes?: Schema$ConnectPoolNodeConfig[];
         /**
@@ -790,11 +770,11 @@ export declare namespace sqladmin_v1 {
          */
         name?: string | null;
         /**
-         * The number of nodes in a read pool.
+         * The number of read pool nodes in a read pool.
          */
         nodeCount?: number | null;
         /**
-         * Output only. Entries containing information about each node of the read pool.
+         * Output only. Entries containing information about each read pool node of the read pool.
          */
         nodes?: Schema$PoolNodeConfig[];
         /**
@@ -1103,7 +1083,7 @@ export declare namespace sqladmin_v1 {
          */
         kind?: string | null;
         /**
-         * Option for export offload.
+         * Whether to perform a serverless export.
          */
         offload?: boolean | null;
         /**
@@ -1538,6 +1518,10 @@ export declare namespace sqladmin_v1 {
          * The name of the backup that's used to restore a Cloud SQL instance: Format: projects/{project-id\}/backups/{backup-uid\}. Only one of restore_backup_context, backup, backupdr_backup can be passed to the input.
          */
         backup?: string | null;
+        /**
+         * The name of the backup that's used to restore a Cloud SQL instance: Format: "projects/{project-id\}/locations/{location\}/backupVaults/{backupvault\}/dataSources/{datasource\}/backups/{backup-uid\}". Only one of restore_backup_context, backup, backupdr_backup can be passed to the input.
+         */
+        backupdrBackup?: string | null;
         /**
          * Parameters required to perform the restore backup operation.
          */
@@ -2033,31 +2017,64 @@ export declare namespace sqladmin_v1 {
         targetSizeGb?: string | null;
     }
     /**
-     * Details of a single node of a read pool.
+     * The context to perform a point-in-time recovery of an instance managed by Google Cloud Backup and Disaster Recovery.
+     */
+    export interface Schema$PointInTimeRestoreContext {
+        /**
+         * Optional. The name of the allocated IP range for the internal IP Cloud SQL instance. For example: "google-managed-services-default". If you set this, then Cloud SQL creates the IP address for the cloned instance in the allocated range. This range must comply with [RFC 1035](https://tools.ietf.org/html/rfc1035) standards. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Reserved for future use. http://go/speckle-subnet-picker-clone
+         */
+        allocatedIpRange?: string | null;
+        /**
+         * The Google Cloud Backup and Disaster Recovery Datasource URI. Format: projects/{project\}/locations/{region\}/backupVaults/{backupvault\}/dataSources/{datasource\}.
+         */
+        datasource?: string | null;
+        /**
+         * Required. The date and time to which you want to restore the instance.
+         */
+        pointInTime?: string | null;
+        /**
+         * Optional. Point-in-time recovery of a regional instance in the specified zones. If not specified, clone to the same secondary zone as the source instance. This value cannot be the same as the preferred_zone field.
+         */
+        preferredSecondaryZone?: string | null;
+        /**
+         * Optional. Point-in-time recovery of an instance to the specified zone. If no zone is specified, then clone to the same primary zone as the source instance.
+         */
+        preferredZone?: string | null;
+        /**
+         * 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;
+        /**
+         * Target instance name.
+         */
+        targetInstance?: string | null;
+    }
+    /**
+     * Details of a single read pool node of a read pool.
      */
     export interface Schema$PoolNodeConfig {
         /**
-         * Output only. The DNS name of the node.
+         * Output only. The DNS name of the read pool node.
          */
         dnsName?: string | null;
         /**
-         * Output only. The list of DNS names used by this node.
+         * Output only. The list of DNS names used by this read pool node.
          */
         dnsNames?: Schema$DnsNameMapping[];
         /**
-         * Output only. The serving zone of the node.
+         * Output only. The zone of the read pool node.
          */
         gceZone?: string | null;
         /**
-         * Output only. Mappings containing IP addresses that can be used to connect to the node.
+         * Output only. Mappings containing IP addresses that can be used to connect to the read pool node.
          */
         ipAddresses?: Schema$IpMapping[];
         /**
-         * Output only. The name of the node, to be used for retrieving metrics and logs for the node.
+         * Output only. The name of the read pool node, to be used for retrieving metrics and logs.
          */
         name?: string | null;
         /**
-         * Output only. The current state of the node.
+         * Output only. The current state of the read pool node.
          */
         state?: string | null;
     }
@@ -2296,7 +2313,7 @@ export declare namespace sqladmin_v1 {
          */
         enableDataplexIntegration?: boolean | null;
         /**
-         * Optional. When this parameter is set to true, Cloud SQL instances can connect to Vertex AI to pass requests for real-time predictions and insights to the AI. The default value is false. This applies only to Cloud SQL for PostgreSQL instances.
+         * Optional. When this parameter is set to true, Cloud SQL instances can connect to Vertex AI to pass requests for real-time predictions and insights to the AI. The default value is false. This applies only to Cloud SQL for MySQL and Cloud SQL for PostgreSQL instances.
          */
         enableGoogleMlIntegration?: boolean | null;
         /**
@@ -3066,7 +3083,7 @@ export declare namespace sqladmin_v1 {
         ListBackups(params: Params$Resource$Backups$Listbackups, callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
         ListBackups(callback: BodyResponseCallback<Schema$ListBackupsResponse>): void;
         /**
-         * Updates the retention period and description of the backup. You can use this API to update final backups only.
+         * This API updates the following: 1- retention period and description of backup in case of final backups only. 2- gcbdr_soft_delete_status of backup in case of GCBDR managed backups only.
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3126,7 +3143,7 @@ export declare namespace sqladmin_v1 {
          */
         name?: string;
         /**
-         * The list of fields that you can update. You can update only the description and retention period of the final backup.
+         * The list of fields that you can update. 1- You can update only the description and retention period for a final backup. 2- You can update only the gcbdr_soft_delete_status for GCBDR managed backup.
          */
         updateMask?: string;
         /**
@@ -3625,6 +3642,20 @@ export declare namespace sqladmin_v1 {
         patch(params: Params$Resource$Instances$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
         patch(params: Params$Resource$Instances$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
         patch(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Point in time restore for an instance managed by Google Cloud Backup and Disaster Recovery.
+         *
+         * @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.
+         */
+        pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, options: StreamMethodOptions): GaxiosPromise<Readable>;
+        pointInTimeRestore(params?: Params$Resource$Instances$Pointintimerestore, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
+        pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        pointInTimeRestore(params: Params$Resource$Instances$Pointintimerestore, callback: BodyResponseCallback<Schema$Operation>): void;
+        pointInTimeRestore(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
          * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
          *
@@ -4024,6 +4055,16 @@ export declare namespace sqladmin_v1 {
          */
         requestBody?: Schema$DatabaseInstance;
     }
+    export interface Params$Resource$Instances$Pointintimerestore extends StandardParameters {
+        /**
+         * Required. The parent resource where you created this instance. Format: projects/{project\}
+         */
+        parent?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$PointInTimeRestoreContext;
+    }
     export interface Params$Resource$Instances$Promotereplica extends StandardParameters {
         /**
          * 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.

package/build/v1.js

@@ -1169,6 +1169,38 @@ var sqladmin_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
+        pointInTimeRestore(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/{+parent}:pointInTimeRestore').replace(/([^:]\/)\/+/g, '$1'),
+                    method: 'POST',
+                    apiVersion: '',
+                }, options),
+                params,
+                requiredParams: ['parent'],
+                pathParams: ['parent'],
+                context: this.context,
+            };
+            if (callback) {
+                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
+            }
+            else {
+                return (0, googleapis_common_1.createAPIRequest)(parameters);
+            }
+        }
         promoteReplica(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback ||
                 {});