google-api-client 0.9.28 → 0.10.0

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 (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)