RubyGems - google-apis-sqladmin_v1beta4 - Versions diffs - 0.14.0 → 0.18.0 - Mend

google-apis-sqladmin_v1beta4 0.14.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +16 -0
data/lib/google/apis/sqladmin_v1beta4/classes.rb +474 -187
data/lib/google/apis/sqladmin_v1beta4/gem_version.rb +2 -2
data/lib/google/apis/sqladmin_v1beta4/representations.rb +107 -0
data/lib/google/apis/sqladmin_v1beta4/service.rb +14 -18
data/lib/google/apis/sqladmin_v1beta4.rb +1 -1
metadata +3 -3

data/lib/google/apis/sqladmin_v1beta4/classes.rb CHANGED Viewed

@@ -26,13 +26,13 @@ module Google
       class AclEntry
         include Google::Apis::Core::Hashable
-        # The time when this access control entry expires in RFC 3339 format, for
-        # example *2012-11-15T16:19:00.094Z*.
+        # The time when this access control entry expires in [RFC 3339](https://tools.
+        # ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
-        # This is always *sql#aclEntry*.
+        # This is always **sql#aclEntry**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -114,7 +114,7 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
-        # This is always *sql#backupConfiguration*.
+        # This is always **sql#backupConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -137,7 +137,7 @@ module Google
         alias_method :replication_log_archiving_enabled?, :replication_log_archiving_enabled
         # Start time for the daily backup configuration in UTC timezone in the 24 hour
-        # format - *HH:MM*.
+        # format - **HH:MM**.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -175,7 +175,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :backup_id
-        # This is always *sql#backupContext*.
+        # This is always **sql#backupContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -243,14 +243,14 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::DiskEncryptionStatus]
         attr_accessor :disk_encryption_status
-        # The time the backup operation completed in UTC timezone in RFC 3339 format,
-        # for example *2012-11-15T16:19:00.094Z*.
+        # The time the backup operation completed in UTC timezone in [RFC 3339](https://
+        # tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
-        # The time the run was enqueued in UTC timezone in RFC 3339 format, for example *
-        # 2012-11-15T16:19:00.094Z*.
+        # The time the run was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.
+        # org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `enqueuedTime`
         # @return [String]
         attr_accessor :enqueued_time
@@ -271,7 +271,7 @@ module Google
         # @return [String]
         attr_accessor :instance
-        # This is always *sql#backupRun*.
+        # This is always **sql#backupRun**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -286,8 +286,9 @@ module Google
         # @return [String]
         attr_accessor :self_link
-        # The time the backup operation actually started in UTC timezone in RFC 3339
-        # format, for example *2012-11-15T16:19:00.094Z*.
+        # The time the backup operation actually started in UTC timezone in [RFC 3339](
+        # https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.
+        # 094Z**.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -304,7 +305,8 @@ module Google
         attr_accessor :type
         # The start time of the backup window during which this the backup was attempted
-        # in RFC 3339 format, for example *2012-11-15T16:19:00.094Z*.
+        # in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-
+        # 11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `windowStartTime`
         # @return [String]
         attr_accessor :window_start_time
@@ -343,7 +345,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::BackupRun>]
         attr_accessor :items
-        # This is always *sql#backupRunsList*.
+        # This is always **sql#backupRunsList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -380,7 +382,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :bin_log_position
-        # This is always *sql#binLogCoordinates*.
+        # This is always **sql#binLogCoordinates**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -411,7 +413,7 @@ module Google
         # @return [String]
         attr_accessor :destination_instance_name
-        # This is always *sql#cloneContext*.
+        # This is always **sql#cloneContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -472,6 +474,12 @@ module Google
         # @return [String]
         attr_accessor :kind
+        # The cloud region for the instance. e.g. **us-central1**, **europe-west1**. The
+        # region cannot be changed after instance creation.
+        # Corresponds to the JSON property `region`
+        # @return [String]
+        attr_accessor :region
         # SslCerts Resource
         # Corresponds to the JSON property `serverCaCert`
         # @return [Google::Apis::SqladminV1beta4::SslCert]
@@ -487,6 +495,7 @@ module Google
           @database_version = args[:database_version] if args.key?(:database_version)
           @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
           @kind = args[:kind] if args.key?(:kind)
+          @region = args[:region] if args.key?(:region)
           @server_ca_cert = args[:server_ca_cert] if args.key?(:server_ca_cert)
         end
       end
@@ -515,7 +524,7 @@ module Google
         # @return [String]
         attr_accessor :instance
-        # This is always *sql#database*.
+        # This is always **sql#database**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -566,14 +575,14 @@ module Google
         # The name of the flag. These flags are passed at instance startup, so include
         # both server options and system variables. Flags are specified with underscores,
-        # not hyphens. For more information, see Configuring Database Flags in the
-        # Cloud SQL documentation.
+        # not hyphens. For more information, see [Configuring Database Flags](https://
+        # cloud.google.com/sql/docs/mysql/flags) in the Cloud SQL documentation.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # The value of the flag. Booleans are set to *on* for true and *off* for false.
-        # This field must be omitted if the flag doesn't take a value.
+        # The value of the flag. Booleans are set to **on** for true and **off** for
+        # false. This field must be omitted if the flag doesn't take a value.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -593,9 +602,10 @@ module Google
       class DatabaseInstance
         include Google::Apis::Core::Hashable
-        # *SECOND_GEN*: Cloud SQL database instance. *EXTERNAL*: A database server that
-        # is not managed by Google. This property is read-only; use the *tier* property
-        # in the *settings* object to determine the database type.
+        # The backend type. **SECOND_GEN**: Cloud SQL database instance. **EXTERNAL**: A
+        # database server that is not managed by Google. This property is read-only; use
+        # the **tier** property in the **settings** object to determine the database
+        # type.
         # Corresponds to the JSON property `backendType`
         # @return [String]
         attr_accessor :backend_type
@@ -605,20 +615,28 @@ module Google
         # @return [String]
         attr_accessor :connection_name
+        # Output only. The time when the instance was created in [RFC 3339](https://
+        # tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
         # The current disk usage of the instance in bytes. This property has been
         # deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric
-        # in Cloud Monitoring API instead. Please see this announcement for details.
+        # in Cloud Monitoring API instead. Please see [this announcement](https://groups.
+        # google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for
+        # details.
         # Corresponds to the JSON property `currentDiskSize`
         # @return [Fixnum]
         attr_accessor :current_disk_size
-        # The database engine type and version. The *databaseVersion* field cannot be
-        # changed after instance creation. MySQL instances: *MYSQL_8_0*, *MYSQL_5_7* (
-        # default), or *MYSQL_5_6*. PostgreSQL instances: *POSTGRES_9_6*, *POSTGRES_10*,
-        # *POSTGRES_11*, *POSTGRES_12*, *POSTGRES_13* (default). SQL Server instances: *
-        # SQLSERVER_2019_STANDARD*, *SQLSERVER_2019_ENTERPRISE*, *SQLSERVER_2019_EXPRESS*
-        # , or *SQLSERVER_2019_WEB*, *SQLSERVER_2017_STANDARD* (default), *
-        # SQLSERVER_2017_ENTERPRISE*, *SQLSERVER_2017_EXPRESS*, or *SQLSERVER_2017_WEB*.
+        # The database engine type and version. The **databaseVersion** field cannot be
+        # changed after instance creation. * **MySQL instances**: MYSQL_8_0, MYSQL_5_7 (
+        # default), or MYSQL_5_6. * **PostgreSQL instances**: POSTGRES_9_6, POSTGRES_10,
+        # POSTGRES_11, POSTGRES_12, POSTGRES_13 (default). * **SQL Server instances**:
+        # SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2019_EXPRESS, or
+        # SQLSERVER_2019_WEB, SQLSERVER_2017_STANDARD (default),
+        # SQLSERVER_2017_ENTERPRISE, SQLSERVER_2017_EXPRESS, or SQLSERVER_2017_WEB.
         # Corresponds to the JSON property `databaseVersion`
         # @return [String]
         attr_accessor :database_version
@@ -634,7 +652,7 @@ module Google
         attr_accessor :disk_encryption_status
         # This field is deprecated and will be removed from a future version of the API.
-        # Use the *settings.settingsVersion* field instead.
+        # Use the **settings.settingsVersion** field instead.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -651,10 +669,10 @@ module Google
         # @return [String]
         attr_accessor :gce_zone
-        # The instance type. This can be one of the following. *CLOUD_SQL_INSTANCE*: A
-        # Cloud SQL instance that is not replicating from a primary instance. *
-        # ON_PREMISES_INSTANCE*: An instance running on the customer's premises. *
-        # READ_REPLICA_INSTANCE*: A Cloud SQL instance configured as a read-replica.
+        # The instance type. This can be one of the following: * **CLOUD_SQL_INSTANCE**:
+        # A Cloud SQL instance that is not replicating from a primary instance. * **
+        # ON_PREMISES_INSTANCE**: An instance running on the customer's premises. * **
+        # READ_REPLICA_INSTANCE**: A Cloud SQL instance configured as a read-replica.
         # Corresponds to the JSON property `instanceType`
         # @return [String]
         attr_accessor :instance_type
@@ -670,7 +688,7 @@ module Google
         # @return [String]
         attr_accessor :ipv6_address
-        # This is always *sql#instance*.
+        # This is always **sql#instance**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -706,10 +724,10 @@ module Google
         # @return [String]
         attr_accessor :project
-        # The geographical region. Can be *us-central* (*FIRST_GEN* instances only) *us-
-        # central1* (*SECOND_GEN* instances only) *asia-east1* or *europe-west1*.
-        # Defaults to *us-central* or *us-central1* depending on the instance type. The
-        # region cannot be changed after instance creation.
+        # The geographical region. Can be: * **us-central** (**FIRST_GEN** instances
+        # only) * **us-central1** (**SECOND_GEN** instances only) * **asia-east1** or **
+        # europe-west1**. Defaults to **us-central** or **us-central1** depending on the
+        # instance type. The region cannot be changed after instance creation.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -770,12 +788,12 @@ module Google
         attr_accessor :settings
         # The current serving state of the Cloud SQL instance. This can be one of the
-        # following. *SQL_INSTANCE_STATE_UNSPECIFIED*: The state of the instance is
-        # unknown. *RUNNABLE*: The instance is running, or has been stopped by owner. *
-        # SUSPENDED*: The instance is not available, for example due to problems with
-        # billing. *PENDING_DELETE*: The instance is being deleted. *PENDING_CREATE*:
-        # The instance is being created. *MAINTENANCE*: The instance is down for
-        # maintenance. *FAILED*: The instance creation failed.
+        # following: * **SQL_INSTANCE_STATE_UNSPECIFIED**: The state of the instance is
+        # unknown. * **RUNNABLE**: The instance is running, or has been stopped by owner.
+        # * **SUSPENDED**: The instance is not available, for example due to problems
+        # with billing. * **PENDING_DELETE**: The instance is being deleted. * **
+        # PENDING_CREATE**: The instance is being created. * **MAINTENANCE**: The
+        # instance is down for maintenance. * **FAILED**: The instance creation failed.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -793,6 +811,7 @@ module Google
         def update!(**args)
           @backend_type = args[:backend_type] if args.key?(:backend_type)
           @connection_name = args[:connection_name] if args.key?(:connection_name)
+          @create_time = args[:create_time] if args.key?(:create_time)
           @current_disk_size = args[:current_disk_size] if args.key?(:current_disk_size)
           @database_version = args[:database_version] if args.key?(:database_version)
           @disk_encryption_configuration = args[:disk_encryption_configuration] if args.key?(:disk_encryption_configuration)
@@ -865,7 +884,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::Database>]
         attr_accessor :items
-        # This is always *sql#databasesList*.
+        # This is always **sql#databasesList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -885,7 +904,7 @@ module Google
       class DemoteMasterConfiguration
         include Google::Apis::Core::Hashable
-        # This is always *sql#demoteMasterConfiguration*.
+        # This is always **sql#demoteMasterConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -910,7 +929,7 @@ module Google
       class DemoteMasterContext
         include Google::Apis::Core::Hashable
-        # This is always *sql#demoteMasterContext*.
+        # This is always **sql#demoteMasterContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -926,7 +945,13 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::DemoteMasterConfiguration]
         attr_accessor :replica_configuration
-        # Verify GTID consistency for demote operation. Default value: *True*. Setting
+        # Flag to skip replication setup on the instance.
+        # Corresponds to the JSON property `skipReplicationSetup`
+        # @return [Boolean]
+        attr_accessor :skip_replication_setup
+        alias_method :skip_replication_setup?, :skip_replication_setup
+        # Verify GTID consistency for demote operation. Default value: **True**. Setting
         # this flag to false enables you to bypass GTID consistency check between on-
         # premises primary instance and Cloud SQL instance during the demotion operation
         # but also exposes you to the risk of future replication failures. Change the
@@ -946,6 +971,7 @@ module Google
           @kind = args[:kind] if args.key?(:kind)
           @master_instance_name = args[:master_instance_name] if args.key?(:master_instance_name)
           @replica_configuration = args[:replica_configuration] if args.key?(:replica_configuration)
+          @skip_replication_setup = args[:skip_replication_setup] if args.key?(:skip_replication_setup)
           @verify_gtid_consistency = args[:verify_gtid_consistency] if args.key?(:verify_gtid_consistency)
         end
       end
@@ -971,7 +997,7 @@ module Google
         # @return [String]
         attr_accessor :client_key
-        # This is always *sql#demoteMasterMysqlReplicaConfiguration*.
+        # This is always **sql#demoteMasterMysqlReplicaConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1044,7 +1070,7 @@ module Google
       class DiskEncryptionConfiguration
         include Google::Apis::Core::Hashable
-        # This is always *sql#diskEncryptionConfiguration*.
+        # This is always **sql#diskEncryptionConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1069,7 +1095,7 @@ module Google
       class DiskEncryptionStatus
         include Google::Apis::Core::Hashable
-        # This is always *sql#diskEncryptionStatus*.
+        # This is always **sql#diskEncryptionStatus**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1094,32 +1120,32 @@ module Google
       class ExportContext
         include Google::Apis::Core::Hashable
-        # Options for exporting data as CSV. *MySQL* and *PostgreSQL* instances only.
+        # Options for exporting data as CSV. **MySQL** and **PostgreSQL** instances only.
         # Corresponds to the JSON property `csvExportOptions`
         # @return [Google::Apis::SqladminV1beta4::ExportContext::CsvExportOptions]
         attr_accessor :csv_export_options
-        # Databases to be exported. *MySQL instances:* If *fileType* is *SQL* and no
-        # database is specified, all databases are exported, except for the *mysql*
-        # system database. If *fileType* is *CSV*, you can specify one database, either
-        # by using this property or by using the *csvExportOptions.selectQuery* property,
-        # which takes precedence over this property. *PostgreSQL instances:* You must
-        # specify one database to be exported. If *fileType* is *CSV*, this database
-        # must match the one specified in the *csvExportOptions.selectQuery* property. *
-        # SQL Server instances:* You must specify one database to be exported, and the *
-        # fileType* must be *BAK*.
+        # Databases to be exported. * **MySQL instances:** If **fileType** is **SQL**
+        # and no database is specified, all databases are exported, except for the **
+        # mysql** system database. If **fileType** is **CSV**, you can specify one
+        # database, either by using this property or by using the **csvExportOptions.
+        # selectQuery** property, which takes precedence over this property. * **
+        # PostgreSQL instances:** You must specify one database to be exported. If **
+        # fileType** is **CSV**, this database must match the one specified in the **
+        # csvExportOptions.selectQuery** property. * **SQL Server instances:** You must
+        # specify one database to be exported, and the **fileType** must be **BAK**.
         # Corresponds to the JSON property `databases`
         # @return [Array<String>]
         attr_accessor :databases
-        # The file type for the specified uri. *SQL*: The file contains SQL statements. *
-        # CSV*: The file contains CSV data. *BAK*: The file contains backup data for a
-        # SQL Server instance.
+        # The file type for the specified uri. * **SQL**: The file contains SQL
+        # statements. * **CSV**: The file contains CSV data. * **BAK**: The file
+        # contains backup data for a SQL Server instance.
         # Corresponds to the JSON property `fileType`
         # @return [String]
         attr_accessor :file_type
-        # This is always *sql#exportContext*.
+        # This is always **sql#exportContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1136,9 +1162,9 @@ module Google
         attr_accessor :sql_export_options
         # The path to the file in Google Cloud Storage where the export will be stored.
-        # The URI is in the form *gs://bucketName/fileName*. If the file already exists,
-        # the request succeeds, but the operation fails. If *fileType* is *SQL* and the
-        # filename ends with .gz, the contents are compressed.
+        # The URI is in the form **gs://bucketName/fileName**. If the file already
+        # exists, the request succeeds, but the operation fails. If **fileType** is **
+        # SQL** and the filename ends with .gz, the contents are compressed.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -1158,10 +1184,33 @@ module Google
           @uri = args[:uri] if args.key?(:uri)
         end
-        # Options for exporting data as CSV. *MySQL* and *PostgreSQL* instances only.
+        # Options for exporting data as CSV. **MySQL** and **PostgreSQL** instances only.
         class CsvExportOptions
           include Google::Apis::Core::Hashable
+          # Specifies the character that should appear before a data character that needs
+          # to be escaped.
+          # Corresponds to the JSON property `escapeCharacter`
+          # @return [String]
+          attr_accessor :escape_character
+          # Specifies the character that separates columns within each row (line) of the
+          # file.
+          # Corresponds to the JSON property `fieldsTerminatedBy`
+          # @return [String]
+          attr_accessor :fields_terminated_by
+          # This is used to separate lines. If a line does not contain all fields, the
+          # rest of the columns are set to their default values.
+          # Corresponds to the JSON property `linesTerminatedBy`
+          # @return [String]
+          attr_accessor :lines_terminated_by
+          # Specifies the quoting character to be used when a data value is quoted.
+          # Corresponds to the JSON property `quoteCharacter`
+          # @return [String]
+          attr_accessor :quote_character
           # The select query used to extract the data.
           # Corresponds to the JSON property `selectQuery`
           # @return [String]
@@ -1173,6 +1222,10 @@ module Google
           # Update properties of this object
           def update!(**args)
+            @escape_character = args[:escape_character] if args.key?(:escape_character)
+            @fields_terminated_by = args[:fields_terminated_by] if args.key?(:fields_terminated_by)
+            @lines_terminated_by = args[:lines_terminated_by] if args.key?(:lines_terminated_by)
+            @quote_character = args[:quote_character] if args.key?(:quote_character)
             @select_query = args[:select_query] if args.key?(:select_query)
           end
         end
@@ -1214,11 +1267,11 @@ module Google
           class MysqlExportOptions
             include Google::Apis::Core::Hashable
-            # Option to include SQL statement required to set up replication. If set to *1*,
-            # the dump file includes a CHANGE MASTER TO statement with the binary log
-            # coordinates, and --set-gtid-purged is set to ON. If set to *2*, the CHANGE
-            # MASTER TO statement is written as a SQL comment and has no effect. If set to
-            # any value other than *1*, --set-gtid-purged is set to OFF.
+            # Option to include SQL statement required to set up replication. * If set to **
+            # 1**, the dump file includes a CHANGE MASTER TO statement with the binary log
+            # coordinates, and --set-gtid-purged is set to ON. * If set to **2**, the CHANGE
+            # MASTER TO statement is written as a SQL comment and has no effect. * If set to
+            # any value other than **1**, --set-gtid-purged is set to OFF.
             # Corresponds to the JSON property `masterData`
             # @return [Fixnum]
             attr_accessor :master_data
@@ -1239,7 +1292,7 @@ module Google
       class FailoverContext
         include Google::Apis::Core::Hashable
-        # This is always *sql#failoverContext*.
+        # This is always **sql#failoverContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1271,13 +1324,13 @@ module Google
         # @return [Array<Fixnum>]
         attr_accessor :allowed_int_values
-        # For *STRING* flags, a list of strings that the value can be set to.
+        # For **STRING** flags, a list of strings that the value can be set to.
         # Corresponds to the JSON property `allowedStringValues`
         # @return [Array<String>]
         attr_accessor :allowed_string_values
-        # The database version this flag applies to. Can be *MYSQL_8_0*, *MYSQL_5_6*, or
-        # *MYSQL_5_7*.
+        # The database version this flag applies to. Can be **MYSQL_8_0**, **MYSQL_5_6**,
+        # or **MYSQL_5_7**.
         # Corresponds to the JSON property `appliesTo`
         # @return [Array<String>]
         attr_accessor :applies_to
@@ -1288,36 +1341,37 @@ module Google
         attr_accessor :in_beta
         alias_method :in_beta?, :in_beta
-        # This is always *sql#flag*.
+        # This is always **sql#flag**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # For *INTEGER* flags, the maximum allowed value.
+        # For **INTEGER** flags, the maximum allowed value.
         # Corresponds to the JSON property `maxValue`
         # @return [Fixnum]
         attr_accessor :max_value
-        # For *INTEGER* flags, the minimum allowed value.
+        # For **INTEGER** flags, the minimum allowed value.
         # Corresponds to the JSON property `minValue`
         # @return [Fixnum]
         attr_accessor :min_value
         # This is the name of the flag. Flag names always use underscores, not hyphens,
-        # for example: *max_allowed_packet*
+        # for example: **max_allowed_packet**
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Indicates whether changing this flag will trigger a database restart.
+        # Indicates whether changing this flag will trigger a database restart. Only
+        # applicable to Second Generation instances.
         # Corresponds to the JSON property `requiresRestart`
         # @return [Boolean]
         attr_accessor :requires_restart
         alias_method :requires_restart?, :requires_restart
-        # The type of the flag. Flags are typed to being *BOOLEAN*, *STRING*, *INTEGER*
-        # or *NONE*. *NONE* is used for flags which do not take a value, such as *
-        # skip_grant_tables*.
+        # The type of the flag. Flags are typed to being **BOOLEAN**, **STRING**, **
+        # INTEGER** or **NONE**. **NONE** is used for flags which do not take a value,
+        # such as **skip_grant_tables**.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1350,7 +1404,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::Flag>]
         attr_accessor :items
-        # This is always *sql#flagsList*.
+        # This is always **sql#flagsList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1385,6 +1439,11 @@ module Google
         # @return [String]
         attr_accessor :read_time
+        # Optional. If set, it will contain the cert valid duration.
+        # Corresponds to the JSON property `validDuration`
+        # @return [String]
+        attr_accessor :valid_duration
         def initialize(**args)
            update!(**args)
         end
@@ -1394,6 +1453,7 @@ module Google
           @access_token = args[:access_token] if args.key?(:access_token)
           @public_key = args[:public_key] if args.key?(:public_key)
           @read_time = args[:read_time] if args.key?(:read_time)
+          @valid_duration = args[:valid_duration] if args.key?(:valid_duration)
         end
       end
@@ -1430,16 +1490,17 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::ImportContext::CsvImportOptions]
         attr_accessor :csv_import_options
-        # The target database for the import. If *fileType* is *SQL*, this field is
+        # The target database for the import. If **fileType** is **SQL**, this field is
         # required only if the import file does not specify a database, and is
-        # overridden by any database specification in the import file. If *fileType* is *
-        # CSV*, one database must be specified.
+        # overridden by any database specification in the import file. If **fileType**
+        # is **CSV**, one database must be specified.
         # Corresponds to the JSON property `database`
         # @return [String]
         attr_accessor :database
-        # The file type for the specified uri. *SQL*: The file contains SQL statements. *
-        # CSV*: The file contains CSV data.
+        # The file type for the specified uri. * **SQL**: The file contains SQL
+        # statements. * **CSV**: The file contains CSV data. * **BAK**: The file
+        # contains backup data for a SQL Server instance.
         # Corresponds to the JSON property `fileType`
         # @return [String]
         attr_accessor :file_type
@@ -1449,15 +1510,15 @@ module Google
         # @return [String]
         attr_accessor :import_user
-        # This is always *sql#importContext*.
+        # This is always **sql#importContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Path to the import file in Cloud Storage, in the form *gs://bucketName/
-        # fileName*. Compressed gzip files (.gz) are supported when *fileType* is *SQL*.
-        # The instance must have write permissions to the bucket and read access to the
-        # file.
+        # Path to the import file in Cloud Storage, in the form **gs://bucketName/
+        # fileName**. Compressed gzip files (.gz) are supported when **fileType** is **
+        # SQL**. The instance must have write permissions to the bucket and read access
+        # to the file.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -1499,8 +1560,8 @@ module Google
           class EncryptionOptions
             include Google::Apis::Core::Hashable
-            # Path to the Certificate (.cer) in Cloud Storage, in the form *gs://bucketName/
-            # fileName*. The instance must have write permissions to the bucket and read
+            # Path to the Certificate (.cer) in Cloud Storage, in the form **gs://bucketName/
+            # fileName**. The instance must have write permissions to the bucket and read
             # access to the file.
             # Corresponds to the JSON property `certPath`
             # @return [String]
@@ -1511,8 +1572,8 @@ module Google
             # @return [String]
             attr_accessor :pvk_password
-            # Path to the Certificate Private Key (.pvk) in Cloud Storage, in the form *gs://
-            # bucketName/fileName*. The instance must have write permissions to the bucket
+            # Path to the Certificate Private Key (.pvk) in Cloud Storage, in the form **gs:/
+            # /bucketName/fileName**. The instance must have write permissions to the bucket
             # and read access to the file.
             # Corresponds to the JSON property `pvkPath`
             # @return [String]
@@ -1541,6 +1602,29 @@ module Google
           # @return [Array<String>]
           attr_accessor :columns
+          # Specifies the character that should appear before a data character that needs
+          # to be escaped.
+          # Corresponds to the JSON property `escapeCharacter`
+          # @return [String]
+          attr_accessor :escape_character
+          # Specifies the character that separates columns within each row (line) of the
+          # file.
+          # Corresponds to the JSON property `fieldsTerminatedBy`
+          # @return [String]
+          attr_accessor :fields_terminated_by
+          # This is used to separate lines. If a line does not contain all fields, the
+          # rest of the columns are set to their default values.
+          # Corresponds to the JSON property `linesTerminatedBy`
+          # @return [String]
+          attr_accessor :lines_terminated_by
+          # Specifies the quoting character to be used when a data value is quoted.
+          # Corresponds to the JSON property `quoteCharacter`
+          # @return [String]
+          attr_accessor :quote_character
           # The table to which CSV data is imported.
           # Corresponds to the JSON property `table`
           # @return [String]
@@ -1553,6 +1637,10 @@ module Google
           # Update properties of this object
           def update!(**args)
             @columns = args[:columns] if args.key?(:columns)
+            @escape_character = args[:escape_character] if args.key?(:escape_character)
+            @fields_terminated_by = args[:fields_terminated_by] if args.key?(:fields_terminated_by)
+            @lines_terminated_by = args[:lines_terminated_by] if args.key?(:lines_terminated_by)
+            @quote_character = args[:quote_character] if args.key?(:quote_character)
             @table = args[:table] if args.key?(:table)
           end
         end
@@ -1609,6 +1697,39 @@ module Google
         end
       end
+      # Reference to another Cloud SQL instance.
+      class InstanceReference
+        include Google::Apis::Core::Hashable
+        # The name of the Cloud SQL instance being referenced. This does not include the
+        # project ID.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+        # The project ID of the Cloud SQL instance being referenced. The default is the
+        # same project ID as the instance references it.
+        # Corresponds to the JSON property `project`
+        # @return [String]
+        attr_accessor :project
+        # The region of the Cloud SQL instance being referenced.
+        # Corresponds to the JSON property `region`
+        # @return [String]
+        attr_accessor :region
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @project = args[:project] if args.key?(:project)
+          @region = args[:region] if args.key?(:region)
+        end
+      end
       # Database instance clone request.
       class CloneInstancesRequest
         include Google::Apis::Core::Hashable
@@ -1713,7 +1834,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::DatabaseInstance>]
         attr_accessor :items
-        # This is always *sql#instancesList*.
+        # This is always **sql#instancesList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1756,7 +1877,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::SslCert>]
         attr_accessor :certs
-        # This is always *sql#instancesListServerCas*.
+        # This is always **sql#instancesListServerCas**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1835,9 +1956,19 @@ module Google
       class IpConfiguration
         include Google::Apis::Core::Hashable
+        # The name of the allocated ip range for the private ip CloudSQL instance. For
+        # example: "google-managed-services-default". If set, the instance ip will be
+        # created in the allocated range. The range name must comply with [RFC 1035](
+        # https://tools.ietf.org/html/rfc1035). Specifically, the name must be 1-63
+        # characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?.`
+        # Reserved for future use.
+        # Corresponds to the JSON property `allocatedIpRange`
+        # @return [String]
+        attr_accessor :allocated_ip_range
         # The list of external networks that are allowed to connect to the instance
         # using the IP. In 'CIDR' notation, also known as 'slash' notation (for example:
-        # *192.168.100.0/24*).
+        # **192.168.100.0/24**).
         # Corresponds to the JSON property `authorizedNetworks`
         # @return [Array<Google::Apis::SqladminV1beta4::AclEntry>]
         attr_accessor :authorized_networks
@@ -1849,8 +1980,8 @@ module Google
         alias_method :ipv4_enabled?, :ipv4_enabled
         # The resource link for the VPC network from which the Cloud SQL instance is
-        # accessible for private IP. For example, */projects/myProject/global/networks/
-        # default*. This setting can be updated, but it cannot be removed after it is
+        # accessible for private IP. For example, **/projects/myProject/global/networks/
+        # default**. This setting can be updated, but it cannot be removed after it is
         # set.
         # Corresponds to the JSON property `privateNetwork`
         # @return [String]
@@ -1868,6 +1999,7 @@ module Google
         # Update properties of this object
         def update!(**args)
+          @allocated_ip_range = args[:allocated_ip_range] if args.key?(:allocated_ip_range)
           @authorized_networks = args[:authorized_networks] if args.key?(:authorized_networks)
           @ipv4_enabled = args[:ipv4_enabled] if args.key?(:ipv4_enabled)
           @private_network = args[:private_network] if args.key?(:private_network)
@@ -1884,17 +2016,17 @@ module Google
         # @return [String]
         attr_accessor :ip_address
-        # The due time for this IP to be retired in RFC 3339 format, for example *2012-
-        # 11-15T16:19:00.094Z*. This field is only available when the IP is scheduled to
-        # be retired.
+        # The due time for this IP to be retired in [RFC 3339](https://tools.ietf.org/
+        # html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**. This field is
+        # only available when the IP is scheduled to be retired.
         # Corresponds to the JSON property `timeToRetire`
         # @return [String]
         attr_accessor :time_to_retire
-        # The type of this IP address. A *PRIMARY* address is a public address that can
-        # accept incoming connections. A *PRIVATE* address is a private address that can
-        # accept incoming connections. An *OUTGOING* address is the source address of
-        # connections originating from the instance, if supported.
+        # The type of this IP address. A **PRIMARY** address is a public address that
+        # can accept incoming connections. A **PRIVATE** address is a private address
+        # that can accept incoming connections. An **OUTGOING** address is the source
+        # address of connections originating from the instance, if supported.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1911,11 +2043,9 @@ module Google
         end
       end
-      # Preferred location. This specifies where a Cloud SQL instance is located,
-      # either in a specific Compute Engine zone, or co-located with an App Engine
-      # application. Note that if the preferred location is not available, the
-      # instance will be located as close as possible within the region. Only one
-      # location may be specified.
+      # Preferred location. This specifies where a Cloud SQL instance is located. Note
+      # that if the preferred location is not available, the instance will be located
+      # as close as possible within the region. Only one location may be specified.
       class LocationPreference
         include Google::Apis::Core::Hashable
@@ -1925,7 +2055,7 @@ module Google
         # @return [String]
         attr_accessor :follow_gae_application
-        # This is always *sql#locationPreference*.
+        # This is always **sql#locationPreference**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -1970,12 +2100,14 @@ module Google
         # @return [Fixnum]
         attr_accessor :hour
-        # This is always *sql#maintenanceWindow*.
+        # This is always **sql#maintenanceWindow**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Maintenance timing setting: *canary* (Earlier) or *stable* (Later). Learn more.
+        # Maintenance timing setting: **canary** (Earlier) or **stable** (Later). [Learn
+        # more](https://cloud.google.com/sql/docs/mysql/instance-settings#maintenance-
+        # timing-2ndgen).
         # Corresponds to the JSON property `updateTrack`
         # @return [String]
         attr_accessor :update_track
@@ -2027,7 +2159,7 @@ module Google
         # @return [String]
         attr_accessor :dump_file_path
-        # This is always *sql#mysqlReplicaConfiguration*.
+        # This is always **sql#mysqlReplicaConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2079,6 +2211,25 @@ module Google
         end
       end
+      # MySQL-specific external server sync settings.
+      class MySqlSyncConfig
+        include Google::Apis::Core::Hashable
+        # Flags to use for the initial dump.
+        # Corresponds to the JSON property `initialSyncFlags`
+        # @return [Array<Google::Apis::SqladminV1beta4::SyncFlags>]
+        attr_accessor :initial_sync_flags
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @initial_sync_flags = args[:initial_sync_flags] if args.key?(:initial_sync_flags)
+        end
+      end
       # On-premises instance configuration.
       class OnPremisesConfiguration
         include Google::Apis::Core::Hashable
@@ -2109,7 +2260,7 @@ module Google
         # @return [String]
         attr_accessor :host_port
-        # This is always *sql#onPremisesConfiguration*.
+        # This is always **sql#onPremisesConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2119,6 +2270,11 @@ module Google
         # @return [String]
         attr_accessor :password
+        # Reference to another Cloud SQL instance.
+        # Corresponds to the JSON property `sourceInstance`
+        # @return [Google::Apis::SqladminV1beta4::InstanceReference]
+        attr_accessor :source_instance
         # The username for connecting to on-premises instance.
         # Corresponds to the JSON property `username`
         # @return [String]
@@ -2137,6 +2293,7 @@ module Google
           @host_port = args[:host_port] if args.key?(:host_port)
           @kind = args[:kind] if args.key?(:kind)
           @password = args[:password] if args.key?(:password)
+          @source_instance = args[:source_instance] if args.key?(:source_instance)
           @username = args[:username] if args.key?(:username)
         end
       end
@@ -2152,8 +2309,8 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::BackupContext]
         attr_accessor :backup_context
-        # The time this operation finished in UTC timezone in RFC 3339 format, for
-        # example *2012-11-15T16:19:00.094Z*.
+        # The time this operation finished in UTC timezone in [RFC 3339](https://tools.
+        # ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
@@ -2173,13 +2330,13 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::ImportContext]
         attr_accessor :import_context
-        # The time this operation was enqueued in UTC timezone in RFC 3339 format, for
-        # example *2012-11-15T16:19:00.094Z*.
+        # The time this operation was enqueued in UTC timezone in [RFC 3339](https://
+        # tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `insertTime`
         # @return [String]
         attr_accessor :insert_time
-        # This is always *sql#operation*.
+        # This is always **sql#operation**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2191,9 +2348,10 @@ module Google
         # @return [String]
         attr_accessor :name
-        # The type of the operation. Valid values are: *CREATE* *DELETE* *UPDATE* *
-        # RESTART* *IMPORT* *EXPORT* *BACKUP_VOLUME* *RESTORE_VOLUME* *CREATE_USER* *
-        # DELETE_USER* *CREATE_DATABASE* *DELETE_DATABASE*
+        # The type of the operation. Valid values are: * **CREATE** * **DELETE** * **
+        # UPDATE** * **RESTART** * **IMPORT** * **EXPORT** * **BACKUP_VOLUME** * **
+        # RESTORE_VOLUME** * **CREATE_USER** * **DELETE_USER** * **CREATE_DATABASE** * **
+        # DELETE_DATABASE**
         # Corresponds to the JSON property `operationType`
         # @return [String]
         attr_accessor :operation_type
@@ -2203,14 +2361,14 @@ module Google
         # @return [String]
         attr_accessor :self_link
-        # The time this operation actually started in UTC timezone in RFC 3339 format,
-        # for example *2012-11-15T16:19:00.094Z*.
+        # The time this operation actually started in UTC timezone in [RFC 3339](https://
+        # tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
-        # The status of an operation. Valid values are: *PENDING* *RUNNING* *DONE* *
-        # SQL_OPERATION_STATUS_UNSPECIFIED*
+        # The status of an operation. Valid values are: * **PENDING** * **RUNNING** * **
+        # DONE** * **SQL_OPERATION_STATUS_UNSPECIFIED**
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -2269,7 +2427,7 @@ module Google
         # @return [String]
         attr_accessor :code
-        # This is always *sql#operationError*.
+        # This is always **sql#operationError**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2300,7 +2458,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::OperationError>]
         attr_accessor :errors
-        # This is always *sql#operationErrors*.
+        # This is always **sql#operationErrors**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2316,7 +2474,7 @@ module Google
         end
       end
-      # Database instance list operations response.
+      # Operations list response.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable
@@ -2325,7 +2483,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::Operation>]
         attr_accessor :items
-        # This is always *sql#operationsList*.
+        # This is always **sql#operationsList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2352,8 +2510,8 @@ module Google
       class ReplicaConfiguration
         include Google::Apis::Core::Hashable
-        # Specifies if the replica is the failover target. If the field is set to *true*
-        # the replica will be designated as a failover replica. In case the primary
+        # Specifies if the replica is the failover target. If the field is set to **true*
+        # * the replica will be designated as a failover replica. In case the primary
         # instance fails, the replica instance will be promoted as the new primary
         # instance. Only one replica can be specified as failover target, and the
         # replica has to be in different zone with the primary instance.
@@ -2362,7 +2520,7 @@ module Google
         attr_accessor :failover_target
         alias_method :failover_target?, :failover_target
-        # This is always *sql#replicaConfiguration*.
+        # This is always **sql#replicaConfiguration**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2394,8 +2552,8 @@ module Google
         attr_accessor :reschedule_type
         # Optional. Timestamp when the maintenance shall be rescheduled to if
-        # reschedule_type=SPECIFIC_TIME, in RFC 3339 format, for example *2012-11-15T16:
-        # 19:00.094Z*.
+        # reschedule_type=SPECIFIC_TIME, in [RFC 3339](https://tools.ietf.org/html/
+        # rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `scheduleTime`
         # @return [String]
         attr_accessor :schedule_time
@@ -2426,7 +2584,7 @@ module Google
         # @return [String]
         attr_accessor :instance_id
-        # This is always *sql#restoreBackupContext*.
+        # This is always **sql#restoreBackupContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2453,7 +2611,7 @@ module Google
       class RotateServerCaContext
         include Google::Apis::Core::Hashable
-        # This is always *sql#rotateServerCaContext*.
+        # This is always **sql#rotateServerCaContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2480,10 +2638,10 @@ module Google
         include Google::Apis::Core::Hashable
         # The activation policy specifies when the instance is activated; it is
-        # applicable only when the instance state is RUNNABLE. Valid values: *ALWAYS*:
-        # The instance is on, and remains so even in the absence of connection requests.
-        # *NEVER*: The instance is off; it is not activated, even if a connection
-        # request arrives.
+        # applicable only when the instance state is RUNNABLE. Valid values: * **ALWAYS**
+        # : The instance is on, and remains so even in the absence of connection
+        # requests. * **NEVER**: The instance is off; it is not activated, even if a
+        # connection request arrives.
         # Corresponds to the JSON property `activationPolicy`
         # @return [String]
         attr_accessor :activation_policy
@@ -2499,11 +2657,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :authorized_gae_applications
-        # Availability type. Potential values: *ZONAL*: The instance serves data from
-        # only one zone. Outages in that zone affect data accessibility. *REGIONAL*: The
-        # instance can serve data from more than one zone in a region (it is highly
-        # available). For more information, see Overview of the High Availability
-        # Configuration.
+        # Availability type. Potential values: * **ZONAL**: The instance serves data
+        # from only one zone. Outages in that zone affect data accessibility. * **
+        # REGIONAL**: The instance can serve data from more than one zone in a region (
+        # it is highly available)./ For more information, see [Overview of the High
+        # Availability Configuration](https://cloud.google.com/sql/docs/mysql/high-
+        # availability).
         # Corresponds to the JSON property `availabilityType`
         # @return [String]
         attr_accessor :availability_type
@@ -2531,7 +2690,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :data_disk_size_gb
-        # The type of data disk: PD_SSD (default) or PD_HDD. Not used for First
+        # The type of data disk: **PD_SSD** (default) or **PD_HDD**. Not used for First
         # Generation instances.
         # Corresponds to the JSON property `dataDiskType`
         # @return [String]
@@ -2565,16 +2724,14 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::IpConfiguration]
         attr_accessor :ip_configuration
-        # This is always *sql#settings*.
+        # This is always **sql#settings**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Preferred location. This specifies where a Cloud SQL instance is located,
-        # either in a specific Compute Engine zone, or co-located with an App Engine
-        # application. Note that if the preferred location is not available, the
-        # instance will be located as close as possible within the region. Only one
-        # location may be specified.
+        # Preferred location. This specifies where a Cloud SQL instance is located. Note
+        # that if the preferred location is not available, the instance will be located
+        # as close as possible within the region. Only one location may be specified.
         # Corresponds to the JSON property `locationPreference`
         # @return [Google::Apis::SqladminV1beta4::LocationPreference]
         attr_accessor :location_preference
@@ -2585,14 +2742,14 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::MaintenanceWindow]
         attr_accessor :maintenance_window
-        # The pricing plan for this instance. This can be either *PER_USE* or *PACKAGE*.
-        # Only *PER_USE* is supported for Second Generation instances.
+        # The pricing plan for this instance. This can be either **PER_USE** or **
+        # PACKAGE**. Only **PER_USE** is supported for Second Generation instances.
         # Corresponds to the JSON property `pricingPlan`
         # @return [String]
         attr_accessor :pricing_plan
-        # The type of replication this instance uses. This can be either *ASYNCHRONOUS*
-        # or *SYNCHRONOUS*. (Deprecated_ This property was only applicable to First
+        # The type of replication this instance uses. This can be either **ASYNCHRONOUS**
+        # or **SYNCHRONOUS**. (Deprecated) This property was only applicable to First
         # Generation instances.
         # Corresponds to the JSON property `replicationType`
         # @return [String]
@@ -2606,6 +2763,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :settings_version
+        # SQL Server specific audit configuration.
+        # Corresponds to the JSON property `sqlServerAuditConfig`
+        # @return [Google::Apis::SqladminV1beta4::SqlServerAuditConfig]
+        attr_accessor :sql_server_audit_config
         # Configuration to increase storage size automatically. The default value is
         # true.
         # Corresponds to the JSON property `storageAutoResize`
@@ -2619,7 +2781,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :storage_auto_resize_limit
-        # The tier (or machine type) for this instance, for example *db-custom-1-3840* .
+        # The tier (or machine type) for this instance, for example **db-custom-1-3840**.
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
@@ -2656,6 +2818,7 @@ module Google
           @pricing_plan = args[:pricing_plan] if args.key?(:pricing_plan)
           @replication_type = args[:replication_type] if args.key?(:replication_type)
           @settings_version = args[:settings_version] if args.key?(:settings_version)
+          @sql_server_audit_config = args[:sql_server_audit_config] if args.key?(:sql_server_audit_config)
           @storage_auto_resize = args[:storage_auto_resize] if args.key?(:storage_auto_resize)
           @storage_auto_resize_limit = args[:storage_auto_resize_limit] if args.key?(:storage_auto_resize_limit)
           @tier = args[:tier] if args.key?(:tier)
@@ -2697,7 +2860,7 @@ module Google
         # @return [String]
         attr_accessor :detail
-        # Can be *sql#externalSyncSettingError* or *sql#externalSyncSettingWarning*.
+        # Can be **sql#externalSyncSettingError** or **sql#externalSyncSettingWarning**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2738,6 +2901,77 @@ module Google
         end
       end
+      #
+      class SqlInstancesStartExternalSyncRequest
+        include Google::Apis::Core::Hashable
+        # MySQL-specific external server sync settings.
+        # Corresponds to the JSON property `mysqlSyncConfig`
+        # @return [Google::Apis::SqladminV1beta4::MySqlSyncConfig]
+        attr_accessor :mysql_sync_config
+        # Whether to skip the verification step (VESS).
+        # Corresponds to the JSON property `skipVerification`
+        # @return [Boolean]
+        attr_accessor :skip_verification
+        alias_method :skip_verification?, :skip_verification
+        # External sync mode.
+        # Corresponds to the JSON property `syncMode`
+        # @return [String]
+        attr_accessor :sync_mode
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @mysql_sync_config = args[:mysql_sync_config] if args.key?(:mysql_sync_config)
+          @skip_verification = args[:skip_verification] if args.key?(:skip_verification)
+          @sync_mode = args[:sync_mode] if args.key?(:sync_mode)
+        end
+      end
+      #
+      class SqlInstancesVerifyExternalSyncSettingsRequest
+        include Google::Apis::Core::Hashable
+        # MySQL-specific external server sync settings.
+        # Corresponds to the JSON property `mysqlSyncConfig`
+        # @return [Google::Apis::SqladminV1beta4::MySqlSyncConfig]
+        attr_accessor :mysql_sync_config
+        # External sync mode
+        # Corresponds to the JSON property `syncMode`
+        # @return [String]
+        attr_accessor :sync_mode
+        # Flag to enable verifying connection only
+        # Corresponds to the JSON property `verifyConnectionOnly`
+        # @return [Boolean]
+        attr_accessor :verify_connection_only
+        alias_method :verify_connection_only?, :verify_connection_only
+        # Optional. Flag to verify settings required by replication setup only
+        # Corresponds to the JSON property `verifyReplicationOnly`
+        # @return [Boolean]
+        attr_accessor :verify_replication_only
+        alias_method :verify_replication_only?, :verify_replication_only
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @mysql_sync_config = args[:mysql_sync_config] if args.key?(:mysql_sync_config)
+          @sync_mode = args[:sync_mode] if args.key?(:sync_mode)
+          @verify_connection_only = args[:verify_connection_only] if args.key?(:verify_connection_only)
+          @verify_replication_only = args[:verify_replication_only] if args.key?(:verify_replication_only)
+        end
+      end
       # Instance verify external sync settings response.
       class SqlInstancesVerifyExternalSyncSettingsResponse
         include Google::Apis::Core::Hashable
@@ -2747,7 +2981,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::SqlExternalSyncSettingError>]
         attr_accessor :errors
-        # This is always *sql#migrationSettingErrorList*.
+        # This is always **sql#migrationSettingErrorList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2774,14 +3008,15 @@ module Google
         include Google::Apis::Core::Hashable
         # The minimum recommended increase size in GigaBytes This field is consumed by
-        # the frontend Writers: -- the proactive database wellness job for OOD.
+        # the frontend * Writers: * the proactive database wellness job for OOD. *
+        # Readers:
         # Corresponds to the JSON property `sqlMinRecommendedIncreaseSizeGb`
         # @return [Fixnum]
         attr_accessor :sql_min_recommended_increase_size_gb
         # This field represents the state generated by the proactive database wellness
-        # job for OutOfDisk issues. Writers: -- the proactive database wellness job for
-        # OOD. Readers: -- the proactive database wellness job
+        # job for OutOfDisk issues. * Writers: * the proactive database wellness job for
+        # OOD. * Readers: * the proactive database wellness job
         # Corresponds to the JSON property `sqlOutOfDiskState`
         # @return [String]
         attr_accessor :sql_out_of_disk_state
@@ -2836,6 +3071,31 @@ module Google
         end
       end
+      # SQL Server specific audit configuration.
+      class SqlServerAuditConfig
+        include Google::Apis::Core::Hashable
+        # The name of the destination bucket (e.g., gs://mybucket).
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+        # This is always sql#sqlServerAuditConfig
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
       # Represents a Sql Server database on the Cloud SQL instance.
       class SqlServerDatabaseDetails
         include Google::Apis::Core::Hashable
@@ -2906,14 +3166,14 @@ module Google
         # @return [String]
         attr_accessor :common_name
-        # The time when the certificate was created in RFC 3339 format, for example *
-        # 2012-11-15T16:19:00.094Z*
+        # The time when the certificate was created in [RFC 3339](https://tools.ietf.org/
+        # html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
-        # The time when the certificate expires in RFC 3339 format, for example *2012-11-
-        # 15T16:19:00.094Z*.
+        # The time when the certificate expires in [RFC 3339](https://tools.ietf.org/
+        # html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
@@ -2923,7 +3183,7 @@ module Google
         # @return [String]
         attr_accessor :instance
-        # This is always *sql#sslCert*.
+        # This is always **sql#sslCert**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3036,7 +3296,7 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::SslCertDetail]
         attr_accessor :client_cert
-        # This is always *sql#sslCertsInsert*.
+        # This is always **sql#sslCertsInsert**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3075,7 +3335,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1beta4::SslCert>]
         attr_accessor :items
-        # This is always *sql#sslCertsList*.
+        # This is always **sql#sslCertsList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3091,6 +3351,33 @@ module Google
         end
       end
+      # Initial sync flags for certain Cloud SQL APIs. Currently used for the MySQL
+      # external server initial dump.
+      class SyncFlags
+        include Google::Apis::Core::Hashable
+        # The name of the flag.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+        # The value of the flag. This field must be omitted if the flag doesn't take a
+        # value.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
       # A Google Cloud SQL service tier resource.
       class Tier
         include Google::Apis::Core::Hashable
@@ -3164,13 +3451,13 @@ module Google
       class TruncateLogContext
         include Google::Apis::Core::Hashable
-        # This is always *sql#truncateLogContext*.
+        # This is always **sql#truncateLogContext**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # The type of log to truncate. Valid values are *MYSQL_GENERAL_TABLE* and *
-        # MYSQL_SLOW_TABLE*.
+        # The type of log to truncate. Valid values are **MYSQL_GENERAL_TABLE** and **
+        # MYSQL_SLOW_TABLE**.
         # Corresponds to the JSON property `logType`
         # @return [String]
         attr_accessor :log_type