blob: 3c447e43ba7f0b8ef81e0b4a0e302f447dcef0c2 [file] [log] [blame]
Bu Sun Kim673ec5c2020-11-16 11:05:03 -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="logging_v2.html">Cloud Logging API</a> . <a href="logging_v2.billingAccounts.html">billingAccounts</a> . <a href="logging_v2.billingAccounts.locations.html">locations</a> . <a href="logging_v2.billingAccounts.locations.buckets.html">buckets</a> . <a href="logging_v2.billingAccounts.locations.buckets.views.html">views</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">
81 <code><a href="#create">create(parent, body=None, viewId=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Creates a view over logs in a bucket. A bucket may contain a maximum of 50 views.</p>
83<p class="toc_element">
84 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
85<p class="firstline">Deletes a view from a bucket.</p>
86<p class="toc_element">
87 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
88<p class="firstline">Lists views on a bucket.</p>
89<p class="toc_element">
90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
91<p class="firstline">Retrieves the next page of results.</p>
92<p class="toc_element">
93 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
94<p class="firstline">Updates a view. This method replaces the following fields in the existing view with values from the new view: filter.</p>
95<h3>Method Details</h3>
96<div class="method">
97 <code class="details" id="close">close()</code>
98 <pre>Close httplib2 connections.</pre>
99</div>
100
101<div class="method">
102 <code class="details" id="create">create(parent, body=None, viewId=None, x__xgafv=None)</code>
103 <pre>Creates a view over logs in a bucket. A bucket may contain a maximum of 50 views.
104
105Args:
106 parent: string, Required. The bucket in which to create the view &quot;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&quot; Example: &quot;projects/my-logging-project/locations/my-location/buckets/my-bucket&quot; (required)
107 body: object, The request body.
108 The object takes the form of:
109
110{ # Describes a view over logs in a bucket.
111 &quot;filter&quot;: &quot;A String&quot;, # Filter that restricts which log entries in a bucket are visible in this view. Filters are restricted to be a logical AND of ==/!= of any of the following: originating project/folder/organization/billing account. resource type log id Example: SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
112 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
113 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view. For example &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
114 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
115 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
116}
117
118 viewId: string, Required. The id to use for this view.
119 x__xgafv: string, V1 error format.
120 Allowed values
121 1 - v1 error format
122 2 - v2 error format
123
124Returns:
125 An object of the form:
126
127 { # Describes a view over logs in a bucket.
128 &quot;filter&quot;: &quot;A String&quot;, # Filter that restricts which log entries in a bucket are visible in this view. Filters are restricted to be a logical AND of ==/!= of any of the following: originating project/folder/organization/billing account. resource type log id Example: SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
129 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
130 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view. For example &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
131 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
132 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
133 }</pre>
134</div>
135
136<div class="method">
137 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
138 <pre>Deletes a view from a bucket.
139
140Args:
141 name: string, Required. The full resource name of the view to delete: &quot;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]&quot; Example: &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id&quot;. (required)
142 x__xgafv: string, V1 error format.
143 Allowed values
144 1 - v1 error format
145 2 - v2 error format
146
147Returns:
148 An object of the form:
149
150 { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for Empty is empty JSON object {}.
151 }</pre>
152</div>
153
154<div class="method">
155 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
156 <pre>Lists views on a bucket.
157
158Args:
159 parent: string, Required. The bucket whose views are to be listed: &quot;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&quot; (required)
160 pageSize: integer, Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
161 pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
162 x__xgafv: string, V1 error format.
163 Allowed values
164 1 - v1 error format
165 2 - v2 error format
166
167Returns:
168 An object of the form:
169
170 { # The response from ListViews.
171 &quot;views&quot;: [ # A list of views.
172 { # Describes a view over logs in a bucket.
173 &quot;filter&quot;: &quot;A String&quot;, # Filter that restricts which log entries in a bucket are visible in this view. Filters are restricted to be a logical AND of ==/!= of any of the following: originating project/folder/organization/billing account. resource type log id Example: SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
174 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
175 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view. For example &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
176 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
177 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
178 },
179 ],
180 &quot;nextPageToken&quot;: &quot;A String&quot;, # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
181 }</pre>
182</div>
183
184<div class="method">
185 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
186 <pre>Retrieves the next page of results.
187
188Args:
189 previous_request: The request for the previous page. (required)
190 previous_response: The response from the request for the previous page. (required)
191
192Returns:
193 A request object that you can call &#x27;execute()&#x27; on to request the next
194 page. Returns None if there are no more items in the collection.
195 </pre>
196</div>
197
198<div class="method">
199 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
200 <pre>Updates a view. This method replaces the following fields in the existing view with values from the new view: filter.
201
202Args:
203 name: string, Required. The full resource name of the view to update &quot;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]&quot; Example: &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id&quot;. (required)
204 body: object, The request body.
205 The object takes the form of:
206
207{ # Describes a view over logs in a bucket.
208 &quot;filter&quot;: &quot;A String&quot;, # Filter that restricts which log entries in a bucket are visible in this view. Filters are restricted to be a logical AND of ==/!= of any of the following: originating project/folder/organization/billing account. resource type log id Example: SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
209 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
210 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view. For example &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
211 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
212 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
213}
214
215 updateMask: string, Optional. Field mask that specifies the fields in view that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
216 x__xgafv: string, V1 error format.
217 Allowed values
218 1 - v1 error format
219 2 - v2 error format
220
221Returns:
222 An object of the form:
223
224 { # Describes a view over logs in a bucket.
225 &quot;filter&quot;: &quot;A String&quot;, # Filter that restricts which log entries in a bucket are visible in this view. Filters are restricted to be a logical AND of ==/!= of any of the following: originating project/folder/organization/billing account. resource type log id Example: SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
226 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
227 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view. For example &quot;projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view
228 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
229 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
230 }</pre>
231</div>
232
233</body></html>