google-apis-sqladmin_v1beta4 0.55.0 → 0.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f831ddc53f19977ea48b0487da72fa48210e84ee0d35fc355e139825256fad2
-  data.tar.gz: bf9570a1036540d018ad00200902f2937b712616acb999a0b5068fd4d7c9d4e4
+  metadata.gz: f6b06d6236c0532fe4a92184d552a10241d43613f0a30643d98111b8dd13ffd2
+  data.tar.gz: e48126490b1bfb6ea99ae7809acdfc327802b727bf166597eb39eca61befecc7
 SHA512:
-  metadata.gz: 9a26cebc05914e04d4cb81843fef078d9decb1119cf9d0baed272f043a581ea806feecc3e280707cfeecb0e8790610df5d68bf175565175d484bce1b666003ed
-  data.tar.gz: 500b952e707c871f73c7a40c741edd73e26a589f8da844d5fa7f336ee82a22def322d4158e696ab2b42704c3512dc0bbf27b1c369fcf9c0e35d291b522741fe6
+  metadata.gz: 3d49d36d3ba609c68d575cd0e39cd405ea71858407cc5653d2bc56651442198ec828e80f0a3b56505e0952b99caa9e41b4cb3e90b7ebade0b0baf061568cc7a0
+  data.tar.gz: cf79d467f0fb1d4324f6a5ee1659419a0167fa09f1786e94d8825fa388654f32f952246ee7b4c9b8afa8b90048805c917d3043661164216ffacf4b749a75b2e4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-sqladmin_v1beta4
 
+### v0.57.0 (2023-10-22)
+
+* Regenerated from discovery document revision 20231017
+
+### v0.56.0 (2023-10-08)
+
+* Regenerated from discovery document revision 20231004
+
 ### v0.55.0 (2023-09-10)
 
 * Regenerated from discovery document revision 20230831

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

@@ -844,7 +844,7 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::SqlOutOfDiskReport]
         attr_accessor :out_of_disk_report
       
-        # Output only. The dns name of the primary instance in a replication group.
+        # Output only. DEPRECATED: please use write_endpoint instead.
         # Corresponds to the JSON property `primaryDnsName`
         # @return [String]
         attr_accessor :primary_dns_name
@@ -934,6 +934,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :suspension_reason
       
+        # Output only. The dns name of the primary instance in a replication group.
+        # Corresponds to the JSON property `writeEndpoint`
+        # @return [String]
+        attr_accessor :write_endpoint
+      
         def initialize(**args)
            update!(**args)
         end
@@ -979,6 +984,7 @@ module Google
           @settings = args[:settings] if args.key?(:settings)
           @state = args[:state] if args.key?(:state)
           @suspension_reason = args[:suspension_reason] if args.key?(:suspension_reason)
+          @write_endpoint = args[:write_endpoint] if args.key?(:write_endpoint)
         end
         
         # The name and status of the failover replica.
@@ -1779,14 +1785,17 @@ module Google
           attr_accessor :recovery_only
           alias_method :recovery_only?, :recovery_only
         
-          # Optional. StopAt keyword for transaction log import, Applies to Cloud SQL for
-          # SQL Server only
+          # Optional. The timestamp when the import should stop. This timestamp is in the [
+          # RFC 3339](https://tools.ietf.org/html/rfc3339) format (for example, `2023-10-
+          # 01T16:19:00.094`). This field is equivalent to the STOPAT keyword and applies
+          # to Cloud SQL for SQL Server only.
           # Corresponds to the JSON property `stopAt`
           # @return [String]
           attr_accessor :stop_at
         
-          # Optional. StopAtMark keyword for transaction log import, Applies to Cloud SQL
-          # for SQL Server only
+          # Optional. The marked transaction where the import should stop. This field is
+          # equivalent to the STOPATMARK keyword and applies to Cloud SQL for SQL Server
+          # only.
           # Corresponds to the JSON property `stopAtMark`
           # @return [String]
           attr_accessor :stop_at_mark
@@ -2274,12 +2283,35 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::PscConfig]
         attr_accessor :psc_config
       
-        # Whether SSL connections over IP are enforced or not.
+        # 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 legacy `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. This flag is
+        # supported only for PostgreSQL. Use the legacy `require_ssl` flag for enforcing
+        # SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, use the `ssl_mode` flag
+        # instead of the legacy `require_ssl` flag. To avoid the conflict between those
+        # flags in PostgreSQL, only the following value pairs are valid: * `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` Note that the
+        # value of `ssl_mode` gets priority over the value of the legacy `require_ssl`.
+        # For example, for the pair `ssl_mode=ENCRYPTED_ONLY, require_ssl=false`, the `
+        # ssl_mode=ENCRYPTED_ONLY` means "only accepts SSL connection", while the `
+        # require_ssl=false` means "both non-SSL and SSL connections are allowed". The
+        # database respects `ssl_mode` in this case and only accepts SSL connections.
+        # Corresponds to the JSON property `sslMode`
+        # @return [String]
+        attr_accessor :ssl_mode
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2293,10 +2325,11 @@ module Google
           @private_network = args[:private_network] if args.key?(:private_network)
           @psc_config = args[:psc_config] if args.key?(:psc_config)
           @require_ssl = args[:require_ssl] if args.key?(:require_ssl)
+          @ssl_mode = args[:ssl_mode] if args.key?(:ssl_mode)
         end
       end
       
-      # Database instance IP Mapping.
+      # Database instance IP mapping
       class IpMapping
         include Google::Apis::Core::Hashable
       
@@ -2954,10 +2987,10 @@ module Google
       class PscConfig
         include Google::Apis::Core::Hashable
       
-        # List of consumer projects that are allow-listed for PSC connections to this
-        # instance. This instance can be connected to with PSC from any network in these
-        # projects. Each consumer project in this list may be represented by a project
-        # number (numeric) or by a project id (alphanumeric).
+        # Optional. The list of consumer projects that are allow-listed for PSC
+        # connections to this instance. This instance can be connected to with PSC from
+        # any network in these projects. Each consumer project in this list may be
+        # represented by a project number (numeric) or by a project id (alphanumeric).
         # Corresponds to the JSON property `allowedConsumerProjects`
         # @return [Array<String>]
         attr_accessor :allowed_consumer_projects
@@ -2983,6 +3016,14 @@ module Google
       class ReplicaConfiguration
         include Google::Apis::Core::Hashable
       
+        # Optional. Specifies if a SQL Server replica is a cascadable replica. A
+        # cascadable replica is a SQL Server cross region replica that supports replica(
+        # s) under it.
+        # Corresponds to the JSON property `cascadableReplica`
+        # @return [Boolean]
+        attr_accessor :cascadable_replica
+        alias_method :cascadable_replica?, :cascadable_replica
+      
         # 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
@@ -3009,6 +3050,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @cascadable_replica = args[:cascadable_replica] if args.key?(:cascadable_replica)
           @failover_target = args[:failover_target] if args.key?(:failover_target)
           @kind = args[:kind] if args.key?(:kind)
           @mysql_replica_configuration = args[:mysql_replica_configuration] if args.key?(:mysql_replica_configuration)

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SqladminV1beta4
       # Version of the google-apis-sqladmin_v1beta4 gem
-      GEM_VERSION = "0.55.0"
+      GEM_VERSION = "0.57.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230831"
+      REVISION = "20231017"
     end
   end
 end

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

@@ -847,6 +847,7 @@ module Google
       
           property :state, as: 'state'
           collection :suspension_reason, as: 'suspensionReason'
+          property :write_endpoint, as: 'writeEndpoint'
         end
         
         class FailoverReplica
@@ -1214,6 +1215,7 @@ module Google
           property :psc_config, as: 'pscConfig', class: Google::Apis::SqladminV1beta4::PscConfig, decorator: Google::Apis::SqladminV1beta4::PscConfig::Representation
       
           property :require_ssl, as: 'requireSsl'
+          property :ssl_mode, as: 'sslMode'
         end
       end
       
@@ -1392,6 +1394,7 @@ module Google
       class ReplicaConfiguration
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cascadable_replica, as: 'cascadableReplica'
           property :failover_target, as: 'failoverTarget'
           property :kind, as: 'kind'
           property :mysql_replica_configuration, as: 'mysqlReplicaConfiguration', class: Google::Apis::SqladminV1beta4::MySqlReplicaConfiguration, decorator: Google::Apis::SqladminV1beta4::MySqlReplicaConfiguration::Representation

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

@@ -679,7 +679,7 @@ module Google
         # @param [String] project
         #   Project ID of the project that contains the instance to be exported.
         # @param [String] instance
-        #   Cloud SQL instance ID. This does not include the project ID.
+        #   The Cloud SQL instance ID. This doesn't include the project ID.
         # @param [Google::Apis::SqladminV1beta4::ExportInstancesRequest] export_instances_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -984,6 +984,10 @@ module Google
         #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1001,12 +1005,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def promote_instance_replica(project, instance, fields: nil, quota_user: nil, options: nil, &block)
+        def promote_instance_replica(project, instance, failover: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'sql/v1beta4/projects/{project}/instances/{instance}/promoteReplica', options)
           command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
           command.response_class = Google::Apis::SqladminV1beta4::Operation
           command.params['project'] = project unless project.nil?
           command.params['instance'] = instance unless instance.nil?
+          command.query['failover'] = failover unless failover.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1255,6 +1260,44 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Switches over from the primary instance to a replica instance.
+        # @param [String] project
+        #   ID of the project that contains the replica.
+        # @param [String] instance
+        #   Cloud SQL read replica instance name.
+        # @param [String] db_timeout
+        #   Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum
+        #   of all database operations. Default value is 10 minutes and can be modified to
+        #   a maximum value of 24 hours.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqladminV1beta4::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def switchover_instance(project, instance, db_timeout: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'sql/v1beta4/projects/{project}/instances/{instance}/switchover', options)
+          command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqladminV1beta4::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.nil?
+          command.query['dbTimeout'] = db_timeout unless db_timeout.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Truncate MySQL general and slow query log tables MySQL only.
         # @param [String] project
         #   Project ID of the Cloud SQL project.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-sqladmin_v1beta4
 version: !ruby/object:Gem::Version
-  version: 0.55.0
+  version: 0.57.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-10 00:00:00.000000000 Z
+date: 2023-10-22 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_v1beta4/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.55.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.57.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1beta4
 post_install_message: 
 rdoc_options: []