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; */