google-apis-sqladmin_v1 0.56.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0bcc7df6c85ee79128cbf93aaf306b8236ae2f095b741b84cd085d6bedc3dd5
-  data.tar.gz: 979b4b1418357db3d1abb4b9da7889f61151e56aca72ef3485a9235ae1537179
+  metadata.gz: c708c73467e7a2bd1e611c63327f89ecb83740bb5ce7dc92ca7447eddd4ffc04
+  data.tar.gz: ed5e91a2a329803473a6675f0c3648a33275731f8c7e60ad5aac98e42360e691
 SHA512:
-  metadata.gz: 1cbbb34479db278de3b263d78f23e0f68570c57ee27696f3990c55e8565213acb4a4ed07c1d2c098fefea19f3863cb1c0d3698727c9e2da5787f3ac99c3f66b4
-  data.tar.gz: 48a1ff2aff0e4eb12e3730677f45f17bd2c0832541a41e97fc5ae43f5416b85ab313c50e425b8979d6facd8af3a269d38690af1d79d5f0d33d0ed7d3b416ee53
+  metadata.gz: f3183d1e82bc8ffea65f40b4062b6b8baf94f99629bae3a9284ab491d870fddcf63e2fafc32843606bd23cb082cdb8c061e6c41e3024c88008f85dde5c373d35
+  data.tar.gz: 2ef16ce56bf9516484fae8e2b86ff126b779a35fb932fc8d3caa6043016fe929169a700627318e887dce1947fd5d8ddfc720b79b1c8532b5f8f1da837f9cc0b5

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-sqladmin_v1
 
+### v0.58.0 (2024-05-05)
+
+* Regenerated from discovery document revision 20240425
+
+### v0.57.0 (2024-03-31)
+
+* Regenerated from discovery document revision 20240324
+
 ### v0.56.0 (2024-03-24)
 
 * Regenerated from discovery document revision 20240317

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

@@ -207,7 +207,7 @@ module Google
         attr_accessor :transaction_log_retention_days
       
         # Output only. This value contains the storage location of transactional logs
-        # for the database for point-in-time recovery.
+        # used to perform point-in-time recovery (PITR) for the database.
         # Corresponds to the JSON property `transactionalLogStorageState`
         # @return [String]
         attr_accessor :transactional_log_storage_state
@@ -839,7 +839,7 @@ module Google
         # @return [String]
         attr_accessor :gce_zone
       
-        # Gemini configuration.
+        # Gemini instance configuration.
         # Corresponds to the JSON property `geminiConfig`
         # @return [Google::Apis::SqladminV1::GeminiInstanceConfig]
         attr_accessor :gemini_config
@@ -929,7 +929,9 @@ module Google
         # @return [Array<String>]
         attr_accessor :replica_names
       
-        # Primary-DR replica pair
+        # A primary instance and disaster recovery (DR) replica pair. A DR replica is a
+        # cross-region replica that you designate for failover in the event that the
+        # primary instance experiences regional failure. Only applicable to MySQL.
         # Corresponds to the JSON property `replicationCluster`
         # @return [Google::Apis::SqladminV1::ReplicationCluster]
         attr_accessor :replication_cluster
@@ -1741,41 +1743,41 @@ module Google
         end
       end
       
-      # Gemini configuration.
+      # Gemini instance configuration.
       class GeminiInstanceConfig
         include Google::Apis::Core::Hashable
       
-        # Output only. Whether active query is enabled.
+        # Output only. Whether the active query is enabled.
         # Corresponds to the JSON property `activeQueryEnabled`
         # @return [Boolean]
         attr_accessor :active_query_enabled
         alias_method :active_query_enabled?, :active_query_enabled
       
-        # Output only. Whether gemini is enabled.
+        # Output only. Whether Gemini is enabled.
         # Corresponds to the JSON property `entitled`
         # @return [Boolean]
         attr_accessor :entitled
         alias_method :entitled?, :entitled
       
-        # Output only. Whether flag recommender is enabled.
+        # Output only. Whether the flag recommender is enabled.
         # Corresponds to the JSON property `flagRecommenderEnabled`
         # @return [Boolean]
         attr_accessor :flag_recommender_enabled
         alias_method :flag_recommender_enabled?, :flag_recommender_enabled
       
-        # Output only. Whether vacuum management is enabled.
+        # Output only. Whether the vacuum management is enabled.
         # Corresponds to the JSON property `googleVacuumMgmtEnabled`
         # @return [Boolean]
         attr_accessor :google_vacuum_mgmt_enabled
         alias_method :google_vacuum_mgmt_enabled?, :google_vacuum_mgmt_enabled
       
-        # Output only. Whether index advisor is enabled.
+        # Output only. Whether the index advisor is enabled.
         # Corresponds to the JSON property `indexAdvisorEnabled`
         # @return [Boolean]
         attr_accessor :index_advisor_enabled
         alias_method :index_advisor_enabled?, :index_advisor_enabled
       
-        # Output only. Whether oom session cancel is enabled.
+        # Output only. Whether canceling the out-of-memory (OOM) session is enabled.
         # Corresponds to the JSON property `oomSessionCancelEnabled`
         # @return [Boolean]
         attr_accessor :oom_session_cancel_enabled
@@ -1890,6 +1892,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # Optional. Options for importing data from SQL statements.
+        # Corresponds to the JSON property `sqlImportOptions`
+        # @return [Google::Apis::SqladminV1::ImportContext::SqlImportOptions]
+        attr_accessor :sql_import_options
+      
         # 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
@@ -1910,6 +1917,7 @@ module Google
           @file_type = args[:file_type] if args.key?(:file_type)
           @import_user = args[:import_user] if args.key?(:import_user)
           @kind = args[:kind] if args.key?(:kind)
+          @sql_import_options = args[:sql_import_options] if args.key?(:sql_import_options)
           @uri = args[:uri] if args.key?(:uri)
         end
         
@@ -2068,6 +2076,32 @@ module Google
             @table = args[:table] if args.key?(:table)
           end
         end
+        
+        # Optional. Options for importing data from SQL statements.
+        class SqlImportOptions
+          include Google::Apis::Core::Hashable
+        
+          # Optional. Whether or not the import should be parallel.
+          # Corresponds to the JSON property `parallel`
+          # @return [Boolean]
+          attr_accessor :parallel
+          alias_method :parallel?, :parallel
+        
+          # Optional. The number of threads to use for parallel import.
+          # Corresponds to the JSON property `threads`
+          # @return [Fixnum]
+          attr_accessor :threads
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @parallel = args[:parallel] if args.key?(:parallel)
+            @threads = args[:threads] if args.key?(:threads)
+          end
+        end
       end
       
       # Insights configuration. This specifies when Cloud SQL Insights feature is
@@ -2481,31 +2515,31 @@ module Google
         # @return [Google::Apis::SqladminV1::PscConfig]
         attr_accessor :psc_config
       
-        # Use `ssl_mode` instead for MySQL and PostgreSQL. SQL Server uses this flag.
-        # Whether SSL/TLS connections over IP are enforced. If set to false, then allow
-        # both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the
-        # client certificate won't be verified. If set to true, then only allow
-        # connections encrypted with SSL/TLS and with valid client certificates. If you
-        # want to enforce SSL/TLS without enforcing the requirement for valid client
-        # certificates, then use the `ssl_mode` flag instead of the `require_ssl` flag.
+        # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If
+        # set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/
+        # TLS connections, the client certificate won't be verified. If set to true,
+        # then only allow connections encrypted with SSL/TLS and with valid client
+        # certificates. If you want to enforce SSL/TLS without enforcing the requirement
+        # for valid client certificates, then use the `ssl_mode` flag instead of the `
+        # require_ssl` flag.
         # Corresponds to the JSON property `requireSsl`
         # @return [Boolean]
         attr_accessor :require_ssl
         alias_method :require_ssl?, :require_ssl
       
-        # Specify how SSL/TLS is enforced in database connections. MySQL and PostgreSQL
-        # use the `ssl_mode` flag. If you must use the `require_ssl` flag for backward
-        # compatibility, then only the following value pairs are valid: * `ssl_mode=
+        # Specify how SSL/TLS is enforced in database connections. If you must use the `
+        # require_ssl` flag for backward compatibility, then only the following value
+        # pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=
         # ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=
         # ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=
-        # TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` The value of `
-        # ssl_mode` gets priority over the value of `require_ssl`. For example, for the
-        # pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, the `ssl_mode=
-        # ENCRYPTED_ONLY` means only accept SSL connections, while the `require_ssl=
-        # false` means accept both non-SSL and SSL connections. MySQL and PostgreSQL
-        # databases respect `ssl_mode` in this case and accept only SSL connections. SQL
-        # Server uses the `require_ssl` flag. You can set the value for this flag to `
-        # true` or `false`.
+        # TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `
+        # ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=
+        # ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority
+        # over the value of `require_ssl`. For example, for the pair `ssl_mode=
+        # ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means
+        # accept only SSL connections, while `require_ssl=false` means accept both non-
+        # SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `
+        # ssl_mode` and accepts only SSL connections.
         # Corresponds to the JSON property `sslMode`
         # @return [String]
         attr_accessor :ssl_mode
@@ -3274,12 +3308,14 @@ module Google
         end
       end
       
-      # Primary-DR replica pair
+      # A primary instance and disaster recovery (DR) replica pair. A DR replica is a
+      # cross-region replica that you designate for failover in the event that the
+      # primary instance experiences regional failure. Only applicable to MySQL.
       class ReplicationCluster
         include Google::Apis::Core::Hashable
       
-        # Output only. read-only field that indicates if the replica is a dr_replica;
-        # not set for a primary.
+        # Output only. Read-only field that indicates whether the replica is a DR
+        # replica. This field is not set if the instance is a primary instance.
         # Corresponds to the JSON property `drReplica`
         # @return [Boolean]
         attr_accessor :dr_replica
@@ -3288,8 +3324,9 @@ module Google
         # Optional. If the instance is a primary instance, then this field identifies
         # the disaster recovery (DR) replica. A DR replica is an optional configuration
         # for Enterprise Plus edition instances. If the instance is a read replica, then
-        # the field is not set. Users can set this field to set a designated DR replica
-        # for a primary. Removing this field removes the DR replica.
+        # the field is not set. Set this field to a replica name to designate a DR
+        # replica for a primary instance. Remove the replica name to remove the DR
+        # replica designation.
         # Corresponds to the JSON property `failoverDrReplicaName`
         # @return [String]
         attr_accessor :failover_dr_replica_name
@@ -3834,8 +3871,9 @@ module Google
       class SqlInstancesStartExternalSyncRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. MigrationType decides if the migration is a physical file based
-        # migration or logical migration.
+        # Optional. MigrationType configures the migration to use physical files or
+        # logical dump files. If not set, then the logical dump file configuration is
+        # used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
         # Corresponds to the JSON property `migrationType`
         # @return [String]
         attr_accessor :migration_type
@@ -3880,8 +3918,9 @@ module Google
       class SqlInstancesVerifyExternalSyncSettingsRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. MigrationType decides if the migration is a physical file based
-        # migration or logical migration
+        # Optional. MigrationType configures the migration to use physical files or
+        # logical dump files. If not set, then the logical dump file configuration is
+        # used. Valid values are `LOGICAL` or `PHYSICAL`. Only applicable to MySQL.
         # Corresponds to the JSON property `migrationType`
         # @return [String]
         attr_accessor :migration_type
@@ -3896,8 +3935,7 @@ module Google
         # @return [String]
         attr_accessor :sync_mode
       
-        # Optional. Parallel level for initial data sync. Currently only applicable for
-        # PostgreSQL.
+        # Optional. Parallel level for initial data sync. Only applicable for PostgreSQL.
         # Corresponds to the JSON property `syncParallelLevel`
         # @return [String]
         attr_accessor :sync_parallel_level

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SqladminV1
       # Version of the google-apis-sqladmin_v1 gem
-      GEM_VERSION = "0.56.0"
+      GEM_VERSION = "0.58.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240317"
+      REVISION = "20240425"
     end
   end
 end

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

@@ -270,6 +270,12 @@ module Google
         
           include Google::Apis::Core::JsonObjectSupport
         end
+        
+        class SqlImportOptions
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
       
         include Google::Apis::Core::JsonObjectSupport
       end
@@ -1136,6 +1142,8 @@ module Google
           property :file_type, as: 'fileType'
           property :import_user, as: 'importUser'
           property :kind, as: 'kind'
+          property :sql_import_options, as: 'sqlImportOptions', class: Google::Apis::SqladminV1::ImportContext::SqlImportOptions, decorator: Google::Apis::SqladminV1::ImportContext::SqlImportOptions::Representation
+      
           property :uri, as: 'uri'
         end
         
@@ -1173,6 +1181,14 @@ module Google
             property :table, as: 'table'
           end
         end
+        
+        class SqlImportOptions
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :parallel, as: 'parallel'
+            property :threads, as: 'threads'
+          end
+        end
       end
       
       class InsightsConfig

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

@@ -1056,16 +1056,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Promotes the read replica instance to be a stand-alone Cloud SQL instance.
-        # Using this operation might cause your instance to restart.
+        # Promotes the read replica instance to be an independent Cloud SQL primary
+        # instance. Using this operation might cause your instance to restart.
         # @param [String] project
         #   ID of the project that contains the read replica.
         # @param [String] instance
         #   Cloud SQL read replica instance name.
         # @param [Boolean] failover
-        #   Set to true if the promote operation should attempt to re-add the original
-        #   primary as a replica when it comes back online. Otherwise, if this value is
-        #   false or not set, the original primary will be a standalone instance.
+        #   Set to true to invoke a replica failover to the designated DR replica. As part
+        #   of replica failover, the promote operation attempts to add the original
+        #   primary instance as a replica of the promoted DR replica when the original
+        #   primary instance comes back online. If set to false or not specified, then the
+        #   original primary instance becomes an independent Cloud SQL primary instance.
+        #   Only applicable to MySQL.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1373,7 +1376,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Switches over from the primary instance to the replica instance.
+        # Switches over from the primary instance to the designated DR replica instance.
         # @param [String] project
         #   ID of the project that contains the replica.
         # @param [String] instance

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-sqladmin_v1
 version: !ruby/object:Gem::Version
-  version: 0.56.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-24 00:00:00.000000000 Z
+date: 2024-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.56.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.58.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1
 post_install_message: 
 rdoc_options: []