diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 2fbd6ff96..b53ef596d 100644 --- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -197,16 +197,16 @@ public SubscriberStub getStub() { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *
If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *
Sample code: * @@ -265,16 +265,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *
If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *
Sample code: * @@ -330,16 +330,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *
If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *
Sample code: * @@ -434,16 +434,16 @@ public final Subscription createSubscription( // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * Creates a subscription to a given topic. See the <a - * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name - * rules</a>. If the subscription already exists, returns `ALREADY_EXISTS`. If the - * corresponding topic doesn't exist, returns `NOT_FOUND`. + * Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). If the subscription already + * exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns + * `NOT_FOUND`. * *
If the name is not provided in the request, the server will assign a random name for this - * subscription on the same project as the topic, conforming to the [resource name - * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is - * populated in the returned Subscription object. Note that for REST API requests, you must - * specify a name in the request. + * subscription on the same project as the topic, conforming to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is populated in + * the returned Subscription object. Note that for REST API requests, you must specify a name in + * the request. * *
Sample code:
*
@@ -1525,10 +1525,10 @@ public final UnaryCallable Sample code:
*
@@ -1555,10 +1555,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ProjectName project) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -1582,10 +1582,10 @@ public final ListSnapshotsPagedResponse listSnapshots(String project) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -1610,10 +1610,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -1638,10 +1638,10 @@ public final ListSnapshotsPagedResponse listSnapshots(ListSnapshotsRequest reque
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the existing snapshots. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -1672,19 +1672,18 @@ public final UnaryCallable Sample code:
*
@@ -1722,19 +1721,18 @@ public final Snapshot createSnapshot(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates a snapshot from the requested subscription. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested
- * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old
- * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is
- * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the
- * request, the server will assign a random name for this snapshot on the same project as the
- * subscription, conforming to the [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is
- * populated in the returned Snapshot object. Note that for REST API requests, you must specify a
- * name in the request.
+ * Creates a snapshot from the requested subscription. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot. If the snapshot
+ * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns
+ * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would
+ * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the
+ * `Snapshot.expire_time` field. If the name is not provided in the request, the server will
+ * assign a random name for this snapshot on the same project as the subscription, conforming to
+ * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * generated name is populated in the returned Snapshot object. Note that for REST API requests,
+ * you must specify a name in the request.
*
* Sample code:
*
@@ -1768,19 +1766,18 @@ public final Snapshot createSnapshot(String name, String subscription) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates a snapshot from the requested subscription. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested
- * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old
- * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is
- * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the
- * request, the server will assign a random name for this snapshot on the same project as the
- * subscription, conforming to the [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is
- * populated in the returned Snapshot object. Note that for REST API requests, you must specify a
- * name in the request.
+ * Creates a snapshot from the requested subscription. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot. If the snapshot
+ * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns
+ * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would
+ * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the
+ * `Snapshot.expire_time` field. If the name is not provided in the request, the server will
+ * assign a random name for this snapshot on the same project as the subscription, conforming to
+ * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * generated name is populated in the returned Snapshot object. Note that for REST API requests,
+ * you must specify a name in the request.
*
* Sample code:
*
@@ -1805,19 +1802,18 @@ public final Snapshot createSnapshot(CreateSnapshotRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates a snapshot from the requested subscription. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`. If the requested
- * subscription doesn't exist, returns `NOT_FOUND`. If the backlog in the subscription is too old
- * -- and the resulting snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is
- * returned. See also the `Snapshot.expire_time` field. If the name is not provided in the
- * request, the server will assign a random name for this snapshot on the same project as the
- * subscription, conforming to the [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The generated name is
- * populated in the returned Snapshot object. Note that for REST API requests, you must specify a
- * name in the request.
+ * Creates a snapshot from the requested subscription. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot. If the snapshot
+ * already exists, returns `ALREADY_EXISTS`. If the requested subscription doesn't exist, returns
+ * `NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting snapshot would
+ * expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. See also the
+ * `Snapshot.expire_time` field. If the name is not provided in the request, the server will
+ * assign a random name for this snapshot on the same project as the subscription, conforming to
+ * the [resource name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * generated name is populated in the returned Snapshot object. Note that for REST API requests,
+ * you must specify a name in the request.
*
* Sample code:
*
@@ -1916,14 +1912,13 @@ public final UnaryCallable Sample code:
*
@@ -1948,14 +1943,13 @@ public final void deleteSnapshot(ProjectSnapshotName snapshot) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a
- * snapshot.<br><br> When the snapshot is deleted, all messages retained in the
- * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with
- * the same name, but the new one has no association with the old snapshot or its subscription,
- * unless the same subscription is specified.
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all
+ * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new
+ * one may be created with the same name, but the new one has no association with the old snapshot
+ * or its subscription, unless the same subscription is specified.
*
* Sample code:
*
@@ -1978,14 +1972,13 @@ public final void deleteSnapshot(String snapshot) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a
- * snapshot.<br><br> When the snapshot is deleted, all messages retained in the
- * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with
- * the same name, but the new one has no association with the old snapshot or its subscription,
- * unless the same subscription is specified.
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all
+ * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new
+ * one may be created with the same name, but the new one has no association with the old snapshot
+ * or its subscription, unless the same subscription is specified.
*
* Sample code:
*
@@ -2008,14 +2001,13 @@ public final void deleteSnapshot(DeleteSnapshotRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Removes an existing snapshot. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a
- * snapshot.<br><br> When the snapshot is deleted, all messages retained in the
- * snapshot are immediately dropped. After a snapshot is deleted, a new one may be created with
- * the same name, but the new one has no association with the old snapshot or its subscription,
- * unless the same subscription is specified.
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot. When the snapshot is deleted, all
+ * messages retained in the snapshot are immediately dropped. After a snapshot is deleted, a new
+ * one may be created with the same name, but the new one has no association with the old snapshot
+ * or its subscription, unless the same subscription is specified.
*
* Sample code:
*
@@ -2038,11 +2030,11 @@ public final UnaryCallable Sample code:
*
@@ -2066,11 +2058,11 @@ public final SeekResponse seek(SeekRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided
- * in the request. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot. Note that
- * both the subscription and the snapshot must be on the same topic.
+ * in the request. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage
+ * message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in
+ * an existing subscription to the state captured by a snapshot. Note that both the subscription
+ * and the snapshot must be on the same topic.
*
* Sample code:
*
diff --git a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
index 1d1096550..482969622 100644
--- a/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
+++ b/google-cloud-pubsub/src/main/java/com/google/cloud/pubsub/v1/TopicAdminClient.java
@@ -182,9 +182,8 @@ public PublisherStub getStub() {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates the given topic with the given name. See the <a
- * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
- * rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
* Sample code:
*
@@ -209,9 +208,8 @@ public final Topic createTopic(TopicName name) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates the given topic with the given name. See the <a
- * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
- * rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
* Sample code:
*
@@ -264,9 +262,8 @@ public final Topic createTopic(ProjectTopicName name) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates the given topic with the given name. See the <a
- * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
- * rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
* Sample code:
*
@@ -289,9 +286,8 @@ public final Topic createTopic(Topic request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates the given topic with the given name. See the <a
- * href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource name
- * rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
* Sample code:
*
@@ -889,10 +885,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the names of the snapshots on this topic. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the names of the snapshots on this topic. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -919,10 +915,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the names of the snapshots on this topic. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the names of the snapshots on this topic. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -947,10 +943,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the names of the snapshots on this topic. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the names of the snapshots on this topic. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -976,10 +972,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the names of the snapshots on this topic. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the names of the snapshots on this topic. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
@@ -1005,10 +1001,10 @@ public final ListTopicSubscriptionsPagedResponse listTopicSubscriptions(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Lists the names of the snapshots on this topic. Snapshots are used in <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a> operations, which
- * allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment
- * state of messages in an existing subscription to the state captured by a snapshot.
+ * Lists the names of the snapshots on this topic. Snapshots are used in
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to
+ * manage message acknowledgments in bulk. That is, you can set the acknowledgment state of
+ * messages in an existing subscription to the state captured by a snapshot.
*
* Sample code:
*
diff --git a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java
index 8ddccd07f..d1e85d8f4 100644
--- a/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java
+++ b/grpc-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PublisherGrpc.java
@@ -468,9 +468,8 @@ public abstract static class PublisherImplBase implements io.grpc.BindableServic
*
*
*
- * Creates the given topic with the given name. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
*/
public void createTopic(
@@ -552,11 +551,10 @@ public void listTopicSubscriptions(
*
*
* Lists the names of the snapshots on this topic. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public void listTopicSnapshots(
@@ -685,9 +683,8 @@ protected PublisherStub build(io.grpc.Channel channel, io.grpc.CallOptions callO
*
*
*
- * Creates the given topic with the given name. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
*/
public void createTopic(
@@ -781,11 +778,10 @@ public void listTopicSubscriptions(
*
*
* Lists the names of the snapshots on this topic. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public void listTopicSnapshots(
@@ -863,9 +859,8 @@ protected PublisherBlockingStub build(
*
*
*
- * Creates the given topic with the given name. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
*/
public com.google.pubsub.v1.Topic createTopic(com.google.pubsub.v1.Topic request) {
@@ -938,11 +933,10 @@ public com.google.pubsub.v1.ListTopicSubscriptionsResponse listTopicSubscription
*
*
* Lists the names of the snapshots on this topic. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public com.google.pubsub.v1.ListTopicSnapshotsResponse listTopicSnapshots(
@@ -1006,9 +1000,8 @@ protected PublisherFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
*
*
*
- * Creates the given topic with the given name. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates the given topic with the given name. See the [resource name rules](
+ * https://cloud.google.com/pubsub/docs/admin#resource_names).
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Creates a subscription to a given topic. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates a subscription to a given topic. See the [resource name rules]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names).
* If the subscription already exists, returns `ALREADY_EXISTS`.
* If the corresponding topic doesn't exist, returns `NOT_FOUND`.
* If the name is not provided in the request, the server will assign a random
* name for this subscription on the same project as the topic, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
- * generated name is populated in the returned Subscription object. Note that
- * for REST API requests, you must specify a name in the request.
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+ * name is populated in the returned Subscription object. Note that for REST
+ * API requests, you must specify a name in the request.
*
*/
public void createSubscription(
@@ -932,12 +930,11 @@ public void getSnapshot(
*
*
*
- * Lists the existing snapshots. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public void listSnapshots(
@@ -951,21 +948,19 @@ public void listSnapshots(
*
*
* Creates a snapshot from the requested subscription. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
+ * If the snapshot already exists, returns `ALREADY_EXISTS`.
* If the requested subscription doesn't exist, returns `NOT_FOUND`.
* If the backlog in the subscription is too old -- and the resulting snapshot
* would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
* See also the `Snapshot.expire_time` field. If the name is not provided in
* the request, the server will assign a random
* name for this snapshot on the same project as the subscription, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
* generated name is populated in the returned Snapshot object. Note that for
* REST API requests, you must specify a name in the request.
*
@@ -998,12 +993,11 @@ public void updateSnapshot(
*
*
*
- * Removes an existing snapshot. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.<br><br>
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
* When the snapshot is deleted, all messages retained in the snapshot
* are immediately dropped. After a snapshot is deleted, a new one may be
* created with the same name, but the new one has no association with the old
@@ -1021,13 +1015,12 @@ public void deleteSnapshot(
*
*
*
* Protobuf type {@code google.pubsub.v1.PubsubMessage}
@@ -1462,9 +1456,6 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot. Note that both the subscription and the snapshot
- * must be on the same topic.
+ * whichever is provided in the request. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot. Note that both the subscription and the
+ * snapshot must be on the same topic.
*
*/
public void seek(
@@ -1163,18 +1156,16 @@ protected SubscriberStub build(io.grpc.Channel channel, io.grpc.CallOptions call
*
*
*
- * Creates a subscription to a given topic. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates a subscription to a given topic. See the [resource name rules]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names).
* If the subscription already exists, returns `ALREADY_EXISTS`.
* If the corresponding topic doesn't exist, returns `NOT_FOUND`.
* If the name is not provided in the request, the server will assign a random
* name for this subscription on the same project as the topic, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
- * generated name is populated in the returned Subscription object. Note that
- * for REST API requests, you must specify a name in the request.
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+ * name is populated in the returned Subscription object. Note that for REST
+ * API requests, you must specify a name in the request.
*
*/
public void createSubscription(
@@ -1376,12 +1367,11 @@ public void getSnapshot(
*
*
*
- * Lists the existing snapshots. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public void listSnapshots(
@@ -1398,21 +1388,19 @@ public void listSnapshots(
*
*
* Creates a snapshot from the requested subscription. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
+ * If the snapshot already exists, returns `ALREADY_EXISTS`.
* If the requested subscription doesn't exist, returns `NOT_FOUND`.
* If the backlog in the subscription is too old -- and the resulting snapshot
* would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
* See also the `Snapshot.expire_time` field. If the name is not provided in
* the request, the server will assign a random
* name for this snapshot on the same project as the subscription, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
* generated name is populated in the returned Snapshot object. Note that for
* REST API requests, you must specify a name in the request.
*
@@ -1451,12 +1439,11 @@ public void updateSnapshot(
*
*
*
- * Removes an existing snapshot. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.<br><br>
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
* When the snapshot is deleted, all messages retained in the snapshot
* are immediately dropped. After a snapshot is deleted, a new one may be
* created with the same name, but the new one has no association with the old
@@ -1477,13 +1464,12 @@ public void deleteSnapshot(
*
*
*
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot. Note that both the subscription and the snapshot
- * must be on the same topic.
+ * whichever is provided in the request. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot. Note that both the subscription and the
+ * snapshot must be on the same topic.
*
*/
public void seek(
@@ -1519,18 +1505,16 @@ protected SubscriberBlockingStub build(
*
*
*
- * Creates a subscription to a given topic. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates a subscription to a given topic. See the [resource name rules]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names).
* If the subscription already exists, returns `ALREADY_EXISTS`.
* If the corresponding topic doesn't exist, returns `NOT_FOUND`.
* If the name is not provided in the request, the server will assign a random
* name for this subscription on the same project as the topic, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
- * generated name is populated in the returned Subscription object. Note that
- * for REST API requests, you must specify a name in the request.
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+ * name is populated in the returned Subscription object. Note that for REST
+ * API requests, you must specify a name in the request.
*
*/
public com.google.pubsub.v1.Subscription createSubscription(
@@ -1678,12 +1662,11 @@ public com.google.pubsub.v1.Snapshot getSnapshot(
*
*
*
- * Lists the existing snapshots. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
@@ -1696,21 +1679,19 @@ public com.google.pubsub.v1.ListSnapshotsResponse listSnapshots(
*
*
* Creates a snapshot from the requested subscription. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
+ * If the snapshot already exists, returns `ALREADY_EXISTS`.
* If the requested subscription doesn't exist, returns `NOT_FOUND`.
* If the backlog in the subscription is too old -- and the resulting snapshot
* would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
* See also the `Snapshot.expire_time` field. If the name is not provided in
* the request, the server will assign a random
* name for this snapshot on the same project as the subscription, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
* generated name is populated in the returned Snapshot object. Note that for
* REST API requests, you must specify a name in the request.
*
@@ -1741,12 +1722,11 @@ public com.google.pubsub.v1.Snapshot updateSnapshot(
*
*
*
- * Removes an existing snapshot. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.<br><br>
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
* When the snapshot is deleted, all messages retained in the snapshot
* are immediately dropped. After a snapshot is deleted, a new one may be
* created with the same name, but the new one has no association with the old
@@ -1763,13 +1743,12 @@ public com.google.protobuf.Empty deleteSnapshot(
*
*
*
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot. Note that both the subscription and the snapshot
- * must be on the same topic.
+ * whichever is provided in the request. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot. Note that both the subscription and the
+ * snapshot must be on the same topic.
*
*/
public com.google.pubsub.v1.SeekResponse seek(com.google.pubsub.v1.SeekRequest request) {
@@ -1801,18 +1780,16 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Creates a subscription to a given topic. See the
- * <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
- * resource name rules</a>.
+ * Creates a subscription to a given topic. See the [resource name rules]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names).
* If the subscription already exists, returns `ALREADY_EXISTS`.
* If the corresponding topic doesn't exist, returns `NOT_FOUND`.
* If the name is not provided in the request, the server will assign a random
* name for this subscription on the same project as the topic, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
- * generated name is populated in the returned Subscription object. Note that
- * for REST API requests, you must specify a name in the request.
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+ * name is populated in the returned Subscription object. Note that for REST
+ * API requests, you must specify a name in the request.
*
*/
public com.google.common.util.concurrent.ListenableFuture
- * Lists the existing snapshots. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * Lists the existing snapshots. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -1986,21 +1962,19 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
* Creates a snapshot from the requested subscription. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
- * <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ * which allow you to manage message acknowledgments in bulk. That is, you can
+ * set the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
+ * If the snapshot already exists, returns `ALREADY_EXISTS`.
* If the requested subscription doesn't exist, returns `NOT_FOUND`.
* If the backlog in the subscription is too old -- and the resulting snapshot
* would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
* See also the `Snapshot.expire_time` field. If the name is not provided in
* the request, the server will assign a random
* name for this snapshot on the same project as the subscription, conforming
- * to the
- * [resource name
- * format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ * to the [resource name format]
+ * (https://cloud.google.com/pubsub/docs/admin#resource_names). The
* generated name is populated in the returned Snapshot object. Note that for
* REST API requests, you must specify a name in the request.
*
@@ -2033,12 +2007,11 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
- * Removes an existing snapshot. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.<br><br>
+ * Removes an existing snapshot. Snapshots are used in [Seek]
+ * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot.
* When the snapshot is deleted, all messages retained in the snapshot
* are immediately dropped. After a snapshot is deleted, a new one may be
* created with the same name, but the new one has no association with the old
@@ -2056,13 +2029,12 @@ protected SubscriberFutureStub build(io.grpc.Channel channel, io.grpc.CallOption
*
*
*
* Protobuf type {@code google.pubsub.v1.PubsubMessage}
@@ -419,9 +419,6 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
* Seeks an existing subscription to a point in time or to a given snapshot,
- * whichever is provided in the request. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot. Note that both the subscription and the snapshot
- * must be on the same topic.
+ * whichever is provided in the request. Snapshots are used in [Seek](
+ * https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ * allow you to manage message acknowledgments in bulk. That is, you can set
+ * the acknowledgment state of messages in an existing subscription to the
+ * state captured by a snapshot. Note that both the subscription and the
+ * snapshot must be on the same topic.
*
*/
public com.google.common.util.concurrent.ListenableFuturestring ordering_key = 5;
@@ -450,9 +447,6 @@ public java.lang.String getOrderingKey() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
* string ordering_key = 5;
@@ -685,11 +679,11 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
* A message that is published by publishers and consumed by subscribers. The
* message must contain either a non-empty data field or at least one attribute.
* Note that client libraries represent this object differently
- * depending on the language. See the corresponding
- * <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
- * library documentation</a> for more information. See
- * <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
- * for more information about message limits.
+ * depending on the language. See the corresponding [client library
+ * documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+ * more information. See [quotas and limits]
+ * (https://cloud.google.com/pubsub/quotas) for more information about message
+ * limits.
* string ordering_key = 5;
@@ -1492,9 +1483,6 @@ public java.lang.String getOrderingKey() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
@@ -1522,9 +1510,6 @@ public com.google.protobuf.ByteString getOrderingKeyBytes() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
@@ -1551,9 +1536,6 @@ public Builder setOrderingKey(java.lang.String value) {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
@@ -1576,9 +1558,6 @@ public Builder clearOrderingKey() {
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java
index dfe2dcf0c..a81cdd8e2 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/PubsubMessageOrBuilder.java
@@ -183,9 +183,6 @@ public interface PubsubMessageOrBuilder
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
@@ -203,9 +200,6 @@ public interface PubsubMessageOrBuilder
* delivered to subscribers in the order in which they are received by the
* Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
* must specify the same `ordering_key` value.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* string ordering_key = 5;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
index 6d6000105..7097a40b5 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Snapshot.java
@@ -23,11 +23,10 @@
*
*
* A snapshot resource. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+ * operations, which allow you to manage message acknowledgments in bulk. That
+ * is, you can set the acknowledgment state of messages in an existing
+ * subscription to the state captured by a snapshot.
*
*
* Protobuf type {@code google.pubsub.v1.Snapshot}
@@ -362,8 +361,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -385,8 +384,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -399,8 +398,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -417,8 +416,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -637,11 +636,10 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
* A snapshot resource. Snapshots are used in
- * <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
- * operations, which allow
- * you to manage message acknowledgments in bulk. That is, you can set the
- * acknowledgment state of messages in an existing subscription to the state
- * captured by a snapshot.
+ * [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+ * operations, which allow you to manage message acknowledgments in bulk. That
+ * is, you can set the acknowledgment state of messages in an existing
+ * subscription to the state captured by a snapshot.
*
*
* Protobuf type {@code google.pubsub.v1.Snapshot}
@@ -1343,8 +1341,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1366,8 +1364,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1380,8 +1378,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1399,8 +1397,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1425,8 +1423,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1447,8 +1445,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -1467,8 +1465,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
index 9ef1ef752..c8d3ed3ad 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SnapshotOrBuilder.java
@@ -139,8 +139,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -150,8 +150,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -164,8 +164,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -175,8 +175,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
@@ -186,8 +186,8 @@ public interface SnapshotOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 4;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
index 01a1c6fe5..3b1afd152 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Subscription.java
@@ -460,10 +460,8 @@ public 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
- * <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
- * Seek to a timestamp</a>.
+ * 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;
@@ -650,9 +648,6 @@ public java.lang.String getLabelsOrThrow(java.lang.String key) {
* 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.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* bool enable_message_ordering = 10;
@@ -2094,10 +2089,8 @@ public Builder clearAckDeadlineSeconds() {
* 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
- * <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
- * Seek to a timestamp</a>.
+ * 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;
@@ -2115,10 +2108,8 @@ public boolean getRetainAckedMessages() {
* 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
- * <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
- * Seek to a timestamp</a>.
+ * 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;
@@ -2139,10 +2130,8 @@ public Builder setRetainAckedMessages(boolean value) {
* 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
- * <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
- * Seek to a timestamp</a>.
+ * 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;
@@ -2560,9 +2549,6 @@ public Builder putAllLabels(java.util.Mapbool enable_message_ordering = 10;
@@ -2581,9 +2567,6 @@ public boolean getEnableMessageOrdering() {
* 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.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* bool enable_message_ordering = 10;
@@ -2605,9 +2588,6 @@ public Builder setEnableMessageOrdering(boolean value) {
* 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.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* bool enable_message_ordering = 10;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
index f7d1714d1..e19141cb0 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/SubscriptionOrBuilder.java
@@ -168,10 +168,8 @@ public interface SubscriptionOrBuilder
* 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
- * <a
- * href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
- * Seek to a timestamp</a>.
+ * 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;
@@ -297,9 +295,6 @@ public interface SubscriptionOrBuilder
* 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.
- * <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
- * API might be changed in backward-incompatible ways and is not recommended
- * for production use. It is not subject to any SLA or deprecation policy.
*
*
* bool enable_message_ordering = 10;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
index 5df76aa71..18db5a187 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/Topic.java
@@ -246,8 +246,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -269,8 +269,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -283,8 +283,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -301,8 +301,8 @@ public java.lang.String getLabelsOrDefault(java.lang.String key, java.lang.Strin
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -985,8 +985,8 @@ public int getLabelsCount() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1008,8 +1008,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1022,8 +1022,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1041,8 +1041,8 @@ public java.lang.String getLabelsOrDefault(
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1067,8 +1067,8 @@ public Builder clearLabels() {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1089,8 +1089,8 @@ public java.util.Map
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -1109,8 +1109,8 @@ public Builder putLabels(java.lang.String key, java.lang.String value) {
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
diff --git a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
index 1e1338b11..a11846480 100644
--- a/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
+++ b/proto-google-cloud-pubsub-v1/src/main/java/com/google/pubsub/v1/TopicOrBuilder.java
@@ -62,8 +62,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -73,8 +73,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -87,8 +87,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -98,8 +98,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
@@ -109,8 +109,8 @@ public interface TopicOrBuilder
*
*
*
- * See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
- * managing labels</a>.
+ * See [Creating and managing labels]
+ * (https://cloud.google.com/pubsub/docs/labels).
*
*
* map<string, string> labels = 2;
diff --git a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
index dc9151446..909863eb9 100644
--- a/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
+++ b/proto-google-cloud-pubsub-v1/src/main/proto/google/pubsub/v1/pubsub.proto
@@ -42,9 +42,8 @@ service Publisher {
"https://www.googleapis.com/auth/cloud-platform,"
"https://www.googleapis.com/auth/pubsub";
- // Creates the given topic with the given name. See the
- //
- // resource name rules.
+ // Creates the given topic with the given name. See the [resource name rules](
+ // https://cloud.google.com/pubsub/docs/admin#resource_names).
rpc CreateTopic(Topic) returns (Topic) {
option (google.api.http) = {
put: "/v1/{name=projects/*/topics/*}"
@@ -98,11 +97,10 @@ service Publisher {
}
// Lists the names of the snapshots on this topic. Snapshots are used in
- // Seek
- // operations, which allow
- // you to manage message acknowledgments in bulk. That is, you can set the
- // acknowledgment state of messages in an existing subscription to the state
- // captured by a snapshot.
+ // [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ // which allow you to manage message acknowledgments in bulk. That is, you can
+ // set the acknowledgment state of messages in an existing subscription to the
+ // state captured by a snapshot.
rpc ListTopicSnapshots(ListTopicSnapshotsRequest)
returns (ListTopicSnapshotsResponse) {
option (google.api.http) = {
@@ -161,8 +159,8 @@ message Topic {
// must not start with `"goog"`.
string name = 1 [(google.api.field_behavior) = REQUIRED];
- // See Creating and
- // managing labels.
+ // See [Creating and managing labels]
+ // (https://cloud.google.com/pubsub/docs/labels).
map
If the snapshot already exists, returns `ALREADY_EXISTS`.
+ // [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+ // which allow you to manage message acknowledgments in bulk. That is, you can
+ // set the acknowledgment state of messages in an existing subscription to the
+ // state captured by a snapshot.
+ // If the snapshot already exists, returns `ALREADY_EXISTS`.
// If the requested subscription doesn't exist, returns `NOT_FOUND`.
// If the backlog in the subscription is too old -- and the resulting snapshot
// would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
// See also the `Snapshot.expire_time` field. If the name is not provided in
// the request, the server will assign a random
// name for this snapshot on the same project as the subscription, conforming
- // to the
- // [resource name
- // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+ // to the [resource name format]
+ // (https://cloud.google.com/pubsub/docs/admin#resource_names). The
// generated name is populated in the returned Snapshot object. Note that for
// REST API requests, you must specify a name in the request.
rpc CreateSnapshot(CreateSnapshotRequest) returns (Snapshot) {
@@ -580,12 +570,11 @@ service Subscriber {
};
}
- // Removes an existing snapshot. Snapshots are used in
- // Seek
- // operations, which allow
- // you to manage message acknowledgments in bulk. That is, you can set the
- // acknowledgment state of messages in an existing subscription to the state
- // captured by a snapshot.
+ // Removes an existing snapshot. Snapshots are used in [Seek]
+ // (https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ // allow you to manage message acknowledgments in bulk. That is, you can set
+ // the acknowledgment state of messages in an existing subscription to the
+ // state captured by a snapshot.
// When the snapshot is deleted, all messages retained in the snapshot
// are immediately dropped. After a snapshot is deleted, a new one may be
// created with the same name, but the new one has no association with the old
@@ -598,13 +587,12 @@ service Subscriber {
}
// Seeks an existing subscription to a point in time or to a given snapshot,
- // whichever is provided in the request. Snapshots are used in
- // Seek
- // operations, which allow
- // you to manage message acknowledgments in bulk. That is, you can set the
- // acknowledgment state of messages in an existing subscription to the state
- // captured by a snapshot. Note that both the subscription and the snapshot
- // must be on the same topic.
+ // whichever is provided in the request. Snapshots are used in [Seek](
+ // https://cloud.google.com/pubsub/docs/replay-overview) operations, which
+ // allow you to manage message acknowledgments in bulk. That is, you can set
+ // the acknowledgment state of messages in an existing subscription to the
+ // state captured by a snapshot. Note that both the subscription and the
+ // snapshot must be on the same topic.
rpc Seek(SeekRequest) returns (SeekResponse) {
option (google.api.http) = {
post: "/v1/{subscription=projects/*/subscriptions/*}:seek"
@@ -666,10 +654,8 @@ message Subscription {
// 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.
+ // 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;
// How long to retain unacknowledged messages in the subscription's backlog,
@@ -688,9 +674,6 @@ message Subscription {
// 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.
- // EXPERIMENTAL: This feature is part of a closed alpha release. This
- // API might be changed in backward-incompatible ways and is not recommended
- // for production use. It is not subject to any SLA or deprecation policy.
bool enable_message_ordering = 10;
// A policy that specifies the conditions for this subscription's expiration.
@@ -1186,11 +1169,10 @@ message UpdateSnapshotRequest {
}
// A snapshot resource. Snapshots are used in
-// Seek
-// operations, which allow
-// you to manage message acknowledgments in bulk. That is, you can set the
-// acknowledgment state of messages in an existing subscription to the state
-// captured by a snapshot.
+// [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+// operations, which allow you to manage message acknowledgments in bulk. That
+// is, you can set the acknowledgment state of messages in an existing
+// subscription to the state captured by a snapshot.
message Snapshot {
option (google.api.resource) = {
type: "pubsub.googleapis.com/Snapshot"
@@ -1217,8 +1199,8 @@ message Snapshot {
// snapshot that would expire in less than 1 hour after creation.
google.protobuf.Timestamp expire_time = 3;
- // See Creating and
- // managing labels.
+ // See [Creating and managing labels]
+ // (https://cloud.google.com/pubsub/docs/labels).
map