google-apis-sqladmin_v1beta4 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0ac53ebb79824560db6d97353744b8221b10ae306cb3866751a810f2975874d
-  data.tar.gz: c02368a61a9a360b6588e941b435114fd52ac668c7c70fba4027051ef36d1450
+  metadata.gz: e5fdd518376963f34ca7f26080f6ed97ba4ededfc2362887cd646796dae54f42
+  data.tar.gz: 7378317a7ae01525dc2cc5ea4c49c617ea7ba322f838b46c54f8e3a37753e2ad
 SHA512:
-  metadata.gz: '007168a51fbaef3c702abaf450cf283b87c999c588fe8cedb5abd46cfedc434fc070b24d61fe932103534024248017b8f14ad3f982ec5f30697d8ebb196dc9fe'
-  data.tar.gz: 64466f40458095f1740efd68e0dc45f0da432c27c651c3ff6ddc799b0276624e6f7e6cc02a120010a89287d2ed3435f18b7f714d25833248d6bae3cad0a10e01
+  metadata.gz: 5f0c47c2d136f131b3293ef3d2d5095cabda9fc13a393f8817f636f71bc66613e4a3849ccf768059b4c9e9aa8aa0fcf18f567e45622fbdf15ada0fdf36c6a995
+  data.tar.gz: c1db8465bb597698cce76b564f0b294338c95b01b5bcc2bdd692cc4987f1d175a590ca7246607155dc25fcdb0fd231f32d6ed68a74b0ea157cfbcd9f209df86e

data/CHANGELOG.md

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

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

@@ -844,6 +844,11 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::SqlOutOfDiskReport]
         attr_accessor :out_of_disk_report
       
+        # Output only. DEPRECATED: please use write_endpoint instead.
+        # Corresponds to the JSON property `primaryDnsName`
+        # @return [String]
+        attr_accessor :primary_dns_name
+      
         # The project ID of the project containing the Cloud SQL instance. The Google
         # apps domain is prefixed if applicable.
         # Corresponds to the JSON property `project`
@@ -929,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
@@ -958,6 +968,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @on_premises_configuration = args[:on_premises_configuration] if args.key?(:on_premises_configuration)
           @out_of_disk_report = args[:out_of_disk_report] if args.key?(:out_of_disk_report)
+          @primary_dns_name = args[:primary_dns_name] if args.key?(:primary_dns_name)
           @project = args[:project] if args.key?(:project)
           @psc_service_attachment_link = args[:psc_service_attachment_link] if args.key?(:psc_service_attachment_link)
           @region = args[:region] if args.key?(:region)
@@ -973,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.
@@ -2268,12 +2280,37 @@ module Google
         # @return [Google::Apis::SqladminV1beta4::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
@@ -2287,10 +2324,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
       
@@ -2344,7 +2382,8 @@ module Google
         attr_accessor :kind
       
         # The preferred Compute Engine zone for the secondary/failover (for example: us-
-        # central1-a, us-central1-b, etc.).
+        # central1-a, us-central1-b, etc.). To disable this field, set it to '
+        # no_secondary_zone'.
         # Corresponds to the JSON property `secondaryZone`
         # @return [String]
         attr_accessor :secondary_zone
@@ -2881,6 +2920,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]
@@ -2916,6 +2962,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)
@@ -2947,10 +2994,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
@@ -2976,6 +3023,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
@@ -3002,6 +3057,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.54.0"
+      GEM_VERSION = "0.56.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 = "20230721"
+      REVISION = "20231004"
     end
   end
 end

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

@@ -827,6 +827,7 @@ module Google
       
           property :out_of_disk_report, as: 'outOfDiskReport', class: Google::Apis::SqladminV1beta4::SqlOutOfDiskReport, decorator: Google::Apis::SqladminV1beta4::SqlOutOfDiskReport::Representation
       
+          property :primary_dns_name, as: 'primaryDnsName'
           property :project, as: 'project'
           property :psc_service_attachment_link, as: 'pscServiceAttachmentLink'
           property :region, as: 'region'
@@ -846,6 +847,7 @@ module Google
       
           property :state, as: 'state'
           collection :suspension_reason, as: 'suspensionReason'
+          property :write_endpoint, as: 'writeEndpoint'
         end
         
         class FailoverReplica
@@ -1213,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
       
@@ -1365,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'
@@ -1391,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::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.54.0
+  version: 0.56.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-06 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_v1beta4/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.54.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.56.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1beta4
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud SQL Admin API V1beta4