google-api-client 0.9.28 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (138) hide show
  1. checksums.yaml +4 -4
  2. data/.travis.yml +7 -4
  3. data/CHANGELOG.md +10 -0
  4. data/api_names.yaml +36512 -36326
  5. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  6. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +41 -41
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +13 -13
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +110 -110
  9. data/generated/google/apis/adsense_v1_4.rb +1 -1
  10. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  11. data/generated/google/apis/analyticsreporting_v4.rb +3 -3
  12. data/generated/google/apis/analyticsreporting_v4/classes.rb +845 -845
  13. data/generated/google/apis/analyticsreporting_v4/representations.rb +184 -184
  14. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  15. data/generated/google/apis/androidenterprise_v1/classes.rb +5 -5
  16. data/generated/google/apis/androidenterprise_v1/service.rb +3 -1
  17. data/generated/google/apis/appstate_v1.rb +1 -1
  18. data/generated/google/apis/calendar_v3.rb +1 -1
  19. data/generated/google/apis/classroom_v1.rb +22 -25
  20. data/generated/google/apis/classroom_v1/classes.rb +998 -907
  21. data/generated/google/apis/classroom_v1/representations.rb +240 -240
  22. data/generated/google/apis/classroom_v1/service.rb +1269 -1061
  23. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  24. data/generated/google/apis/cloudbuild_v1/classes.rb +322 -322
  25. data/generated/google/apis/cloudbuild_v1/representations.rb +88 -88
  26. data/generated/google/apis/cloudbuild_v1/service.rb +57 -57
  27. data/generated/google/apis/clouddebugger_v2.rb +4 -4
  28. data/generated/google/apis/clouddebugger_v2/classes.rb +311 -311
  29. data/generated/google/apis/clouddebugger_v2/representations.rb +92 -92
  30. data/generated/google/apis/clouddebugger_v2/service.rb +41 -41
  31. data/generated/google/apis/cloudkms_v1beta1.rb +1 -1
  32. data/generated/google/apis/cloudkms_v1beta1/classes.rb +611 -611
  33. data/generated/google/apis/cloudkms_v1beta1/representations.rb +124 -124
  34. data/generated/google/apis/cloudkms_v1beta1/service.rb +254 -248
  35. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  36. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +116 -116
  37. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +28 -28
  38. data/generated/google/apis/cloudresourcemanager_v1/service.rb +257 -257
  39. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +4 -4
  40. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +394 -394
  41. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +79 -79
  42. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +269 -269
  43. data/generated/google/apis/cloudtrace_v1.rb +8 -8
  44. data/generated/google/apis/cloudtrace_v1/classes.rb +90 -84
  45. data/generated/google/apis/cloudtrace_v1/representations.rb +22 -22
  46. data/generated/google/apis/cloudtrace_v1/service.rb +40 -35
  47. data/generated/google/apis/compute_beta.rb +1 -1
  48. data/generated/google/apis/compute_beta/classes.rb +406 -31
  49. data/generated/google/apis/compute_beta/representations.rb +154 -0
  50. data/generated/google/apis/compute_beta/service.rb +262 -9
  51. data/generated/google/apis/compute_v1.rb +1 -1
  52. data/generated/google/apis/compute_v1/classes.rb +17 -20
  53. data/generated/google/apis/content_v2.rb +1 -1
  54. data/generated/google/apis/dataflow_v1b3.rb +1 -1
  55. data/generated/google/apis/dataflow_v1b3/classes.rb +3226 -2847
  56. data/generated/google/apis/dataflow_v1b3/representations.rb +825 -677
  57. data/generated/google/apis/dataflow_v1b3/service.rb +175 -175
  58. data/generated/google/apis/dataproc_v1.rb +2 -2
  59. data/generated/google/apis/dataproc_v1/classes.rb +1213 -1136
  60. data/generated/google/apis/dataproc_v1/representations.rb +262 -244
  61. data/generated/google/apis/dataproc_v1/service.rb +298 -243
  62. data/generated/google/apis/datastore_v1.rb +4 -4
  63. data/generated/google/apis/datastore_v1/classes.rb +728 -728
  64. data/generated/google/apis/datastore_v1/representations.rb +167 -167
  65. data/generated/google/apis/datastore_v1/service.rb +68 -68
  66. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  67. data/generated/google/apis/drive_v2.rb +1 -1
  68. data/generated/google/apis/drive_v3.rb +1 -1
  69. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  70. data/generated/google/apis/games_management_v1management.rb +1 -1
  71. data/generated/google/apis/games_v1.rb +1 -1
  72. data/generated/google/apis/genomics_v1.rb +7 -7
  73. data/generated/google/apis/genomics_v1/classes.rb +932 -932
  74. data/generated/google/apis/genomics_v1/representations.rb +205 -205
  75. data/generated/google/apis/genomics_v1/service.rb +1228 -1228
  76. data/generated/google/apis/gmail_v1.rb +1 -1
  77. data/generated/google/apis/iam_v1/classes.rb +440 -440
  78. data/generated/google/apis/iam_v1/representations.rb +94 -94
  79. data/generated/google/apis/iam_v1/service.rb +60 -60
  80. data/generated/google/apis/identitytoolkit_v3.rb +1 -1
  81. data/generated/google/apis/identitytoolkit_v3/classes.rb +21 -1
  82. data/generated/google/apis/identitytoolkit_v3/representations.rb +3 -0
  83. data/generated/google/apis/kgsearch_v1/classes.rb +6 -6
  84. data/generated/google/apis/kgsearch_v1/representations.rb +1 -1
  85. data/generated/google/apis/kgsearch_v1/service.rb +21 -21
  86. data/generated/google/apis/language_v1beta1.rb +1 -1
  87. data/generated/google/apis/language_v1beta1/classes.rb +232 -232
  88. data/generated/google/apis/language_v1beta1/representations.rb +75 -75
  89. data/generated/google/apis/logging_v2beta1.rb +1 -1
  90. data/generated/google/apis/logging_v2beta1/classes.rb +345 -337
  91. data/generated/google/apis/logging_v2beta1/representations.rb +55 -55
  92. data/generated/google/apis/logging_v2beta1/service.rb +331 -306
  93. data/generated/google/apis/monitoring_v3.rb +1 -1
  94. data/generated/google/apis/monitoring_v3/classes.rb +253 -253
  95. data/generated/google/apis/monitoring_v3/representations.rb +58 -58
  96. data/generated/google/apis/monitoring_v3/service.rb +135 -135
  97. data/generated/google/apis/people_v1.rb +15 -16
  98. data/generated/google/apis/people_v1/classes.rb +985 -855
  99. data/generated/google/apis/people_v1/representations.rb +227 -220
  100. data/generated/google/apis/people_v1/service.rb +58 -52
  101. data/generated/google/apis/plus_domains_v1.rb +1 -1
  102. data/generated/google/apis/plus_v1.rb +1 -1
  103. data/generated/google/apis/pubsub_v1.rb +1 -1
  104. data/generated/google/apis/pubsub_v1/classes.rb +257 -257
  105. data/generated/google/apis/pubsub_v1/representations.rb +83 -83
  106. data/generated/google/apis/pubsub_v1/service.rb +390 -390
  107. data/generated/google/apis/script_v1.rb +17 -17
  108. data/generated/google/apis/script_v1/classes.rb +149 -141
  109. data/generated/google/apis/script_v1/representations.rb +26 -27
  110. data/generated/google/apis/script_v1/service.rb +9 -8
  111. data/generated/google/apis/sheets_v4.rb +1 -1
  112. data/generated/google/apis/sheets_v4/classes.rb +4223 -4188
  113. data/generated/google/apis/sheets_v4/representations.rb +850 -834
  114. data/generated/google/apis/sheets_v4/service.rb +192 -192
  115. data/generated/google/apis/slides_v1.rb +1 -1
  116. data/generated/google/apis/slides_v1/classes.rb +927 -800
  117. data/generated/google/apis/slides_v1/representations.rb +253 -211
  118. data/generated/google/apis/speech_v1beta1.rb +1 -1
  119. data/generated/google/apis/speech_v1beta1/classes.rb +94 -107
  120. data/generated/google/apis/speech_v1beta1/representations.rb +24 -36
  121. data/generated/google/apis/speech_v1beta1/service.rb +51 -54
  122. data/generated/google/apis/storage_v1.rb +1 -1
  123. data/generated/google/apis/vision_v1.rb +1 -1
  124. data/generated/google/apis/vision_v1/classes.rb +888 -885
  125. data/generated/google/apis/vision_v1/representations.rb +139 -139
  126. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  127. data/generated/google/apis/youtube_analytics_v1/service.rb +5 -1
  128. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  129. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  130. data/generated/google/apis/youtubereporting_v1/classes.rb +80 -80
  131. data/generated/google/apis/youtubereporting_v1/representations.rb +23 -23
  132. data/generated/google/apis/youtubereporting_v1/service.rb +51 -51
  133. data/google-api-client.gemspec +2 -2
  134. data/lib/google/apis/core/api_command.rb +1 -1
  135. data/lib/google/apis/core/json_representation.rb +2 -2
  136. data/lib/google/apis/version.rb +1 -1
  137. data/samples/cli/lib/samples/you_tube.rb +4 -1
  138. metadata +36 -30
@@ -58,13 +58,13 @@ module Google
58
58
  include Google::Apis::Core::JsonObjectSupport
59
59
  end
60
60
 
61
- class LogSink
61
+ class WriteLogEntriesRequest
62
62
  class Representation < Google::Apis::Core::JsonRepresentation; end
63
63
 
64
64
  include Google::Apis::Core::JsonObjectSupport
65
65
  end
66
66
 
67
- class WriteLogEntriesRequest
67
+ class LogSink
68
68
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
69
 
70
70
  include Google::Apis::Core::JsonObjectSupport
@@ -157,17 +157,17 @@ module Google
157
157
  class ListMonitoredResourceDescriptorsResponse
158
158
  # @private
159
159
  class Representation < Google::Apis::Core::JsonRepresentation
160
+ property :next_page_token, as: 'nextPageToken'
160
161
  collection :resource_descriptors, as: 'resourceDescriptors', class: Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor, decorator: Google::Apis::LoggingV2beta1::MonitoredResourceDescriptor::Representation
161
162
 
162
- property :next_page_token, as: 'nextPageToken'
163
163
  end
164
164
  end
165
165
 
166
166
  class SourceReference
167
167
  # @private
168
168
  class Representation < Google::Apis::Core::JsonRepresentation
169
- property :revision_id, as: 'revisionId'
170
169
  property :repository, as: 'repository'
170
+ property :revision_id, as: 'revisionId'
171
171
  end
172
172
  end
173
173
 
@@ -205,19 +205,6 @@ module Google
205
205
  end
206
206
  end
207
207
 
208
- class LogSink
209
- # @private
210
- class Representation < Google::Apis::Core::JsonRepresentation
211
- property :name, as: 'name'
212
- property :destination, as: 'destination'
213
- property :filter, as: 'filter'
214
- property :end_time, as: 'endTime'
215
- property :start_time, as: 'startTime'
216
- property :writer_identity, as: 'writerIdentity'
217
- property :output_version_format, as: 'outputVersionFormat'
218
- end
219
- end
220
-
221
208
  class WriteLogEntriesRequest
222
209
  # @private
223
210
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -231,17 +218,37 @@ module Google
231
218
  end
232
219
  end
233
220
 
221
+ class LogSink
222
+ # @private
223
+ class Representation < Google::Apis::Core::JsonRepresentation
224
+ property :name, as: 'name'
225
+ property :filter, as: 'filter'
226
+ property :destination, as: 'destination'
227
+ property :end_time, as: 'endTime'
228
+ property :start_time, as: 'startTime'
229
+ property :writer_identity, as: 'writerIdentity'
230
+ property :output_version_format, as: 'outputVersionFormat'
231
+ end
232
+ end
233
+
234
234
  class ListLogsResponse
235
235
  # @private
236
236
  class Representation < Google::Apis::Core::JsonRepresentation
237
- property :next_page_token, as: 'nextPageToken'
238
237
  collection :log_names, as: 'logNames'
238
+ property :next_page_token, as: 'nextPageToken'
239
239
  end
240
240
  end
241
241
 
242
242
  class HttpRequest
243
243
  # @private
244
244
  class Representation < Google::Apis::Core::JsonRepresentation
245
+ property :user_agent, as: 'userAgent'
246
+ property :latency, as: 'latency'
247
+ property :cache_fill_bytes, as: 'cacheFillBytes'
248
+ property :request_method, as: 'requestMethod'
249
+ property :response_size, as: 'responseSize'
250
+ property :request_size, as: 'requestSize'
251
+ property :request_url, as: 'requestUrl'
245
252
  property :server_ip, as: 'serverIp'
246
253
  property :remote_ip, as: 'remoteIp'
247
254
  property :cache_lookup, as: 'cacheLookup'
@@ -249,31 +256,24 @@ module Google
249
256
  property :cache_validated_with_origin_server, as: 'cacheValidatedWithOriginServer'
250
257
  property :status, as: 'status'
251
258
  property :referer, as: 'referer'
252
- property :user_agent, as: 'userAgent'
253
- property :latency, as: 'latency'
254
- property :cache_fill_bytes, as: 'cacheFillBytes'
255
- property :request_method, as: 'requestMethod'
256
- property :request_size, as: 'requestSize'
257
- property :response_size, as: 'responseSize'
258
- property :request_url, as: 'requestUrl'
259
259
  end
260
260
  end
261
261
 
262
262
  class ListSinksResponse
263
263
  # @private
264
264
  class Representation < Google::Apis::Core::JsonRepresentation
265
+ property :next_page_token, as: 'nextPageToken'
265
266
  collection :sinks, as: 'sinks', class: Google::Apis::LoggingV2beta1::LogSink, decorator: Google::Apis::LoggingV2beta1::LogSink::Representation
266
267
 
267
- property :next_page_token, as: 'nextPageToken'
268
268
  end
269
269
  end
270
270
 
271
271
  class LabelDescriptor
272
272
  # @private
273
273
  class Representation < Google::Apis::Core::JsonRepresentation
274
- property :value_type, as: 'valueType'
275
274
  property :key, as: 'key'
276
275
  property :description, as: 'description'
276
+ property :value_type, as: 'valueType'
277
277
  end
278
278
  end
279
279
 
@@ -292,29 +292,29 @@ module Google
292
292
  class LogEntrySourceLocation
293
293
  # @private
294
294
  class Representation < Google::Apis::Core::JsonRepresentation
295
+ property :file, as: 'file'
295
296
  property :function, as: 'function'
296
297
  property :line, as: 'line'
297
- property :file, as: 'file'
298
298
  end
299
299
  end
300
300
 
301
301
  class ListLogEntriesResponse
302
302
  # @private
303
303
  class Representation < Google::Apis::Core::JsonRepresentation
304
- property :next_page_token, as: 'nextPageToken'
305
304
  collection :entries, as: 'entries', class: Google::Apis::LoggingV2beta1::LogEntry, decorator: Google::Apis::LoggingV2beta1::LogEntry::Representation
306
305
 
306
+ property :next_page_token, as: 'nextPageToken'
307
307
  end
308
308
  end
309
309
 
310
310
  class LogLine
311
311
  # @private
312
312
  class Representation < Google::Apis::Core::JsonRepresentation
313
- property :severity, as: 'severity'
314
- property :log_message, as: 'logMessage'
315
313
  property :source_location, as: 'sourceLocation', class: Google::Apis::LoggingV2beta1::SourceLocation, decorator: Google::Apis::LoggingV2beta1::SourceLocation::Representation
316
314
 
317
315
  property :time, as: 'time'
316
+ property :severity, as: 'severity'
317
+ property :log_message, as: 'logMessage'
318
318
  end
319
319
  end
320
320
 
@@ -330,14 +330,11 @@ module Google
330
330
  class LogEntry
331
331
  # @private
332
332
  class Representation < Google::Apis::Core::JsonRepresentation
333
- property :source_location, as: 'sourceLocation', class: Google::Apis::LoggingV2beta1::LogEntrySourceLocation, decorator: Google::Apis::LoggingV2beta1::LogEntrySourceLocation::Representation
334
-
335
- property :timestamp, as: 'timestamp'
336
333
  property :log_name, as: 'logName'
337
- property :resource, as: 'resource', class: Google::Apis::LoggingV2beta1::MonitoredResource, decorator: Google::Apis::LoggingV2beta1::MonitoredResource::Representation
338
-
339
334
  property :http_request, as: 'httpRequest', class: Google::Apis::LoggingV2beta1::HttpRequest, decorator: Google::Apis::LoggingV2beta1::HttpRequest::Representation
340
335
 
336
+ property :resource, as: 'resource', class: Google::Apis::LoggingV2beta1::MonitoredResource, decorator: Google::Apis::LoggingV2beta1::MonitoredResource::Representation
337
+
341
338
  hash :json_payload, as: 'jsonPayload'
342
339
  property :insert_id, as: 'insertId'
343
340
  property :operation, as: 'operation', class: Google::Apis::LoggingV2beta1::LogEntryOperation, decorator: Google::Apis::LoggingV2beta1::LogEntryOperation::Representation
@@ -347,6 +344,9 @@ module Google
347
344
  property :trace, as: 'trace'
348
345
  hash :labels, as: 'labels'
349
346
  property :severity, as: 'severity'
347
+ property :source_location, as: 'sourceLocation', class: Google::Apis::LoggingV2beta1::LogEntrySourceLocation, decorator: Google::Apis::LoggingV2beta1::LogEntrySourceLocation::Representation
348
+
349
+ property :timestamp, as: 'timestamp'
350
350
  end
351
351
  end
352
352
 
@@ -370,8 +370,8 @@ module Google
370
370
  class Representation < Google::Apis::Core::JsonRepresentation
371
371
  property :order_by, as: 'orderBy'
372
372
  collection :resource_names, as: 'resourceNames'
373
- collection :project_ids, as: 'projectIds'
374
373
  property :filter, as: 'filter'
374
+ collection :project_ids, as: 'projectIds'
375
375
  property :page_token, as: 'pageToken'
376
376
  property :page_size, as: 'pageSize'
377
377
  end
@@ -380,6 +380,23 @@ module Google
380
380
  class RequestLog
381
381
  # @private
382
382
  class Representation < Google::Apis::Core::JsonRepresentation
383
+ property :nickname, as: 'nickname'
384
+ property :status, as: 'status'
385
+ property :resource, as: 'resource'
386
+ property :pending_time, as: 'pendingTime'
387
+ property :task_name, as: 'taskName'
388
+ property :url_map_entry, as: 'urlMapEntry'
389
+ property :instance_index, as: 'instanceIndex'
390
+ property :finished, as: 'finished'
391
+ property :host, as: 'host'
392
+ property :http_version, as: 'httpVersion'
393
+ property :start_time, as: 'startTime'
394
+ property :latency, as: 'latency'
395
+ property :ip, as: 'ip'
396
+ property :app_id, as: 'appId'
397
+ property :app_engine_release, as: 'appEngineRelease'
398
+ property :method_prop, as: 'method'
399
+ property :cost, as: 'cost'
383
400
  property :instance_id, as: 'instanceId'
384
401
  property :mega_cycles, as: 'megaCycles'
385
402
  property :first, as: 'first'
@@ -394,26 +411,9 @@ module Google
394
411
  property :trace_id, as: 'traceId'
395
412
  collection :line, as: 'line', class: Google::Apis::LoggingV2beta1::LogLine, decorator: Google::Apis::LoggingV2beta1::LogLine::Representation
396
413
 
397
- property :task_queue_name, as: 'taskQueueName'
398
414
  property :referrer, as: 'referrer'
415
+ property :task_queue_name, as: 'taskQueueName'
399
416
  property :request_id, as: 'requestId'
400
- property :nickname, as: 'nickname'
401
- property :pending_time, as: 'pendingTime'
402
- property :resource, as: 'resource'
403
- property :status, as: 'status'
404
- property :task_name, as: 'taskName'
405
- property :url_map_entry, as: 'urlMapEntry'
406
- property :instance_index, as: 'instanceIndex'
407
- property :host, as: 'host'
408
- property :finished, as: 'finished'
409
- property :http_version, as: 'httpVersion'
410
- property :start_time, as: 'startTime'
411
- property :latency, as: 'latency'
412
- property :ip, as: 'ip'
413
- property :app_id, as: 'appId'
414
- property :app_engine_release, as: 'appEngineRelease'
415
- property :method_prop, as: 'method'
416
- property :cost, as: 'cost'
417
417
  end
418
418
  end
419
419
  end
@@ -46,40 +46,18 @@ module Google
46
46
  super('https://logging.googleapis.com/', '')
47
47
  end
48
48
 
49
- # Lists log entries. Use this method to retrieve log entries from Stackdriver
50
- # Logging. For ways to export log entries, see Exporting Logs.
51
- # @param [Google::Apis::LoggingV2beta1::ListLogEntriesRequest] list_log_entries_request_object
52
- # @param [String] quota_user
53
- # Available to use for quota purposes for server-side applications. Can be any
54
- # arbitrary string assigned to a user, but should not exceed 40 characters.
55
- # @param [String] fields
56
- # Selector specifying which fields to include in a partial response.
57
- # @param [Google::Apis::RequestOptions] options
58
- # Request-specific options
59
- #
60
- # @yield [result, err] Result & error if block supplied
61
- # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogEntriesResponse] parsed result object
62
- # @yieldparam err [StandardError] error object if request failed
63
- #
64
- # @return [Google::Apis::LoggingV2beta1::ListLogEntriesResponse]
65
- #
66
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
67
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
68
- # @raise [Google::Apis::AuthorizationError] Authorization is required
69
- def list_entry_log_entries(list_log_entries_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
70
- command = make_simple_command(:post, 'v2beta1/entries:list', options)
71
- command.request_representation = Google::Apis::LoggingV2beta1::ListLogEntriesRequest::Representation
72
- command.request_object = list_log_entries_request_object
73
- command.response_representation = Google::Apis::LoggingV2beta1::ListLogEntriesResponse::Representation
74
- command.response_class = Google::Apis::LoggingV2beta1::ListLogEntriesResponse
75
- command.query['quotaUser'] = quota_user unless quota_user.nil?
76
- command.query['fields'] = fields unless fields.nil?
77
- execute_or_queue_command(command, &block)
78
- end
79
-
80
- # Writes log entries to Stackdriver Logging. All log entries are written by this
81
- # method.
82
- # @param [Google::Apis::LoggingV2beta1::WriteLogEntriesRequest] write_log_entries_request_object
49
+ # Deletes all the log entries in a log. The log reappears if it receives new
50
+ # entries. Log entries written shortly before the delete operation might not be
51
+ # deleted.
52
+ # @param [String] log_name
53
+ # Required. The resource name of the log to delete:
54
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
55
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
56
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
57
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
58
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
59
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
60
+ # 2Factivity". For more information about log names, see LogEntry.
83
61
  # @param [String] quota_user
84
62
  # Available to use for quota purposes for server-side applications. Can be any
85
63
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -89,29 +67,32 @@ module Google
89
67
  # Request-specific options
90
68
  #
91
69
  # @yield [result, err] Result & error if block supplied
92
- # @yieldparam result [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse] parsed result object
70
+ # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
93
71
  # @yieldparam err [StandardError] error object if request failed
94
72
  #
95
- # @return [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse]
73
+ # @return [Google::Apis::LoggingV2beta1::Empty]
96
74
  #
97
75
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
98
76
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
99
77
  # @raise [Google::Apis::AuthorizationError] Authorization is required
100
- def write_entry_log_entries(write_log_entries_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
101
- command = make_simple_command(:post, 'v2beta1/entries:write', options)
102
- command.request_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesRequest::Representation
103
- command.request_object = write_log_entries_request_object
104
- command.response_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse::Representation
105
- command.response_class = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse
78
+ def delete_log(log_name, quota_user: nil, fields: nil, options: nil, &block)
79
+ command = make_simple_command(:delete, 'v2beta1/{+logName}', options)
80
+ command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
81
+ command.response_class = Google::Apis::LoggingV2beta1::Empty
82
+ command.params['logName'] = log_name unless log_name.nil?
106
83
  command.query['quotaUser'] = quota_user unless quota_user.nil?
107
84
  command.query['fields'] = fields unless fields.nil?
108
85
  execute_or_queue_command(command, &block)
109
86
  end
110
87
 
111
- # Lists logs-based metrics.
88
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
89
+ # logs that have entries are listed.
112
90
  # @param [String] parent
113
- # Required. The name of the project containing the metrics:
91
+ # Required. The resource name that owns the logs:
114
92
  # "projects/[PROJECT_ID]"
93
+ # "organizations/[ORGANIZATION_ID]"
94
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
95
+ # "folders/[FOLDER_ID]"
115
96
  # @param [String] page_token
116
97
  # Optional. If present, then retrieve the next batch of results from the
117
98
  # preceding call to this method. pageToken must be the value of nextPageToken
@@ -130,18 +111,18 @@ module Google
130
111
  # Request-specific options
131
112
  #
132
113
  # @yield [result, err] Result & error if block supplied
133
- # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogMetricsResponse] parsed result object
114
+ # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogsResponse] parsed result object
134
115
  # @yieldparam err [StandardError] error object if request failed
135
116
  #
136
- # @return [Google::Apis::LoggingV2beta1::ListLogMetricsResponse]
117
+ # @return [Google::Apis::LoggingV2beta1::ListLogsResponse]
137
118
  #
138
119
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
139
120
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
140
121
  # @raise [Google::Apis::AuthorizationError] Authorization is required
141
- def list_project_metrics(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
142
- command = make_simple_command(:get, 'v2beta1/{+parent}/metrics', options)
143
- command.response_representation = Google::Apis::LoggingV2beta1::ListLogMetricsResponse::Representation
144
- command.response_class = Google::Apis::LoggingV2beta1::ListLogMetricsResponse
122
+ def list_logs(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
123
+ command = make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
124
+ command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
125
+ command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
145
126
  command.params['parent'] = parent unless parent.nil?
146
127
  command.query['pageToken'] = page_token unless page_token.nil?
147
128
  command.query['pageSize'] = page_size unless page_size.nil?
@@ -150,10 +131,29 @@ module Google
150
131
  execute_or_queue_command(command, &block)
151
132
  end
152
133
 
153
- # Gets a logs-based metric.
154
- # @param [String] metric_name
155
- # The resource name of the desired metric:
156
- # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
134
+ # Creates a sink that exports specified log entries to a destination. The export
135
+ # of newly-ingested log entries begins immediately, unless the current time is
136
+ # outside the sink's start and end times or the sink's writer_identity is not
137
+ # permitted to write to the destination. A sink can export log entries only from
138
+ # the resource owning the sink.
139
+ # @param [String] parent
140
+ # Required. The resource in which to create the sink:
141
+ # "projects/[PROJECT_ID]"
142
+ # "organizations/[ORGANIZATION_ID]"
143
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
144
+ # "folders/[FOLDER_ID]"
145
+ # Examples: "projects/my-logging-project", "organizations/123456789".
146
+ # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
147
+ # @param [Boolean] unique_writer_identity
148
+ # Optional. Determines the kind of IAM identity returned as writer_identity in
149
+ # the new sink. If this value is omitted or set to false, and if the sink's
150
+ # parent is a project, then the value returned as writer_identity is cloud-logs@
151
+ # system.gserviceaccount.com, the same identity used before the addition of
152
+ # writer identities to this API. The sink's destination must be in the same
153
+ # project as the sink itself.If this field is set to true, or if the sink is
154
+ # owned by a non-project resource such as an organization, then the value of
155
+ # writer_identity will be a unique service account used only for exports from
156
+ # the new sink. For more information, see writer_identity in LogSink.
157
157
  # @param [String] quota_user
158
158
  # Available to use for quota purposes for server-side applications. Can be any
159
159
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -163,32 +163,37 @@ module Google
163
163
  # Request-specific options
164
164
  #
165
165
  # @yield [result, err] Result & error if block supplied
166
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
166
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
167
167
  # @yieldparam err [StandardError] error object if request failed
168
168
  #
169
- # @return [Google::Apis::LoggingV2beta1::LogMetric]
169
+ # @return [Google::Apis::LoggingV2beta1::LogSink]
170
170
  #
171
171
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
172
172
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
173
173
  # @raise [Google::Apis::AuthorizationError] Authorization is required
174
- def get_project_metric(metric_name, quota_user: nil, fields: nil, options: nil, &block)
175
- command = make_simple_command(:get, 'v2beta1/{+metricName}', options)
176
- command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
177
- command.response_class = Google::Apis::LoggingV2beta1::LogMetric
178
- command.params['metricName'] = metric_name unless metric_name.nil?
174
+ def create_project_sink(parent, log_sink_object = nil, unique_writer_identity: nil, quota_user: nil, fields: nil, options: nil, &block)
175
+ command = make_simple_command(:post, 'v2beta1/{+parent}/sinks', options)
176
+ command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
177
+ command.request_object = log_sink_object
178
+ command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
179
+ command.response_class = Google::Apis::LoggingV2beta1::LogSink
180
+ command.params['parent'] = parent unless parent.nil?
181
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
179
182
  command.query['quotaUser'] = quota_user unless quota_user.nil?
180
183
  command.query['fields'] = fields unless fields.nil?
181
184
  execute_or_queue_command(command, &block)
182
185
  end
183
186
 
184
- # Creates or updates a logs-based metric.
185
- # @param [String] metric_name
186
- # The resource name of the metric to update:
187
- # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
188
- # The updated metric must be provided in the request and it's name field must be
189
- # the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a
190
- # new metric is created.
191
- # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
187
+ # Deletes a sink. If the sink has a unique writer_identity, then that service
188
+ # account is also deleted.
189
+ # @param [String] sink_name
190
+ # Required. The full resource name of the sink to delete, including the parent
191
+ # resource and the sink identifier:
192
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
193
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
194
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
195
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
196
+ # Example: "projects/my-project-id/sinks/my-sink-id".
192
197
  # @param [String] quota_user
193
198
  # Available to use for quota purposes for server-side applications. Can be any
194
199
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -198,32 +203,40 @@ module Google
198
203
  # Request-specific options
199
204
  #
200
205
  # @yield [result, err] Result & error if block supplied
201
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
206
+ # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
202
207
  # @yieldparam err [StandardError] error object if request failed
203
208
  #
204
- # @return [Google::Apis::LoggingV2beta1::LogMetric]
209
+ # @return [Google::Apis::LoggingV2beta1::Empty]
205
210
  #
206
211
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
207
212
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
208
213
  # @raise [Google::Apis::AuthorizationError] Authorization is required
209
- def update_project_metric(metric_name, log_metric_object = nil, quota_user: nil, fields: nil, options: nil, &block)
210
- command = make_simple_command(:put, 'v2beta1/{+metricName}', options)
211
- command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
212
- command.request_object = log_metric_object
213
- command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
214
- command.response_class = Google::Apis::LoggingV2beta1::LogMetric
215
- command.params['metricName'] = metric_name unless metric_name.nil?
214
+ def delete_project_sink(sink_name, quota_user: nil, fields: nil, options: nil, &block)
215
+ command = make_simple_command(:delete, 'v2beta1/{+sinkName}', options)
216
+ command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
217
+ command.response_class = Google::Apis::LoggingV2beta1::Empty
218
+ command.params['sinkName'] = sink_name unless sink_name.nil?
216
219
  command.query['quotaUser'] = quota_user unless quota_user.nil?
217
220
  command.query['fields'] = fields unless fields.nil?
218
221
  execute_or_queue_command(command, &block)
219
222
  end
220
223
 
221
- # Creates a logs-based metric.
224
+ # Lists sinks.
222
225
  # @param [String] parent
223
- # The resource name of the project in which to create the metric:
226
+ # Required. The parent resource whose sinks are to be listed:
224
227
  # "projects/[PROJECT_ID]"
225
- # The new metric must be provided in the request.
226
- # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
228
+ # "organizations/[ORGANIZATION_ID]"
229
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
230
+ # "folders/[FOLDER_ID]"
231
+ # @param [String] page_token
232
+ # Optional. If present, then retrieve the next batch of results from the
233
+ # preceding call to this method. pageToken must be the value of nextPageToken
234
+ # from the previous response. The values of other method parameters should be
235
+ # identical to those in the previous call.
236
+ # @param [Fixnum] page_size
237
+ # Optional. The maximum number of results to return from this request. Non-
238
+ # positive values are ignored. The presence of nextPageToken in the response
239
+ # indicates that more results might be available.
227
240
  # @param [String] quota_user
228
241
  # Available to use for quota purposes for server-side applications. Can be any
229
242
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -233,30 +246,34 @@ module Google
233
246
  # Request-specific options
234
247
  #
235
248
  # @yield [result, err] Result & error if block supplied
236
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
249
+ # @yieldparam result [Google::Apis::LoggingV2beta1::ListSinksResponse] parsed result object
237
250
  # @yieldparam err [StandardError] error object if request failed
238
251
  #
239
- # @return [Google::Apis::LoggingV2beta1::LogMetric]
252
+ # @return [Google::Apis::LoggingV2beta1::ListSinksResponse]
240
253
  #
241
254
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
242
255
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
243
256
  # @raise [Google::Apis::AuthorizationError] Authorization is required
244
- def create_project_metric(parent, log_metric_object = nil, quota_user: nil, fields: nil, options: nil, &block)
245
- command = make_simple_command(:post, 'v2beta1/{+parent}/metrics', options)
246
- command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
247
- command.request_object = log_metric_object
248
- command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
249
- command.response_class = Google::Apis::LoggingV2beta1::LogMetric
257
+ def list_project_sinks(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
258
+ command = make_simple_command(:get, 'v2beta1/{+parent}/sinks', options)
259
+ command.response_representation = Google::Apis::LoggingV2beta1::ListSinksResponse::Representation
260
+ command.response_class = Google::Apis::LoggingV2beta1::ListSinksResponse
250
261
  command.params['parent'] = parent unless parent.nil?
262
+ command.query['pageToken'] = page_token unless page_token.nil?
263
+ command.query['pageSize'] = page_size unless page_size.nil?
251
264
  command.query['quotaUser'] = quota_user unless quota_user.nil?
252
265
  command.query['fields'] = fields unless fields.nil?
253
266
  execute_or_queue_command(command, &block)
254
267
  end
255
268
 
256
- # Deletes a logs-based metric.
257
- # @param [String] metric_name
258
- # The resource name of the metric to delete:
259
- # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
269
+ # Gets a sink.
270
+ # @param [String] sink_name
271
+ # Required. The resource name of the sink:
272
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
273
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
274
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
275
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
276
+ # Example: "projects/my-project-id/sinks/my-sink-id".
260
277
  # @param [String] quota_user
261
278
  # Available to use for quota purposes for server-side applications. Can be any
262
279
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -266,33 +283,48 @@ module Google
266
283
  # Request-specific options
267
284
  #
268
285
  # @yield [result, err] Result & error if block supplied
269
- # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
286
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
270
287
  # @yieldparam err [StandardError] error object if request failed
271
288
  #
272
- # @return [Google::Apis::LoggingV2beta1::Empty]
289
+ # @return [Google::Apis::LoggingV2beta1::LogSink]
273
290
  #
274
291
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
275
292
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
276
293
  # @raise [Google::Apis::AuthorizationError] Authorization is required
277
- def delete_project_metric(metric_name, quota_user: nil, fields: nil, options: nil, &block)
278
- command = make_simple_command(:delete, 'v2beta1/{+metricName}', options)
279
- command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
280
- command.response_class = Google::Apis::LoggingV2beta1::Empty
281
- command.params['metricName'] = metric_name unless metric_name.nil?
294
+ def get_project_sink(sink_name, quota_user: nil, fields: nil, options: nil, &block)
295
+ command = make_simple_command(:get, 'v2beta1/{+sinkName}', options)
296
+ command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
297
+ command.response_class = Google::Apis::LoggingV2beta1::LogSink
298
+ command.params['sinkName'] = sink_name unless sink_name.nil?
282
299
  command.query['quotaUser'] = quota_user unless quota_user.nil?
283
300
  command.query['fields'] = fields unless fields.nil?
284
301
  execute_or_queue_command(command, &block)
285
302
  end
286
303
 
287
- # Deletes all the log entries in a log. The log reappears if it receives new
288
- # entries.
289
- # @param [String] log_name
290
- # Required. The resource name of the log to delete:
291
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
292
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
293
- # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
294
- # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
295
- # 2Factivity". For more information about log names, see LogEntry.
304
+ # Updates a sink. If the named sink doesn't exist, then this method is identical
305
+ # to sinks.create. If the named sink does exist, then this method replaces the
306
+ # following fields in the existing sink with values from the new sink:
307
+ # destination, filter, output_version_format, start_time, and end_time. The
308
+ # updated filter might also have a new writer_identity; see the
309
+ # unique_writer_identity field.
310
+ # @param [String] sink_name
311
+ # Required. The full resource name of the sink to update, including the parent
312
+ # resource and the sink identifier:
313
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
314
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
315
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
316
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
317
+ # Example: "projects/my-project-id/sinks/my-sink-id".
318
+ # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
319
+ # @param [Boolean] unique_writer_identity
320
+ # Optional. See sinks.create for a description of this field. When updating a
321
+ # sink, the effect of this field on the value of writer_identity in the updated
322
+ # sink depends on both the old and new values of this field:
323
+ # If the old and new values of this field are both false or both true, then
324
+ # there is no change to the sink's writer_identity.
325
+ # If the old value was false and the new value is true, then writer_identity is
326
+ # changed to a unique service account.
327
+ # It is an error if the old value was true and the new value is false.
296
328
  # @param [String] quota_user
297
329
  # Available to use for quota purposes for server-side applications. Can be any
298
330
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -302,39 +334,31 @@ module Google
302
334
  # Request-specific options
303
335
  #
304
336
  # @yield [result, err] Result & error if block supplied
305
- # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
337
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
306
338
  # @yieldparam err [StandardError] error object if request failed
307
339
  #
308
- # @return [Google::Apis::LoggingV2beta1::Empty]
340
+ # @return [Google::Apis::LoggingV2beta1::LogSink]
309
341
  #
310
342
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
311
343
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
312
344
  # @raise [Google::Apis::AuthorizationError] Authorization is required
313
- def delete_log(log_name, quota_user: nil, fields: nil, options: nil, &block)
314
- command = make_simple_command(:delete, 'v2beta1/{+logName}', options)
315
- command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
316
- command.response_class = Google::Apis::LoggingV2beta1::Empty
317
- command.params['logName'] = log_name unless log_name.nil?
345
+ def update_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, quota_user: nil, fields: nil, options: nil, &block)
346
+ command = make_simple_command(:put, 'v2beta1/{+sinkName}', options)
347
+ command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
348
+ command.request_object = log_sink_object
349
+ command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
350
+ command.response_class = Google::Apis::LoggingV2beta1::LogSink
351
+ command.params['sinkName'] = sink_name unless sink_name.nil?
352
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
318
353
  command.query['quotaUser'] = quota_user unless quota_user.nil?
319
354
  command.query['fields'] = fields unless fields.nil?
320
355
  execute_or_queue_command(command, &block)
321
356
  end
322
357
 
323
- # Lists the logs in projects or organizations. Only logs that have entries are
324
- # listed.
325
- # @param [String] parent
326
- # Required. The resource name that owns the logs:
327
- # "projects/[PROJECT_ID]"
328
- # "organizations/[ORGANIZATION_ID]"
329
- # @param [String] page_token
330
- # Optional. If present, then retrieve the next batch of results from the
331
- # preceding call to this method. pageToken must be the value of nextPageToken
332
- # from the previous response. The values of other method parameters should be
333
- # identical to those in the previous call.
334
- # @param [Fixnum] page_size
335
- # Optional. The maximum number of results to return from this request. Non-
336
- # positive values are ignored. The presence of nextPageToken in the response
337
- # indicates that more results might be available.
358
+ # Deletes a logs-based metric.
359
+ # @param [String] metric_name
360
+ # The resource name of the metric to delete:
361
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
338
362
  # @param [String] quota_user
339
363
  # Available to use for quota purposes for server-side applications. Can be any
340
364
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -344,74 +368,37 @@ module Google
344
368
  # Request-specific options
345
369
  #
346
370
  # @yield [result, err] Result & error if block supplied
347
- # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogsResponse] parsed result object
371
+ # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
348
372
  # @yieldparam err [StandardError] error object if request failed
349
373
  #
350
- # @return [Google::Apis::LoggingV2beta1::ListLogsResponse]
374
+ # @return [Google::Apis::LoggingV2beta1::Empty]
351
375
  #
352
376
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
353
377
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
354
378
  # @raise [Google::Apis::AuthorizationError] Authorization is required
355
- def list_logs(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
356
- command = make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
357
- command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
358
- command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
359
- command.params['parent'] = parent unless parent.nil?
360
- command.query['pageToken'] = page_token unless page_token.nil?
361
- command.query['pageSize'] = page_size unless page_size.nil?
379
+ def delete_project_metric(metric_name, quota_user: nil, fields: nil, options: nil, &block)
380
+ command = make_simple_command(:delete, 'v2beta1/{+metricName}', options)
381
+ command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
382
+ command.response_class = Google::Apis::LoggingV2beta1::Empty
383
+ command.params['metricName'] = metric_name unless metric_name.nil?
362
384
  command.query['quotaUser'] = quota_user unless quota_user.nil?
363
385
  command.query['fields'] = fields unless fields.nil?
364
386
  execute_or_queue_command(command, &block)
365
387
  end
366
388
 
367
- # Lists sinks.
389
+ # Lists logs-based metrics.
368
390
  # @param [String] parent
369
- # Required. The parent resource whose sinks are to be listed. Examples: "
370
- # projects/my-logging-project", "organizations/123456789".
371
- # @param [Fixnum] page_size
372
- # Optional. The maximum number of results to return from this request. Non-
373
- # positive values are ignored. The presence of nextPageToken in the response
374
- # indicates that more results might be available.
391
+ # Required. The name of the project containing the metrics:
392
+ # "projects/[PROJECT_ID]"
375
393
  # @param [String] page_token
376
- # Optional. If present, then retrieve the next batch of results from the
377
- # preceding call to this method. pageToken must be the value of nextPageToken
378
- # from the previous response. The values of other method parameters should be
379
- # identical to those in the previous call.
380
- # @param [String] quota_user
381
- # Available to use for quota purposes for server-side applications. Can be any
382
- # arbitrary string assigned to a user, but should not exceed 40 characters.
383
- # @param [String] fields
384
- # Selector specifying which fields to include in a partial response.
385
- # @param [Google::Apis::RequestOptions] options
386
- # Request-specific options
387
- #
388
- # @yield [result, err] Result & error if block supplied
389
- # @yieldparam result [Google::Apis::LoggingV2beta1::ListSinksResponse] parsed result object
390
- # @yieldparam err [StandardError] error object if request failed
391
- #
392
- # @return [Google::Apis::LoggingV2beta1::ListSinksResponse]
393
- #
394
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
395
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
396
- # @raise [Google::Apis::AuthorizationError] Authorization is required
397
- def list_project_sinks(parent, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
398
- command = make_simple_command(:get, 'v2beta1/{+parent}/sinks', options)
399
- command.response_representation = Google::Apis::LoggingV2beta1::ListSinksResponse::Representation
400
- command.response_class = Google::Apis::LoggingV2beta1::ListSinksResponse
401
- command.params['parent'] = parent unless parent.nil?
402
- command.query['pageSize'] = page_size unless page_size.nil?
403
- command.query['pageToken'] = page_token unless page_token.nil?
404
- command.query['quotaUser'] = quota_user unless quota_user.nil?
405
- command.query['fields'] = fields unless fields.nil?
406
- execute_or_queue_command(command, &block)
407
- end
408
-
409
- # Gets a sink.
410
- # @param [String] sink_name
411
- # Required. The parent resource name of the sink:
412
- # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
413
- # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
414
- # Example: "projects/my-project-id/sinks/my-sink-id".
394
+ # Optional. If present, then retrieve the next batch of results from the
395
+ # preceding call to this method. pageToken must be the value of nextPageToken
396
+ # from the previous response. The values of other method parameters should be
397
+ # identical to those in the previous call.
398
+ # @param [Fixnum] page_size
399
+ # Optional. The maximum number of results to return from this request. Non-
400
+ # positive values are ignored. The presence of nextPageToken in the response
401
+ # indicates that more results might be available.
415
402
  # @param [String] quota_user
416
403
  # Available to use for quota purposes for server-side applications. Can be any
417
404
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -421,46 +408,30 @@ module Google
421
408
  # Request-specific options
422
409
  #
423
410
  # @yield [result, err] Result & error if block supplied
424
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
411
+ # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogMetricsResponse] parsed result object
425
412
  # @yieldparam err [StandardError] error object if request failed
426
413
  #
427
- # @return [Google::Apis::LoggingV2beta1::LogSink]
414
+ # @return [Google::Apis::LoggingV2beta1::ListLogMetricsResponse]
428
415
  #
429
416
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
430
417
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
431
418
  # @raise [Google::Apis::AuthorizationError] Authorization is required
432
- def get_project_sink(sink_name, quota_user: nil, fields: nil, options: nil, &block)
433
- command = make_simple_command(:get, 'v2beta1/{+sinkName}', options)
434
- command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
435
- command.response_class = Google::Apis::LoggingV2beta1::LogSink
436
- command.params['sinkName'] = sink_name unless sink_name.nil?
419
+ def list_project_metrics(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
420
+ command = make_simple_command(:get, 'v2beta1/{+parent}/metrics', options)
421
+ command.response_representation = Google::Apis::LoggingV2beta1::ListLogMetricsResponse::Representation
422
+ command.response_class = Google::Apis::LoggingV2beta1::ListLogMetricsResponse
423
+ command.params['parent'] = parent unless parent.nil?
424
+ command.query['pageToken'] = page_token unless page_token.nil?
425
+ command.query['pageSize'] = page_size unless page_size.nil?
437
426
  command.query['quotaUser'] = quota_user unless quota_user.nil?
438
427
  command.query['fields'] = fields unless fields.nil?
439
428
  execute_or_queue_command(command, &block)
440
429
  end
441
430
 
442
- # Updates a sink. If the named sink doesn't exist, then this method is identical
443
- # to sinks.create. If the named sink does exist, then this method replaces the
444
- # following fields in the existing sink with values from the new sink:
445
- # destination, filter, output_version_format, start_time, and end_time. The
446
- # updated filter might also have a new writer_identity; see the
447
- # unique_writer_identity field.
448
- # @param [String] sink_name
449
- # Required. The full resource name of the sink to update, including the parent
450
- # resource and the sink identifier:
451
- # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
452
- # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
453
- # Example: "projects/my-project-id/sinks/my-sink-id".
454
- # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
455
- # @param [Boolean] unique_writer_identity
456
- # Optional. See sinks.create for a description of this field. When updating a
457
- # sink, the effect of this field on the value of writer_identity in the updated
458
- # sink depends on both the old and new values of this field:
459
- # If the old and new values of this field are both false or both true, then
460
- # there is no change to the sink's writer_identity.
461
- # If the old value was false and the new value is true, then writer_identity is
462
- # changed to a unique service account.
463
- # It is an error if the old value was true and the new value is false.
431
+ # Gets a logs-based metric.
432
+ # @param [String] metric_name
433
+ # The resource name of the desired metric:
434
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
464
435
  # @param [String] quota_user
465
436
  # Available to use for quota purposes for server-side applications. Can be any
466
437
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -470,48 +441,32 @@ module Google
470
441
  # Request-specific options
471
442
  #
472
443
  # @yield [result, err] Result & error if block supplied
473
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
444
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
474
445
  # @yieldparam err [StandardError] error object if request failed
475
446
  #
476
- # @return [Google::Apis::LoggingV2beta1::LogSink]
447
+ # @return [Google::Apis::LoggingV2beta1::LogMetric]
477
448
  #
478
449
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
479
450
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
480
451
  # @raise [Google::Apis::AuthorizationError] Authorization is required
481
- def update_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, quota_user: nil, fields: nil, options: nil, &block)
482
- command = make_simple_command(:put, 'v2beta1/{+sinkName}', options)
483
- command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
484
- command.request_object = log_sink_object
485
- command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
486
- command.response_class = Google::Apis::LoggingV2beta1::LogSink
487
- command.params['sinkName'] = sink_name unless sink_name.nil?
488
- command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
452
+ def get_project_metric(metric_name, quota_user: nil, fields: nil, options: nil, &block)
453
+ command = make_simple_command(:get, 'v2beta1/{+metricName}', options)
454
+ command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
455
+ command.response_class = Google::Apis::LoggingV2beta1::LogMetric
456
+ command.params['metricName'] = metric_name unless metric_name.nil?
489
457
  command.query['quotaUser'] = quota_user unless quota_user.nil?
490
458
  command.query['fields'] = fields unless fields.nil?
491
459
  execute_or_queue_command(command, &block)
492
460
  end
493
461
 
494
- # Creates a sink that exports specified log entries to a destination. The export
495
- # of newly-ingested log entries begins immediately, unless the current time is
496
- # outside the sink's start and end times or the sink's writer_identity is not
497
- # permitted to write to the destination. A sink can export log entries only from
498
- # the resource owning the sink.
499
- # @param [String] parent
500
- # Required. The resource in which to create the sink:
501
- # "projects/[PROJECT_ID]"
502
- # "organizations/[ORGANIZATION_ID]"
503
- # Examples: "projects/my-logging-project", "organizations/123456789".
504
- # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
505
- # @param [Boolean] unique_writer_identity
506
- # Optional. Determines the kind of IAM identity returned as writer_identity in
507
- # the new sink. If this value is omitted or set to false, and if the sink's
508
- # parent is a project, then the value returned as writer_identity is cloud-logs@
509
- # system.gserviceaccount.com, the same identity used before the addition of
510
- # writer identities to this API. The sink's destination must be in the same
511
- # project as the sink itself.If this field is set to true, or if the sink is
512
- # owned by a non-project resource such as an organization, then the value of
513
- # writer_identity will be a unique service account used only for exports from
514
- # the new sink. For more information, see writer_identity in LogSink.
462
+ # Creates or updates a logs-based metric.
463
+ # @param [String] metric_name
464
+ # The resource name of the metric to update:
465
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
466
+ # The updated metric must be provided in the request and it's name field must be
467
+ # the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a
468
+ # new metric is created.
469
+ # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
515
470
  # @param [String] quota_user
516
471
  # Available to use for quota purposes for server-side applications. Can be any
517
472
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -521,36 +476,32 @@ module Google
521
476
  # Request-specific options
522
477
  #
523
478
  # @yield [result, err] Result & error if block supplied
524
- # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
479
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
525
480
  # @yieldparam err [StandardError] error object if request failed
526
481
  #
527
- # @return [Google::Apis::LoggingV2beta1::LogSink]
482
+ # @return [Google::Apis::LoggingV2beta1::LogMetric]
528
483
  #
529
484
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
530
485
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
531
486
  # @raise [Google::Apis::AuthorizationError] Authorization is required
532
- def create_project_sink(parent, log_sink_object = nil, unique_writer_identity: nil, quota_user: nil, fields: nil, options: nil, &block)
533
- command = make_simple_command(:post, 'v2beta1/{+parent}/sinks', options)
534
- command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
535
- command.request_object = log_sink_object
536
- command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
537
- command.response_class = Google::Apis::LoggingV2beta1::LogSink
538
- command.params['parent'] = parent unless parent.nil?
539
- command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
487
+ def update_project_metric(metric_name, log_metric_object = nil, quota_user: nil, fields: nil, options: nil, &block)
488
+ command = make_simple_command(:put, 'v2beta1/{+metricName}', options)
489
+ command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
490
+ command.request_object = log_metric_object
491
+ command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
492
+ command.response_class = Google::Apis::LoggingV2beta1::LogMetric
493
+ command.params['metricName'] = metric_name unless metric_name.nil?
540
494
  command.query['quotaUser'] = quota_user unless quota_user.nil?
541
495
  command.query['fields'] = fields unless fields.nil?
542
496
  execute_or_queue_command(command, &block)
543
497
  end
544
498
 
545
- # Deletes a sink. If the sink has a unique writer_identity, then that service
546
- # account is also deleted.
547
- # @param [String] sink_name
548
- # Required. The full resource name of the sink to delete, including the parent
549
- # resource and the sink identifier:
550
- # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
551
- # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
552
- # It is an error if the sink does not exist. Example: "projects/my-project-id/
553
- # sinks/my-sink-id". It is an error if the sink does not exist.
499
+ # Creates a logs-based metric.
500
+ # @param [String] parent
501
+ # The resource name of the project in which to create the metric:
502
+ # "projects/[PROJECT_ID]"
503
+ # The new metric must be provided in the request.
504
+ # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
554
505
  # @param [String] quota_user
555
506
  # Available to use for quota purposes for server-side applications. Can be any
556
507
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -560,30 +511,35 @@ module Google
560
511
  # Request-specific options
561
512
  #
562
513
  # @yield [result, err] Result & error if block supplied
563
- # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
514
+ # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
564
515
  # @yieldparam err [StandardError] error object if request failed
565
516
  #
566
- # @return [Google::Apis::LoggingV2beta1::Empty]
517
+ # @return [Google::Apis::LoggingV2beta1::LogMetric]
567
518
  #
568
519
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
569
520
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
570
521
  # @raise [Google::Apis::AuthorizationError] Authorization is required
571
- def delete_project_sink(sink_name, quota_user: nil, fields: nil, options: nil, &block)
572
- command = make_simple_command(:delete, 'v2beta1/{+sinkName}', options)
573
- command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
574
- command.response_class = Google::Apis::LoggingV2beta1::Empty
575
- command.params['sinkName'] = sink_name unless sink_name.nil?
522
+ def create_project_metric(parent, log_metric_object = nil, quota_user: nil, fields: nil, options: nil, &block)
523
+ command = make_simple_command(:post, 'v2beta1/{+parent}/metrics', options)
524
+ command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
525
+ command.request_object = log_metric_object
526
+ command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
527
+ command.response_class = Google::Apis::LoggingV2beta1::LogMetric
528
+ command.params['parent'] = parent unless parent.nil?
576
529
  command.query['quotaUser'] = quota_user unless quota_user.nil?
577
530
  command.query['fields'] = fields unless fields.nil?
578
531
  execute_or_queue_command(command, &block)
579
532
  end
580
533
 
581
534
  # Deletes all the log entries in a log. The log reappears if it receives new
582
- # entries.
535
+ # entries. Log entries written shortly before the delete operation might not be
536
+ # deleted.
583
537
  # @param [String] log_name
584
538
  # Required. The resource name of the log to delete:
585
539
  # "projects/[PROJECT_ID]/logs/[LOG_ID]"
586
540
  # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
541
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
542
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
587
543
  # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
588
544
  # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
589
545
  # 2Factivity". For more information about log names, see LogEntry.
@@ -614,21 +570,23 @@ module Google
614
570
  execute_or_queue_command(command, &block)
615
571
  end
616
572
 
617
- # Lists the logs in projects or organizations. Only logs that have entries are
618
- # listed.
573
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
574
+ # logs that have entries are listed.
619
575
  # @param [String] parent
620
576
  # Required. The resource name that owns the logs:
621
577
  # "projects/[PROJECT_ID]"
622
578
  # "organizations/[ORGANIZATION_ID]"
623
- # @param [Fixnum] page_size
624
- # Optional. The maximum number of results to return from this request. Non-
625
- # positive values are ignored. The presence of nextPageToken in the response
626
- # indicates that more results might be available.
579
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
580
+ # "folders/[FOLDER_ID]"
627
581
  # @param [String] page_token
628
582
  # Optional. If present, then retrieve the next batch of results from the
629
583
  # preceding call to this method. pageToken must be the value of nextPageToken
630
584
  # from the previous response. The values of other method parameters should be
631
585
  # identical to those in the previous call.
586
+ # @param [Fixnum] page_size
587
+ # Optional. The maximum number of results to return from this request. Non-
588
+ # positive values are ignored. The presence of nextPageToken in the response
589
+ # indicates that more results might be available.
632
590
  # @param [String] quota_user
633
591
  # Available to use for quota purposes for server-side applications. Can be any
634
592
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -646,13 +604,13 @@ module Google
646
604
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
647
605
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
648
606
  # @raise [Google::Apis::AuthorizationError] Authorization is required
649
- def list_billing_account_logs(parent, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
607
+ def list_billing_account_logs(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
650
608
  command = make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
651
609
  command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
652
610
  command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
653
611
  command.params['parent'] = parent unless parent.nil?
654
- command.query['pageSize'] = page_size unless page_size.nil?
655
612
  command.query['pageToken'] = page_token unless page_token.nil?
613
+ command.query['pageSize'] = page_size unless page_size.nil?
656
614
  command.query['quotaUser'] = quota_user unless quota_user.nil?
657
615
  command.query['fields'] = fields unless fields.nil?
658
616
  execute_or_queue_command(command, &block)
@@ -696,21 +654,62 @@ module Google
696
654
  execute_or_queue_command(command, &block)
697
655
  end
698
656
 
699
- # Lists the logs in projects or organizations. Only logs that have entries are
700
- # listed.
657
+ # Deletes all the log entries in a log. The log reappears if it receives new
658
+ # entries. Log entries written shortly before the delete operation might not be
659
+ # deleted.
660
+ # @param [String] log_name
661
+ # Required. The resource name of the log to delete:
662
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
663
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
664
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
665
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
666
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
667
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
668
+ # 2Factivity". For more information about log names, see LogEntry.
669
+ # @param [String] quota_user
670
+ # Available to use for quota purposes for server-side applications. Can be any
671
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
672
+ # @param [String] fields
673
+ # Selector specifying which fields to include in a partial response.
674
+ # @param [Google::Apis::RequestOptions] options
675
+ # Request-specific options
676
+ #
677
+ # @yield [result, err] Result & error if block supplied
678
+ # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
679
+ # @yieldparam err [StandardError] error object if request failed
680
+ #
681
+ # @return [Google::Apis::LoggingV2beta1::Empty]
682
+ #
683
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
684
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
685
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
686
+ def delete_organization_log(log_name, quota_user: nil, fields: nil, options: nil, &block)
687
+ command = make_simple_command(:delete, 'v2beta1/{+logName}', options)
688
+ command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
689
+ command.response_class = Google::Apis::LoggingV2beta1::Empty
690
+ command.params['logName'] = log_name unless log_name.nil?
691
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
692
+ command.query['fields'] = fields unless fields.nil?
693
+ execute_or_queue_command(command, &block)
694
+ end
695
+
696
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
697
+ # logs that have entries are listed.
701
698
  # @param [String] parent
702
699
  # Required. The resource name that owns the logs:
703
700
  # "projects/[PROJECT_ID]"
704
701
  # "organizations/[ORGANIZATION_ID]"
705
- # @param [Fixnum] page_size
706
- # Optional. The maximum number of results to return from this request. Non-
707
- # positive values are ignored. The presence of nextPageToken in the response
708
- # indicates that more results might be available.
702
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
703
+ # "folders/[FOLDER_ID]"
709
704
  # @param [String] page_token
710
705
  # Optional. If present, then retrieve the next batch of results from the
711
706
  # preceding call to this method. pageToken must be the value of nextPageToken
712
707
  # from the previous response. The values of other method parameters should be
713
708
  # identical to those in the previous call.
709
+ # @param [Fixnum] page_size
710
+ # Optional. The maximum number of results to return from this request. Non-
711
+ # positive values are ignored. The presence of nextPageToken in the response
712
+ # indicates that more results might be available.
714
713
  # @param [String] quota_user
715
714
  # Available to use for quota purposes for server-side applications. Can be any
716
715
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -728,27 +727,21 @@ module Google
728
727
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
729
728
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
730
729
  # @raise [Google::Apis::AuthorizationError] Authorization is required
731
- def list_organization_logs(parent, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
730
+ def list_organization_logs(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
732
731
  command = make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
733
732
  command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
734
733
  command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
735
734
  command.params['parent'] = parent unless parent.nil?
736
- command.query['pageSize'] = page_size unless page_size.nil?
737
735
  command.query['pageToken'] = page_token unless page_token.nil?
736
+ command.query['pageSize'] = page_size unless page_size.nil?
738
737
  command.query['quotaUser'] = quota_user unless quota_user.nil?
739
738
  command.query['fields'] = fields unless fields.nil?
740
739
  execute_or_queue_command(command, &block)
741
740
  end
742
741
 
743
- # Deletes all the log entries in a log. The log reappears if it receives new
744
- # entries.
745
- # @param [String] log_name
746
- # Required. The resource name of the log to delete:
747
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
748
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
749
- # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
750
- # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
751
- # 2Factivity". For more information about log names, see LogEntry.
742
+ # Lists log entries. Use this method to retrieve log entries from Stackdriver
743
+ # Logging. For ways to export log entries, see Exporting Logs.
744
+ # @param [Google::Apis::LoggingV2beta1::ListLogEntriesRequest] list_log_entries_request_object
752
745
  # @param [String] quota_user
753
746
  # Available to use for quota purposes for server-side applications. Can be any
754
747
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -758,19 +751,51 @@ module Google
758
751
  # Request-specific options
759
752
  #
760
753
  # @yield [result, err] Result & error if block supplied
761
- # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
754
+ # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogEntriesResponse] parsed result object
762
755
  # @yieldparam err [StandardError] error object if request failed
763
756
  #
764
- # @return [Google::Apis::LoggingV2beta1::Empty]
757
+ # @return [Google::Apis::LoggingV2beta1::ListLogEntriesResponse]
765
758
  #
766
759
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
767
760
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
768
761
  # @raise [Google::Apis::AuthorizationError] Authorization is required
769
- def delete_organization_log(log_name, quota_user: nil, fields: nil, options: nil, &block)
770
- command = make_simple_command(:delete, 'v2beta1/{+logName}', options)
771
- command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
772
- command.response_class = Google::Apis::LoggingV2beta1::Empty
773
- command.params['logName'] = log_name unless log_name.nil?
762
+ def list_entry_log_entries(list_log_entries_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
763
+ command = make_simple_command(:post, 'v2beta1/entries:list', options)
764
+ command.request_representation = Google::Apis::LoggingV2beta1::ListLogEntriesRequest::Representation
765
+ command.request_object = list_log_entries_request_object
766
+ command.response_representation = Google::Apis::LoggingV2beta1::ListLogEntriesResponse::Representation
767
+ command.response_class = Google::Apis::LoggingV2beta1::ListLogEntriesResponse
768
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
769
+ command.query['fields'] = fields unless fields.nil?
770
+ execute_or_queue_command(command, &block)
771
+ end
772
+
773
+ # Writes log entries to Stackdriver Logging. All log entries are written by this
774
+ # method.
775
+ # @param [Google::Apis::LoggingV2beta1::WriteLogEntriesRequest] write_log_entries_request_object
776
+ # @param [String] quota_user
777
+ # Available to use for quota purposes for server-side applications. Can be any
778
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
779
+ # @param [String] fields
780
+ # Selector specifying which fields to include in a partial response.
781
+ # @param [Google::Apis::RequestOptions] options
782
+ # Request-specific options
783
+ #
784
+ # @yield [result, err] Result & error if block supplied
785
+ # @yieldparam result [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse] parsed result object
786
+ # @yieldparam err [StandardError] error object if request failed
787
+ #
788
+ # @return [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse]
789
+ #
790
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
791
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
792
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
793
+ def write_entry_log_entries(write_log_entries_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
794
+ command = make_simple_command(:post, 'v2beta1/entries:write', options)
795
+ command.request_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesRequest::Representation
796
+ command.request_object = write_log_entries_request_object
797
+ command.response_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse::Representation
798
+ command.response_class = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse
774
799
  command.query['quotaUser'] = quota_user unless quota_user.nil?
775
800
  command.query['fields'] = fields unless fields.nil?
776
801
  execute_or_queue_command(command, &block)