Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided in the request. Snapshots are used in subscriptions.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.
HTTP request
Path parameters
| Parameters | |
|---|---|
subscription
|
Required. The subscription to affect. |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ // Union field |
Union field target
.
target
can be only one of the following:
time
string (
Timestamp
format)
Optional. The time to seek to. Messages retained in the subscription that were published before this time are marked as acknowledged, and messages retained in the subscription that were published after this time are marked as unacknowledged. Note that this operation affects only those messages retained in the subscription (configured by the combination of messageRetentionDuration
and retainAckedMessages
). For example, if time
corresponds to a point before the message retention window (or to a point before the system's notion of the subscription creation time), only retained messages will be marked as unacknowledged, and already-expunged messages will not be restored.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
or "2014-10-02T15:01:23+05:30"
.
snapshot
string
Optional. The snapshot to seek to. The snapshot's topic must be the same as that of the provided subscription. Format is projects/{project}/snapshots/{snap}
.
Response body
If successful, the response body is empty.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/pubsub -
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
