google-apis-sqladmin_v1 0.3.0 → 0.7.0

data/lib/google/apis/sqladmin_v1/classes.rb

@@ -243,14 +243,14 @@ module Google
         # @return [Google::Apis::SqladminV1::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::SqladminV1::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::SqladminV1::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
@@ -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::SqladminV1::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
@@ -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,12 +945,18 @@ module Google
         # @return [Google::Apis::SqladminV1::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
-        # value value only if you know the reason for the GTID divergence and are
-        # confident that doing so will not cause any replication issues.
+        # value only if you know the reason for the GTID divergence and are confident
+        # that doing so will not cause any replication issues.
         # Corresponds to the JSON property `verifyGtidConsistency`
         # @return [Boolean]
         attr_accessor :verify_gtid_consistency
@@ -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
@@ -1015,8 +1041,8 @@ module Google
         attr_accessor :end_date
       
         # "deny maintenance period" start date. If the year of the start date is empty,
-        # the year of the end date also must be empty. In this case, it means the no
-        # maintenance interval recurs every year. The date is in format yyyy-mm-dd i.e.,
+        # the year of the end date also must be empty. In this case, it means the deny
+        # maintenance period recurs every year. The date is in format yyyy-mm-dd i.e.,
         # 2020-11-01, or mm-dd, i.e., 11-01
         # Corresponds to the JSON property `startDate`
         # @return [String]
@@ -1099,22 +1125,22 @@ module Google
         # @return [Google::Apis::SqladminV1::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
@@ -1162,6 +1188,29 @@ module Google
         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,10 +1267,10 @@ 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
+            # 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]
@@ -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
@@ -1386,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
@@ -1395,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
       
@@ -1542,6 +1601,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]
@@ -1554,6 +1636,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
@@ -1610,6 +1696,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 InstancesCloneRequest
         include Google::Apis::Core::Hashable
@@ -1714,7 +1833,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::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
@@ -1757,7 +1876,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::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
@@ -1836,6 +1955,16 @@ 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**).
@@ -1869,6 +1998,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)
@@ -1975,7 +2105,7 @@ module Google
         attr_accessor :kind
       
         # Maintenance timing setting: **canary** (Earlier) or **stable** (Later). [Learn
-        # more] (https://cloud.google.com/sql/docs/mysql/instance-settings#maintenance-
+        # more](https://cloud.google.com/sql/docs/mysql/instance-settings#maintenance-
         # timing-2ndgen).
         # Corresponds to the JSON property `updateTrack`
         # @return [String]
@@ -2080,6 +2210,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::SqladminV1::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
@@ -2110,7 +2259,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
@@ -2120,6 +2269,11 @@ module Google
         # @return [String]
         attr_accessor :password
       
+        # Reference to another Cloud SQL instance.
+        # Corresponds to the JSON property `sourceInstance`
+        # @return [Google::Apis::SqladminV1::InstanceReference]
+        attr_accessor :source_instance
+      
         # The username for connecting to on-premises instance.
         # Corresponds to the JSON property `username`
         # @return [String]
@@ -2138,6 +2292,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
@@ -2192,9 +2347,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
@@ -2210,8 +2366,8 @@ module Google
         # @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
@@ -2326,7 +2482,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::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
@@ -2353,8 +2509,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.
@@ -2363,7 +2519,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
@@ -2395,8 +2551,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
@@ -2427,7 +2583,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
@@ -2454,7 +2610,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
@@ -2481,10 +2637,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
@@ -2500,11 +2656,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](https://cloud.google.com/sql/docs/mysql/high-availability).
+        # 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
@@ -2532,7 +2689,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :data_disk_size_gb
       
-        # The type of data disk: **PD_SSD** (default) or **PD_HDD**.
+        # 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]
         attr_accessor :data_disk_type
@@ -2604,6 +2762,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :settings_version
       
+        # SQL Server specific audit configuration.
+        # Corresponds to the JSON property `sqlServerAuditConfig`
+        # @return [Google::Apis::SqladminV1::SqlServerAuditConfig]
+        attr_accessor :sql_server_audit_config
+      
         # Configuration to increase storage size automatically. The default value is
         # true.
         # Corresponds to the JSON property `storageAutoResize`
@@ -2654,6 +2817,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)
@@ -2686,7 +2850,7 @@ module Google
         end
       end
       
-      # External primary instance migration setting error.
+      # External primary instance migration setting error/warning.
       class SqlExternalSyncSettingError
         include Google::Apis::Core::Hashable
       
@@ -2695,7 +2859,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
@@ -2736,6 +2900,77 @@ module Google
         end
       end
       
+      # Instance start external sync request.
+      class SqlInstancesStartExternalSyncRequest
+        include Google::Apis::Core::Hashable
+      
+        # MySQL-specific external server sync settings.
+        # Corresponds to the JSON property `mysqlSyncConfig`
+        # @return [Google::Apis::SqladminV1::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
+      
+      # Instance verify external sync settings request.
+      class SqlInstancesVerifyExternalSyncSettingsRequest
+        include Google::Apis::Core::Hashable
+      
+        # MySQL-specific external server sync settings.
+        # Corresponds to the JSON property `mysqlSyncConfig`
+        # @return [Google::Apis::SqladminV1::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
@@ -2745,7 +2980,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::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
@@ -2772,15 +3007,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. Readers:
-        # -- the Pantheon frontend
+        # 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 Pantheon frontend -- 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
@@ -2835,6 +3070,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
@@ -2922,7 +3182,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
@@ -3035,7 +3295,7 @@ module Google
         # @return [Google::Apis::SqladminV1::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
@@ -3074,7 +3334,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::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
@@ -3090,6 +3350,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
@@ -3104,7 +3391,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :ram
       
-        # This is always *sql#tier*.
+        # This is always **sql#tier**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3115,7 +3402,7 @@ module Google
         attr_accessor :region
       
         # An identifier for the machine type, for example, db-custom-1-3840. For related
-        # information, see Pricing.
+        # information, see [Pricing](/sql/pricing).
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
@@ -3143,7 +3430,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::Tier>]
         attr_accessor :items
       
-        # This is always *sql#tiersList*.
+        # This is always **sql#tiersList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3163,13 +3450,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
@@ -3194,25 +3481,25 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The host name from which the user can connect. For *insert* operations, host
-        # defaults to an empty string. For *update* operations, host is specified as
+        # The host name from which the user can connect. For **insert** operations, host
+        # defaults to an empty string. For **update** operations, host is specified as
         # part of the request URL. The host name cannot be updated after insertion.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
         # The name of the Cloud SQL instance. This does not include the project ID. Can
-        # be omitted for *update* since it is already specified on the URL.
+        # be omitted for **update** since it is already specified on the URL.
         # Corresponds to the JSON property `instance`
         # @return [String]
         attr_accessor :instance
       
-        # This is always *sql#user*.
+        # This is always **sql#user**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # The name of the user in the Cloud SQL instance. Can be omitted for *update*
+        # The name of the user in the Cloud SQL instance. Can be omitted for **update**
         # since it is already specified in the URL.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -3224,8 +3511,8 @@ module Google
         attr_accessor :password
       
         # The project ID of the project containing the Cloud SQL database. The Google
-        # apps domain is prefixed if applicable. Can be omitted for *update* since it is
-        # already specified on the URL.
+        # apps domain is prefixed if applicable. Can be omitted for **update** since it
+        # is already specified on the URL.
         # Corresponds to the JSON property `project`
         # @return [String]
         attr_accessor :project
@@ -3268,7 +3555,7 @@ module Google
         # @return [Array<Google::Apis::SqladminV1::User>]
         attr_accessor :items
       
-        # This is always *sql#usersList*.
+        # This is always **sql#usersList**.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind