google-apis-alloydb_v1 0.25.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a12ff010d52dd71a5a588c97c470c82b34bea6c0daf29b9451bef56a2243e5d
-  data.tar.gz: 9b493d6f18f4f8dbc2d9e4e1c4055270c4ad562fe5a639fd6771ed2d88e7999e
+  metadata.gz: 7694b502f4a4d1e7641bbb2f3a2556bff297279fd0def4e4dbb8054e8d069306
+  data.tar.gz: fc021ee07daaccd630363616e41ae212c4b23fa970dcce2ede9c533b4cd5bbe5
 SHA512:
-  metadata.gz: 830a3c7828e18b0aeea6bfc3fa4f731f544b7ab22a2ce25b2765b9c6a5aad3e6ab1fd252090f85e82f7d5ecba26128c897011b60f2b946ec387e7f369d334d7e
-  data.tar.gz: 2b1e896700480af58e5c2446367ae19bcd4b3e93e7b0e3bfe71d51367d70b274b57f432b10ef49fe49e2c9b86c7b0e028c28a37bfc71c09326a6acaad2039230
+  metadata.gz: 289f2a783f1ac1e582ba6566fdfb4089ba8d846b6831a115241634d216f95cbecc7047e12bfcbf42b17fe93fcf31e14c7a39a745a946a639d1374563ed761c08
+  data.tar.gz: faf3567a307089ac460d1dfcd0adeb62ed34a6699f119dddc233f2fed4ab1db7a9275bc5f7ae0974b7b0c9f6f1967447a7bf1d815712ab4b2384cbaf038a9bfd

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-alloydb_v1
 
+### v0.27.0 (2024-11-24)
+
+* Regenerated from discovery document revision 20241106
+
+### v0.26.0 (2024-11-03)
+
+* Regenerated from discovery document revision 20241023
+
 ### v0.25.0 (2024-10-27)
 
 * Regenerated from discovery document revision 20241015

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

@@ -837,6 +837,26 @@ module Google
         end
       end
       
+      # Options for exporting data in CSV format. For now, we only support a query to
+      # get the data that needs to be exported.
+      class CsvExportOptions
+        include Google::Apis::Core::Hashable
+      
+        # Required. The select_query used to extract the data.
+        # Corresponds to the JSON property `selectQuery`
+        # @return [String]
+        attr_accessor :select_query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @select_query = args[:select_query] if args.key?(:select_query)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -901,6 +921,59 @@ module Google
         end
       end
       
+      # Export cluster request.
+      class ExportClusterRequest
+        include Google::Apis::Core::Hashable
+      
+        # Options for exporting data in CSV format. For now, we only support a query to
+        # get the data that needs to be exported.
+        # Corresponds to the JSON property `csvExportOptions`
+        # @return [Google::Apis::AlloydbV1::CsvExportOptions]
+        attr_accessor :csv_export_options
+      
+        # Required. Name of the database where the query will be executed. Note - Value
+        # provided should be the same as expected from `SELECT current_database();` and
+        # NOT as a resource reference.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # Destination for Export. Export will be done to cloud storage.
+        # Corresponds to the JSON property `gcsDestination`
+        # @return [Google::Apis::AlloydbV1::GcsDestination]
+        attr_accessor :gcs_destination
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @csv_export_options = args[:csv_export_options] if args.key?(:csv_export_options)
+          @database = args[:database] if args.key?(:database)
+          @gcs_destination = args[:gcs_destination] if args.key?(:gcs_destination)
+        end
+      end
+      
+      # Response of export cluster rpc.
+      class ExportClusterResponse
+        include Google::Apis::Core::Hashable
+      
+        # Destination for Export. Export will be done to cloud storage.
+        # Corresponds to the JSON property `gcsDestination`
+        # @return [Google::Apis::AlloydbV1::GcsDestination]
+        attr_accessor :gcs_destination
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @gcs_destination = args[:gcs_destination] if args.key?(:gcs_destination)
+        end
+      end
+      
       # Message for triggering failover on an Instance
       class FailoverInstanceRequest
         include Google::Apis::Core::Hashable
@@ -938,6 +1011,27 @@ module Google
         end
       end
       
+      # Destination for Export. Export will be done to cloud storage.
+      class GcsDestination
+        include Google::Apis::Core::Hashable
+      
+        # Required. The path to the file in Google Cloud Storage where the export will
+        # be stored. The URI is in the form `gs://bucketName/fileName`. If the file
+        # already exists, the request succeeds, but the operation fails.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # The response message for Locations.ListLocations.
       class GoogleCloudLocationListLocationsResponse
         include Google::Apis::Core::Hashable
@@ -1128,16 +1222,17 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Database flags. Set at instance level. * They are copied from primary instance
-        # on read instance creation. * Read instances can set new or override existing
-        # flags that are relevant for reads, e.g. for enabling columnar cache on a read
-        # instance. Flags set on read instance may or may not be present on primary.
-        # This is a list of "key": "value" pairs. "key": The name of the flag. These
-        # flags are passed at instance setup time, so include both server options and
-        # system variables for Postgres. Flags are specified with underscores, not
-        # hyphens. "value": The value of the flag. Booleans are set to **on** for true
-        # and **off** for false. This field must be omitted if the flag doesn't take a
-        # value.
+        # Database flags. Set at the instance level. They are copied from the primary
+        # instance on secondary instance creation. Flags that have restrictions default
+        # to the value at primary instance on read instances during creation. Read
+        # instances can set new flags or override existing flags that are relevant for
+        # reads, for example, for enabling columnar cache on a read instance. Flags set
+        # on read instance might or might not be present on the primary instance. This
+        # is a list of "key": "value" pairs. "key": The name of the flag. These flags
+        # are passed at instance setup time, so include both server options and system
+        # variables for Postgres. Flags are specified with underscores, not hyphens. "
+        # value": The value of the flag. Booleans are set to **on** for true and **off**
+        # for false. This field must be omitted if the flag doesn't take a value.
         # Corresponds to the JSON property `databaseFlags`
         # @return [Hash<String,String>]
         attr_accessor :database_flags

data/lib/google/apis/alloydb_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module AlloydbV1
       # Version of the google-apis-alloydb_v1 gem
-      GEM_VERSION = "0.25.0"
+      GEM_VERSION = "0.27.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241015"
+      REVISION = "20241106"
     end
   end
 end

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

@@ -100,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CsvExportOptions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,12 +124,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExportClusterRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExportClusterResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class FailoverInstanceRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GcsDestination
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudLocationListLocationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -722,6 +746,13 @@ module Google
         end
       end
       
+      class CsvExportOptions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :select_query, as: 'selectQuery'
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -743,6 +774,25 @@ module Google
         end
       end
       
+      class ExportClusterRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :csv_export_options, as: 'csvExportOptions', class: Google::Apis::AlloydbV1::CsvExportOptions, decorator: Google::Apis::AlloydbV1::CsvExportOptions::Representation
+      
+          property :database, as: 'database'
+          property :gcs_destination, as: 'gcsDestination', class: Google::Apis::AlloydbV1::GcsDestination, decorator: Google::Apis::AlloydbV1::GcsDestination::Representation
+      
+        end
+      end
+      
+      class ExportClusterResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :gcs_destination, as: 'gcsDestination', class: Google::Apis::AlloydbV1::GcsDestination, decorator: Google::Apis::AlloydbV1::GcsDestination::Representation
+      
+        end
+      end
+      
       class FailoverInstanceRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -751,6 +801,13 @@ module Google
         end
       end
       
+      class GcsDestination
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :uri, as: 'uri'
+        end
+      end
+      
       class GoogleCloudLocationListLocationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -542,6 +542,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Exports data from the cluster. Imperative only.
+        # @param [String] name
+        #   Required. The resource name of the cluster.
+        # @param [Google::Apis::AlloydbV1::ExportClusterRequest] export_cluster_request_object
+        # @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::AlloydbV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AlloydbV1::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 export_cluster(name, export_cluster_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:export', options)
+          command.request_representation = Google::Apis::AlloydbV1::ExportClusterRequest::Representation
+          command.request_object = export_cluster_request_object
+          command.response_representation = Google::Apis::AlloydbV1::Operation::Representation
+          command.response_class = Google::Apis::AlloydbV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets details of a single Cluster.
         # @param [String] name
         #   Required. The name of the resource. For the required format, see the comment

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-alloydb_v1
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-27 00:00:00.000000000 Z
+date: 2024-12-04 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-alloydb_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-alloydb_v1/v0.25.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-alloydb_v1/v0.27.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-alloydb_v1
 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.5.21
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Simple REST client for AlloyDB API V1