com.google.pubsub.v1.SubscriptionOrBuilder Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of proto-google-cloud-pubsub-v1 Show documentation
Show all versions of proto-google-cloud-pubsub-v1 Show documentation
PROTO library for proto-google-cloud-pubsub-v1
/*
* Copyright 2020 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
// Generated by the protocol buffer compiler. DO NOT EDIT!
// source: google/pubsub/v1/pubsub.proto
package com.google.pubsub.v1;
public interface SubscriptionOrBuilder
extends
// @@protoc_insertion_point(interface_extends:google.pubsub.v1.Subscription)
com.google.protobuf.MessageOrBuilder {
/**
*
*
*
* Required. The name of the subscription. It must have the format
* `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
* start with a letter, and contain only letters (`[A-Za-z]`), numbers
* (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
* plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
* in length, and it must not start with `"goog"`.
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
*
* @return The name.
*/
java.lang.String getName();
/**
*
*
*
* Required. The name of the subscription. It must have the format
* `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
* start with a letter, and contain only letters (`[A-Za-z]`), numbers
* (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
* plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
* in length, and it must not start with `"goog"`.
*
*
* string name = 1 [(.google.api.field_behavior) = REQUIRED];
*
* @return The bytes for name.
*/
com.google.protobuf.ByteString getNameBytes();
/**
*
*
*
* Required. The name of the topic from which this subscription is receiving
* messages. Format is `projects/{project}/topics/{topic}`. The value of this
* field will be `_deleted-topic_` if the topic has been deleted.
*
*
*
* string topic = 2 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
*
*
* @return The topic.
*/
java.lang.String getTopic();
/**
*
*
*
* Required. The name of the topic from which this subscription is receiving
* messages. Format is `projects/{project}/topics/{topic}`. The value of this
* field will be `_deleted-topic_` if the topic has been deleted.
*
*
*
* string topic = 2 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
*
*
* @return The bytes for topic.
*/
com.google.protobuf.ByteString getTopicBytes();
/**
*
*
*
* If push delivery is used with this subscription, this field is
* used to configure it. An empty `pushConfig` signifies that the subscriber
* will pull and ack messages using API methods.
*
*
* .google.pubsub.v1.PushConfig push_config = 4;
*
* @return Whether the pushConfig field is set.
*/
boolean hasPushConfig();
/**
*
*
*
* If push delivery is used with this subscription, this field is
* used to configure it. An empty `pushConfig` signifies that the subscriber
* will pull and ack messages using API methods.
*
*
* .google.pubsub.v1.PushConfig push_config = 4;
*
* @return The pushConfig.
*/
com.google.pubsub.v1.PushConfig getPushConfig();
/**
*
*
*
* If push delivery is used with this subscription, this field is
* used to configure it. An empty `pushConfig` signifies that the subscriber
* will pull and ack messages using API methods.
*
*
* .google.pubsub.v1.PushConfig push_config = 4;
*/
com.google.pubsub.v1.PushConfigOrBuilder getPushConfigOrBuilder();
/**
*
*
*
* 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 <i>outstanding</i>. 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;
*
* @return The ackDeadlineSeconds.
*/
int getAckDeadlineSeconds();
/**
*
*
*
* 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).
*
*
* bool retain_acked_messages = 7;
*
* @return The retainAckedMessages.
*/
boolean getRetainAckedMessages();
/**
*
*
*
* 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 7 days or less than 10
* minutes.
*
*
* .google.protobuf.Duration message_retention_duration = 8;
*
* @return Whether the messageRetentionDuration field is set.
*/
boolean hasMessageRetentionDuration();
/**
*
*
*
* 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 7 days or less than 10
* minutes.
*
*
* .google.protobuf.Duration message_retention_duration = 8;
*
* @return The messageRetentionDuration.
*/
com.google.protobuf.Duration getMessageRetentionDuration();
/**
*
*
*
* 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 7 days or less than 10
* minutes.
*
*
* .google.protobuf.Duration message_retention_duration = 8;
*/
com.google.protobuf.DurationOrBuilder getMessageRetentionDurationOrBuilder();
/**
*
*
*
* See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
* managing labels</a>.
*
*
* map<string, string> labels = 9;
*/
int getLabelsCount();
/**
*
*
*
* See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
* managing labels</a>.
*
*
* map<string, string> labels = 9;
*/
boolean containsLabels(java.lang.String key);
/** Use {@link #getLabelsMap()} instead. */
@java.lang.Deprecated
java.util.Map getLabels();
/**
*
*
*
* See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
* managing labels</a>.
*
*
* map<string, string> labels = 9;
*/
java.util.Map getLabelsMap();
/**
*
*
*
* See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
* managing labels</a>.
*
*
* map<string, string> labels = 9;
*/
java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.String defaultValue);
/**
*
*
*
* See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
* managing labels</a>.
*
*
* map<string, string> labels = 9;
*/
java.lang.String getLabelsOrThrow(java.lang.String key);
/**
*
*
*
* 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;
*
* @return The enableMessageOrdering.
*/
boolean getEnableMessageOrdering();
/**
*
*
*
* 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.
*
*
* .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
*
* @return Whether the expirationPolicy field is set.
*/
boolean hasExpirationPolicy();
/**
*
*
*
* 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.
*
*
* .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
*
* @return The expirationPolicy.
*/
com.google.pubsub.v1.ExpirationPolicy getExpirationPolicy();
/**
*
*
*
* 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.
*
*
* .google.pubsub.v1.ExpirationPolicy expiration_policy = 11;
*/
com.google.pubsub.v1.ExpirationPolicyOrBuilder getExpirationPolicyOrBuilder();
/**
*
*
*
* 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;
*
* @return The filter.
*/
java.lang.String getFilter();
/**
*
*
*
* 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;
*
* @return The bytes for filter.
*/
com.google.protobuf.ByteString getFilterBytes();
/**
*
*
*
* 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 Cloud 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.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
*
* @return Whether the deadLetterPolicy field is set.
*/
boolean hasDeadLetterPolicy();
/**
*
*
*
* 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 Cloud 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.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
*
* @return The deadLetterPolicy.
*/
com.google.pubsub.v1.DeadLetterPolicy getDeadLetterPolicy();
/**
*
*
*
* 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 Cloud 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.pubsub.v1.DeadLetterPolicy dead_letter_policy = 13;
*/
com.google.pubsub.v1.DeadLetterPolicyOrBuilder getDeadLetterPolicyOrBuilder();
/**
*
*
*
* 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.pubsub.v1.RetryPolicy retry_policy = 14;
*
* @return Whether the retryPolicy field is set.
*/
boolean hasRetryPolicy();
/**
*
*
*
* 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.pubsub.v1.RetryPolicy retry_policy = 14;
*
* @return The retryPolicy.
*/
com.google.pubsub.v1.RetryPolicy getRetryPolicy();
/**
*
*
*
* 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.pubsub.v1.RetryPolicy retry_policy = 14;
*/
com.google.pubsub.v1.RetryPolicyOrBuilder getRetryPolicyOrBuilder();
/**
*
*
*
* 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;
*
* @return The detached.
*/
boolean getDetached();
}