google-apis-sqladmin_v1 0.43.0 → 0.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed996052ee62c4a7495de29d2cf9ad58f0a028f067ec3dd442b938f6a86cab58
-  data.tar.gz: 5c1ed594319353b40d311f4282ec9633872ee6b60d6bd6656cef699add19af4e
+  metadata.gz: 61eec3cbe925b9bcb0252ccfc07def1f4a2a5200e42ba573fc05e8e62b6a8373
+  data.tar.gz: 3c91e2cb1ea79058a100dd8205b845137a7e2cfb9f797ecfde872b2b1faa9df2
 SHA512:
-  metadata.gz: bd01320016b012fd6fd2a859f5b3c30a82e57b58750f5b819f3e7b1b9b4f981017ac961346d8e7c55ec70709d415763c6ddb9f6d976760d955d1569d9ef491b7
-  data.tar.gz: aa092305b5a75a3dec4cb8d40c20dbdd07f258014fb0205ef889e129e8ddb2f581ec0eec96021fa75782ebaef1121aa076e54655f8714482e43e2f734eb07c8e
+  metadata.gz: 2333984ab0e56ab9b0b242a130e53495d3f0e2fbc9616b3ff973654ed80e1926fd7b46451a514cbc026f1a5b53c3bb4ea38c392ef0530362a61ab936de476f2f
+  data.tar.gz: 322d02a0701e99efc6b436a87512bf7d5572a702f2cf561844c2ca816ebdc749688f2a689c835e62f60096a8b76396ad9f347304ef52e92e187368acfaa2b5ee

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-sqladmin_v1
 
+### v0.45.0 (2023-10-22)
+
+* Regenerated from discovery document revision 20231017
+
+### 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.
@@ -1778,14 +1784,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
@@ -2273,12 +2282,35 @@ module Google
         # @return [Google::Apis::SqladminV1::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
@@ -2292,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
       
@@ -2953,10 +2986,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 +3015,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 +3049,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.45.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_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
       
@@ -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::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.45.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_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.45.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1
 post_install_message: 
 rdoc_options: []