diff --git a/SqlAdmin/metadata/V1Beta4/CloudSqlResources.php b/SqlAdmin/metadata/V1Beta4/CloudSqlResources.php
index bac030aa61ad..bc9bba0bcbea 100644
Binary files a/SqlAdmin/metadata/V1Beta4/CloudSqlResources.php and b/SqlAdmin/metadata/V1Beta4/CloudSqlResources.php differ
diff --git a/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/promote_replica.php b/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/promote_replica.php
index 222a100179bf..26cffb03eac2 100644
--- a/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/promote_replica.php
+++ b/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/promote_replica.php
@@ -28,7 +28,8 @@
use Google\Cloud\Sql\V1beta4\SqlInstancesServiceClient;
/**
- * Promotes the read replica instance to be a stand-alone Cloud SQL instance.
+ * Promotes the read replica instance to be an independent Cloud SQL
+ * primary instance.
* Using this operation might cause your instance to restart.
*
* This sample has been automatically generated and should be regarded as a code
diff --git a/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/switchover.php b/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/switchover.php
index 0a321b59cd95..31a51890b623 100644
--- a/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/switchover.php
+++ b/SqlAdmin/samples/V1beta4/SqlInstancesServiceClient/switchover.php
@@ -28,7 +28,8 @@
use Google\Cloud\Sql\V1beta4\SqlInstancesServiceClient;
/**
- * Switches over from the primary instance to a replica instance.
+ * Switches over from the primary instance to the designated DR replica
+ * instance.
*
* This sample has been automatically generated and should be regarded as a code
* template only. It will require modifications to work:
diff --git a/SqlAdmin/src/V1beta4/BackupConfiguration/TransactionalLogStorageState.php b/SqlAdmin/src/V1beta4/BackupConfiguration/TransactionalLogStorageState.php
index 9b18b6a7219a..8c7c49af2bda 100644
--- a/SqlAdmin/src/V1beta4/BackupConfiguration/TransactionalLogStorageState.php
+++ b/SqlAdmin/src/V1beta4/BackupConfiguration/TransactionalLogStorageState.php
@@ -7,8 +7,8 @@
use UnexpectedValueException;
/**
- * This value contains the storage location of transactional logs for the
- * database for point-in-time recovery.
+ * This value contains the storage location of the transactional logs
+ * used to perform point-in-time recovery (PITR) for the database.
*
* Protobuf type google.cloud.sql.v1beta4.BackupConfiguration.TransactionalLogStorageState
*/
@@ -21,27 +21,31 @@ class TransactionalLogStorageState
*/
const TRANSACTIONAL_LOG_STORAGE_STATE_UNSPECIFIED = 0;
/**
- * The transaction logs for the instance are stored on a data disk.
+ * The transaction logs used for PITR for the instance are stored
+ * on a data disk.
*
* Generated from protobuf enum DISK = 1;
*/
const DISK = 1;
/**
- * The transaction logs for the instance are switching from being stored on
- * a data disk to being stored in Cloud Storage.
+ * The transaction logs used for PITR for the instance are switching from
+ * being stored on a data disk to being stored in Cloud Storage.
+ * Only applicable to MySQL.
*
* Generated from protobuf enum SWITCHING_TO_CLOUD_STORAGE = 2;
*/
const SWITCHING_TO_CLOUD_STORAGE = 2;
/**
- * The transaction logs for the instance are now stored in Cloud Storage.
- * Previously, they were stored on a data disk.
+ * The transaction logs used for PITR for the instance are now stored
+ * in Cloud Storage. Previously, they were stored on a data disk.
+ * Only applicable to MySQL.
*
* Generated from protobuf enum SWITCHED_TO_CLOUD_STORAGE = 3;
*/
const SWITCHED_TO_CLOUD_STORAGE = 3;
/**
- * The transaction logs for the instance are stored in Cloud Storage.
+ * The transaction logs used for PITR for the instance are stored in
+ * Cloud Storage. Only applicable to MySQL and PostgreSQL.
*
* Generated from protobuf enum CLOUD_STORAGE = 4;
*/
diff --git a/SqlAdmin/src/V1beta4/DatabaseInstance.php b/SqlAdmin/src/V1beta4/DatabaseInstance.php
index 8efed83d3db3..b6a470e9bf0a 100644
--- a/SqlAdmin/src/V1beta4/DatabaseInstance.php
+++ b/SqlAdmin/src/V1beta4/DatabaseInstance.php
@@ -303,10 +303,10 @@ class DatabaseInstance extends \Google\Protobuf\Internal\Message
*/
private $write_endpoint = null;
/**
- * The pair of a primary instance and disaster recovery (DR) replica.
+ * 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.
+ * experiences regional failure. Only applicable to MySQL.
*
* Generated from protobuf field optional .google.cloud.sql.v1beta4.ReplicationCluster replication_cluster = 54;
*/
@@ -444,10 +444,10 @@ class DatabaseInstance extends \Google\Protobuf\Internal\Message
* @type string $write_endpoint
* Output only. The dns name of the primary instance in a replication group.
* @type \Google\Cloud\Sql\V1beta4\ReplicationCluster $replication_cluster
- * The pair of a primary instance and disaster recovery (DR) replica.
+ * 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.
+ * experiences regional failure. Only applicable to MySQL.
* @type \Google\Cloud\Sql\V1beta4\GeminiInstanceConfig $gemini_config
* Gemini instance configuration.
* }
@@ -1895,10 +1895,10 @@ public function setWriteEndpoint($var)
}
/**
- * The pair of a primary instance and disaster recovery (DR) replica.
+ * 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.
+ * experiences regional failure. Only applicable to MySQL.
*
* Generated from protobuf field optional .google.cloud.sql.v1beta4.ReplicationCluster replication_cluster = 54;
* @return \Google\Cloud\Sql\V1beta4\ReplicationCluster|null
@@ -1919,10 +1919,10 @@ public function clearReplicationCluster()
}
/**
- * The pair of a primary instance and disaster recovery (DR) replica.
+ * 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.
+ * experiences regional failure. Only applicable to MySQL.
*
* Generated from protobuf field optional .google.cloud.sql.v1beta4.ReplicationCluster replication_cluster = 54;
* @param \Google\Cloud\Sql\V1beta4\ReplicationCluster $var
diff --git a/SqlAdmin/src/V1beta4/Gapic/SqlInstancesServiceGapicClient.php b/SqlAdmin/src/V1beta4/Gapic/SqlInstancesServiceGapicClient.php
index d08d06b5136b..1539f631b1ea 100644
--- a/SqlAdmin/src/V1beta4/Gapic/SqlInstancesServiceGapicClient.php
+++ b/SqlAdmin/src/V1beta4/Gapic/SqlInstancesServiceGapicClient.php
@@ -1412,7 +1412,8 @@ public function performDiskShrink(array $optionalArgs = [])
}
/**
- * Promotes the read replica instance to be a stand-alone Cloud SQL instance.
+ * Promotes the read replica instance to be an independent Cloud SQL
+ * primary instance.
* Using this operation might cause your instance to restart.
*
* Sample code:
@@ -1433,9 +1434,13 @@ public function performDiskShrink(array $optionalArgs = [])
* @type string $project
* ID of the project that contains the read replica.
* @type bool $failover
- * 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.
* @type RetrySettings|array $retrySettings
* Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
* associative array of retry settings parameters. See the documentation on
@@ -2017,8 +2022,9 @@ public function rotateServerCa(array $optionalArgs = [])
* for MySQL.
* For allowed values, use constants defined on {@see \Google\Cloud\Sql\V1beta4\ExternalSyncParallelLevel}
* @type int $migrationType
- * 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.
* For allowed values, use constants defined on {@see \Google\Cloud\Sql\V1beta4\SqlInstancesVerifyExternalSyncSettingsRequest\MigrationType}
* @type RetrySettings|array $retrySettings
* Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
@@ -2201,7 +2207,8 @@ public function stopReplica(array $optionalArgs = [])
}
/**
- * Switches over from the primary instance to a replica instance.
+ * Switches over from the primary instance to the designated DR replica
+ * instance.
*
* Sample code:
* ```
@@ -2430,12 +2437,13 @@ public function update(array $optionalArgs = [])
* @type MySqlSyncConfig $mysqlSyncConfig
* Optional. MySQL-specific settings for start external sync.
* @type int $migrationType
- * 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.
* For allowed values, use constants defined on {@see \Google\Cloud\Sql\V1beta4\SqlInstancesVerifyExternalSyncSettingsRequest\MigrationType}
* @type int $syncParallelLevel
- * Optional. Parallel level for initial data sync. Currently only applicable
- * for PostgreSQL.
+ * Optional. Parallel level for initial data sync. Only applicable for
+ * PostgreSQL.
* For allowed values, use constants defined on {@see \Google\Cloud\Sql\V1beta4\ExternalSyncParallelLevel}
* @type RetrySettings|array $retrySettings
* Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
diff --git a/SqlAdmin/src/V1beta4/GeminiInstanceConfig.php b/SqlAdmin/src/V1beta4/GeminiInstanceConfig.php
index 0ce6fcd8316c..1f3613fa25be 100644
--- a/SqlAdmin/src/V1beta4/GeminiInstanceConfig.php
+++ b/SqlAdmin/src/V1beta4/GeminiInstanceConfig.php
@@ -9,7 +9,7 @@
use Google\Protobuf\Internal\GPBUtil;
/**
- * Gemini configuration.
+ * Gemini instance configuration.
*
* Generated from protobuf message google.cloud.sql.v1beta4.GeminiInstanceConfig
*/
@@ -22,31 +22,31 @@ class GeminiInstanceConfig extends \Google\Protobuf\Internal\Message
*/
private $entitled = null;
/**
- * Output only. Whether vacuum management is enabled.
+ * Output only. Whether the vacuum management is enabled.
*
* Generated from protobuf field optional bool google_vacuum_mgmt_enabled = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
private $google_vacuum_mgmt_enabled = null;
/**
- * Output only. Whether oom session cancel is enabled.
+ * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
*
* Generated from protobuf field optional bool oom_session_cancel_enabled = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
private $oom_session_cancel_enabled = null;
/**
- * Output only. Whether active query is enabled.
+ * Output only. Whether the active query is enabled.
*
* Generated from protobuf field optional bool active_query_enabled = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
private $active_query_enabled = null;
/**
- * Output only. Whether index advisor is enabled.
+ * Output only. Whether the index advisor is enabled.
*
* Generated from protobuf field optional bool index_advisor_enabled = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
private $index_advisor_enabled = null;
/**
- * Output only. Whether flag recommender is enabled.
+ * Output only. Whether the flag recommender is enabled.
*
* Generated from protobuf field optional bool flag_recommender_enabled = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
@@ -61,15 +61,15 @@ class GeminiInstanceConfig extends \Google\Protobuf\Internal\Message
* @type bool $entitled
* Output only. Whether Gemini is enabled.
* @type bool $google_vacuum_mgmt_enabled
- * Output only. Whether vacuum management is enabled.
+ * Output only. Whether the vacuum management is enabled.
* @type bool $oom_session_cancel_enabled
- * Output only. Whether oom session cancel is enabled.
+ * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
* @type bool $active_query_enabled
- * Output only. Whether active query is enabled.
+ * Output only. Whether the active query is enabled.
* @type bool $index_advisor_enabled
- * Output only. Whether index advisor is enabled.
+ * Output only. Whether the index advisor is enabled.
* @type bool $flag_recommender_enabled
- * Output only. Whether flag recommender is enabled.
+ * Output only. Whether the flag recommender is enabled.
* }
*/
public function __construct($data = NULL) {
@@ -114,7 +114,7 @@ public function setEntitled($var)
}
/**
- * Output only. Whether vacuum management is enabled.
+ * Output only. Whether the vacuum management is enabled.
*
* Generated from protobuf field optional bool google_vacuum_mgmt_enabled = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -135,7 +135,7 @@ public function clearGoogleVacuumMgmtEnabled()
}
/**
- * Output only. Whether vacuum management is enabled.
+ * Output only. Whether the vacuum management is enabled.
*
* Generated from protobuf field optional bool google_vacuum_mgmt_enabled = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
@@ -150,7 +150,7 @@ public function setGoogleVacuumMgmtEnabled($var)
}
/**
- * Output only. Whether oom session cancel is enabled.
+ * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
*
* Generated from protobuf field optional bool oom_session_cancel_enabled = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -171,7 +171,7 @@ public function clearOomSessionCancelEnabled()
}
/**
- * Output only. Whether oom session cancel is enabled.
+ * Output only. Whether canceling the out-of-memory (OOM) session is enabled.
*
* Generated from protobuf field optional bool oom_session_cancel_enabled = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
@@ -186,7 +186,7 @@ public function setOomSessionCancelEnabled($var)
}
/**
- * Output only. Whether active query is enabled.
+ * Output only. Whether the active query is enabled.
*
* Generated from protobuf field optional bool active_query_enabled = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -207,7 +207,7 @@ public function clearActiveQueryEnabled()
}
/**
- * Output only. Whether active query is enabled.
+ * Output only. Whether the active query is enabled.
*
* Generated from protobuf field optional bool active_query_enabled = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
@@ -222,7 +222,7 @@ public function setActiveQueryEnabled($var)
}
/**
- * Output only. Whether index advisor is enabled.
+ * Output only. Whether the index advisor is enabled.
*
* Generated from protobuf field optional bool index_advisor_enabled = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -243,7 +243,7 @@ public function clearIndexAdvisorEnabled()
}
/**
- * Output only. Whether index advisor is enabled.
+ * Output only. Whether the index advisor is enabled.
*
* Generated from protobuf field optional bool index_advisor_enabled = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
@@ -258,7 +258,7 @@ public function setIndexAdvisorEnabled($var)
}
/**
- * Output only. Whether flag recommender is enabled.
+ * Output only. Whether the flag recommender is enabled.
*
* Generated from protobuf field optional bool flag_recommender_enabled = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -279,7 +279,7 @@ public function clearFlagRecommenderEnabled()
}
/**
- * Output only. Whether flag recommender is enabled.
+ * Output only. Whether the flag recommender is enabled.
*
* Generated from protobuf field optional bool flag_recommender_enabled = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
diff --git a/SqlAdmin/src/V1beta4/IpConfiguration.php b/SqlAdmin/src/V1beta4/IpConfiguration.php
index 6f570c16aafd..fb332bdc43e6 100644
--- a/SqlAdmin/src/V1beta4/IpConfiguration.php
+++ b/SqlAdmin/src/V1beta4/IpConfiguration.php
@@ -80,12 +80,12 @@ class IpConfiguration extends \Google\Protobuf\Internal\Message
* 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.
+ * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.IpConfiguration.SslMode ssl_mode = 8;
*/
@@ -144,12 +144,12 @@ class IpConfiguration extends \Google\Protobuf\Internal\Message
* 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.
+ * 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.
* @type \Google\Cloud\Sql\V1beta4\PscConfig $psc_config
* PSC settings for this instance.
* }
@@ -489,12 +489,12 @@ public function setEnablePrivatePathForGoogleCloudServicesValue($var)
* 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.
+ * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.IpConfiguration.SslMode ssl_mode = 8;
* @return int
@@ -515,12 +515,12 @@ public function getSslMode()
* 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.
+ * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.IpConfiguration.SslMode ssl_mode = 8;
* @param int $var
diff --git a/SqlAdmin/src/V1beta4/IpConfiguration/SslMode.php b/SqlAdmin/src/V1beta4/IpConfiguration/SslMode.php
index d9ba3359399b..200afdff2f71 100644
--- a/SqlAdmin/src/V1beta4/IpConfiguration/SslMode.php
+++ b/SqlAdmin/src/V1beta4/IpConfiguration/SslMode.php
@@ -20,18 +20,21 @@ class SslMode
*/
const SSL_MODE_UNSPECIFIED = 0;
/**
- * Allow non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections,
- * the client certificate won't be verified.
+ * Allow non-SSL/non-TLS and SSL/TLS connections.
+ * For SSL connections to MySQL and PostgreSQL, the client certificate
+ * isn't verified.
* When this value is used, the legacy `require_ssl` flag must be false or
- * cleared to avoid the conflict between values of two flags.
+ * cleared to avoid a conflict between the values of the two flags.
*
* Generated from protobuf enum ALLOW_UNENCRYPTED_AND_ENCRYPTED = 1;
*/
const ALLOW_UNENCRYPTED_AND_ENCRYPTED = 1;
/**
* Only allow connections encrypted with SSL/TLS.
+ * For SSL connections to MySQL and PostgreSQL, the client certificate
+ * isn't verified.
* When this value is used, the legacy `require_ssl` flag must be false or
- * cleared to avoid the conflict between values of two flags.
+ * cleared to avoid a conflict between the values of the two flags.
*
* Generated from protobuf enum ENCRYPTED_ONLY = 2;
*/
@@ -48,7 +51,7 @@ class SslMode
* [Cloud SQL
* Connectors](https://cloud.google.com/sql/docs/postgres/connect-connectors)
* to enforce client identity verification.
- * This value is not applicable to SQL Server.
+ * Only applicable to MySQL and PostgreSQL. Not applicable to SQL Server.
*
* Generated from protobuf enum TRUSTED_CLIENT_CERTIFICATE_REQUIRED = 3;
*/
diff --git a/SqlAdmin/src/V1beta4/Operation/SqlOperationType.php b/SqlAdmin/src/V1beta4/Operation/SqlOperationType.php
index 95a74ec14960..f7ec185bd9d8 100644
--- a/SqlAdmin/src/V1beta4/Operation/SqlOperationType.php
+++ b/SqlAdmin/src/V1beta4/Operation/SqlOperationType.php
@@ -266,6 +266,25 @@ class SqlOperationType
* Generated from protobuf enum RECONFIGURE_OLD_PRIMARY = 44;
*/
const RECONFIGURE_OLD_PRIMARY = 44;
+ /**
+ * Indicates that the instance, its read replicas, and its cascading
+ * replicas are in maintenance. Maintenance typically gets initiated on
+ * groups of replicas first, followed by the primary instance. For each
+ * instance, maintenance typically causes the instance to be unavailable for
+ * 1-3 minutes.
+ *
+ * Generated from protobuf enum CLUSTER_MAINTENANCE = 45;
+ */
+ const CLUSTER_MAINTENANCE = 45;
+ /**
+ * Indicates that the instance (and any of its replicas) are currently in
+ * maintenance. This is initiated as a self-service request by using SSM.
+ * Maintenance typically causes the instance to be unavailable for 1-3
+ * minutes.
+ *
+ * Generated from protobuf enum SELF_SERVICE_MAINTENANCE = 46;
+ */
+ const SELF_SERVICE_MAINTENANCE = 46;
private static $valueToName = [
self::SQL_OPERATION_TYPE_UNSPECIFIED => 'SQL_OPERATION_TYPE_UNSPECIFIED',
@@ -310,6 +329,8 @@ class SqlOperationType
self::ACQUIRE_SSRS_LEASE => 'ACQUIRE_SSRS_LEASE',
self::RELEASE_SSRS_LEASE => 'RELEASE_SSRS_LEASE',
self::RECONFIGURE_OLD_PRIMARY => 'RECONFIGURE_OLD_PRIMARY',
+ self::CLUSTER_MAINTENANCE => 'CLUSTER_MAINTENANCE',
+ self::SELF_SERVICE_MAINTENANCE => 'SELF_SERVICE_MAINTENANCE',
];
public static function name($value)
diff --git a/SqlAdmin/src/V1beta4/ReplicationCluster.php b/SqlAdmin/src/V1beta4/ReplicationCluster.php
index 3cfb5ceed15b..58afedbfc485 100644
--- a/SqlAdmin/src/V1beta4/ReplicationCluster.php
+++ b/SqlAdmin/src/V1beta4/ReplicationCluster.php
@@ -9,7 +9,10 @@
use Google\Protobuf\Internal\GPBUtil;
/**
- * 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.
*
* Generated from protobuf message google.cloud.sql.v1beta4.ReplicationCluster
*/
@@ -19,16 +22,16 @@ class ReplicationCluster extends \Google\Protobuf\Internal\Message
* 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.
+ * 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.
*
* Generated from protobuf field optional string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL];
*/
private $failover_dr_replica_name = null;
/**
- * 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.
*
* Generated from protobuf field optional bool dr_replica = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
*/
@@ -44,12 +47,12 @@ class ReplicationCluster extends \Google\Protobuf\Internal\Message
* 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.
+ * 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.
* @type bool $dr_replica
- * 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.
* }
*/
public function __construct($data = NULL) {
@@ -61,9 +64,9 @@ public function __construct($data = 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.
+ * 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.
*
* Generated from protobuf field optional string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL];
* @return string
@@ -87,9 +90,9 @@ public function clearFailoverDrReplicaName()
* 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.
+ * 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.
*
* Generated from protobuf field optional string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL];
* @param string $var
@@ -104,8 +107,8 @@ public function setFailoverDrReplicaName($var)
}
/**
- * 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.
*
* Generated from protobuf field optional bool dr_replica = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @return bool
@@ -126,8 +129,8 @@ public function clearDrReplica()
}
/**
- * 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.
*
* Generated from protobuf field optional bool dr_replica = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
* @param bool $var
diff --git a/SqlAdmin/src/V1beta4/SqlDatabaseVersion.php b/SqlAdmin/src/V1beta4/SqlDatabaseVersion.php
index a5072e10aa56..c74106a9a36f 100644
--- a/SqlAdmin/src/V1beta4/SqlDatabaseVersion.php
+++ b/SqlAdmin/src/V1beta4/SqlDatabaseVersion.php
@@ -211,6 +211,12 @@ class SqlDatabaseVersion
* Generated from protobuf enum MYSQL_8_0_40 = 358;
*/
const MYSQL_8_0_40 = 358;
+ /**
+ * The database version is MySQL 8.4.
+ *
+ * Generated from protobuf enum MYSQL_8_4 = 398;
+ */
+ const MYSQL_8_4 = 398;
/**
* The database version is SQL Server 2019 Standard.
*
@@ -294,6 +300,7 @@ class SqlDatabaseVersion
self::MYSQL_8_0_38 => 'MYSQL_8_0_38',
self::MYSQL_8_0_39 => 'MYSQL_8_0_39',
self::MYSQL_8_0_40 => 'MYSQL_8_0_40',
+ self::MYSQL_8_4 => 'MYSQL_8_4',
self::SQLSERVER_2019_STANDARD => 'SQLSERVER_2019_STANDARD',
self::SQLSERVER_2019_ENTERPRISE => 'SQLSERVER_2019_ENTERPRISE',
self::SQLSERVER_2019_EXPRESS => 'SQLSERVER_2019_EXPRESS',
diff --git a/SqlAdmin/src/V1beta4/SqlInstancesPromoteReplicaRequest.php b/SqlAdmin/src/V1beta4/SqlInstancesPromoteReplicaRequest.php
index 693c63b8607b..5facf1562a80 100644
--- a/SqlAdmin/src/V1beta4/SqlInstancesPromoteReplicaRequest.php
+++ b/SqlAdmin/src/V1beta4/SqlInstancesPromoteReplicaRequest.php
@@ -26,9 +26,13 @@ class SqlInstancesPromoteReplicaRequest extends \Google\Protobuf\Internal\Messag
*/
private $project = '';
/**
- * 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.
*
* Generated from protobuf field bool failover = 3;
*/
@@ -45,9 +49,13 @@ class SqlInstancesPromoteReplicaRequest extends \Google\Protobuf\Internal\Messag
* @type string $project
* ID of the project that contains the read replica.
* @type bool $failover
- * 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.
* }
*/
public function __construct($data = NULL) {
@@ -108,9 +116,13 @@ public function setProject($var)
}
/**
- * 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.
*
* Generated from protobuf field bool failover = 3;
* @return bool
@@ -121,9 +133,13 @@ public function getFailover()
}
/**
- * 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.
*
* Generated from protobuf field bool failover = 3;
* @param bool $var
diff --git a/SqlAdmin/src/V1beta4/SqlInstancesStartExternalSyncRequest.php b/SqlAdmin/src/V1beta4/SqlInstancesStartExternalSyncRequest.php
index f9ad0d745410..5275f84592a2 100644
--- a/SqlAdmin/src/V1beta4/SqlInstancesStartExternalSyncRequest.php
+++ b/SqlAdmin/src/V1beta4/SqlInstancesStartExternalSyncRequest.php
@@ -45,8 +45,9 @@ class SqlInstancesStartExternalSyncRequest extends \Google\Protobuf\Internal\Mes
*/
private $sync_parallel_level = 0;
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL];
*/
@@ -73,8 +74,9 @@ class SqlInstancesStartExternalSyncRequest extends \Google\Protobuf\Internal\Mes
* Optional. Parallel level for initial data sync. Currently only applicable
* for MySQL.
* @type int $migration_type
- * 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.
* }
*/
public function __construct($data = NULL) {
@@ -246,8 +248,9 @@ public function setSyncParallelLevel($var)
}
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL];
* @return int
@@ -258,8 +261,9 @@ public function getMigrationType()
}
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL];
* @param int $var
diff --git a/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest.php b/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest.php
index b0e70355a21d..12b6a8209e1e 100644
--- a/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest.php
+++ b/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest.php
@@ -44,15 +44,16 @@ class SqlInstancesVerifyExternalSyncSettingsRequest extends \Google\Protobuf\Int
*/
private $verify_replication_only = false;
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 7 [(.google.api.field_behavior) = OPTIONAL];
*/
private $migration_type = 0;
/**
- * Optional. Parallel level for initial data sync. Currently only applicable
- * for PostgreSQL.
+ * Optional. Parallel level for initial data sync. Only applicable for
+ * PostgreSQL.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL];
*/
@@ -78,11 +79,12 @@ class SqlInstancesVerifyExternalSyncSettingsRequest extends \Google\Protobuf\Int
* @type \Google\Cloud\Sql\V1beta4\MySqlSyncConfig $mysql_sync_config
* Optional. MySQL-specific settings for start external sync.
* @type int $migration_type
- * 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.
* @type int $sync_parallel_level
- * Optional. Parallel level for initial data sync. Currently only applicable
- * for PostgreSQL.
+ * Optional. Parallel level for initial data sync. Only applicable for
+ * PostgreSQL.
* }
*/
public function __construct($data = NULL) {
@@ -252,8 +254,9 @@ public function setMysqlSyncConfig($var)
}
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 7 [(.google.api.field_behavior) = OPTIONAL];
* @return int
@@ -264,8 +267,9 @@ public function getMigrationType()
}
/**
- * 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.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 7 [(.google.api.field_behavior) = OPTIONAL];
* @param int $var
@@ -280,8 +284,8 @@ public function setMigrationType($var)
}
/**
- * Optional. Parallel level for initial data sync. Currently only applicable
- * for PostgreSQL.
+ * Optional. Parallel level for initial data sync. Only applicable for
+ * PostgreSQL.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL];
* @return int
@@ -292,8 +296,8 @@ public function getSyncParallelLevel()
}
/**
- * Optional. Parallel level for initial data sync. Currently only applicable
- * for PostgreSQL.
+ * Optional. Parallel level for initial data sync. Only applicable for
+ * PostgreSQL.
*
* Generated from protobuf field .google.cloud.sql.v1beta4.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL];
* @param int $var
diff --git a/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php b/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php
index 02e6833a98f2..49218ddea1fc 100644
--- a/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php
+++ b/SqlAdmin/src/V1beta4/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php
@@ -7,27 +7,27 @@
use UnexpectedValueException;
/**
- * MigrationType enum decides if the migration is a physical file based
- * migration or logical migration
+ * MigrationType determines whether the migration is a physical file-based
+ * migration or a logical dump file-based migration.
*
* Protobuf type google.cloud.sql.v1beta4.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType
*/
class MigrationType
{
/**
- * If no migration type is specified it will be defaulted to LOGICAL.
+ * Default value is a logical dump file-based migration
*
* Generated from protobuf enum MIGRATION_TYPE_UNSPECIFIED = 0;
*/
const MIGRATION_TYPE_UNSPECIFIED = 0;
/**
- * Logical Migrations
+ * Logical dump file-based migration
*
* Generated from protobuf enum LOGICAL = 1;
*/
const LOGICAL = 1;
/**
- * Physical file based Migrations
+ * Physical file-based migration
*
* Generated from protobuf enum PHYSICAL = 2;
*/