Class: Google::Pubsub::V1::StreamingPullRequest

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb

Overview

Request for the +StreamingPull+ streaming RPC method. This request is used to establish the initial stream as well as to stream acknowledgements and ack deadline modifications from the client to the server.

Instance Attribute Summary collapse

Instance Attribute Details

#ack_ids ⇒ Array<String>

Returns List of acknowledgement IDs for acknowledging previously received messages (received on this stream or a different stream). If an ack ID has expired, the corresponding message may be redelivered later. Acknowledging a message more than once will not result in an error. If the acknowledgement ID is malformed, the stream will be aborted with status +INVALID_ARGUMENT+.

Returns:

  • (Array<String>) —

    List of acknowledgement IDs for acknowledging previously received messages (received on this stream or a different stream). If an ack ID has expired, the corresponding message may be redelivered later. Acknowledging a message more than once will not result in an error. If the acknowledgement ID is malformed, the stream will be aborted with status +INVALID_ARGUMENT+.



423
 
# File 'lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb', line 423

class StreamingPullRequest; end

#modify_deadline_ack_ids ⇒ Array<String>

Returns List of acknowledgement IDs whose deadline will be modified based on the corresponding element in +modify_deadline_seconds+. This field can be used to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted.

Returns:

  • (Array<String>) —

    List of acknowledgement IDs whose deadline will be modified based on the corresponding element in +modify_deadline_seconds+. This field can be used to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted.



423
 
# File 'lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb', line 423

class StreamingPullRequest; end

#modify_deadline_seconds ⇒ Array<Integer>

Returns The list of new ack deadlines for the IDs listed in +modify_deadline_ack_ids+. The size of this list must be the same as the size of +modify_deadline_ack_ids+. If it differs the stream will be aborted with +INVALID_ARGUMENT+. Each element in this list is applied to the element in the same position in +modify_deadline_ack_ids+. The new ack deadline is with respect to the time this request was sent to the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack deadline will expire 10 seconds after this request is received. If the value is 0, the message is immediately made available for another streaming or non-streaming pull request. If the value is < 0 (an error), the stream will be aborted with status +INVALID_ARGUMENT+.

Returns:

  • (Array<Integer>) —

    The list of new ack deadlines for the IDs listed in +modify_deadline_ack_ids+. The size of this list must be the same as the size of +modify_deadline_ack_ids+. If it differs the stream will be aborted with +INVALID_ARGUMENT+. Each element in this list is applied to the element in the same position in +modify_deadline_ack_ids+. The new ack deadline is with respect to the time this request was sent to the Pub/Sub system. Must be >= 0. For example, if the value is 10, the new ack deadline will expire 10 seconds after this request is received. If the value is 0, the message is immediately made available for another streaming or non-streaming pull request. If the value is < 0 (an error), the stream will be aborted with status +INVALID_ARGUMENT+.



423
 
# File 'lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb', line 423

class StreamingPullRequest; end

#stream_ack_deadline_seconds ⇒ Integer

Returns The ack deadline to use for the stream. This must be provided in the first request on the stream, but it can also be updated on subsequent requests from client to server. The minimum deadline you can specify is 10 seconds. The maximum deadline you can specify is 600 seconds (10 minutes).

Returns:

  • (Integer) —

    The ack deadline to use for the stream. This must be provided in the first request on the stream, but it can also be updated on subsequent requests from client to server. The minimum deadline you can specify is 10 seconds. The maximum deadline you can specify is 600 seconds (10 minutes).



423
 
# File 'lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb', line 423

class StreamingPullRequest; end

#subscription ⇒ String

Returns The subscription for which to initialize the new stream. This must be provided in the first request on the stream, and must not be set in subsequent requests from client to server. Format is +projects/project/subscriptions/sub+.

Returns:

  • (String) —

    The subscription for which to initialize the new stream. This must be provided in the first request on the stream, and must not be set in subsequent requests from client to server. Format is +projects/project/subscriptions/sub+.



423
 
# File 'lib/google/cloud/pubsub/v1/doc/google/pubsub/v1/pubsub.rb', line 423

class StreamingPullRequest; end