Cloud PubSub V1 Client - Class PullRequest (1.45.2)

Reference documentation and code samples for the Cloud PubSub V1 Client class PullRequest.

Request for the Pull method.

Generated from protobuf message google.pubsub.v1.PullRequest

Namespace

Google \ Cloud \ PubSub \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ subscription string

Required. The subscription from which messages should be pulled. Format is projects/{project}/subscriptions/{sub}.

↳ return_immediately bool

Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the Pull response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages. Warning: setting this field to true is discouraged because it adversely impacts the performance of Pull operations. We recommend that users do not set this field.

↳ max_messages int

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

getSubscription

Required. The subscription from which messages should be pulled.

Format is projects/{project}/subscriptions/{sub}.

Returns
TypeDescription
string

setSubscription

Required. The subscription from which messages should be pulled.

Format is projects/{project}/subscriptions/{sub}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getReturnImmediately

Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the Pull response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages.

Warning: setting this field to true is discouraged because it adversely impacts the performance of Pull operations. We recommend that users do not set this field.

Returns
TypeDescription
bool

setReturnImmediately

Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the Pull response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages.

Warning: setting this field to true is discouraged because it adversely impacts the performance of Pull operations. We recommend that users do not set this field.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getMaxMessages

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

Returns
TypeDescription
int

setMaxMessages

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

static::build

Parameters
NameDescription
subscription string

Required. The subscription from which messages should be pulled. Format is projects/{project}/subscriptions/{sub}. Please see Google\Cloud\PubSub\V1\SubscriberClient::subscriptionName() for help formatting this field.

returnImmediately bool

Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the Pull response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages. Warning: setting this field to true is discouraged because it adversely impacts the performance of Pull operations. We recommend that users do not set this field.

maxMessages int

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

Returns
TypeDescription
Google\Cloud\PubSub\V1\PullRequest

static::buildFromSubscriptionMaxMessages

Parameters
NameDescription
subscription string

Required. The subscription from which messages should be pulled. Format is projects/{project}/subscriptions/{sub}. Please see Google\Cloud\PubSub\V1\SubscriberClient::subscriptionName() for help formatting this field.

maxMessages int

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

Returns
TypeDescription
Google\Cloud\PubSub\V1\PullRequest