google-apis-datastream_v1 0.27.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 561dead08a1e55c77e1a3752e3471b8ca26d0e863c82155c52b42ebd894f137f
-  data.tar.gz: 43418a0e0ef501c15cb6de91aaf77423b39abd9a25dcae81ae7ebce2b8cfccd6
+  metadata.gz: 0e0260b6b67be012062c00bd012dd129cc5b1c651cf3626b8fa4a11cc2d00661
+  data.tar.gz: c6b5e61372f57747ec1c76662ea87c4ac2b55f87089a6270e71611c6e9ad25be
 SHA512:
-  metadata.gz: fe9dfda4784849a86cfd861d0cd90c55151399b4b56a1413a6c43f349a79adfff8afb6d80aca2081302b0b90a48246b3a7b7a03fa1c2a28c3ce2816bba7a7ab0
-  data.tar.gz: 602ae4b4e38bd9e5a09d7db64611ec9d9395cb67f81a02c81210020d21674f9bdf23c183794935c65c01576efbff95ad0a3de37f8519a03fdaa5f46fe2db074b
+  metadata.gz: 044dbba562e05ffd1da1946a58d5e9f19314f7c3c1873459dbe4663da13fa8e36394f69e02904a96402df0723b7cdb6dadff4ef5b084bfe9811500b64764e932
+  data.tar.gz: e92f5c3d438fae0f2763b9bd21e0af23bc87be5dbe07826c0ea53b31e31f3299800c80765061ddc1874f9f8deafee15f8614bf6e6aff64dd12942c12b2050a73

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-datastream_v1
 
+### v0.29.0 (2023-08-13)
+
+* Regenerated from discovery document revision 20230802
+
+### v0.28.0 (2023-08-03)
+
+* Regenerated from discovery document revision 20230719
+
 ### v0.27.0 (2023-07-23)
 
 * Regenerated from discovery document revision 20230630

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

@@ -184,6 +184,38 @@ module Google
         end
       end
       
+      # The strategy that the stream uses for CDC replication.
+      class CdcStrategy
+        include Google::Apis::Core::Hashable
+      
+        # CDC strategy to start replicating from the most recent position in the source.
+        # Corresponds to the JSON property `mostRecentStartPosition`
+        # @return [Google::Apis::DatastreamV1::MostRecentStartPosition]
+        attr_accessor :most_recent_start_position
+      
+        # CDC strategy to resume replication from the next available position in the
+        # source.
+        # Corresponds to the JSON property `nextAvailableStartPosition`
+        # @return [Google::Apis::DatastreamV1::NextAvailableStartPosition]
+        attr_accessor :next_available_start_position
+      
+        # CDC strategy to start replicating from a specific position in the source.
+        # Corresponds to the JSON property `specificStartPosition`
+        # @return [Google::Apis::DatastreamV1::SpecificStartPosition]
+        attr_accessor :specific_start_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @most_recent_start_position = args[:most_recent_start_position] if args.key?(:most_recent_start_position)
+          @next_available_start_position = args[:next_available_start_position] if args.key?(:next_available_start_position)
+          @specific_start_position = args[:specific_start_position] if args.key?(:specific_start_position)
+        end
+      end
+      
       # A set of reusable connection configurations to be used as a source or
       # destination for a stream.
       class ConnectionProfile
@@ -944,6 +976,19 @@ module Google
         end
       end
       
+      # CDC strategy to start replicating from the most recent position in the source.
+      class MostRecentStartPosition
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # MySQL Column.
       class MysqlColumn
         include Google::Apis::Core::Hashable
@@ -1039,6 +1084,31 @@ module Google
         end
       end
       
+      # MySQL log position
+      class MysqlLogPosition
+        include Google::Apis::Core::Hashable
+      
+        # The binary log file name.
+        # Corresponds to the JSON property `logFile`
+        # @return [String]
+        attr_accessor :log_file
+      
+        # The position within the binary log file. Default is head of file.
+        # Corresponds to the JSON property `logPosition`
+        # @return [Fixnum]
+        attr_accessor :log_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @log_file = args[:log_file] if args.key?(:log_file)
+          @log_position = args[:log_position] if args.key?(:log_position)
+        end
+      end
+      
       # Mysql data source object identifier.
       class MysqlObjectIdentifier
         include Google::Apis::Core::Hashable
@@ -1248,6 +1318,20 @@ module Google
         end
       end
       
+      # CDC strategy to resume replication from the next available position in the
+      # source.
+      class NextAvailableStartPosition
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -1285,13 +1369,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is `google.
-        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # the response should be the resource. For other methods, the response should
-        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # response type is `TakeSnapshotResponse`.
+        # The normal, successful response of the operation. If the original method
+        # returns no data on success, such as `Delete`, the response is `google.protobuf.
+        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
+        # response should be the resource. For other methods, the response should have
+        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
+        # if the original method name is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -2025,6 +2109,25 @@ module Google
         end
       end
       
+      # Request message for running a stream.
+      class RunStreamRequest
+        include Google::Apis::Core::Hashable
+      
+        # The strategy that the stream uses for CDC replication.
+        # Corresponds to the JSON property `cdcStrategy`
+        # @return [Google::Apis::DatastreamV1::CdcStrategy]
+        attr_accessor :cdc_strategy
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cdc_strategy = args[:cdc_strategy] if args.key?(:cdc_strategy)
+        end
+      end
+      
       # A single target dataset to which all data will be streamed.
       class SingleTargetDataset
         include Google::Apis::Core::Hashable
@@ -2134,6 +2237,25 @@ module Google
         end
       end
       
+      # CDC strategy to start replicating from a specific position in the source.
+      class SpecificStartPosition
+        include Google::Apis::Core::Hashable
+      
+        # MySQL log position
+        # Corresponds to the JSON property `mysqlLogPosition`
+        # @return [Google::Apis::DatastreamV1::MysqlLogPosition]
+        attr_accessor :mysql_log_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mysql_log_position = args[:mysql_log_position] if args.key?(:mysql_log_position)
+        end
+      end
+      
       # Request for manually initiating a backfill job for a specific stream object.
       class StartBackfillJobRequest
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatastreamV1
       # Version of the google-apis-datastream_v1 gem
-      GEM_VERSION = "0.27.0"
+      GEM_VERSION = "0.29.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 = "20230630"
+      REVISION = "20230802"
     end
   end
 end

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

@@ -64,6 +64,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CdcStrategy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ConnectionProfile
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -196,6 +202,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MostRecentStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MysqlColumn
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,6 +220,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MysqlLogPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MysqlObjectIdentifier
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -244,6 +262,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class NextAvailableStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -358,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RunStreamRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SingleTargetDataset
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -382,6 +412,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SpecificStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class StartBackfillJobRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -519,6 +555,18 @@ module Google
         end
       end
       
+      class CdcStrategy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :most_recent_start_position, as: 'mostRecentStartPosition', class: Google::Apis::DatastreamV1::MostRecentStartPosition, decorator: Google::Apis::DatastreamV1::MostRecentStartPosition::Representation
+      
+          property :next_available_start_position, as: 'nextAvailableStartPosition', class: Google::Apis::DatastreamV1::NextAvailableStartPosition, decorator: Google::Apis::DatastreamV1::NextAvailableStartPosition::Representation
+      
+          property :specific_start_position, as: 'specificStartPosition', class: Google::Apis::DatastreamV1::SpecificStartPosition, decorator: Google::Apis::DatastreamV1::SpecificStartPosition::Representation
+      
+        end
+      end
+      
       class ConnectionProfile
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -752,6 +800,12 @@ module Google
         end
       end
       
+      class MostRecentStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class MysqlColumn
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -776,6 +830,14 @@ module Google
         end
       end
       
+      class MysqlLogPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :log_file, as: 'logFile'
+          property :log_position, as: 'logPosition'
+        end
+      end
+      
       class MysqlObjectIdentifier
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -837,6 +899,12 @@ module Google
         end
       end
       
+      class NextAvailableStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1049,6 +1117,14 @@ module Google
         end
       end
       
+      class RunStreamRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cdc_strategy, as: 'cdcStrategy', class: Google::Apis::DatastreamV1::CdcStrategy, decorator: Google::Apis::DatastreamV1::CdcStrategy::Representation
+      
+        end
+      end
+      
       class SingleTargetDataset
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1089,6 +1165,14 @@ module Google
         end
       end
       
+      class SpecificStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :mysql_log_position, as: 'mysqlLogPosition', class: Google::Apis::DatastreamV1::MysqlLogPosition, decorator: Google::Apis::DatastreamV1::MysqlLogPosition::Representation
+      
+        end
+      end
+      
       class StartBackfillJobRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -1156,6 +1156,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Use this method to start, resume or recover a stream with a non default CDC
+        # strategy. NOTE: This feature is currently experimental.
+        # @param [String] name
+        #   Required. Name of the stream resource to start, in the format: projects/`
+        #   project_id`/locations/`location`/streams/`stream_name`
+        # @param [Google::Apis::DatastreamV1::RunStreamRequest] run_stream_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::DatastreamV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatastreamV1::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 run_stream(name, run_stream_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:run', options)
+          command.request_representation = Google::Apis::DatastreamV1::RunStreamRequest::Representation
+          command.request_object = run_stream_request_object
+          command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
+          command.response_class = Google::Apis::DatastreamV1::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
+        
         # Use this method to get details about a stream object.
         # @param [String] name
         #   Required. The name of the stream object resource to get.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datastream_v1
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-23 00:00:00.000000000 Z
+date: 2023-08-13 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-datastream_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datastream_v1/v0.27.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datastream_v1/v0.29.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datastream_v1
 post_install_message: 
 rdoc_options: []