google-apis-sqladmin_v1beta4 0.69.0 → 0.71.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb6b099a75987926998a939edd8e1c313ec1fcf8a4dcc2db429ab65fbc104dab
-  data.tar.gz: 58b99dec46ef9c3c6b275f94964b746a2edcfdca95369e15edd493b67b4d8a8a
+  metadata.gz: 726ac1828dd3d32a5a303719f7ecba21f98e4d88e370613ad5f51f77beefb635
+  data.tar.gz: 68d1ac150279f2ef8f7fe6d13a2da4508b779bb64982d435e933a52c89d05b37
 SHA512:
-  metadata.gz: eec7acef090b3d6033260fc28cd4245218cb00e573152172299714bd614f34d6b791db37dc51551cf0c9e879b9bcb1bfe9f0691e9bc47c882d5c6df68cd717d6
-  data.tar.gz: 1026d3fa6dba9b9971e9acf847952d318f22eed08c8d6fcaf5e0e702bb8e6288c4ab9ccc37c56f1a929ab1f48f0a99dbe69d39cb6f18803755a3ce15259a2ed1
+  metadata.gz: 52c4d6df5138f826c636c6888d040ab04c8fbd9a94c6c9268e6dd02fdcb78bc2cb8211431931b53db22a726dd9b8bacc9c8a15f56a834f555aa11ca28664261c
+  data.tar.gz: f557de5ad3170a5e61a75ed31eddf183a4113c873eff48c6377be62b6ecd683192a0f203373f5ccde3e542a2a79b43e6092efb9d48c0b78fd42db3a3deff57ea

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-sqladmin_v1beta4
 
+### v0.71.0 (2024-05-26)
+
+* Regenerated from discovery document revision 20240521
+* Regenerated using generator version 0.15.0
+
+### v0.70.0 (2024-05-05)
+
+* Regenerated from discovery document revision 20240425
+
 ### v0.69.0 (2024-03-31)
 
 * Regenerated from discovery document revision 20240324

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

@@ -149,6 +149,38 @@ module Google
         end
       end
       
+      # An available database version. It can be a major or a minor version.
+      class AvailableDatabaseVersion
+        include Google::Apis::Core::Hashable
+      
+        # The database version's display name.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The version's major version name.
+        # Corresponds to the JSON property `majorVersion`
+        # @return [String]
+        attr_accessor :major_version
+      
+        # The database version name. For MySQL 8.0, this string provides the database
+        # major and minor version.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @major_version = args[:major_version] if args.key?(:major_version)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Database instance backup configuration.
       class BackupConfiguration
         include Google::Apis::Core::Hashable
@@ -543,8 +575,15 @@ module Google
         # @return [String]
         attr_accessor :point_in_time
       
-        # Optional. (Point-in-time recovery for PostgreSQL only) Clone to an instance in
-        # the specified zone. If no zone is specified, clone to the same zone as the
+        # Optional. Copy clone and point-in-time recovery clone of a regional instance
+        # in the specified zones. If not specified, clone to the same secondary zone as
+        # the source instance. This value cannot be the same as the preferred_zone field.
+        # Corresponds to the JSON property `preferredSecondaryZone`
+        # @return [String]
+        attr_accessor :preferred_secondary_zone
+      
+        # Optional. Copy clone and point-in-time recovery clone of an instance to the
+        # specified zone. If no zone is specified, clone to the same primary zone as the
         # source instance.
         # Corresponds to the JSON property `preferredZone`
         # @return [String]
@@ -563,6 +602,7 @@ module Google
           @kind = args[:kind] if args.key?(:kind)
           @pitr_timestamp_ms = args[:pitr_timestamp_ms] if args.key?(:pitr_timestamp_ms)
           @point_in_time = args[:point_in_time] if args.key?(:point_in_time)
+          @preferred_secondary_zone = args[:preferred_secondary_zone] if args.key?(:preferred_secondary_zone)
           @preferred_zone = args[:preferred_zone] if args.key?(:preferred_zone)
         end
       end
@@ -839,7 +879,7 @@ module Google
         # @return [String]
         attr_accessor :gce_zone
       
-        # Gemini configuration.
+        # Gemini instance configuration.
         # Corresponds to the JSON property `geminiConfig`
         # @return [Google::Apis::SqladminV1beta4::GeminiInstanceConfig]
         attr_accessor :gemini_config
@@ -929,7 +969,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 has regional failure. Only applicable to MySQL.
         # Corresponds to the JSON property `replicationCluster`
         # @return [Google::Apis::SqladminV1beta4::ReplicationCluster]
         attr_accessor :replication_cluster
@@ -940,7 +982,8 @@ module Google
         # @return [String]
         attr_accessor :root_password
       
-        # The status indicating if instance satisfiesPzs. Reserved for future use.
+        # This status indicates whether the instance satisfies PZS. The status is
+        # reserved for future use.
         # Corresponds to the JSON property `satisfiesPzs`
         # @return [Boolean]
         attr_accessor :satisfies_pzs
@@ -995,6 +1038,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :suspension_reason
       
+        # Output only. All database versions that are available for upgrade.
+        # Corresponds to the JSON property `upgradableDatabaseVersions`
+        # @return [Array<Google::Apis::SqladminV1beta4::AvailableDatabaseVersion>]
+        attr_accessor :upgradable_database_versions
+      
         # Output only. The dns name of the primary instance in a replication group.
         # Corresponds to the JSON property `writeEndpoint`
         # @return [String]
@@ -1048,6 +1096,7 @@ module Google
           @sql_network_architecture = args[:sql_network_architecture] if args.key?(:sql_network_architecture)
           @state = args[:state] if args.key?(:state)
           @suspension_reason = args[:suspension_reason] if args.key?(:suspension_reason)
+          @upgradable_database_versions = args[:upgradable_database_versions] if args.key?(:upgradable_database_versions)
           @write_endpoint = args[:write_endpoint] if args.key?(:write_endpoint)
         end
         
@@ -1741,11 +1790,11 @@ 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
@@ -1757,25 +1806,25 @@ module Google
         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
@@ -2533,12 +2582,12 @@ module Google
         # ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=
         # 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` gets priority
+        # 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`, 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.
+        # 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
@@ -3307,12 +3356,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 has 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
@@ -3321,12 +3372,24 @@ 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
       
+        # Output only. If set, it indicates this instance has a private service access (
+        # PSA) dns endpoint that is pointing to the primary instance of the cluster. If
+        # this instance is the primary, the dns should be pointing to this instance.
+        # After Switchover or Replica failover, this DNS endpoint points to the promoted
+        # instance. This is a read-only field, returned to the user as information. This
+        # field can exist even if a standalone instance does not yet have a replica, or
+        # had a DR replica that was deleted.
+        # Corresponds to the JSON property `psaWriteEndpoint`
+        # @return [String]
+        attr_accessor :psa_write_endpoint
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3335,6 +3398,7 @@ module Google
         def update!(**args)
           @dr_replica = args[:dr_replica] if args.key?(:dr_replica)
           @failover_dr_replica_name = args[:failover_dr_replica_name] if args.key?(:failover_dr_replica_name)
+          @psa_write_endpoint = args[:psa_write_endpoint] if args.key?(:psa_write_endpoint)
         end
       end
       
@@ -3867,8 +3931,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
@@ -3913,8 +3978,9 @@ module Google
       class SqlInstancesVerifyExternalSyncSettingsRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. MigrationType field 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
@@ -3929,8 +3995,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_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.69.0"
+      GEM_VERSION = "0.71.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.14.0"
+      GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240324"
+      REVISION = "20240521"
     end
   end
 end

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

@@ -46,6 +46,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AvailableDatabaseVersion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BackupConfiguration
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -712,6 +718,15 @@ module Google
         end
       end
       
+      class AvailableDatabaseVersion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :display_name, as: 'displayName'
+          property :major_version, as: 'majorVersion'
+          property :name, as: 'name'
+        end
+      end
+      
       class BackupConfiguration
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -809,6 +824,7 @@ module Google
           property :kind, as: 'kind'
           property :pitr_timestamp_ms, :numeric_string => true, as: 'pitrTimestampMs'
           property :point_in_time, as: 'pointInTime'
+          property :preferred_secondary_zone, as: 'preferredSecondaryZone'
           property :preferred_zone, as: 'preferredZone'
         end
       end
@@ -917,6 +933,8 @@ module Google
           property :sql_network_architecture, as: 'sqlNetworkArchitecture'
           property :state, as: 'state'
           collection :suspension_reason, as: 'suspensionReason'
+          collection :upgradable_database_versions, as: 'upgradableDatabaseVersions', class: Google::Apis::SqladminV1beta4::AvailableDatabaseVersion, decorator: Google::Apis::SqladminV1beta4::AvailableDatabaseVersion::Representation
+      
           property :write_endpoint, as: 'writeEndpoint'
         end
         
@@ -1530,6 +1548,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :dr_replica, as: 'drReplica'
           property :failover_dr_replica_name, as: 'failoverDrReplicaName'
+          property :psa_write_endpoint, as: 'psaWriteEndpoint'
         end
       end
       

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

@@ -1055,16 +1055,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 a 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_v1beta4
 version: !ruby/object:Gem::Version
-  version: 0.69.0
+  version: 0.71.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-31 00:00:00.000000000 Z
+date: 2024-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -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.69.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1beta4/v0.71.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1beta4
 post_install_message: 
 rdoc_options: []