From 23415ce49ac44aa961bed5af7a6dfec7daa55a3c Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Tue, 4 Jun 2024 16:04:43 -0700 Subject: [PATCH] feat: Support for CLUSTER_MAINTENANCE and SELF_SERVICE_MAINTENANCE operation types (#7363) feat: Support for MySQL 8.4 docs: Various updates and clarifications to the documentation PiperOrigin-RevId: 639967918 Source-Link: https://github.com/googleapis/googleapis/commit/b7bcc9b8b34d3ba85790ebd7a6b460e92d013b31 Source-Link: https://github.com/googleapis/googleapis-gen/commit/252397b269fd2b3051f56a2480b2423a520cd842 Copy-Tag: eyJwIjoiU3FsQWRtaW4vLk93bEJvdC55YW1sIiwiaCI6IjI1MjM5N2IyNjlmZDJiMzA1MWY1NmEyNDgwYjI0MjNhNTIwY2Q4NDIifQ== --- SqlAdmin/metadata/V1/CloudSqlResources.php | Bin 15132 -> 15203 bytes .../promote_replica.php | 3 +- .../SqlInstancesServiceClient/switchover.php | 3 +- SqlAdmin/src/V1/BackupConfiguration.php | 8 +-- .../TransactionalLogStorageState.php | 20 ++++--- .../V1/Client/SqlInstancesServiceClient.php | 6 ++- SqlAdmin/src/V1/DatabaseInstance.php | 36 +++++++------ SqlAdmin/src/V1/GeminiInstanceConfig.php | 50 +++++++++--------- SqlAdmin/src/V1/IpConfiguration.php | 48 ++++++++--------- SqlAdmin/src/V1/IpConfiguration/SslMode.php | 12 +++-- .../src/V1/Operation/SqlOperationType.php | 21 ++++++++ SqlAdmin/src/V1/ReplicationCluster.php | 45 ++++++++-------- SqlAdmin/src/V1/SqlDatabaseVersion.php | 7 +++ .../V1/SqlInstancesPromoteReplicaRequest.php | 40 +++++++++----- .../SqlInstancesStartExternalSyncRequest.php | 20 ++++--- ...ancesVerifyExternalSyncSettingsRequest.php | 36 +++++++------ .../MigrationType.php | 10 ++-- 17 files changed, 218 insertions(+), 147 deletions(-) diff --git a/SqlAdmin/metadata/V1/CloudSqlResources.php b/SqlAdmin/metadata/V1/CloudSqlResources.php index fd0a2267dd466a5c172870304d11f042e2bc1841..50aa6e3ff9004810005e05e52c8fc7ba91a866de 100644 GIT binary patch delta 123 zcmbPJ_PA`rB_@`m1zfrly>&M;GtZS`e6)F?tQa%n>&-h9%$UuE#JPl>eL{mnT!Z3$ z9XTvVoLvQUg=DxSf?a*w;)7j-!aSW_QDpTtzf;x|WSqTO)^sHkKOYyTZ)9+w RPrOCEi9jFo=A-7}%m8`nBoptional .google.cloud.sql.v1.BackupConfiguration.TransactionalLogStorageState transactional_log_storage_state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ @@ -109,7 +109,7 @@ class BackupConfiguration extends \Google\Protobuf\Internal\Message * restore, from 1-7. * @type int $transactional_log_storage_state * Output only. This value contains the storage location of transactional logs - * for the database for point-in-time recovery. + * used to perform point-in-time recovery (PITR) for the database. * } */ public function __construct($data = NULL) { @@ -558,7 +558,7 @@ public function setTransactionLogRetentionDaysValue($var) /** * Output only. This value contains the storage location of transactional logs - * for the database for point-in-time recovery. + * used to perform point-in-time recovery (PITR) for the database. * * Generated from protobuf field optional .google.cloud.sql.v1.BackupConfiguration.TransactionalLogStorageState transactional_log_storage_state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return int @@ -580,7 +580,7 @@ public function clearTransactionalLogStorageState() /** * Output only. This value contains the storage location of transactional logs - * for the database for point-in-time recovery. + * used to perform point-in-time recovery (PITR) for the database. * * Generated from protobuf field optional .google.cloud.sql.v1.BackupConfiguration.TransactionalLogStorageState transactional_log_storage_state = 10 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param int $var diff --git a/SqlAdmin/src/V1/BackupConfiguration/TransactionalLogStorageState.php b/SqlAdmin/src/V1/BackupConfiguration/TransactionalLogStorageState.php index 60e6472ee91a..a97dca030c97 100644 --- a/SqlAdmin/src/V1/BackupConfiguration/TransactionalLogStorageState.php +++ b/SqlAdmin/src/V1/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.v1.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/V1/Client/SqlInstancesServiceClient.php b/SqlAdmin/src/V1/Client/SqlInstancesServiceClient.php index 1b79b87cdfc9..f96067b17d86 100644 --- a/SqlAdmin/src/V1/Client/SqlInstancesServiceClient.php +++ b/SqlAdmin/src/V1/Client/SqlInstancesServiceClient.php @@ -733,7 +733,8 @@ public function performDiskShrink(SqlInstancesPerformDiskShrinkRequest $request, } /** - * 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. * * The async variant is {@see SqlInstancesServiceClient::promoteReplicaAsync()} . @@ -1051,7 +1052,8 @@ public function stopReplica(SqlInstancesStopReplicaRequest $request, array $call } /** - * Switches over from the primary instance to the replica instance. + * Switches over from the primary instance to the designated DR replica + * instance. * * The async variant is {@see SqlInstancesServiceClient::switchoverAsync()} . * diff --git a/SqlAdmin/src/V1/DatabaseInstance.php b/SqlAdmin/src/V1/DatabaseInstance.php index 667241e24161..050f2127f1fe 100644 --- a/SqlAdmin/src/V1/DatabaseInstance.php +++ b/SqlAdmin/src/V1/DatabaseInstance.php @@ -301,15 +301,16 @@ class DatabaseInstance extends \Google\Protobuf\Internal\Message */ private $write_endpoint = 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. * * Generated from protobuf field .google.cloud.sql.v1.ReplicationCluster replication_cluster = 54 [(.google.api.field_behavior) = OPTIONAL]; */ private $replication_cluster = null; /** - * Gemini configuration. + * Gemini instance configuration. * * Generated from protobuf field optional .google.cloud.sql.v1.GeminiInstanceConfig gemini_config = 55; */ @@ -440,11 +441,12 @@ 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\V1\ReplicationCluster $replication_cluster - * 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. * @type \Google\Cloud\Sql\V1\GeminiInstanceConfig $gemini_config - * Gemini configuration. + * Gemini instance configuration. * } */ public function __construct($data = NULL) { @@ -1886,9 +1888,10 @@ public function setWriteEndpoint($var) } /** - * 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. * * Generated from protobuf field .google.cloud.sql.v1.ReplicationCluster replication_cluster = 54 [(.google.api.field_behavior) = OPTIONAL]; * @return \Google\Cloud\Sql\V1\ReplicationCluster|null @@ -1909,9 +1912,10 @@ public function clearReplicationCluster() } /** - * 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. * * Generated from protobuf field .google.cloud.sql.v1.ReplicationCluster replication_cluster = 54 [(.google.api.field_behavior) = OPTIONAL]; * @param \Google\Cloud\Sql\V1\ReplicationCluster $var @@ -1926,7 +1930,7 @@ public function setReplicationCluster($var) } /** - * Gemini configuration. + * Gemini instance configuration. * * Generated from protobuf field optional .google.cloud.sql.v1.GeminiInstanceConfig gemini_config = 55; * @return \Google\Cloud\Sql\V1\GeminiInstanceConfig|null @@ -1947,7 +1951,7 @@ public function clearGeminiConfig() } /** - * Gemini configuration. + * Gemini instance configuration. * * Generated from protobuf field optional .google.cloud.sql.v1.GeminiInstanceConfig gemini_config = 55; * @param \Google\Cloud\Sql\V1\GeminiInstanceConfig $var diff --git a/SqlAdmin/src/V1/GeminiInstanceConfig.php b/SqlAdmin/src/V1/GeminiInstanceConfig.php index 7965703349ee..8f866b2377ab 100644 --- a/SqlAdmin/src/V1/GeminiInstanceConfig.php +++ b/SqlAdmin/src/V1/GeminiInstanceConfig.php @@ -9,44 +9,44 @@ use Google\Protobuf\Internal\GPBUtil; /** - * Gemini configuration. + * Gemini instance configuration. * * Generated from protobuf message google.cloud.sql.v1.GeminiInstanceConfig */ class GeminiInstanceConfig extends \Google\Protobuf\Internal\Message { /** - * Output only. Whether gemini is enabled. + * Output only. Whether Gemini is enabled. * * Generated from protobuf field optional bool entitled = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; */ 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]; */ @@ -59,17 +59,17 @@ class GeminiInstanceConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type bool $entitled - * Output only. Whether gemini is enabled. + * 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) { @@ -78,7 +78,7 @@ public function __construct($data = NULL) { } /** - * Output only. Whether gemini is enabled. + * Output only. Whether Gemini is enabled. * * Generated from protobuf field optional bool entitled = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return bool @@ -99,7 +99,7 @@ public function clearEntitled() } /** - * Output only. Whether gemini is enabled. + * Output only. Whether Gemini is enabled. * * Generated from protobuf field optional bool entitled = 1 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param bool $var @@ -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/V1/IpConfiguration.php b/SqlAdmin/src/V1/IpConfiguration.php index 3de6807f2421..c85421072b41 100644 --- a/SqlAdmin/src/V1/IpConfiguration.php +++ b/SqlAdmin/src/V1/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.v1.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\V1\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.v1.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.v1.IpConfiguration.SslMode ssl_mode = 8; * @param int $var diff --git a/SqlAdmin/src/V1/IpConfiguration/SslMode.php b/SqlAdmin/src/V1/IpConfiguration/SslMode.php index c2ab1a42f77b..d043949c13a5 100644 --- a/SqlAdmin/src/V1/IpConfiguration/SslMode.php +++ b/SqlAdmin/src/V1/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,6 +51,7 @@ class SslMode * [Cloud SQL * Connectors](https://cloud.google.com/sql/docs/postgres/connect-connectors) * to enforce client identity verification. + * 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/V1/Operation/SqlOperationType.php b/SqlAdmin/src/V1/Operation/SqlOperationType.php index c1a10393293b..a5952f8db3f4 100644 --- a/SqlAdmin/src/V1/Operation/SqlOperationType.php +++ b/SqlAdmin/src/V1/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/V1/ReplicationCluster.php b/SqlAdmin/src/V1/ReplicationCluster.php index d505dd43e6c9..a48327c2f49f 100644 --- a/SqlAdmin/src/V1/ReplicationCluster.php +++ b/SqlAdmin/src/V1/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 experiences regional failure. + * Only applicable to MySQL. * * Generated from protobuf message google.cloud.sql.v1.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 string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL]; */ private $failover_dr_replica_name = ''; /** - * 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 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 string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL]; * @return string @@ -77,9 +80,9 @@ public function getFailoverDrReplicaName() * 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 string failover_dr_replica_name = 2 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var @@ -94,8 +97,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 bool dr_replica = 4 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @return bool @@ -106,8 +109,8 @@ public function getDrReplica() } /** - * 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 bool dr_replica = 4 [(.google.api.field_behavior) = OUTPUT_ONLY]; * @param bool $var diff --git a/SqlAdmin/src/V1/SqlDatabaseVersion.php b/SqlAdmin/src/V1/SqlDatabaseVersion.php index 98b70d4298d9..43d42b800e11 100644 --- a/SqlAdmin/src/V1/SqlDatabaseVersion.php +++ b/SqlAdmin/src/V1/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/V1/SqlInstancesPromoteReplicaRequest.php b/SqlAdmin/src/V1/SqlInstancesPromoteReplicaRequest.php index b6fce696b5c8..9ae50161cfd1 100644 --- a/SqlAdmin/src/V1/SqlInstancesPromoteReplicaRequest.php +++ b/SqlAdmin/src/V1/SqlInstancesPromoteReplicaRequest.php @@ -28,9 +28,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; */ @@ -47,9 +51,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) { @@ -110,9 +118,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 @@ -123,9 +135,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/V1/SqlInstancesStartExternalSyncRequest.php b/SqlAdmin/src/V1/SqlInstancesStartExternalSyncRequest.php index 47a5d515ddd1..07c3e9efc3a4 100644 --- a/SqlAdmin/src/V1/SqlInstancesStartExternalSyncRequest.php +++ b/SqlAdmin/src/V1/SqlInstancesStartExternalSyncRequest.php @@ -47,8 +47,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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -75,8 +76,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) { @@ -248,8 +250,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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -260,8 +263,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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 8 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var diff --git a/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest.php b/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest.php index f376cd9abdf8..3fe2e3aad08a 100644 --- a/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest.php +++ b/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest.php @@ -46,15 +46,16 @@ class SqlInstancesVerifyExternalSyncSettingsRequest extends \Google\Protobuf\Int */ private $verify_replication_only = false; /** - * 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.v1.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.v1.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL]; */ @@ -80,11 +81,12 @@ class SqlInstancesVerifyExternalSyncSettingsRequest extends \Google\Protobuf\Int * @type \Google\Cloud\Sql\V1\MySqlSyncConfig $mysql_sync_config * Optional. MySQL-specific settings for start external sync. * @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. * @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) { @@ -254,8 +256,9 @@ public function setMysqlSyncConfig($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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 7 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -266,8 +269,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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType migration_type = 7 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var @@ -282,8 +286,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.v1.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL]; * @return int @@ -294,8 +298,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.v1.ExternalSyncParallelLevel sync_parallel_level = 8 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var diff --git a/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php b/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php index a73bae426519..0460f7304052 100644 --- a/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php +++ b/SqlAdmin/src/V1/SqlInstancesVerifyExternalSyncSettingsRequest/MigrationType.php @@ -7,27 +7,27 @@ use UnexpectedValueException; /** - * MigrationType 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.v1.SqlInstancesVerifyExternalSyncSettingsRequest.MigrationType */ class MigrationType { /** - * Default value is logical migration + * 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; */