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

google-apis-sqladmin_v1beta4 0.14.0 → 0.18.0

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