google-apis-pubsublite_v1 0.2.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd39f992772e40ef1b6515b62e89a600362caa10e342e9cff070a4c62541be25
-  data.tar.gz: 6aac6fed88ac0b109ae10c2f93939fa866db9eeab8fe6bfcef3ac3b365afd82d
+  metadata.gz: 5a208439243ca81538c440c06726fd39d8da0919e08bf61951b5e7dc8cb21793
+  data.tar.gz: e452671b9306d7f617cc6454d340a27b78a7f173584564ccfa5b55ddbd72f4ec
 SHA512:
-  metadata.gz: 9d6e461b6dd2b331116e642d711bd67834bc718db311febee3b19499fdea188ffe12ba88b5a0540bf1984fe7eb3322e1f1f0d43659f04cff0248e324c66bac89
-  data.tar.gz: 1c2212c4485af6d835f0cf58fbcd568c8e4fcfc58147ca0f384b1e5009f77b4839bb7c710a4256aaed16b5bc1bac3d38adc86c5b1e6d4ca5010aa6eb659f0229
+  metadata.gz: 599eecc1e36cc8194d598efc109ccbb4a6dc5f9a08f900abd648ad62b7a1ee389b3ef77b6d38f83f5a7e911e91fe00f0a74cc70710a80a20aef379ab8d8a4996
+  data.tar.gz: 045efc187b46a09f85fc2920616b143d6930eef80ca4605ef77138eb6a8933e51b36985c8e112f7e696674f62678784ca9a86322dd2718417a3d9d06568b7c82

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Release history for google-apis-pubsublite_v1
 
+### v0.7.0 (2021-05-14)
+
+* Regenerated from discovery document revision 20210513
+
+### v0.6.0 (2021-03-27)
+
+* Regenerated from discovery document revision 20210322
+
+### v0.5.0 (2021-03-20)
+
+* Regenerated from discovery document revision 20210316
+* Regenerated using generator version 0.2.0
+
+### v0.4.0 (2021-03-05)
+
+* Regenerated from discovery document revision 20210302
+* Unspecified changes
+
+### v0.3.0 (2021-02-27)
+
+* Regenerated from discovery document revision 20210224
+
 ### v0.2.0 (2021-02-09)
 
 * Regenerated from discovery document revision 20210202

data/lib/google/apis/pubsublite_v1.rb

@@ -29,7 +29,7 @@ module Google
       # This is NOT the gem version.
       VERSION = 'V1'
 
-      # View and manage your data across Google Cloud Platform services
+      # See, edit, configure, and delete your Google Cloud Platform data
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end

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

@@ -47,6 +47,45 @@ module Google
         end
       end
       
+      # Request for CommitCursor.
+      class CommitCursorRequest
+        include Google::Apis::Core::Hashable
+      
+        # A cursor that describes the position of a message within a topic partition.
+        # Corresponds to the JSON property `cursor`
+        # @return [Google::Apis::PubsubliteV1::Cursor]
+        attr_accessor :cursor
+      
+        # The partition for which to update the cursor. Partitions are zero indexed, so `
+        # partition` must be in the range [0, topic.num_partitions).
+        # Corresponds to the JSON property `partition`
+        # @return [Fixnum]
+        attr_accessor :partition
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cursor = args[:cursor] if args.key?(:cursor)
+          @partition = args[:partition] if args.key?(:partition)
+        end
+      end
+      
+      # Response for CommitCursor.
+      class CommitCursorResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Compute the current head cursor for a partition.
       class ComputeHeadCursorRequest
         include Google::Apis::Core::Hashable
@@ -157,6 +196,53 @@ module Google
         end
       end
       
+      # Compute the corresponding cursor for a publish or event time in a topic
+      # partition.
+      class ComputeTimeCursorRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The partition for which we should compute the cursor.
+        # Corresponds to the JSON property `partition`
+        # @return [Fixnum]
+        attr_accessor :partition
+      
+        # A target publish or event time. Can be used for seeking to or retrieving the
+        # corresponding cursor.
+        # Corresponds to the JSON property `target`
+        # @return [Google::Apis::PubsubliteV1::TimeTarget]
+        attr_accessor :target
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @partition = args[:partition] if args.key?(:partition)
+          @target = args[:target] if args.key?(:target)
+        end
+      end
+      
+      # Response containing the cursor corresponding to a publish or event time in a
+      # topic partition.
+      class ComputeTimeCursorResponse
+        include Google::Apis::Core::Hashable
+      
+        # A cursor that describes the position of a message within a topic partition.
+        # Corresponds to the JSON property `cursor`
+        # @return [Google::Apis::PubsubliteV1::Cursor]
+        attr_accessor :cursor
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cursor = args[:cursor] if args.key?(:cursor)
+        end
+      end
+      
       # A cursor that describes the position of a message within a topic partition.
       class Cursor
         include Google::Apis::Core::Hashable
@@ -329,7 +415,10 @@ module Google
         # @return [Google::Apis::PubsubliteV1::Capacity]
         attr_accessor :capacity
       
-        # The number of partitions in the topic. Must be at least 1.
+        # The number of partitions in the topic. Must be at least 1. Once a topic has
+        # been created the number of partitions can be increased but not decreased.
+        # Message ordering is not guaranteed across a topic resize. For more information
+        # see https://cloud.google.com/pubsub/lite/docs/topics#scaling_capacity
         # Corresponds to the JSON property `count`
         # @return [Fixnum]
         attr_accessor :count
@@ -444,6 +533,38 @@ module Google
         end
       end
       
+      # A target publish or event time. Can be used for seeking to or retrieving the
+      # corresponding cursor.
+      class TimeTarget
+        include Google::Apis::Core::Hashable
+      
+        # Request the cursor of the first message with event time greater than or equal
+        # to `event_time`. If messages are missing an event time, the publish time is
+        # used as a fallback. As event times are user supplied, subsequent messages may
+        # have event times less than `event_time` and should be filtered by the client,
+        # if necessary.
+        # Corresponds to the JSON property `eventTime`
+        # @return [String]
+        attr_accessor :event_time
+      
+        # Request the cursor of the first message with publish time greater than or
+        # equal to `publish_time`. All messages thereafter are guaranteed to have
+        # publish times >= `publish_time`.
+        # Corresponds to the JSON property `publishTime`
+        # @return [String]
+        attr_accessor :publish_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @event_time = args[:event_time] if args.key?(:event_time)
+          @publish_time = args[:publish_time] if args.key?(:publish_time)
+        end
+      end
+      
       # Metadata about a topic resource.
       class Topic
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module PubsubliteV1
       # Version of the google-apis-pubsublite_v1 gem
-      GEM_VERSION = "0.2.0"
+      GEM_VERSION = "0.7.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.2"
+      GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210202"
+      REVISION = "20210513"
     end
   end
 end

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

@@ -28,6 +28,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CommitCursorRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class CommitCursorResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ComputeHeadCursorRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -52,6 +64,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ComputeTimeCursorRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ComputeTimeCursorResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Cursor
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,6 +142,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TimeTarget
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Topic
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -138,6 +168,21 @@ module Google
         end
       end
       
+      class CommitCursorRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cursor, as: 'cursor', class: Google::Apis::PubsubliteV1::Cursor, decorator: Google::Apis::PubsubliteV1::Cursor::Representation
+      
+          property :partition, :numeric_string => true, as: 'partition'
+        end
+      end
+      
+      class CommitCursorResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class ComputeHeadCursorRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -174,6 +219,23 @@ module Google
         end
       end
       
+      class ComputeTimeCursorRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :partition, :numeric_string => true, as: 'partition'
+          property :target, as: 'target', class: Google::Apis::PubsubliteV1::TimeTarget, decorator: Google::Apis::PubsubliteV1::TimeTarget::Representation
+      
+        end
+      end
+      
+      class ComputeTimeCursorResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cursor, as: 'cursor', class: Google::Apis::PubsubliteV1::Cursor, decorator: Google::Apis::PubsubliteV1::Cursor::Representation
+      
+        end
+      end
+      
       class Cursor
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -266,6 +328,14 @@ module Google
         end
       end
       
+      class TimeTarget
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :event_time, as: 'eventTime'
+          property :publish_time, as: 'publishTime'
+        end
+      end
+      
       class Topic
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -54,6 +54,10 @@ module Google
         #   Required. The parent location in which to create the subscription. Structured
         #   like `projects/`project_number`/locations/`location``.
         # @param [Google::Apis::PubsubliteV1::Subscription] subscription_object
+        # @param [Boolean] skip_backlog
+        #   If true, the newly created subscription will only receive messages published
+        #   after the subscription was created. Otherwise, the entire message backlog will
+        #   be received on the subscription. Defaults to false.
         # @param [String] subscription_id
         #   Required. The ID to use for the subscription, which will become the final
         #   component of the subscription's name. This value is structured like: `my-sub-
@@ -75,13 +79,14 @@ 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 create_admin_project_location_subscription(parent, subscription_object = nil, subscription_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_admin_project_location_subscription(parent, subscription_object = nil, skip_backlog: nil, subscription_id: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/admin/{+parent}/subscriptions', options)
           command.request_representation = Google::Apis::PubsubliteV1::Subscription::Representation
           command.request_object = subscription_object
           command.response_representation = Google::Apis::PubsubliteV1::Subscription::Representation
           command.response_class = Google::Apis::PubsubliteV1::Subscription
           command.params['parent'] = parent unless parent.nil?
+          command.query['skipBacklog'] = skip_backlog unless skip_backlog.nil?
           command.query['subscriptionId'] = subscription_id unless subscription_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -473,6 +478,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates the committed cursor.
+        # @param [String] subscription
+        #   The subscription for which to update the cursor.
+        # @param [Google::Apis::PubsubliteV1::CommitCursorRequest] commit_cursor_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::PubsubliteV1::CommitCursorResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubliteV1::CommitCursorResponse]
+        #
+        # @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 commit_subscription_cursor(subscription, commit_cursor_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/cursor/{+subscription}:commitCursor', options)
+          command.request_representation = Google::Apis::PubsubliteV1::CommitCursorRequest::Representation
+          command.request_object = commit_cursor_request_object
+          command.response_representation = Google::Apis::PubsubliteV1::CommitCursorResponse::Representation
+          command.response_class = Google::Apis::PubsubliteV1::CommitCursorResponse
+          command.params['subscription'] = subscription unless subscription.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns all committed cursor information for a subscription.
         # @param [String] parent
         #   Required. The subscription for which to retrieve cursors. Structured like `
@@ -515,11 +553,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Compute the head cursor for the partition. The head cursor’s offset is
-        # guaranteed to be before or equal to all messages which have not yet been
-        # acknowledged to be published, and greater than the offset of any message whose
-        # publish has already been acknowledged. It is 0 if there have never been
-        # messages on the partition.
+        # Compute the head cursor for the partition. The head cursor's offset is
+        # guaranteed to be less than or equal to all messages which have not yet been
+        # acknowledged as published, and greater than the offset of any message whose
+        # publish has already been acknowledged. It is zero if there have never been
+        # messages in the partition.
         # @param [String] topic
         #   Required. The topic for which we should compute the head cursor.
         # @param [Google::Apis::PubsubliteV1::ComputeHeadCursorRequest] compute_head_cursor_request_object
@@ -584,6 +622,40 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Compute the corresponding cursor for a publish or event time in a topic
+        # partition.
+        # @param [String] topic
+        #   Required. The topic for which we should compute the cursor.
+        # @param [Google::Apis::PubsubliteV1::ComputeTimeCursorRequest] compute_time_cursor_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::PubsubliteV1::ComputeTimeCursorResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubliteV1::ComputeTimeCursorResponse]
+        #
+        # @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 compute_topic_time_cursor(topic, compute_time_cursor_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/topicStats/{+topic}:computeTimeCursor', options)
+          command.request_representation = Google::Apis::PubsubliteV1::ComputeTimeCursorRequest::Representation
+          command.request_object = compute_time_cursor_request_object
+          command.response_representation = Google::Apis::PubsubliteV1::ComputeTimeCursorResponse::Representation
+          command.response_class = Google::Apis::PubsubliteV1::ComputeTimeCursorResponse
+          command.params['topic'] = topic unless topic.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-pubsublite_v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-15 00:00:00.000000000 Z
+date: 2021-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,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/master/generated/google-apis-pubsublite_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-pubsublite_v1/v0.2.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-pubsublite_v1/v0.7.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-pubsublite_v1
 post_install_message: 
 rdoc_options: []
@@ -62,14 +62,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.6
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Pub/Sub Lite API V1