google-cloud-logging 0.24.0 → 0.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/logging/logger.rb +2 -3
  3. data/lib/google/cloud/logging/service.rb +6 -6
  4. data/lib/google/cloud/logging/v2/config_service_v2_client.rb +66 -35
  5. data/lib/google/cloud/logging/v2/config_service_v2_client_config.json +5 -5
  6. data/lib/google/cloud/logging/v2/doc/google/api/label.rb +2 -2
  7. data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb +2 -2
  8. data/lib/google/cloud/logging/v2/doc/google/logging/type/http_request.rb +2 -2
  9. data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb +32 -2
  10. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb +54 -11
  11. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb +80 -51
  12. data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_metrics.rb +5 -4
  13. data/lib/google/cloud/logging/v2/doc/google/protobuf/any.rb +2 -2
  14. data/lib/google/cloud/logging/v2/doc/google/protobuf/duration.rb +2 -2
  15. data/lib/google/cloud/logging/v2/doc/google/protobuf/timestamp.rb +2 -2
  16. data/lib/google/cloud/logging/v2/logging_service_v2_client.rb +105 -22
  17. data/lib/google/cloud/logging/v2/logging_service_v2_client_config.json +16 -6
  18. data/lib/google/cloud/logging/v2/metrics_service_v2_client.rb +14 -11
  19. data/lib/google/cloud/logging/v2/metrics_service_v2_client_config.json +5 -5
  20. data/lib/google/cloud/logging/version.rb +1 -1
  21. data/lib/google/logging/v2/log_entry_pb.rb +8 -0
  22. data/lib/google/logging/v2/logging_config_services_pb.rb +15 -3
  23. data/lib/google/logging/v2/logging_pb.rb +11 -0
  24. data/lib/google/logging/v2/logging_services_pb.rb +7 -3
  25. metadata +2 -16
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: b21d81a8dd0345896f6d8614d0fe7cdfe13eb1d4
4
- data.tar.gz: 376e833691d63e7f868b959c21ac8907ea872d4a
3
+ metadata.gz: 1f29d7704de59cbe83e205aea50a6fe55b60ec46
4
+ data.tar.gz: c8875c7e34998704478b0bd3816ccb1d51509ad7
5
5
  SHA512:
6
- metadata.gz: 7c76269efa35b6ac9dcb63e9020bde529907a0c01b894016e9c315dea259d30eae2310b1e402b4f77175898ae9b38aa0139ec92d82bf2c5d966d46d28fc3c83e
7
- data.tar.gz: 44157406a87996ac911cc0b1fb22a1e41d2ba9aa06b8ed642c015b4cc8aa22dbfb3752b7299c8146b87522f00d94b20e44620b8e0ab4b2a19d011222ddd96f08
6
+ metadata.gz: 742fcd4d417677dcb457a7947032e07103b0f01e5b316229a9c4baed266a0c3135cf11fe530c29a7d71efe240a687bf99b86de389a7a78ed2f6efabebd5c12c8
7
+ data.tar.gz: 43ea0ca38d5518f1af9bc1be4ece7cb4b483f08407ec95e1ebd704ae5ed690e0e04091b679c044621d991bf7354df3d7ec802aa3a4fe5907e01166084f44eb17
@@ -14,7 +14,6 @@
14
14
 
15
15
 
16
16
  require "logger"
17
- require "orderedhash"
18
17
 
19
18
  module Google
20
19
  module Cloud
@@ -90,7 +89,7 @@ module Google
90
89
  end
91
90
 
92
91
  ##
93
- # A OrderedHash of Thread IDs to Stackdriver request trace ID. The
92
+ # A Hash of Thread IDs to Stackdriver request trace ID. The
94
93
  # Stackdriver trace ID is a shared request identifier across all
95
94
  # Stackdriver services.
96
95
  #
@@ -142,7 +141,7 @@ module Google
142
141
  @resource = resource
143
142
  @labels = labels
144
143
  @level = 0 # DEBUG is the default behavior
145
- @request_info = OrderedHash.new
144
+ @request_info = {}
146
145
  @closed = false
147
146
  # Unused, but present for API compatibility
148
147
  @formatter = ::Logger::Formatter.new
@@ -58,8 +58,8 @@ module Google
58
58
  channel: channel,
59
59
  timeout: timeout,
60
60
  client_config: client_config,
61
- app_name: "gcloud-ruby",
62
- app_version: Google::Cloud::Logging::VERSION)
61
+ lib_name: "gccl",
62
+ lib_version: Google::Cloud::Logging::VERSION)
63
63
  end
64
64
  attr_accessor :mocked_logging
65
65
 
@@ -71,8 +71,8 @@ module Google
71
71
  channel: channel,
72
72
  timeout: timeout,
73
73
  client_config: client_config,
74
- app_name: "gcloud-ruby",
75
- app_version: Google::Cloud::Logging::VERSION)
74
+ lib_name: "gccl",
75
+ lib_version: Google::Cloud::Logging::VERSION)
76
76
  end
77
77
  attr_accessor :mocked_sinks
78
78
 
@@ -84,8 +84,8 @@ module Google
84
84
  channel: channel,
85
85
  timeout: timeout,
86
86
  client_config: client_config,
87
- app_name: "gcloud-ruby",
88
- app_version: Google::Cloud::Logging::VERSION)
87
+ lib_name: "gccl",
88
+ lib_version: Google::Cloud::Logging::VERSION)
89
89
  end
90
90
  attr_accessor :mocked_metrics
91
91
 
@@ -46,8 +46,6 @@ module Google
46
46
  # The default port of the service.
47
47
  DEFAULT_SERVICE_PORT = 443
48
48
 
49
- CODE_GEN_NAME_VERSION = "gapic/0.1.0".freeze
50
-
51
49
  DEFAULT_TIMEOUT = 30
52
50
 
53
51
  PAGE_DESCRIPTORS = {
@@ -137,10 +135,6 @@ module Google
137
135
  # or the specified config is missing data points.
138
136
  # @param timeout [Numeric]
139
137
  # The default timeout, in seconds, for calls made through this client.
140
- # @param app_name [String]
141
- # The codename of the calling service.
142
- # @param app_version [String]
143
- # The version of the calling service.
144
138
  def initialize \
145
139
  service_path: SERVICE_ADDRESS,
146
140
  port: DEFAULT_SERVICE_PORT,
@@ -149,8 +143,10 @@ module Google
149
143
  scopes: ALL_SCOPES,
150
144
  client_config: {},
151
145
  timeout: DEFAULT_TIMEOUT,
152
- app_name: "gax",
153
- app_version: Google::Gax::VERSION
146
+ app_name: nil,
147
+ app_version: nil,
148
+ lib_name: nil,
149
+ lib_version: ""
154
150
  # These require statements are intentionally placed here to initialize
155
151
  # the gRPC module only when it's required.
156
152
  # See https://github.com/googleapis/toolkit/issues/446
@@ -158,9 +154,16 @@ module Google
158
154
  require "google/logging/v2/logging_config_services_pb"
159
155
 
160
156
 
161
- google_api_client = "#{app_name}/#{app_version} " \
162
- "#{CODE_GEN_NAME_VERSION} gax/#{Google::Gax::VERSION} " \
163
- "ruby/#{RUBY_VERSION}".freeze
157
+ if app_name || app_version
158
+ warn "`app_name` and `app_version` are no longer being used in the request headers."
159
+ end
160
+
161
+ google_api_client = "gl-ruby/#{RUBY_VERSION}"
162
+ google_api_client << " #{lib_name}/#{lib_version}" if lib_name
163
+ google_api_client << " gapic/ gax/#{Google::Gax::VERSION}"
164
+ google_api_client << " grpc/#{GRPC::VERSION}"
165
+ google_api_client.freeze
166
+
164
167
  headers = { :"x-goog-api-client" => google_api_client }
165
168
  client_config_file = Pathname.new(__dir__).join(
166
169
  "config_service_v2_client_config.json"
@@ -213,10 +216,8 @@ module Google
213
216
  # Lists sinks.
214
217
  #
215
218
  # @param parent [String]
216
- # Required. The resource name where this sink was created:
217
- #
218
- # "projects/[PROJECT_ID]"
219
- # "organizations/[ORGANIZATION_ID]"
219
+ # Required. The parent resource whose sinks are to be listed.
220
+ # Examples: +"projects/my-logging-project"+, +"organizations/123456789"+.
220
221
  # @param page_size [Integer]
221
222
  # The maximum number of resources contained in the underlying API
222
223
  # response. If page streaming is performed per-resource, this
@@ -267,10 +268,12 @@ module Google
267
268
  # Gets a sink.
268
269
  #
269
270
  # @param sink_name [String]
270
- # Required. The resource name of the sink to return:
271
+ # Required. The parent resource name of the sink:
271
272
  #
272
273
  # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
273
274
  # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
275
+ #
276
+ # Example: +"projects/my-project-id/sinks/my-sink-id"+.
274
277
  # @param options [Google::Gax::CallOptions]
275
278
  # Overrides the default settings for this call, e.g, timeout,
276
279
  # retries, etc.
@@ -294,22 +297,34 @@ module Google
294
297
  @get_sink.call(req, options)
295
298
  end
296
299
 
297
- # Creates a sink.
300
+ # Creates a sink that exports specified log entries to a destination. The
301
+ # export of newly-ingested log entries begins immediately, unless the current
302
+ # time is outside the sink's start and end times or the sink's
303
+ # +writer_identity+ is not permitted to write to the destination. A sink can
304
+ # export log entries only from the resource owning the sink.
298
305
  #
299
306
  # @param parent [String]
300
307
  # Required. The resource in which to create the sink:
301
308
  #
302
309
  # "projects/[PROJECT_ID]"
303
310
  # "organizations/[ORGANIZATION_ID]"
311
+ #
312
+ # Examples: +"projects/my-logging-project"+, +"organizations/123456789"+.
304
313
  # @param sink [Google::Logging::V2::LogSink]
305
314
  # Required. The new sink, whose +name+ parameter is a sink identifier that
306
315
  # is not already in use.
307
316
  # @param unique_writer_identity [true, false]
308
- # Optional. Whether the sink will have a dedicated service account returned
309
- # in the sink's writer_identity. Set this field to be true to export
310
- # logs from one project to a different project. This field is ignored for
311
- # non-project sinks (e.g. organization sinks) because those sinks are
312
- # required to have dedicated service accounts.
317
+ # Optional. Determines the kind of IAM identity returned as +writer_identity+
318
+ # in the new sink. If this value is omitted or set to false, and if the
319
+ # sink's parent is a project, then the value returned as +writer_identity+ is
320
+ # +cloud-logs@google.com+, the same identity used before the addition of
321
+ # writer identities to this API. The sink's destination must be in the same
322
+ # project as the sink itself.
323
+ #
324
+ # If this field is set to true, or if the sink is owned by a non-project
325
+ # resource such as an organization, then the value of +writer_identity+ will
326
+ # be a unique service account used only for exports from the new sink. For
327
+ # more information, see +writer_identity+ in LogSink.
313
328
  # @param options [Google::Gax::CallOptions]
314
329
  # Overrides the default settings for this call, e.g, timeout,
315
330
  # retries, etc.
@@ -339,11 +354,18 @@ module Google
339
354
  @create_sink.call(req, options)
340
355
  end
341
356
 
342
- # Updates or creates a sink.
357
+ # Updates a sink. If the named sink doesn't exist, then this method is
358
+ # identical to
359
+ # {sinks.create}[https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create].
360
+ # If the named sink does exist, then this method replaces the following
361
+ # fields in the existing sink with values from the new sink: +destination+,
362
+ # +filter+, +output_version_format+, +start_time+, and +end_time+.
363
+ # The updated filter might also have a new +writer_identity+; see the
364
+ # +unique_writer_identity+ field.
343
365
  #
344
366
  # @param sink_name [String]
345
- # Required. The resource name of the sink to update, including the parent
346
- # resource and the sink identifier:
367
+ # Required. The full resource name of the sink to update, including the
368
+ # parent resource and the sink identifier:
347
369
  #
348
370
  # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
349
371
  # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -351,14 +373,20 @@ module Google
351
373
  # Example: +"projects/my-project-id/sinks/my-sink-id"+.
352
374
  # @param sink [Google::Logging::V2::LogSink]
353
375
  # Required. The updated sink, whose name is the same identifier that appears
354
- # as part of +sinkName+. If +sinkName+ does not exist, then
376
+ # as part of +sink_name+. If +sink_name+ does not exist, then
355
377
  # this method creates a new sink.
356
378
  # @param unique_writer_identity [true, false]
357
- # Optional. Whether the sink will have a dedicated service account returned
358
- # in the sink's writer_identity. Set this field to be true to export
359
- # logs from one project to a different project. This field is ignored for
360
- # non-project sinks (e.g. organization sinks) because those sinks are
361
- # required to have dedicated service accounts.
379
+ # Optional. See
380
+ # {sinks.create}[https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create]
381
+ # for a description of this field. When updating a sink, the effect of this
382
+ # field on the value of +writer_identity+ in the updated sink depends on both
383
+ # the old and new values of this field:
384
+ #
385
+ # + If the old and new values of this field are both false or both true,
386
+ # then there is no change to the sink's +writer_identity+.
387
+ # + If the old value was false and the new value is true, then
388
+ # +writer_identity+ is changed to a unique service account.
389
+ # + It is an error if the old value was true and the new value is false.
362
390
  # @param options [Google::Gax::CallOptions]
363
391
  # Overrides the default settings for this call, e.g, timeout,
364
392
  # retries, etc.
@@ -388,16 +416,19 @@ module Google
388
416
  @update_sink.call(req, options)
389
417
  end
390
418
 
391
- # Deletes a sink.
419
+ # Deletes a sink. If the sink has a unique +writer_identity+, then that
420
+ # service account is also deleted.
392
421
  #
393
422
  # @param sink_name [String]
394
- # Required. The resource name of the sink to delete, including the parent
395
- # resource and the sink identifier:
423
+ # Required. The full resource name of the sink to delete, including the
424
+ # parent resource and the sink identifier:
396
425
  #
397
426
  # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
398
427
  # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
399
428
  #
400
- # It is an error if the sink does not exist.
429
+ # It is an error if the sink does not exist. Example:
430
+ # +"projects/my-project-id/sinks/my-sink-id"+. It is an error if
431
+ # the sink does not exist.
401
432
  # @param options [Google::Gax::CallOptions]
402
433
  # Overrides the default settings for this call, e.g, timeout,
403
434
  # retries, etc.
@@ -2,11 +2,11 @@
2
2
  "interfaces": {
3
3
  "google.logging.v2.ConfigServiceV2": {
4
4
  "retry_codes": {
5
- "idempotent": [
6
- "DEADLINE_EXCEEDED",
7
- "UNAVAILABLE"
8
- ],
9
- "non_idempotent": []
5
+ "idempotent": [
6
+ "DEADLINE_EXCEEDED",
7
+ "UNAVAILABLE"
8
+ ],
9
+ "non_idempotent": []
10
10
  },
11
11
  "retry_params": {
12
12
  "default": {
@@ -1,10 +1,10 @@
1
- # Copyright 2016 Google Inc. All rights reserved.
1
+ # Copyright 2017, Google Inc. All rights reserved.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
5
5
  # You may obtain a copy of the License at
6
6
  #
7
- # http://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
8
  #
9
9
  # Unless required by applicable law or agreed to in writing, software
10
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -1,10 +1,10 @@
1
- # Copyright 2016 Google Inc. All rights reserved.
1
+ # Copyright 2017, Google Inc. All rights reserved.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
5
5
  # You may obtain a copy of the License at
6
6
  #
7
- # http://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
8
  #
9
9
  # Unless required by applicable law or agreed to in writing, software
10
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -1,10 +1,10 @@
1
- # Copyright 2016 Google Inc. All rights reserved.
1
+ # Copyright 2017, Google Inc. All rights reserved.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
5
5
  # You may obtain a copy of the License at
6
6
  #
7
- # http://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
8
  #
9
9
  # Unless required by applicable law or agreed to in writing, software
10
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -1,10 +1,10 @@
1
- # Copyright 2016 Google Inc. All rights reserved.
1
+ # Copyright 2017, Google Inc. All rights reserved.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
5
5
  # You may obtain a copy of the License at
6
6
  #
7
- # http://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
8
  #
9
9
  # Unless required by applicable law or agreed to in writing, software
10
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -79,6 +79,16 @@ module Google
79
79
  # @return [Google::Logging::V2::LogEntryOperation]
80
80
  # Optional. Information about an operation associated with the log entry, if
81
81
  # applicable.
82
+ # @!attribute [rw] trace
83
+ # @return [String]
84
+ # Optional. Resource name of the trace associated with the log entry, if any.
85
+ # If it contains a relative resource name, the name is assumed to be relative
86
+ # to +//tracing.googleapis.com+. Example:
87
+ # +projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824+
88
+ # @!attribute [rw] source_location
89
+ # @return [Google::Logging::V2::LogEntrySourceLocation]
90
+ # Optional. Source code location information associated with the log entry,
91
+ # if any.
82
92
  class LogEntry; end
83
93
 
84
94
  # Additional information about a potentially long-running operation with which
@@ -99,6 +109,26 @@ module Google
99
109
  # @return [true, false]
100
110
  # Optional. Set this to True if this is the last log entry in the operation.
101
111
  class LogEntryOperation; end
112
+
113
+ # Additional information about the source code location that produced the log
114
+ # entry.
115
+ # @!attribute [rw] file
116
+ # @return [String]
117
+ # Optional. Source file name. Depending on the runtime environment, this
118
+ # might be a simple name or a fully-qualified name.
119
+ # @!attribute [rw] line
120
+ # @return [Integer]
121
+ # Optional. Line within the source file. 1-based; 0 indicates no line number
122
+ # available.
123
+ # @!attribute [rw] function
124
+ # @return [String]
125
+ # Optional. Human-readable name of the function or method being invoked, with
126
+ # optional context such as the class or package name. This information may be
127
+ # used in contexts such as the logs viewer, where a file and line number are
128
+ # less meaningful. The format can vary by language. For example:
129
+ # +qual.if.ied.Class.method+ (Java), +dir/package.func+ (Go), +function+
130
+ # (Python).
131
+ class LogEntrySourceLocation; end
102
132
  end
103
133
  end
104
134
  end
@@ -1,10 +1,10 @@
1
- # Copyright 2016 Google Inc. All rights reserved.
1
+ # Copyright 2017, Google Inc. All rights reserved.
2
2
  #
3
3
  # Licensed under the Apache License, Version 2.0 (the "License");
4
4
  # you may not use this file except in compliance with the License.
5
5
  # You may obtain a copy of the License at
6
6
  #
7
- # http://www.apache.org/licenses/LICENSE-2.0
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
8
  #
9
9
  # Unless required by applicable law or agreed to in writing, software
10
10
  # distributed under the License is distributed on an "AS IS" BASIS,
@@ -87,14 +87,14 @@ module Google
87
87
  # The parameters to +ListLogEntries+.
88
88
  # @!attribute [rw] project_ids
89
89
  # @return [Array<String>]
90
- # Deprecated. One or more project identifiers or project numbers from which
91
- # to retrieve log entries. Example: +"my-project-1A"+. If
92
- # present, these project identifiers are converted to resource format and
93
- # added to the list of resources in +resourceNames+. Callers should use
94
- # +resourceNames+ rather than this parameter.
90
+ # Deprecated. Use +resource_names+ instead. One or more project identifiers
91
+ # or project numbers from which to retrieve log entries. Example:
92
+ # +"my-project-1A"+. If present, these project identifiers are converted to
93
+ # resource name format and added to the list of resources in
94
+ # +resource_names+.
95
95
  # @!attribute [rw] resource_names
96
96
  # @return [Array<String>]
97
- # Required. One or more cloud resources from which to retrieve log
97
+ # Required. Names of one or more resources from which to retrieve log
98
98
  # entries:
99
99
  #
100
100
  # "projects/[PROJECT_ID]"
@@ -105,7 +105,10 @@ module Google
105
105
  # @return [String]
106
106
  # Optional. A filter that chooses which log entries to return. See {Advanced
107
107
  # Logs Filters}[https://cloud.google.com/logging/docs/view/advanced_filters]. Only log entries that
108
- # match the filter are returned. An empty filter matches all log entries.
108
+ # match the filter are returned. An empty filter matches all log entries in
109
+ # the resources listed in +resource_names+. Referencing a parent resource
110
+ # that is not listed in +resource_names+ will cause the filter to return no
111
+ # results.
109
112
  # The maximum length of the filter is 20000 characters.
110
113
  # @!attribute [rw] order_by
111
114
  # @return [String]
@@ -134,9 +137,16 @@ module Google
134
137
  # A list of log entries.
135
138
  # @!attribute [rw] next_page_token
136
139
  # @return [String]
137
- # If there might be more results than appear in this response, then
140
+ # If there might be more results than those appearing in this response, then
138
141
  # +nextPageToken+ is included. To get the next set of results, call this
139
142
  # method again using the value of +nextPageToken+ as +pageToken+.
143
+ #
144
+ # If a value for +next_page_token+ appears and the +entries+ field is empty,
145
+ # it means that the search found no log entries so far but it did not have
146
+ # time to search all the possible log entries. Retry the method with this
147
+ # value for +page_token+ to continue the search. Alternatively, consider
148
+ # speeding up the search by changing your filter to specify a single log name
149
+ # or resource type, or to narrow the time range of the search.
140
150
  class ListLogEntriesResponse; end
141
151
 
142
152
  # The parameters to ListMonitoredResourceDescriptors
@@ -159,10 +169,43 @@ module Google
159
169
  # A list of resource descriptors.
160
170
  # @!attribute [rw] next_page_token
161
171
  # @return [String]
162
- # If there might be more results than appear in this response, then
172
+ # If there might be more results than those appearing in this response, then
163
173
  # +nextPageToken+ is included. To get the next set of results, call this
164
174
  # method again using the value of +nextPageToken+ as +pageToken+.
165
175
  class ListMonitoredResourceDescriptorsResponse; end
176
+
177
+ # The parameters to ListLogs.
178
+ # @!attribute [rw] parent
179
+ # @return [String]
180
+ # Required. The resource name that owns the logs:
181
+ #
182
+ # "projects/[PROJECT_ID]"
183
+ # "organizations/[ORGANIZATION_ID]"
184
+ # @!attribute [rw] page_size
185
+ # @return [Integer]
186
+ # Optional. The maximum number of results to return from this request.
187
+ # Non-positive values are ignored. The presence of +nextPageToken+ in the
188
+ # response indicates that more results might be available.
189
+ # @!attribute [rw] page_token
190
+ # @return [String]
191
+ # Optional. If present, then retrieve the next batch of results from the
192
+ # preceding call to this method. +pageToken+ must be the value of
193
+ # +nextPageToken+ from the previous response. The values of other method
194
+ # parameters should be identical to those in the previous call.
195
+ class ListLogsRequest; end
196
+
197
+ # Result returned from ListLogs.
198
+ # @!attribute [rw] log_names
199
+ # @return [Array<String>]
200
+ # A list of log names. For example,
201
+ # +"projects/my-project/syslog"+ or
202
+ # +"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"+.
203
+ # @!attribute [rw] next_page_token
204
+ # @return [String]
205
+ # If there might be more results than those appearing in this response, then
206
+ # +nextPageToken+ is included. To get the next set of results, call this
207
+ # method again using the value of +nextPageToken+ as +pageToken+.
208
+ class ListLogsResponse; end
166
209
  end
167
210
  end
168
211
  end