blob: e05c83809199785e482146009a5836c9a75c0b8b [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>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -070082<p class="firstline">Creates a view over log entries in a log bucket. A bucket may contain a maximum of 50 views.</p>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070083<p class="toc_element">
84 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -070085<p class="firstline">Deletes a view on a log bucket.</p>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070086<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080087 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -070088<p class="firstline">Lists views on a log bucket.</p>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070089<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>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -070094<p class="firstline">Updates a view on a log bucket. This method replaces the following fields in the existing view with values from the new view: filter.</p>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070095<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>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700103 <pre>Creates a view over log entries in a log bucket. A bucket may contain a maximum of 50 views.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700104
105Args:
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700106 parent: string, Required. The bucket in which to create the view `&quot;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&quot;` For example:&quot;projects/my-project/locations/global/buckets/my-bucket&quot; (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700107 body: object, The request body.
108 The object takes the form of:
109
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700110{ # Describes a view over log entries in a bucket.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800111 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800112 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700113 &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 idFor example:SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
114 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800115 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700116}
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
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700127 { # Describes a view over log entries in a bucket.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800128 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
129 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700130 &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 idFor example:SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
131 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800132 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
133}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700134</div>
135
136<div class="method">
137 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700138 <pre>Deletes a view on a log bucket.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700139
140Args:
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700141 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; For example:&quot;projects/my-project/locations/global/buckets/my-bucket/views/my-view&quot; (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700142 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 {}.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800151}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700152</div>
153
154<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800155 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700156 <pre>Lists views on a log bucket.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700157
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)
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700160 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800161 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.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700162 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800171 &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.
172 &quot;views&quot;: [ # A list of views.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700173 { # Describes a view over log entries in a bucket.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800174 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
175 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700176 &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 idFor example:SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
177 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800178 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
179 },
180 ],
181}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700182</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>
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700200 <pre>Updates a view on a log bucket. This method replaces the following fields in the existing view with values from the new view: filter.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700201
202Args:
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700203 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; For example:&quot;projects/my-project/locations/global/buckets/my-bucket/views/my-view&quot; (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700204 body: object, The request body.
205 The object takes the form of:
206
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700207{ # Describes a view over log entries in a bucket.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800208 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800209 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700210 &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 idFor example:SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
211 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800212 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700213}
214
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700215 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.FieldMaskFor example: updateMask=filter
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700216 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
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700224 { # Describes a view over log entries in a bucket.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800225 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The creation timestamp of the view.
226 &quot;description&quot;: &quot;A String&quot;, # Describes this view.
yoshi-code-bot3e4b5db2021-08-10 00:22:29 -0700227 &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 idFor example:SOURCE(&quot;projects/myproject&quot;) AND resource.type = &quot;gce_instance&quot; AND LOG_ID(&quot;stdout&quot;)
228 &quot;name&quot;: &quot;A String&quot;, # The resource name of the view.For example:projects/my-project/locations/global/buckets/my-bucket/views/my-view
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800229 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the view.
230}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700231</div>
232
233</body></html>