blob: a9ccf27560609fd389a24c930253e956c232d8ae [file] [log] [blame]
Dmitry Frenkel3e17f892020-10-06 16:46:05 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="pubsublite_v1.html">Pub/Sub Lite API</a> . <a href="pubsublite_v1.topicStats.html">topicStats</a> . <a href="pubsublite_v1.topicStats.projects.html">projects</a> . <a href="pubsublite_v1.topicStats.projects.locations.html">locations</a> . <a href="pubsublite_v1.topicStats.projects.locations.topics.html">topics</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080081 <code><a href="#computeHeadCursor">computeHeadCursor(topic, body=None, x__xgafv=None)</a></code></p>
yoshi-code-bota8b35b92021-03-31 13:33:30 -070082<p class="firstline">Compute the head cursor for the partition. The head cursor's offset is guaranteed to be less than or equal to all messages which have not yet been acknowledged as published, and greater than the offset of any message whose publish has already been acknowledged. It is zero if there have never been messages in the partition.</p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080083<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070084 <code><a href="#computeMessageStats">computeMessageStats(topic, body=None, x__xgafv=None)</a></code></p>
85<p class="firstline">Compute statistics about a range of messages in a given topic and partition.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="close">close()</code>
89 <pre>Close httplib2 connections.</pre>
90</div>
91
92<div class="method">
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080093 <code class="details" id="computeHeadCursor">computeHeadCursor(topic, body=None, x__xgafv=None)</code>
yoshi-code-bota8b35b92021-03-31 13:33:30 -070094 <pre>Compute the head cursor for the partition. The head cursor&#x27;s offset is guaranteed to be less than or equal to all messages which have not yet been acknowledged as published, and greater than the offset of any message whose publish has already been acknowledged. It is zero if there have never been messages in the partition.
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080095
96Args:
97 topic: string, Required. The topic for which we should compute the head cursor. (required)
98 body: object, The request body.
99 The object takes the form of:
100
101{ # Compute the current head cursor for a partition.
102 &quot;partition&quot;: &quot;A String&quot;, # Required. The partition for which we should compute the head cursor.
103}
104
105 x__xgafv: string, V1 error format.
106 Allowed values
107 1 - v1 error format
108 2 - v2 error format
109
110Returns:
111 An object of the form:
112
113 { # Response containing the head cursor for the requested topic and partition.
114 &quot;headCursor&quot;: { # A cursor that describes the position of a message within a topic partition. # The head cursor.
115 &quot;offset&quot;: &quot;A String&quot;, # The offset of a message within a topic partition. Must be greater than or equal 0.
116 },
117}</pre>
118</div>
119
120<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700121 <code class="details" id="computeMessageStats">computeMessageStats(topic, body=None, x__xgafv=None)</code>
122 <pre>Compute statistics about a range of messages in a given topic and partition.
123
124Args:
125 topic: string, Required. The topic for which we should compute message stats. (required)
126 body: object, The request body.
127 The object takes the form of:
128
129{ # Compute statistics about a range of messages in a given topic and partition.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800130 &quot;endCursor&quot;: { # A cursor that describes the position of a message within a topic partition. # The exclusive end of the range. The range is empty if end_cursor &lt;= start_cursor. Specifying a start_cursor before the first message and an end_cursor after the last message will retrieve all messages.
131 &quot;offset&quot;: &quot;A String&quot;, # The offset of a message within a topic partition. Must be greater than or equal 0.
132 },
133 &quot;partition&quot;: &quot;A String&quot;, # Required. The partition for which we should compute message stats.
134 &quot;startCursor&quot;: { # A cursor that describes the position of a message within a topic partition. # The inclusive start of the range.
135 &quot;offset&quot;: &quot;A String&quot;, # The offset of a message within a topic partition. Must be greater than or equal 0.
136 },
137}
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700138
139 x__xgafv: string, V1 error format.
140 Allowed values
141 1 - v1 error format
142 2 - v2 error format
143
144Returns:
145 An object of the form:
146
147 { # Response containing stats for messages in the requested topic and partition.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800148 &quot;messageBytes&quot;: &quot;A String&quot;, # The number of quota bytes accounted to these messages.
149 &quot;messageCount&quot;: &quot;A String&quot;, # The count of messages.
150 &quot;minimumEventTime&quot;: &quot;A String&quot;, # The minimum event timestamp across these messages. For the purposes of this computation, if a message does not have an event time, we use the publish time. The timestamp will be unset if there are no messages.
151 &quot;minimumPublishTime&quot;: &quot;A String&quot;, # The minimum publish timestamp across these messages. Note that publish timestamps within a partition are not guaranteed to be non-decreasing. The timestamp will be unset if there are no messages.
152}</pre>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700153</div>
154
155</body></html>