google-apis-sqladmin_v1beta4 0.13.0 → 0.17.0

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

@@ -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
@@ -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
@@ -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
@@ -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
@@ -565,15 +574,15 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The name of the flag. These flags are passed at instance startup, so include
-        # both server options and system variables for MySQL. Flags are specified with
-        # underscores, not hyphens. For more information, see Configuring Database Flags
-        # in the Cloud SQL documentation.
+        # 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.
         # 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
@@ -605,6 +614,12 @@ 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.
@@ -615,9 +630,10 @@ module Google
         # 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*, or *POSTGRES_13* (default). SQL Server instances:
-        # *SQLSERVER_2017_STANDARD* (default), *SQLSERVER_2017_ENTERPRISE*, *
-        # SQLSERVER_2017_EXPRESS*, or *SQLSERVER_2017_WEB*.
+        # *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
@@ -638,8 +654,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The name and status of the failover replica. This property is applicable only
-        # to Second Generation instances.
+        # The name and status of the failover replica.
         # Corresponds to the JSON property `failoverReplica`
         # @return [Google::Apis::SqladminV1beta4::DatabaseInstance::FailoverReplica]
         attr_accessor :failover_replica
@@ -793,6 +808,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)
@@ -825,8 +841,7 @@ module Google
           @suspension_reason = args[:suspension_reason] if args.key?(:suspension_reason)
         end
         
-        # The name and status of the failover replica. This property is applicable only
-        # to Second Generation instances.
+        # The name and status of the failover replica.
         class FailoverReplica
           include Google::Apis::Core::Hashable
         
@@ -840,7 +855,7 @@ module Google
         
           # The name of the failover replica. If specified at instance creation, a
           # failover replica is created for the instance. The name doesn't include the
-          # project ID. This property is applicable only to Second Generation instances.
+          # project ID.
           # Corresponds to the JSON property `name`
           # @return [String]
           attr_accessor :name
@@ -886,7 +901,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
@@ -927,13 +942,18 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::DemoteMasterConfiguration]
         attr_accessor :replica_configuration
       
-        # Verify GTID consistency for demote operation. Default value: *True*. Second
-        # Generation instances only. 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 only if you know the reason for
-        # the GTID divergence and are confident that doing so will not cause any
-        # replication issues.
+        # 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 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
@@ -948,6 +968,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
@@ -973,7 +994,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
@@ -1046,7 +1067,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
@@ -1071,7 +1092,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
@@ -1096,27 +1117,27 @@ 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
@@ -1138,9 +1159,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
@@ -1160,10 +1181,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]
@@ -1175,6 +1219,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
@@ -1216,11 +1264,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
@@ -1273,13 +1321,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
@@ -1290,23 +1338,23 @@ 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
@@ -1318,9 +1366,9 @@ module Google
         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
@@ -1353,7 +1401,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
@@ -1433,16 +1481,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
@@ -1452,15 +1501,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
@@ -1502,8 +1551,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]
@@ -1544,6 +1593,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]
@@ -1556,6 +1628,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
@@ -1572,8 +1648,8 @@ module Google
         attr_accessor :query_insights_enabled
         alias_method :query_insights_enabled?, :query_insights_enabled
       
-        # Number of query plans generated by Insights per minute. Default is 5. Changing
-        # this will restart the database.
+        # Number of query execution plans captured by Insights per minute for all
+        # queries combined. Default is 5.
         # Corresponds to the JSON property `queryPlansPerMinute`
         # @return [Fixnum]
         attr_accessor :query_plans_per_minute
@@ -1612,6 +1688,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
@@ -1838,9 +1947,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
@@ -1852,8 +1971,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]
@@ -1871,6 +1990,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)
@@ -1887,17 +2007,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
@@ -1914,11 +2034,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
       
@@ -1928,7 +2046,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
@@ -1973,12 +2091,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
@@ -2030,7 +2150,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
@@ -2082,6 +2202,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
@@ -2122,6 +2261,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]
@@ -2140,6 +2284,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
@@ -2155,8 +2300,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
@@ -2176,13 +2321,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
@@ -2194,9 +2339,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
@@ -2206,14 +2352,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
@@ -2272,7 +2418,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
@@ -2303,7 +2449,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
@@ -2319,7 +2465,7 @@ module Google
         end
       end
       
-      # Database instance list operations response.
+      # Operations list response.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable
       
@@ -2397,8 +2543,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
@@ -2483,10 +2629,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
@@ -2502,11 +2648,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
@@ -2534,7 +2681,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]
@@ -2568,16 +2715,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
@@ -2588,14 +2733,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]
@@ -2609,6 +2754,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`
@@ -2622,7 +2772,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
@@ -2659,6 +2809,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)
@@ -2741,6 +2892,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
@@ -2777,14 +2999,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
@@ -2839,6 +3062,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
@@ -2909,14 +3157,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
@@ -2926,7 +3174,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
@@ -3094,6 +3342,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