com.google.cloud.bigquery.analyticshub.v1

Interface PubSubSubscriptionOrBuilder

All Superinterfaces:

com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder

All Known Implementing Classes:

PubSubSubscription, PubSubSubscription.Builder

public interface PubSubSubscriptionOrBuilder
extends com.google.protobuf.MessageOrBuilder

Method Summary

Modifier and Type	Method and Description
boolean	containsLabels(String key) Optional.
int	getAckDeadlineSeconds() Optional.
BigQueryConfig	getBigqueryConfig() Optional.
BigQueryConfigOrBuilder	getBigqueryConfigOrBuilder() Optional.
CloudStorageConfig	getCloudStorageConfig() Optional.
CloudStorageConfigOrBuilder	getCloudStorageConfigOrBuilder() Optional.
DeadLetterPolicy	getDeadLetterPolicy() Optional.
DeadLetterPolicyOrBuilder	getDeadLetterPolicyOrBuilder() Optional.
boolean	getDetached() Optional.
boolean	getEnableExactlyOnceDelivery() Optional.
boolean	getEnableMessageOrdering() Optional.
ExpirationPolicy	getExpirationPolicy() Optional.
ExpirationPolicyOrBuilder	getExpirationPolicyOrBuilder() Optional.
String	getFilter() Optional.
com.google.protobuf.ByteString	getFilterBytes() Optional.
Map<String,String>	getLabels() Deprecated.
int	getLabelsCount() Optional.
Map<String,String>	getLabelsMap() Optional.
String	getLabelsOrDefault(String key, String defaultValue) Optional.
String	getLabelsOrThrow(String key) Optional.
com.google.protobuf.Duration	getMessageRetentionDuration() Optional.
com.google.protobuf.DurationOrBuilder	getMessageRetentionDurationOrBuilder() Optional.
MessageTransform	getMessageTransforms(int index) Optional.
int	getMessageTransformsCount() Optional.
List<MessageTransform>	getMessageTransformsList() Optional.
MessageTransformOrBuilder	getMessageTransformsOrBuilder(int index) Optional.
List<? extends MessageTransformOrBuilder>	getMessageTransformsOrBuilderList() Optional.
String	getName() Required.
com.google.protobuf.ByteString	getNameBytes() Required.
PushConfig	getPushConfig() Optional.
PushConfigOrBuilder	getPushConfigOrBuilder() Optional.
boolean	getRetainAckedMessages() Optional.
RetryPolicy	getRetryPolicy() Optional.
RetryPolicyOrBuilder	getRetryPolicyOrBuilder() Optional.
boolean	hasBigqueryConfig() Optional.
boolean	hasCloudStorageConfig() Optional.
boolean	hasDeadLetterPolicy() Optional.
boolean	hasExpirationPolicy() Optional.
boolean	hasMessageRetentionDuration() Optional.
boolean	hasPushConfig() Optional.
boolean	hasRetryPolicy() Optional.

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

isInitialized

Method Detail

getName

String getName()

 Required. Name of the subscription.
 Format is `projects/{project}/subscriptions/{sub}`.
 

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns:

The name.

getNameBytes

com.google.protobuf.ByteString getNameBytes()

 Required. Name of the subscription.
 Format is `projects/{project}/subscriptions/{sub}`.
 

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns:

The bytes for name.

hasPushConfig

boolean hasPushConfig()

 Optional. If push delivery is used with this subscription, this field is
 used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the pushConfig field is set.

getPushConfig

PushConfig getPushConfig()

 Optional. If push delivery is used with this subscription, this field is
 used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The pushConfig.

getPushConfigOrBuilder

PushConfigOrBuilder getPushConfigOrBuilder()

 Optional. If push delivery is used with this subscription, this field is
 used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.PushConfig push_config = 4 [(.google.api.field_behavior) = OPTIONAL];

hasBigqueryConfig

boolean hasBigqueryConfig()

 Optional. If delivery to BigQuery is used with this subscription, this
 field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the bigqueryConfig field is set.

getBigqueryConfig

BigQueryConfig getBigqueryConfig()

 Optional. If delivery to BigQuery is used with this subscription, this
 field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bigqueryConfig.

getBigqueryConfigOrBuilder

BigQueryConfigOrBuilder getBigqueryConfigOrBuilder()

 Optional. If delivery to BigQuery is used with this subscription, this
 field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.BigQueryConfig bigquery_config = 18 [(.google.api.field_behavior) = OPTIONAL];

hasCloudStorageConfig

boolean hasCloudStorageConfig()

 Optional. If delivery to Google Cloud Storage is used with this
 subscription, this field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the cloudStorageConfig field is set.

getCloudStorageConfig

CloudStorageConfig getCloudStorageConfig()

 Optional. If delivery to Google Cloud Storage is used with this
 subscription, this field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The cloudStorageConfig.

getCloudStorageConfigOrBuilder

CloudStorageConfigOrBuilder getCloudStorageConfigOrBuilder()

 Optional. If delivery to Google Cloud Storage is used with this
 subscription, this field is used to configure it.
 

.google.cloud.bigquery.analyticshub.v1.CloudStorageConfig cloud_storage_config = 22 [(.google.api.field_behavior) = OPTIONAL];

getAckDeadlineSeconds

int getAckDeadlineSeconds()

 Optional. The approximate amount of time (on a best-effort basis) Pub/Sub
 waits for the subscriber to acknowledge receipt before resending the
 message. In the interval after the message is delivered and before it is
 acknowledged, it is considered to be _outstanding_. During that time
 period, the message will not be redelivered (on a best-effort basis).

 For pull subscriptions, this value is used as the initial value for the ack
 deadline. To override this value for a given message, call
 `ModifyAckDeadline` with the corresponding `ack_id` if using
 non-streaming pull or send the `ack_id` in a
 `StreamingModifyAckDeadlineRequest` if using streaming pull.
 The minimum custom deadline you can specify is 10 seconds.
 The maximum custom deadline you can specify is 600 seconds (10 minutes).
 If this parameter is 0, a default value of 10 seconds is used.

 For push delivery, this value is also used to set the request timeout for
 the call to the push endpoint.

 If the subscriber never acknowledges the message, the Pub/Sub
 system will eventually redeliver the message.
 

int32 ack_deadline_seconds = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The ackDeadlineSeconds.

getRetainAckedMessages

boolean getRetainAckedMessages()

 Optional. Indicates whether to retain acknowledged messages. If true, then
 messages are not expunged from the subscription's backlog, even if they are
 acknowledged, until they fall out of the `message_retention_duration`
 window. This must be true if you would like to [`Seek` to a timestamp]
 (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in
 the past to replay previously-acknowledged messages.
 

bool retain_acked_messages = 7 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The retainAckedMessages.

hasMessageRetentionDuration

boolean hasMessageRetentionDuration()

 Optional. How long to retain unacknowledged messages in the subscription's
 backlog, from the moment a message is published. If `retain_acked_messages`
 is true, then this also configures the retention of acknowledged messages,
 and thus configures how far back in time a `Seek` can be done. Defaults to
 7 days. Cannot be more than 31 days or less than 10 minutes.
 

.google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the messageRetentionDuration field is set.

getMessageRetentionDuration

com.google.protobuf.Duration getMessageRetentionDuration()

 Optional. How long to retain unacknowledged messages in the subscription's
 backlog, from the moment a message is published. If `retain_acked_messages`
 is true, then this also configures the retention of acknowledged messages,
 and thus configures how far back in time a `Seek` can be done. Defaults to
 7 days. Cannot be more than 31 days or less than 10 minutes.
 

.google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The messageRetentionDuration.

getMessageRetentionDurationOrBuilder

com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder()

 Optional. How long to retain unacknowledged messages in the subscription's
 backlog, from the moment a message is published. If `retain_acked_messages`
 is true, then this also configures the retention of acknowledged messages,
 and thus configures how far back in time a `Seek` can be done. Defaults to
 7 days. Cannot be more than 31 days or less than 10 minutes.
 

.google.protobuf.Duration message_retention_duration = 8 [(.google.api.field_behavior) = OPTIONAL];

getLabelsCount

int getLabelsCount()

 Optional. See [Creating and managing
 labels](https://cloud.google.com/pubsub/docs/labels).
 

map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];

containsLabels

boolean containsLabels(String key)

 Optional. See [Creating and managing
 labels](https://cloud.google.com/pubsub/docs/labels).
 

map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];

getLabels

@Deprecated
Map<String,String> getLabels()

Deprecated.

Use getLabelsMap() instead.

getLabelsMap

Map<String,String> getLabelsMap()

 Optional. See [Creating and managing
 labels](https://cloud.google.com/pubsub/docs/labels).
 

map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];

getLabelsOrDefault

String getLabelsOrDefault(String key,
                          String defaultValue)

 Optional. See [Creating and managing
 labels](https://cloud.google.com/pubsub/docs/labels).
 

map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];

getLabelsOrThrow

String getLabelsOrThrow(String key)

 Optional. See [Creating and managing
 labels](https://cloud.google.com/pubsub/docs/labels).
 

map<string, string> labels = 9 [(.google.api.field_behavior) = OPTIONAL];

getEnableMessageOrdering

boolean getEnableMessageOrdering()

 Optional. If true, messages published with the same `ordering_key` in
 `PubsubMessage` will be delivered to the subscribers in the order in which
 they are received by the Pub/Sub system. Otherwise, they may be delivered
 in any order.
 

bool enable_message_ordering = 10 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The enableMessageOrdering.

hasExpirationPolicy

boolean hasExpirationPolicy()

 Optional. A policy that specifies the conditions for this subscription's
 expiration. A subscription is considered active as long as any connected
 subscriber is successfully consuming messages from the subscription or is
 issuing operations on the subscription. If `expiration_policy` is not set,
 a *default policy* with `ttl` of 31 days will be used. The minimum allowed
 value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
 but `expiration_policy.ttl` is not set, the subscription never expires.
 

.google.cloud.bigquery.analyticshub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the expirationPolicy field is set.

getExpirationPolicy

ExpirationPolicy getExpirationPolicy()

 Optional. A policy that specifies the conditions for this subscription's
 expiration. A subscription is considered active as long as any connected
 subscriber is successfully consuming messages from the subscription or is
 issuing operations on the subscription. If `expiration_policy` is not set,
 a *default policy* with `ttl` of 31 days will be used. The minimum allowed
 value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
 but `expiration_policy.ttl` is not set, the subscription never expires.
 

.google.cloud.bigquery.analyticshub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The expirationPolicy.

getExpirationPolicyOrBuilder

ExpirationPolicyOrBuilder getExpirationPolicyOrBuilder()

 Optional. A policy that specifies the conditions for this subscription's
 expiration. A subscription is considered active as long as any connected
 subscriber is successfully consuming messages from the subscription or is
 issuing operations on the subscription. If `expiration_policy` is not set,
 a *default policy* with `ttl` of 31 days will be used. The minimum allowed
 value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
 but `expiration_policy.ttl` is not set, the subscription never expires.
 

.google.cloud.bigquery.analyticshub.v1.ExpirationPolicy expiration_policy = 11 [(.google.api.field_behavior) = OPTIONAL];

getFilter

String getFilter()

 Optional. An expression written in the Pub/Sub [filter
 language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
 then only `PubsubMessage`s whose `attributes` field matches the filter are
 delivered on this subscription. If empty, then no messages are filtered
 out.
 

string filter = 12 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The filter.

getFilterBytes

com.google.protobuf.ByteString getFilterBytes()

 Optional. An expression written in the Pub/Sub [filter
 language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
 then only `PubsubMessage`s whose `attributes` field matches the filter are
 delivered on this subscription. If empty, then no messages are filtered
 out.
 

string filter = 12 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bytes for filter.

hasDeadLetterPolicy

boolean hasDeadLetterPolicy()

 Optional. A policy that specifies the conditions for dead lettering
 messages in this subscription. If dead_letter_policy is not set, dead
 lettering is disabled.

 The Pub/Sub service account associated with this subscriptions's
 parent project (i.e.,
 service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
 permission to Acknowledge() messages on this subscription.
 

.google.cloud.bigquery.analyticshub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the deadLetterPolicy field is set.

getDeadLetterPolicy

DeadLetterPolicy getDeadLetterPolicy()

 Optional. A policy that specifies the conditions for dead lettering
 messages in this subscription. If dead_letter_policy is not set, dead
 lettering is disabled.

 The Pub/Sub service account associated with this subscriptions's
 parent project (i.e.,
 service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
 permission to Acknowledge() messages on this subscription.
 

.google.cloud.bigquery.analyticshub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The deadLetterPolicy.

getDeadLetterPolicyOrBuilder

DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuilder()

 Optional. A policy that specifies the conditions for dead lettering
 messages in this subscription. If dead_letter_policy is not set, dead
 lettering is disabled.

 The Pub/Sub service account associated with this subscriptions's
 parent project (i.e.,
 service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
 permission to Acknowledge() messages on this subscription.
 

.google.cloud.bigquery.analyticshub.v1.DeadLetterPolicy dead_letter_policy = 13 [(.google.api.field_behavior) = OPTIONAL];

hasRetryPolicy

boolean hasRetryPolicy()

 Optional. A policy that specifies how Pub/Sub retries message delivery for
 this subscription.

 If not set, the default retry policy is applied. This generally implies
 that messages will be retried as soon as possible for healthy subscribers.
 RetryPolicy will be triggered on NACKs or acknowledgement deadline
 exceeded events for a given message.
 

.google.cloud.bigquery.analyticshub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the retryPolicy field is set.

getRetryPolicy

RetryPolicy getRetryPolicy()

 Optional. A policy that specifies how Pub/Sub retries message delivery for
 this subscription.

 If not set, the default retry policy is applied. This generally implies
 that messages will be retried as soon as possible for healthy subscribers.
 RetryPolicy will be triggered on NACKs or acknowledgement deadline
 exceeded events for a given message.
 

.google.cloud.bigquery.analyticshub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The retryPolicy.

getRetryPolicyOrBuilder

RetryPolicyOrBuilder getRetryPolicyOrBuilder()

 Optional. A policy that specifies how Pub/Sub retries message delivery for
 this subscription.

 If not set, the default retry policy is applied. This generally implies
 that messages will be retried as soon as possible for healthy subscribers.
 RetryPolicy will be triggered on NACKs or acknowledgement deadline
 exceeded events for a given message.
 

.google.cloud.bigquery.analyticshub.v1.RetryPolicy retry_policy = 14 [(.google.api.field_behavior) = OPTIONAL];

getDetached

boolean getDetached()

 Optional. Indicates whether the subscription is detached from its topic.
 Detached subscriptions don't receive messages from their topic and don't
 retain any backlog. `Pull` and `StreamingPull` requests will return
 FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
 the endpoint will not be made.
 

bool detached = 15 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The detached.

getEnableExactlyOnceDelivery

boolean getEnableExactlyOnceDelivery()

 Optional. If true, Pub/Sub provides the following guarantees for the
 delivery of a message with a given value of `message_id` on this
 subscription:

 * The message sent to a subscriber is guaranteed not to be resent
 before the message's acknowledgement deadline expires.
 * An acknowledged message will not be resent to a subscriber.

 Note that subscribers may still receive multiple copies of a message
 when `enable_exactly_once_delivery` is true if the message was published
 multiple times by a publisher client. These copies are  considered distinct
 by Pub/Sub and have distinct `message_id` values.
 

bool enable_exactly_once_delivery = 16 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The enableExactlyOnceDelivery.

getMessageTransformsList

List<MessageTransform> getMessageTransformsList()

 Optional. Transforms to be applied to messages before they are delivered to
 subscribers. Transforms are applied in the order specified.
 

repeated .google.cloud.bigquery.analyticshub.v1.MessageTransform message_transforms = 25 [(.google.api.field_behavior) = OPTIONAL];

getMessageTransforms

MessageTransform getMessageTransforms(int index)

 Optional. Transforms to be applied to messages before they are delivered to
 subscribers. Transforms are applied in the order specified.
 

repeated .google.cloud.bigquery.analyticshub.v1.MessageTransform message_transforms = 25 [(.google.api.field_behavior) = OPTIONAL];

getMessageTransformsCount

int getMessageTransformsCount()

 Optional. Transforms to be applied to messages before they are delivered to
 subscribers. Transforms are applied in the order specified.
 

repeated .google.cloud.bigquery.analyticshub.v1.MessageTransform message_transforms = 25 [(.google.api.field_behavior) = OPTIONAL];

getMessageTransformsOrBuilderList

List<? extends MessageTransformOrBuilder> getMessageTransformsOrBuilderList()

 Optional. Transforms to be applied to messages before they are delivered to
 subscribers. Transforms are applied in the order specified.
 

repeated .google.cloud.bigquery.analyticshub.v1.MessageTransform message_transforms = 25 [(.google.api.field_behavior) = OPTIONAL];

getMessageTransformsOrBuilder

MessageTransformOrBuilder getMessageTransformsOrBuilder(int index)

 Optional. Transforms to be applied to messages before they are delivered to
 subscribers. Transforms are applied in the order specified.
 

repeated .google.cloud.bigquery.analyticshub.v1.MessageTransform message_transforms = 25 [(.google.api.field_behavior) = OPTIONAL];