@googleapis/sqladmin 16.1.0 → 17.0.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [17.0.1](https://github.com/googleapis/google-api-nodejs-client/compare/sqladmin-v17.0.0...sqladmin-v17.0.1) (2024-05-07)
+
+
+### Bug Fixes
+
+* **sqladmin:** update the API ([975e692](https://github.com/googleapis/google-api-nodejs-client/commit/975e6928315d2b380b565d81d09356e6819988c4))
+
+## [17.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/sqladmin-v16.1.0...sqladmin-v17.0.0) (2024-05-02)
+
+
+### ⚠ BREAKING CHANGES
+
+* This release has breaking changes.
+* This release has breaking changes.
+
+### Features
+
+* run the generator ([#3434](https://github.com/googleapis/google-api-nodejs-client/issues/3434)) ([f0db524](https://github.com/googleapis/google-api-nodejs-client/commit/f0db524bb26f05cea3dec4c0ed66b496399e3857))
+* run the generator ([#3456](https://github.com/googleapis/google-api-nodejs-client/issues/3456)) ([a865e81](https://github.com/googleapis/google-api-nodejs-client/commit/a865e81539b315d3b321650663ba0b2555b1e5a1))
+* **sqladmin:** update the API ([7cc6d5e](https://github.com/googleapis/google-api-nodejs-client/commit/7cc6d5e1283e44228e54acf2bdb10bbe5436996c))
+* **sqladmin:** update the API ([f17c99a](https://github.com/googleapis/google-api-nodejs-client/commit/f17c99aed62a4d186e4d56756b9fa24b038552e8))
+* **sqladmin:** update the API ([a80b25a](https://github.com/googleapis/google-api-nodejs-client/commit/a80b25a55667abdc7afeca561b5744ddd55eca3b))
+
 ## [16.1.0](https://github.com/googleapis/google-api-nodejs-client/compare/sqladmin-v16.0.0...sqladmin-v16.1.0) (2024-05-02)
 
 

package/build/v1.d.ts

@@ -185,7 +185,7 @@ export declare namespace sqladmin_v1 {
          */
         startTime?: string | null;
         /**
-         * Output only. This value contains the storage location of transactional logs for the database for point-in-time recovery.
+         * Output only. This value contains the storage location of transactional logs used to perform point-in-time recovery (PITR) for the database.
          */
         transactionalLogStorageState?: string | null;
         /**
@@ -524,7 +524,7 @@ export declare namespace sqladmin_v1 {
          */
         gceZone?: string | null;
         /**
-         * Gemini configuration.
+         * Gemini instance configuration.
          */
         geminiConfig?: Schema$GeminiInstanceConfig;
         /**
@@ -592,7 +592,7 @@ export declare namespace sqladmin_v1 {
          */
         replicaNames?: string[] | null;
         /**
-         * Optional. The pair of a primary instance and disaster recovery (DR) replica. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure.
+         * Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
          */
         replicationCluster?: Schema$ReplicationCluster;
         /**
@@ -920,31 +920,31 @@ export declare namespace sqladmin_v1 {
         kind?: string | null;
     }
     /**
-     * Gemini configuration.
+     * Gemini instance configuration.
      */
     export interface Schema$GeminiInstanceConfig {
         /**
-         * Output only. Whether active query is enabled.
+         * Output only. Whether the active query is enabled.
          */
         activeQueryEnabled?: boolean | null;
         /**
-         * Output only. Whether gemini is enabled.
+         * Output only. Whether Gemini is enabled.
          */
         entitled?: boolean | null;
         /**
-         * Output only. Whether flag recommender is enabled.
+         * Output only. Whether the flag recommender is enabled.
          */
         flagRecommenderEnabled?: boolean | null;
         /**
-         * Output only. Whether vacuum management is enabled.
+         * Output only. Whether the vacuum management is enabled.
          */
         googleVacuumMgmtEnabled?: boolean | null;
         /**
-         * Output only. Whether index advisor is enabled.
+         * Output only. Whether the index advisor is enabled.
          */
         indexAdvisorEnabled?: boolean | null;
         /**
-         * Output only. Whether oom session cancel is enabled.
+         * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
          */
         oomSessionCancelEnabled?: boolean | null;
     }
@@ -1246,7 +1246,7 @@ export declare namespace sqladmin_v1 {
          */
         requireSsl?: boolean | null;
         /**
-         * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` gets priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means only accept SSL connections, while the `require_ssl=false` means accept both non-SSL and SSL connections. MySQL and PostgreSQL databases respect `ssl_mode` in this case and accept only SSL connections.
+         * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.
          */
         sslMode?: string | null;
     }
@@ -1652,15 +1652,15 @@ export declare namespace sqladmin_v1 {
         mysqlReplicaConfiguration?: Schema$MySqlReplicaConfiguration;
     }
     /**
-     * Primary-DR replica pair
+     * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
      */
     export interface Schema$ReplicationCluster {
         /**
-         * Output only. read-only field that indicates if the replica is a dr_replica; not set for a primary.
+         * Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance.
          */
         drReplica?: boolean | null;
         /**
-         * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Users can set this field to set a designated DR replica for a primary. Removing this field removes the DR replica.
+         * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation.
          */
         failoverDrReplicaName?: string | null;
     }
@@ -1944,7 +1944,7 @@ export declare namespace sqladmin_v1 {
      */
     export interface Schema$SqlInstancesStartExternalSyncRequest {
         /**
-         * Optional. MigrationType decides if the migration is a physical file based migration or logical migration.
+         * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
          */
         migrationType?: string | null;
         /**
@@ -1969,7 +1969,7 @@ export declare namespace sqladmin_v1 {
      */
     export interface Schema$SqlInstancesVerifyExternalSyncSettingsRequest {
         /**
-         * Optional. MigrationType decides if the migration is a physical file based migration or logical migration
+         * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
          */
         migrationType?: string | null;
         /**
@@ -1981,7 +1981,7 @@ export declare namespace sqladmin_v1 {
          */
         syncMode?: string | null;
         /**
-         * Optional. Parallel level for initial data sync. Currently only applicable for PostgreSQL.
+         * Optional. Parallel level for initial data sync. Only applicable for PostgreSQL.
          */
         syncParallelLevel?: string | null;
         /**
@@ -2930,7 +2930,7 @@ export declare namespace sqladmin_v1 {
         patch(params: Params$Resource$Instances$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
         patch(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
-         * Promotes the read replica instance to be a stand-alone Cloud SQL instance. Using this operation might cause your instance to restart.
+         * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3056,7 +3056,7 @@ export declare namespace sqladmin_v1 {
         stopReplica(params: Params$Resource$Instances$Stopreplica, callback: BodyResponseCallback<Schema$Operation>): void;
         stopReplica(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
-         * Switches over from the primary instance to the replica instance.
+         * Switches over from the primary instance to the designated DR replica instance.
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3280,7 +3280,7 @@ export declare namespace sqladmin_v1 {
     }
     export interface Params$Resource$Instances$Promotereplica extends StandardParameters {
         /**
-         * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.
+         * Set to true to invoke a replica failover to the designated 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. Only applicable to MySQL.
          */
         failover?: boolean;
         /**

package/build/v1beta4.d.ts

@@ -592,7 +592,7 @@ export declare namespace sqladmin_v1beta4 {
          */
         replicaNames?: string[] | null;
         /**
-         * The pair of a primary instance and disaster recovery (DR) replica. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure.
+         * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
          */
         replicationCluster?: Schema$ReplicationCluster;
         /**
@@ -923,11 +923,11 @@ export declare namespace sqladmin_v1beta4 {
         kind?: string | null;
     }
     /**
-     * Gemini configuration.
+     * Gemini instance configuration.
      */
     export interface Schema$GeminiInstanceConfig {
         /**
-         * Output only. Whether active query is enabled.
+         * Output only. Whether the active query is enabled.
          */
         activeQueryEnabled?: boolean | null;
         /**
@@ -935,19 +935,19 @@ export declare namespace sqladmin_v1beta4 {
          */
         entitled?: boolean | null;
         /**
-         * Output only. Whether flag recommender is enabled.
+         * Output only. Whether the flag recommender is enabled.
          */
         flagRecommenderEnabled?: boolean | null;
         /**
-         * Output only. Whether vacuum management is enabled.
+         * Output only. Whether the vacuum management is enabled.
          */
         googleVacuumMgmtEnabled?: boolean | null;
         /**
-         * Output only. Whether index advisor is enabled.
+         * Output only. Whether the index advisor is enabled.
          */
         indexAdvisorEnabled?: boolean | null;
         /**
-         * Output only. Whether oom session cancel is enabled.
+         * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
          */
         oomSessionCancelEnabled?: boolean | null;
     }
@@ -1249,7 +1249,7 @@ export declare namespace sqladmin_v1beta4 {
          */
         requireSsl?: boolean | null;
         /**
-         * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` gets priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means only accept SSL connections, while the `require_ssl=false` means accept both non-SSL and SSL connections. MySQL and PostgreSQL databases respect `ssl_mode` in this case and accept only SSL connections.
+         * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.
          */
         sslMode?: string | null;
     }
@@ -1655,15 +1655,15 @@ export declare namespace sqladmin_v1beta4 {
         mysqlReplicaConfiguration?: Schema$MySqlReplicaConfiguration;
     }
     /**
-     * Primary-DR replica pair
+     * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL.
      */
     export interface Schema$ReplicationCluster {
         /**
-         * Output only. read-only field that indicates if the replica is a dr_replica; not set for a primary.
+         * Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance.
          */
         drReplica?: boolean | null;
         /**
-         * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Users can set this field to set a designated DR replica for a primary. Removing this field removes the DR replica.
+         * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation.
          */
         failoverDrReplicaName?: string | null;
     }
@@ -1944,7 +1944,7 @@ export declare namespace sqladmin_v1beta4 {
     }
     export interface Schema$SqlInstancesStartExternalSyncRequest {
         /**
-         * Optional. MigrationType decides if the migration is a physical file based migration or logical migration.
+         * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
          */
         migrationType?: string | null;
         /**
@@ -1966,7 +1966,7 @@ export declare namespace sqladmin_v1beta4 {
     }
     export interface Schema$SqlInstancesVerifyExternalSyncSettingsRequest {
         /**
-         * Optional. MigrationType field decides if the migration is a physical file based migration or logical migration
+         * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
          */
         migrationType?: string | null;
         /**
@@ -1978,7 +1978,7 @@ export declare namespace sqladmin_v1beta4 {
          */
         syncMode?: string | null;
         /**
-         * Optional. Parallel level for initial data sync. Currently only applicable for PostgreSQL.
+         * Optional. Parallel level for initial data sync. Only applicable for PostgreSQL.
          */
         syncParallelLevel?: string | null;
         /**
@@ -2927,7 +2927,7 @@ export declare namespace sqladmin_v1beta4 {
         patch(params: Params$Resource$Instances$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
         patch(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
-         * Promotes the read replica instance to be a stand-alone Cloud SQL instance. Using this operation might cause your instance to restart.
+         * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3053,7 +3053,7 @@ export declare namespace sqladmin_v1beta4 {
         stopReplica(params: Params$Resource$Instances$Stopreplica, callback: BodyResponseCallback<Schema$Operation>): void;
         stopReplica(callback: BodyResponseCallback<Schema$Operation>): void;
         /**
-         * Switches over from the primary instance to a replica instance.
+         * Switches over from the primary instance to the designated DR replica instance.
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3277,7 +3277,7 @@ export declare namespace sqladmin_v1beta4 {
     }
     export interface Params$Resource$Instances$Promotereplica extends StandardParameters {
         /**
-         * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.
+         * Set to true to invoke a replica failover to the designated 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. Only applicable to MySQL.
          */
         failover?: boolean;
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googleapis/sqladmin",
-  "version": "16.1.0",
+  "version": "17.0.1",
   "description": "sqladmin",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/v1.ts

@@ -247,7 +247,7 @@ export namespace sqladmin_v1 {
      */
     startTime?: string | null;
     /**
-     * Output only. This value contains the storage location of transactional logs for the database for point-in-time recovery.
+     * Output only. This value contains the storage location of transactional logs used to perform point-in-time recovery (PITR) for the database.
      */
     transactionalLogStorageState?: string | null;
     /**
@@ -583,7 +583,7 @@ export namespace sqladmin_v1 {
      */
     gceZone?: string | null;
     /**
-     * Gemini configuration.
+     * Gemini instance configuration.
      */
     geminiConfig?: Schema$GeminiInstanceConfig;
     /**
@@ -651,7 +651,7 @@ export namespace sqladmin_v1 {
      */
     replicaNames?: string[] | null;
     /**
-     * Optional. The pair of a primary instance and disaster recovery (DR) replica. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure.
+     * Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
      */
     replicationCluster?: Schema$ReplicationCluster;
     /**
@@ -976,31 +976,31 @@ export namespace sqladmin_v1 {
     kind?: string | null;
   }
   /**
-   * Gemini configuration.
+   * Gemini instance configuration.
    */
   export interface Schema$GeminiInstanceConfig {
     /**
-     * Output only. Whether active query is enabled.
+     * Output only. Whether the active query is enabled.
      */
     activeQueryEnabled?: boolean | null;
     /**
-     * Output only. Whether gemini is enabled.
+     * Output only. Whether Gemini is enabled.
      */
     entitled?: boolean | null;
     /**
-     * Output only. Whether flag recommender is enabled.
+     * Output only. Whether the flag recommender is enabled.
      */
     flagRecommenderEnabled?: boolean | null;
     /**
-     * Output only. Whether vacuum management is enabled.
+     * Output only. Whether the vacuum management is enabled.
      */
     googleVacuumMgmtEnabled?: boolean | null;
     /**
-     * Output only. Whether index advisor is enabled.
+     * Output only. Whether the index advisor is enabled.
      */
     indexAdvisorEnabled?: boolean | null;
     /**
-     * Output only. Whether oom session cancel is enabled.
+     * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
      */
     oomSessionCancelEnabled?: boolean | null;
   }
@@ -1299,7 +1299,7 @@ export namespace sqladmin_v1 {
      */
     requireSsl?: boolean | null;
     /**
-     * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` gets priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means only accept SSL connections, while the `require_ssl=false` means accept both non-SSL and SSL connections. MySQL and PostgreSQL databases respect `ssl_mode` in this case and accept only SSL connections.
+     * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.
      */
     sslMode?: string | null;
   }
@@ -1705,15 +1705,15 @@ export namespace sqladmin_v1 {
     mysqlReplicaConfiguration?: Schema$MySqlReplicaConfiguration;
   }
   /**
-   * Primary-DR replica pair
+   * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
    */
   export interface Schema$ReplicationCluster {
     /**
-     * Output only. read-only field that indicates if the replica is a dr_replica; not set for a primary.
+     * Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance.
      */
     drReplica?: boolean | null;
     /**
-     * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Users can set this field to set a designated DR replica for a primary. Removing this field removes the DR replica.
+     * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation.
      */
     failoverDrReplicaName?: string | null;
   }
@@ -1994,7 +1994,7 @@ export namespace sqladmin_v1 {
    */
   export interface Schema$SqlInstancesStartExternalSyncRequest {
     /**
-     * Optional. MigrationType decides if the migration is a physical file based migration or logical migration.
+     * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
      */
     migrationType?: string | null;
     /**
@@ -2019,7 +2019,7 @@ export namespace sqladmin_v1 {
    */
   export interface Schema$SqlInstancesVerifyExternalSyncSettingsRequest {
     /**
-     * Optional. MigrationType decides if the migration is a physical file based migration or logical migration
+     * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
      */
     migrationType?: string | null;
     /**
@@ -2031,7 +2031,7 @@ export namespace sqladmin_v1 {
      */
     syncMode?: string | null;
     /**
-     * Optional. Parallel level for initial data sync. Currently only applicable for PostgreSQL.
+     * Optional. Parallel level for initial data sync. Only applicable for PostgreSQL.
      */
     syncParallelLevel?: string | null;
     /**
@@ -5017,7 +5017,7 @@ export namespace sqladmin_v1 {
     }
 
     /**
-     * Promotes the read replica instance to be a stand-alone Cloud SQL instance. Using this operation might cause your instance to restart.
+     * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5816,7 +5816,7 @@ export namespace sqladmin_v1 {
     }
 
     /**
-     * Switches over from the primary instance to the replica instance.
+     * Switches over from the primary instance to the designated DR replica instance.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6274,7 +6274,7 @@ export namespace sqladmin_v1 {
   export interface Params$Resource$Instances$Promotereplica
     extends StandardParameters {
     /**
-     * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.
+     * Set to true to invoke a replica failover to the designated 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. Only applicable to MySQL.
      */
     failover?: boolean;
     /**

package/v1beta4.ts

@@ -651,7 +651,7 @@ export namespace sqladmin_v1beta4 {
      */
     replicaNames?: string[] | null;
     /**
-     * The pair of a primary instance and disaster recovery (DR) replica. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure.
+     * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.
      */
     replicationCluster?: Schema$ReplicationCluster;
     /**
@@ -979,11 +979,11 @@ export namespace sqladmin_v1beta4 {
     kind?: string | null;
   }
   /**
-   * Gemini configuration.
+   * Gemini instance configuration.
    */
   export interface Schema$GeminiInstanceConfig {
     /**
-     * Output only. Whether active query is enabled.
+     * Output only. Whether the active query is enabled.
      */
     activeQueryEnabled?: boolean | null;
     /**
@@ -991,19 +991,19 @@ export namespace sqladmin_v1beta4 {
      */
     entitled?: boolean | null;
     /**
-     * Output only. Whether flag recommender is enabled.
+     * Output only. Whether the flag recommender is enabled.
      */
     flagRecommenderEnabled?: boolean | null;
     /**
-     * Output only. Whether vacuum management is enabled.
+     * Output only. Whether the vacuum management is enabled.
      */
     googleVacuumMgmtEnabled?: boolean | null;
     /**
-     * Output only. Whether index advisor is enabled.
+     * Output only. Whether the index advisor is enabled.
      */
     indexAdvisorEnabled?: boolean | null;
     /**
-     * Output only. Whether oom session cancel is enabled.
+     * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
      */
     oomSessionCancelEnabled?: boolean | null;
   }
@@ -1302,7 +1302,7 @@ export namespace sqladmin_v1beta4 {
      */
     requireSsl?: boolean | null;
     /**
-     * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` gets priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, the `ssl_mode=ENCRYPTED_ONLY` means only accept SSL connections, while the `require_ssl=false` means accept both non-SSL and SSL connections. MySQL and PostgreSQL databases respect `ssl_mode` in this case and accept only SSL connections.
+     * Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.
      */
     sslMode?: string | null;
   }
@@ -1708,15 +1708,15 @@ export namespace sqladmin_v1beta4 {
     mysqlReplicaConfiguration?: Schema$MySqlReplicaConfiguration;
   }
   /**
-   * Primary-DR replica pair
+   * A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL.
    */
   export interface Schema$ReplicationCluster {
     /**
-     * Output only. read-only field that indicates if the replica is a dr_replica; not set for a primary.
+     * Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance.
      */
     drReplica?: boolean | null;
     /**
-     * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Users can set this field to set a designated DR replica for a primary. Removing this field removes the DR replica.
+     * Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation.
      */
     failoverDrReplicaName?: string | null;
   }
@@ -1994,7 +1994,7 @@ export namespace sqladmin_v1beta4 {
   export interface Schema$SqlInstancesResetReplicaSizeRequest {}
   export interface Schema$SqlInstancesStartExternalSyncRequest {
     /**
-     * Optional. MigrationType decides if the migration is a physical file based migration or logical migration.
+     * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
      */
     migrationType?: string | null;
     /**
@@ -2016,7 +2016,7 @@ export namespace sqladmin_v1beta4 {
   }
   export interface Schema$SqlInstancesVerifyExternalSyncSettingsRequest {
     /**
-     * Optional. MigrationType field decides if the migration is a physical file based migration or logical migration
+     * Optional. MigrationType configures the migration to use physical files or logical dump files. If not set, then the logical dump file configuration is used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
      */
     migrationType?: string | null;
     /**
@@ -2028,7 +2028,7 @@ export namespace sqladmin_v1beta4 {
      */
     syncMode?: string | null;
     /**
-     * Optional. Parallel level for initial data sync. Currently only applicable for PostgreSQL.
+     * Optional. Parallel level for initial data sync. Only applicable for PostgreSQL.
      */
     syncParallelLevel?: string | null;
     /**
@@ -5021,7 +5021,7 @@ export namespace sqladmin_v1beta4 {
     }
 
     /**
-     * Promotes the read replica instance to be a stand-alone Cloud SQL instance. Using this operation might cause your instance to restart.
+     * Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5822,7 +5822,7 @@ export namespace sqladmin_v1beta4 {
     }
 
     /**
-     * Switches over from the primary instance to a replica instance.
+     * Switches over from the primary instance to the designated DR replica instance.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6281,7 +6281,7 @@ export namespace sqladmin_v1beta4 {
   export interface Params$Resource$Instances$Promotereplica
     extends StandardParameters {
     /**
-     * Set to true if the promote operation should attempt to re-add the original primary as a replica when it comes back online. Otherwise, if this value is false or not set, the original primary will be a standalone instance.
+     * Set to true to invoke a replica failover to the designated 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. Only applicable to MySQL.
      */
     failover?: boolean;
     /**