google-apis-sqladmin_v1 0.43.0 → 0.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed996052ee62c4a7495de29d2cf9ad58f0a028f067ec3dd442b938f6a86cab58
-  data.tar.gz: 5c1ed594319353b40d311f4282ec9633872ee6b60d6bd6656cef699add19af4e
+  metadata.gz: 7de21da4e3fc0b629989a9179b1cc13e83a316445c17a3cedabcf219bb114669
+  data.tar.gz: 1cb216841ce13a33bf04bd1ce58998571c131238ddc20c24969638bfa53ad401
 SHA512:
-  metadata.gz: bd01320016b012fd6fd2a859f5b3c30a82e57b58750f5b819f3e7b1b9b4f981017ac961346d8e7c55ec70709d415763c6ddb9f6d976760d955d1569d9ef491b7
-  data.tar.gz: aa092305b5a75a3dec4cb8d40c20dbdd07f258014fb0205ef889e129e8ddb2f581ec0eec96021fa75782ebaef1121aa076e54655f8714482e43e2f734eb07c8e
+  metadata.gz: 10ff88a1db84bd389b4e18ec7d549fe81030d2f1d173bcbe8727124c80a410f60abfa7b370a570f8f07470262e80d21cbd657dfabb705f2fec0971dcd38e7f69
+  data.tar.gz: 77818390b4f48ae93c8db67f2c407009862e050545c83fac0c7279d7f1fcf057ffc9eb34a55d13ffc0365d13395c97295823954e82482452ed0aa056914cdc6e

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-sqladmin_v1
 
+### v0.44.0 (2023-10-08)
+
+* Regenerated from discovery document revision 20231004
+
 ### v0.43.0 (2023-09-10)
 
 * Regenerated from discovery document revision 20230831

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

@@ -844,7 +844,7 @@ module Google
         # @return [Google::Apis::SqladminV1::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.
@@ -2273,12 +2279,37 @@ module Google
         # @return [Google::Apis::SqladminV1::PscConfig]
         attr_accessor :psc_config
       
-        # Whether SSL connections over IP are enforced or not.
+        # LINT.IfChange(require_ssl_deprecate) Whether SSL/TLS connections over IP are
+        # enforced or not. If set to false, allow both non-SSL/non-TLS and SSL/TLS
+        # connections. For SSL/TLS connections, the client certificate will not be
+        # verified. If set to true, 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, use the `ssl_mode`
+        # flag instead of the legacy `require_ssl` flag. LINT.ThenChange(//depot/google3/
+        # java/com/google/storage/speckle/boss/admin/actions/InstanceUpdateAction.java:
+        # update_api_temp_fix)
         # Corresponds to the JSON property `requireSsl`
         # @return [Boolean]
         attr_accessor :require_ssl
         alias_method :require_ssl?, :require_ssl
       
+        # Specify how SSL/TLS will be enforced in database connections. This flag is
+        # only supported for PostgreSQL. Use the legacy `require_ssl` flag for enforcing
+        # SSL/TLS in MySQL and SQL Server. But, for PostgreSQL, it is recommended to 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, require_ssl=false; ssl_mode=
+        # ENCRYPTED_ONLY, require_ssl=false; ssl_mode=
+        # TRUSTED_CLIENT_CERTIFICATE_REQUIRED, 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 will respect `ssl_mode` in this case and only accept SSL connections.
+        # Corresponds to the JSON property `sslMode`
+        # @return [String]
+        attr_accessor :ssl_mode
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2292,10 +2323,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
       
@@ -2887,6 +2919,13 @@ module Google
         # @return [String]
         attr_accessor :complexity
       
+        # Disallow credentials that have been previously compromised by a public data
+        # breach.
+        # Corresponds to the JSON property `disallowCompromisedCredentials`
+        # @return [Boolean]
+        attr_accessor :disallow_compromised_credentials
+        alias_method :disallow_compromised_credentials?, :disallow_compromised_credentials
+      
         # Disallow username as a part of the password.
         # Corresponds to the JSON property `disallowUsernameSubstring`
         # @return [Boolean]
@@ -2922,6 +2961,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @complexity = args[:complexity] if args.key?(:complexity)
+          @disallow_compromised_credentials = args[:disallow_compromised_credentials] if args.key?(:disallow_compromised_credentials)
           @disallow_username_substring = args[:disallow_username_substring] if args.key?(:disallow_username_substring)
           @enable_password_policy = args[:enable_password_policy] if args.key?(:enable_password_policy)
           @min_length = args[:min_length] if args.key?(:min_length)
@@ -2953,10 +2993,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
@@ -2982,6 +3022,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
@@ -3008,6 +3056,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_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.43.0"
+      GEM_VERSION = "0.44.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 = "20231004"
     end
   end
 end

data/lib/google/apis/sqladmin_v1/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::SqladminV1::PscConfig, decorator: Google::Apis::SqladminV1::PscConfig::Representation
       
           property :require_ssl, as: 'requireSsl'
+          property :ssl_mode, as: 'sslMode'
         end
       end
       
@@ -1366,6 +1368,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :complexity, as: 'complexity'
+          property :disallow_compromised_credentials, as: 'disallowCompromisedCredentials'
           property :disallow_username_substring, as: 'disallowUsernameSubstring'
           property :enable_password_policy, as: 'enablePasswordPolicy'
           property :min_length, as: 'minLength'
@@ -1392,6 +1395,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::SqladminV1::MySqlReplicaConfiguration, decorator: Google::Apis::SqladminV1::MySqlReplicaConfiguration::Representation

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

@@ -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, 'v1/projects/{project}/instances/{instance}/promoteReplica', options)
           command.response_representation = Google::Apis::SqladminV1::Operation::Representation
           command.response_class = Google::Apis::SqladminV1::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 the 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::SqladminV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqladminV1::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, 'v1/projects/{project}/instances/{instance}/switchover', options)
+          command.response_representation = Google::Apis::SqladminV1::Operation::Representation
+          command.response_class = Google::Apis::SqladminV1::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_v1
 version: !ruby/object:Gem::Version
-  version: 0.43.0
+  version: 0.44.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-10 00:00:00.000000000 Z
+date: 2023-10-08 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.43.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.44.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1
 post_install_message: 
 rdoc_options: []