google-apis-sqladmin_v1 0.57.0 → 0.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bcb28b381631fced4ebf4c2f390e80bf23a261bc39a1587c69354dc8714581e
-  data.tar.gz: c440521d9276fe0ee3c90e8bdd8f0c5c3e0fea65aa84bacaa9dc34eface7b016
+  metadata.gz: 5e45a2d43eebc39bf1efc627cecc7889c024e190b3782efdf1919b230257835c
+  data.tar.gz: b0db23676e4fcdb50526599abd7d356abaa787e305a78824930fe4e6aff25c80
 SHA512:
-  metadata.gz: c5618aa669d29dfd13540217db055e1db1d7820ec816208fec7d4fc1f015a1ce0cecbf1c79915627cfc1ff173898bca2604971945a6e5b35ba56dda49941819f
-  data.tar.gz: 20504be29e7ea2f2a3547b61a69e9cef6db00a6088e2a72da61c94898ea4c0424c53e76e6113b95e5e8e7557db6f04210ca81277aa868d4de65483706aed70be
+  metadata.gz: e85d8c396d0f10ab5b6ef3cb5b3f7e380140a15e0b8d89bbed058b4905de9853c68df2991371bb78cc059f3964a138954297d63c35f7ec2632984c50a190afd1
+  data.tar.gz: ab3bcaf0fda441ad89935a29ab693f57e9cc50bd049b10a571d3c6bc4d1e285fd282a213432414a9e32e441b9088f33a3fcfe3b7486ffa35b3af802292836bf0

data/CHANGELOG.md

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

data/lib/google/apis/sqladmin_v1/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
@@ -207,7 +239,7 @@ module Google
         attr_accessor :transaction_log_retention_days
       
         # Output only. This value contains the storage location of transactional logs
-        # for the database for point-in-time recovery.
+        # used to perform point-in-time recovery (PITR) for the database.
         # Corresponds to the JSON property `transactionalLogStorageState`
         # @return [String]
         attr_accessor :transactional_log_storage_state
@@ -543,9 +575,9 @@ 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
-        # source instance.
+        # 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. This field applies to all DB types.
         # Corresponds to the JSON property `preferredZone`
         # @return [String]
         attr_accessor :preferred_zone
@@ -839,7 +871,7 @@ module Google
         # @return [String]
         attr_accessor :gce_zone
       
-        # Gemini configuration.
+        # Gemini instance configuration.
         # Corresponds to the JSON property `geminiConfig`
         # @return [Google::Apis::SqladminV1::GeminiInstanceConfig]
         attr_accessor :gemini_config
@@ -929,7 +961,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 experiences regional failure. Only applicable to MySQL.
         # Corresponds to the JSON property `replicationCluster`
         # @return [Google::Apis::SqladminV1::ReplicationCluster]
         attr_accessor :replication_cluster
@@ -940,7 +974,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 +1030,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::SqladminV1::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 +1088,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,41 +1782,41 @@ 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
         alias_method :active_query_enabled?, :active_query_enabled
       
-        # Output only. Whether gemini is enabled.
+        # Output only. Whether Gemini is enabled.
         # Corresponds to the JSON property `entitled`
         # @return [Boolean]
         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
@@ -2532,12 +2573,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
@@ -3306,12 +3347,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 experiences 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
@@ -3320,12 +3363,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
@@ -3334,6 +3389,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
       
@@ -3866,8 +3922,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
@@ -3912,8 +3969,9 @@ module Google
       class SqlInstancesVerifyExternalSyncSettingsRequest
         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
@@ -3928,8 +3986,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_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.57.0"
+      GEM_VERSION = "0.59.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_v1/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
@@ -917,6 +932,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::SqladminV1::AvailableDatabaseVersion, decorator: Google::Apis::SqladminV1::AvailableDatabaseVersion::Representation
+      
           property :write_endpoint, as: 'writeEndpoint'
         end
         
@@ -1530,6 +1547,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_v1/service.rb

@@ -1056,16 +1056,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 the 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_v1
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.59.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_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.57.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sqladmin_v1/v0.59.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sqladmin_v1
 post_install_message: 
 rdoc_options: []