google-apis-observability_v1 0.2.0 → 0.14.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.
@@ -22,7 +22,8 @@ module Google
22
22
  module ObservabilityV1
23
23
  # Observability API
24
24
  #
25
- #
25
+ # Provides functionality for configuring the observability scope, which controls
26
+ # the log, metric, and trace data that you can view.
26
27
  #
27
28
  # @example
28
29
  # require 'google/apis/observability_v1'
@@ -51,6 +52,474 @@ module Google
51
52
  @batch_path = 'batch'
52
53
  end
53
54
 
55
+ # Gets information about a location.
56
+ # @param [String] name
57
+ # Resource name for the location.
58
+ # @param [String] fields
59
+ # Selector specifying which fields to include in a partial response.
60
+ # @param [String] quota_user
61
+ # Available to use for quota purposes for server-side applications. Can be any
62
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::ObservabilityV1::Location] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::ObservabilityV1::Location]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def get_folder_location(name, fields: nil, quota_user: nil, options: nil, &block)
76
+ command = make_simple_command(:get, 'v1/{+name}', options)
77
+ command.response_representation = Google::Apis::ObservabilityV1::Location::Representation
78
+ command.response_class = Google::Apis::ObservabilityV1::Location
79
+ command.params['name'] = name unless name.nil?
80
+ command.query['fields'] = fields unless fields.nil?
81
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
82
+ execute_or_queue_command(command, &block)
83
+ end
84
+
85
+ # Lists information about the supported locations for this service. This method
86
+ # can be called in two ways: * **List all public locations:** Use the path `GET /
87
+ # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
88
+ # projects/`project_id`/locations`. This may include public locations as well as
89
+ # private or other locations specifically visible to the project.
90
+ # @param [String] name
91
+ # The resource that owns the locations collection, if applicable.
92
+ # @param [Array<String>, String] extra_location_types
93
+ # Optional. Do not use this field. It is unsupported and is ignored unless
94
+ # explicitly documented otherwise. This is primarily for internal usage.
95
+ # @param [String] filter
96
+ # A filter to narrow down results to a preferred subset. The filtering language
97
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
98
+ # in [AIP-160](https://google.aip.dev/160).
99
+ # @param [Fixnum] page_size
100
+ # The maximum number of results to return. If not set, the service selects a
101
+ # default.
102
+ # @param [String] page_token
103
+ # A page token received from the `next_page_token` field in the response. Send
104
+ # that page token to receive the subsequent page.
105
+ # @param [String] fields
106
+ # Selector specifying which fields to include in a partial response.
107
+ # @param [String] quota_user
108
+ # Available to use for quota purposes for server-side applications. Can be any
109
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
110
+ # @param [Google::Apis::RequestOptions] options
111
+ # Request-specific options
112
+ #
113
+ # @yield [result, err] Result & error if block supplied
114
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
115
+ # @yieldparam err [StandardError] error object if request failed
116
+ #
117
+ # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
118
+ #
119
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
120
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
121
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
122
+ def list_folder_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
123
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
124
+ command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
125
+ command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
126
+ command.params['name'] = name unless name.nil?
127
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
128
+ command.query['filter'] = filter unless filter.nil?
129
+ command.query['pageSize'] = page_size unless page_size.nil?
130
+ command.query['pageToken'] = page_token unless page_token.nil?
131
+ command.query['fields'] = fields unless fields.nil?
132
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
133
+ execute_or_queue_command(command, &block)
134
+ end
135
+
136
+ # Starts asynchronous cancellation on a long-running operation. The server makes
137
+ # a best effort to cancel the operation, but success is not guaranteed. If the
138
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
139
+ # Clients can use Operations.GetOperation or other methods to check whether the
140
+ # cancellation succeeded or whether the operation completed despite cancellation.
141
+ # On successful cancellation, the operation is not deleted; instead, it becomes
142
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
143
+ # , corresponding to `Code.CANCELLED`.
144
+ # @param [String] name
145
+ # The name of the operation resource to be cancelled.
146
+ # @param [Google::Apis::ObservabilityV1::CancelOperationRequest] cancel_operation_request_object
147
+ # @param [String] fields
148
+ # Selector specifying which fields to include in a partial response.
149
+ # @param [String] quota_user
150
+ # Available to use for quota purposes for server-side applications. Can be any
151
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
152
+ # @param [Google::Apis::RequestOptions] options
153
+ # Request-specific options
154
+ #
155
+ # @yield [result, err] Result & error if block supplied
156
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
157
+ # @yieldparam err [StandardError] error object if request failed
158
+ #
159
+ # @return [Google::Apis::ObservabilityV1::Empty]
160
+ #
161
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
162
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
163
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
164
+ def cancel_folder_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
165
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
166
+ command.request_representation = Google::Apis::ObservabilityV1::CancelOperationRequest::Representation
167
+ command.request_object = cancel_operation_request_object
168
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
169
+ command.response_class = Google::Apis::ObservabilityV1::Empty
170
+ command.params['name'] = name unless name.nil?
171
+ command.query['fields'] = fields unless fields.nil?
172
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
173
+ execute_or_queue_command(command, &block)
174
+ end
175
+
176
+ # Deletes a long-running operation. This method indicates that the client is no
177
+ # longer interested in the operation result. It does not cancel the operation.
178
+ # If the server doesn't support this method, it returns `google.rpc.Code.
179
+ # UNIMPLEMENTED`.
180
+ # @param [String] name
181
+ # The name of the operation resource to be deleted.
182
+ # @param [String] fields
183
+ # Selector specifying which fields to include in a partial response.
184
+ # @param [String] quota_user
185
+ # Available to use for quota purposes for server-side applications. Can be any
186
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
187
+ # @param [Google::Apis::RequestOptions] options
188
+ # Request-specific options
189
+ #
190
+ # @yield [result, err] Result & error if block supplied
191
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
192
+ # @yieldparam err [StandardError] error object if request failed
193
+ #
194
+ # @return [Google::Apis::ObservabilityV1::Empty]
195
+ #
196
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
197
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
198
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
199
+ def delete_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
200
+ command = make_simple_command(:delete, 'v1/{+name}', options)
201
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
202
+ command.response_class = Google::Apis::ObservabilityV1::Empty
203
+ command.params['name'] = name unless name.nil?
204
+ command.query['fields'] = fields unless fields.nil?
205
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
206
+ execute_or_queue_command(command, &block)
207
+ end
208
+
209
+ # Gets the latest state of a long-running operation. Clients can use this method
210
+ # to poll the operation result at intervals as recommended by the API service.
211
+ # @param [String] name
212
+ # The name of the operation resource.
213
+ # @param [String] fields
214
+ # Selector specifying which fields to include in a partial response.
215
+ # @param [String] quota_user
216
+ # Available to use for quota purposes for server-side applications. Can be any
217
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
218
+ # @param [Google::Apis::RequestOptions] options
219
+ # Request-specific options
220
+ #
221
+ # @yield [result, err] Result & error if block supplied
222
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
223
+ # @yieldparam err [StandardError] error object if request failed
224
+ #
225
+ # @return [Google::Apis::ObservabilityV1::Operation]
226
+ #
227
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
228
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
229
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
230
+ def get_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
231
+ command = make_simple_command(:get, 'v1/{+name}', options)
232
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
233
+ command.response_class = Google::Apis::ObservabilityV1::Operation
234
+ command.params['name'] = name unless name.nil?
235
+ command.query['fields'] = fields unless fields.nil?
236
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
237
+ execute_or_queue_command(command, &block)
238
+ end
239
+
240
+ # Lists operations that match the specified filter in the request. If the server
241
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
242
+ # @param [String] name
243
+ # The name of the operation's parent resource.
244
+ # @param [String] filter
245
+ # The standard list filter.
246
+ # @param [Fixnum] page_size
247
+ # The standard list page size.
248
+ # @param [String] page_token
249
+ # The standard list page token.
250
+ # @param [Boolean] return_partial_success
251
+ # When set to `true`, operations that are reachable are returned as normal, and
252
+ # those that are unreachable are returned in the ListOperationsResponse.
253
+ # unreachable field. This can only be `true` when reading across collections.
254
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
255
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
256
+ # if set unless explicitly documented otherwise in service or product specific
257
+ # documentation.
258
+ # @param [String] fields
259
+ # Selector specifying which fields to include in a partial response.
260
+ # @param [String] quota_user
261
+ # Available to use for quota purposes for server-side applications. Can be any
262
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
263
+ # @param [Google::Apis::RequestOptions] options
264
+ # Request-specific options
265
+ #
266
+ # @yield [result, err] Result & error if block supplied
267
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListOperationsResponse] parsed result object
268
+ # @yieldparam err [StandardError] error object if request failed
269
+ #
270
+ # @return [Google::Apis::ObservabilityV1::ListOperationsResponse]
271
+ #
272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
275
+ def list_folder_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
276
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
277
+ command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
278
+ command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
279
+ command.params['name'] = name unless name.nil?
280
+ command.query['filter'] = filter unless filter.nil?
281
+ command.query['pageSize'] = page_size unless page_size.nil?
282
+ command.query['pageToken'] = page_token unless page_token.nil?
283
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
284
+ command.query['fields'] = fields unless fields.nil?
285
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
286
+ execute_or_queue_command(command, &block)
287
+ end
288
+
289
+ # Gets information about a location.
290
+ # @param [String] name
291
+ # Resource name for the location.
292
+ # @param [String] fields
293
+ # Selector specifying which fields to include in a partial response.
294
+ # @param [String] quota_user
295
+ # Available to use for quota purposes for server-side applications. Can be any
296
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
297
+ # @param [Google::Apis::RequestOptions] options
298
+ # Request-specific options
299
+ #
300
+ # @yield [result, err] Result & error if block supplied
301
+ # @yieldparam result [Google::Apis::ObservabilityV1::Location] parsed result object
302
+ # @yieldparam err [StandardError] error object if request failed
303
+ #
304
+ # @return [Google::Apis::ObservabilityV1::Location]
305
+ #
306
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
307
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
308
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
309
+ def get_organization_location(name, fields: nil, quota_user: nil, options: nil, &block)
310
+ command = make_simple_command(:get, 'v1/{+name}', options)
311
+ command.response_representation = Google::Apis::ObservabilityV1::Location::Representation
312
+ command.response_class = Google::Apis::ObservabilityV1::Location
313
+ command.params['name'] = name unless name.nil?
314
+ command.query['fields'] = fields unless fields.nil?
315
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
316
+ execute_or_queue_command(command, &block)
317
+ end
318
+
319
+ # Lists information about the supported locations for this service. This method
320
+ # can be called in two ways: * **List all public locations:** Use the path `GET /
321
+ # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
322
+ # projects/`project_id`/locations`. This may include public locations as well as
323
+ # private or other locations specifically visible to the project.
324
+ # @param [String] name
325
+ # The resource that owns the locations collection, if applicable.
326
+ # @param [Array<String>, String] extra_location_types
327
+ # Optional. Do not use this field. It is unsupported and is ignored unless
328
+ # explicitly documented otherwise. This is primarily for internal usage.
329
+ # @param [String] filter
330
+ # A filter to narrow down results to a preferred subset. The filtering language
331
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
332
+ # in [AIP-160](https://google.aip.dev/160).
333
+ # @param [Fixnum] page_size
334
+ # The maximum number of results to return. If not set, the service selects a
335
+ # default.
336
+ # @param [String] page_token
337
+ # A page token received from the `next_page_token` field in the response. Send
338
+ # that page token to receive the subsequent page.
339
+ # @param [String] fields
340
+ # Selector specifying which fields to include in a partial response.
341
+ # @param [String] quota_user
342
+ # Available to use for quota purposes for server-side applications. Can be any
343
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
344
+ # @param [Google::Apis::RequestOptions] options
345
+ # Request-specific options
346
+ #
347
+ # @yield [result, err] Result & error if block supplied
348
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
349
+ # @yieldparam err [StandardError] error object if request failed
350
+ #
351
+ # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
352
+ #
353
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
354
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
355
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
356
+ def list_organization_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
357
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
358
+ command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
359
+ command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
360
+ command.params['name'] = name unless name.nil?
361
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
362
+ command.query['filter'] = filter unless filter.nil?
363
+ command.query['pageSize'] = page_size unless page_size.nil?
364
+ command.query['pageToken'] = page_token unless page_token.nil?
365
+ command.query['fields'] = fields unless fields.nil?
366
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
367
+ execute_or_queue_command(command, &block)
368
+ end
369
+
370
+ # Starts asynchronous cancellation on a long-running operation. The server makes
371
+ # a best effort to cancel the operation, but success is not guaranteed. If the
372
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
373
+ # Clients can use Operations.GetOperation or other methods to check whether the
374
+ # cancellation succeeded or whether the operation completed despite cancellation.
375
+ # On successful cancellation, the operation is not deleted; instead, it becomes
376
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
377
+ # , corresponding to `Code.CANCELLED`.
378
+ # @param [String] name
379
+ # The name of the operation resource to be cancelled.
380
+ # @param [Google::Apis::ObservabilityV1::CancelOperationRequest] cancel_operation_request_object
381
+ # @param [String] fields
382
+ # Selector specifying which fields to include in a partial response.
383
+ # @param [String] quota_user
384
+ # Available to use for quota purposes for server-side applications. Can be any
385
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
386
+ # @param [Google::Apis::RequestOptions] options
387
+ # Request-specific options
388
+ #
389
+ # @yield [result, err] Result & error if block supplied
390
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
391
+ # @yieldparam err [StandardError] error object if request failed
392
+ #
393
+ # @return [Google::Apis::ObservabilityV1::Empty]
394
+ #
395
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
396
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
397
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
398
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
399
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
400
+ command.request_representation = Google::Apis::ObservabilityV1::CancelOperationRequest::Representation
401
+ command.request_object = cancel_operation_request_object
402
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
403
+ command.response_class = Google::Apis::ObservabilityV1::Empty
404
+ command.params['name'] = name unless name.nil?
405
+ command.query['fields'] = fields unless fields.nil?
406
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
407
+ execute_or_queue_command(command, &block)
408
+ end
409
+
410
+ # Deletes a long-running operation. This method indicates that the client is no
411
+ # longer interested in the operation result. It does not cancel the operation.
412
+ # If the server doesn't support this method, it returns `google.rpc.Code.
413
+ # UNIMPLEMENTED`.
414
+ # @param [String] name
415
+ # The name of the operation resource to be deleted.
416
+ # @param [String] fields
417
+ # Selector specifying which fields to include in a partial response.
418
+ # @param [String] quota_user
419
+ # Available to use for quota purposes for server-side applications. Can be any
420
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
421
+ # @param [Google::Apis::RequestOptions] options
422
+ # Request-specific options
423
+ #
424
+ # @yield [result, err] Result & error if block supplied
425
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
426
+ # @yieldparam err [StandardError] error object if request failed
427
+ #
428
+ # @return [Google::Apis::ObservabilityV1::Empty]
429
+ #
430
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
431
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
432
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
433
+ def delete_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
434
+ command = make_simple_command(:delete, 'v1/{+name}', options)
435
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
436
+ command.response_class = Google::Apis::ObservabilityV1::Empty
437
+ command.params['name'] = name unless name.nil?
438
+ command.query['fields'] = fields unless fields.nil?
439
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
440
+ execute_or_queue_command(command, &block)
441
+ end
442
+
443
+ # Gets the latest state of a long-running operation. Clients can use this method
444
+ # to poll the operation result at intervals as recommended by the API service.
445
+ # @param [String] name
446
+ # The name of the operation resource.
447
+ # @param [String] fields
448
+ # Selector specifying which fields to include in a partial response.
449
+ # @param [String] quota_user
450
+ # Available to use for quota purposes for server-side applications. Can be any
451
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
452
+ # @param [Google::Apis::RequestOptions] options
453
+ # Request-specific options
454
+ #
455
+ # @yield [result, err] Result & error if block supplied
456
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
457
+ # @yieldparam err [StandardError] error object if request failed
458
+ #
459
+ # @return [Google::Apis::ObservabilityV1::Operation]
460
+ #
461
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
462
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
463
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
464
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
465
+ command = make_simple_command(:get, 'v1/{+name}', options)
466
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
467
+ command.response_class = Google::Apis::ObservabilityV1::Operation
468
+ command.params['name'] = name unless name.nil?
469
+ command.query['fields'] = fields unless fields.nil?
470
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
471
+ execute_or_queue_command(command, &block)
472
+ end
473
+
474
+ # Lists operations that match the specified filter in the request. If the server
475
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
476
+ # @param [String] name
477
+ # The name of the operation's parent resource.
478
+ # @param [String] filter
479
+ # The standard list filter.
480
+ # @param [Fixnum] page_size
481
+ # The standard list page size.
482
+ # @param [String] page_token
483
+ # The standard list page token.
484
+ # @param [Boolean] return_partial_success
485
+ # When set to `true`, operations that are reachable are returned as normal, and
486
+ # those that are unreachable are returned in the ListOperationsResponse.
487
+ # unreachable field. This can only be `true` when reading across collections.
488
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
489
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
490
+ # if set unless explicitly documented otherwise in service or product specific
491
+ # documentation.
492
+ # @param [String] fields
493
+ # Selector specifying which fields to include in a partial response.
494
+ # @param [String] quota_user
495
+ # Available to use for quota purposes for server-side applications. Can be any
496
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
497
+ # @param [Google::Apis::RequestOptions] options
498
+ # Request-specific options
499
+ #
500
+ # @yield [result, err] Result & error if block supplied
501
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListOperationsResponse] parsed result object
502
+ # @yieldparam err [StandardError] error object if request failed
503
+ #
504
+ # @return [Google::Apis::ObservabilityV1::ListOperationsResponse]
505
+ #
506
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
507
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
508
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
509
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
510
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
511
+ command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
512
+ command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
513
+ command.params['name'] = name unless name.nil?
514
+ command.query['filter'] = filter unless filter.nil?
515
+ command.query['pageSize'] = page_size unless page_size.nil?
516
+ command.query['pageToken'] = page_token unless page_token.nil?
517
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
518
+ command.query['fields'] = fields unless fields.nil?
519
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
520
+ execute_or_queue_command(command, &block)
521
+ end
522
+
54
523
  # Gets information about a location.
55
524
  # @param [String] name
56
525
  # Resource name for the location.
@@ -81,22 +550,317 @@ module Google
81
550
  execute_or_queue_command(command, &block)
82
551
  end
83
552
 
84
- # Lists information about the supported locations for this service.
553
+ # Lists information about the supported locations for this service. This method
554
+ # can be called in two ways: * **List all public locations:** Use the path `GET /
555
+ # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
556
+ # projects/`project_id`/locations`. This may include public locations as well as
557
+ # private or other locations specifically visible to the project.
558
+ # @param [String] name
559
+ # The resource that owns the locations collection, if applicable.
560
+ # @param [Array<String>, String] extra_location_types
561
+ # Optional. Do not use this field. It is unsupported and is ignored unless
562
+ # explicitly documented otherwise. This is primarily for internal usage.
563
+ # @param [String] filter
564
+ # A filter to narrow down results to a preferred subset. The filtering language
565
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
566
+ # in [AIP-160](https://google.aip.dev/160).
567
+ # @param [Fixnum] page_size
568
+ # The maximum number of results to return. If not set, the service selects a
569
+ # default.
570
+ # @param [String] page_token
571
+ # A page token received from the `next_page_token` field in the response. Send
572
+ # that page token to receive the subsequent page.
573
+ # @param [String] fields
574
+ # Selector specifying which fields to include in a partial response.
575
+ # @param [String] quota_user
576
+ # Available to use for quota purposes for server-side applications. Can be any
577
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
578
+ # @param [Google::Apis::RequestOptions] options
579
+ # Request-specific options
580
+ #
581
+ # @yield [result, err] Result & error if block supplied
582
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
583
+ # @yieldparam err [StandardError] error object if request failed
584
+ #
585
+ # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
586
+ #
587
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
588
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
589
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
590
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
591
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
592
+ command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
593
+ command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
594
+ command.params['name'] = name unless name.nil?
595
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
596
+ command.query['filter'] = filter unless filter.nil?
597
+ command.query['pageSize'] = page_size unless page_size.nil?
598
+ command.query['pageToken'] = page_token unless page_token.nil?
599
+ command.query['fields'] = fields unless fields.nil?
600
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
601
+ execute_or_queue_command(command, &block)
602
+ end
603
+
604
+ # Get bucket resource.
605
+ # @param [String] name
606
+ # Required. Name of the bucket to retrieve. The format is: projects/[PROJECT_ID]/
607
+ # locations/[LOCATION]/buckets/[BUCKET_ID]
608
+ # @param [String] fields
609
+ # Selector specifying which fields to include in a partial response.
610
+ # @param [String] quota_user
611
+ # Available to use for quota purposes for server-side applications. Can be any
612
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
613
+ # @param [Google::Apis::RequestOptions] options
614
+ # Request-specific options
615
+ #
616
+ # @yield [result, err] Result & error if block supplied
617
+ # @yieldparam result [Google::Apis::ObservabilityV1::Bucket] parsed result object
618
+ # @yieldparam err [StandardError] error object if request failed
619
+ #
620
+ # @return [Google::Apis::ObservabilityV1::Bucket]
621
+ #
622
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
623
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
624
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
625
+ def get_project_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
626
+ command = make_simple_command(:get, 'v1/{+name}', options)
627
+ command.response_representation = Google::Apis::ObservabilityV1::Bucket::Representation
628
+ command.response_class = Google::Apis::ObservabilityV1::Bucket
629
+ command.params['name'] = name unless name.nil?
630
+ command.query['fields'] = fields unless fields.nil?
631
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
632
+ execute_or_queue_command(command, &block)
633
+ end
634
+
635
+ # List buckets of a project in a particular location.
636
+ # @param [String] parent
637
+ # Required. The parent, which owns this collection of buckets. The format is:
638
+ # projects/[PROJECT_ID]/locations/[LOCATION]
639
+ # @param [Fixnum] page_size
640
+ # Optional. The maximum number of buckets to return. If unspecified, then at
641
+ # most 100 buckets are returned. The maximum value is 1000; values above 1000
642
+ # are coerced to 1000.
643
+ # @param [String] page_token
644
+ # Optional. A page token, received from a previous `ListBuckets` call. Provide
645
+ # this to retrieve the subsequent page.
646
+ # @param [Boolean] show_deleted
647
+ # Optional. If true, then the response will include deleted buckets.
648
+ # @param [String] fields
649
+ # Selector specifying which fields to include in a partial response.
650
+ # @param [String] quota_user
651
+ # Available to use for quota purposes for server-side applications. Can be any
652
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
653
+ # @param [Google::Apis::RequestOptions] options
654
+ # Request-specific options
655
+ #
656
+ # @yield [result, err] Result & error if block supplied
657
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListBucketsResponse] parsed result object
658
+ # @yieldparam err [StandardError] error object if request failed
659
+ #
660
+ # @return [Google::Apis::ObservabilityV1::ListBucketsResponse]
661
+ #
662
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
663
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
664
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
665
+ def list_project_location_buckets(parent, page_size: nil, page_token: nil, show_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
666
+ command = make_simple_command(:get, 'v1/{+parent}/buckets', options)
667
+ command.response_representation = Google::Apis::ObservabilityV1::ListBucketsResponse::Representation
668
+ command.response_class = Google::Apis::ObservabilityV1::ListBucketsResponse
669
+ command.params['parent'] = parent unless parent.nil?
670
+ command.query['pageSize'] = page_size unless page_size.nil?
671
+ command.query['pageToken'] = page_token unless page_token.nil?
672
+ command.query['showDeleted'] = show_deleted unless show_deleted.nil?
673
+ command.query['fields'] = fields unless fields.nil?
674
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
675
+ execute_or_queue_command(command, &block)
676
+ end
677
+
678
+ # Get a dataset.
679
+ # @param [String] name
680
+ # Required. Name of the dataset to retrieve. The format is: projects/[PROJECT_ID]
681
+ # /locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
682
+ # @param [String] fields
683
+ # Selector specifying which fields to include in a partial response.
684
+ # @param [String] quota_user
685
+ # Available to use for quota purposes for server-side applications. Can be any
686
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
687
+ # @param [Google::Apis::RequestOptions] options
688
+ # Request-specific options
689
+ #
690
+ # @yield [result, err] Result & error if block supplied
691
+ # @yieldparam result [Google::Apis::ObservabilityV1::Dataset] parsed result object
692
+ # @yieldparam err [StandardError] error object if request failed
693
+ #
694
+ # @return [Google::Apis::ObservabilityV1::Dataset]
695
+ #
696
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
697
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
698
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
699
+ def get_project_location_bucket_dataset(name, fields: nil, quota_user: nil, options: nil, &block)
700
+ command = make_simple_command(:get, 'v1/{+name}', options)
701
+ command.response_representation = Google::Apis::ObservabilityV1::Dataset::Representation
702
+ command.response_class = Google::Apis::ObservabilityV1::Dataset
703
+ command.params['name'] = name unless name.nil?
704
+ command.query['fields'] = fields unless fields.nil?
705
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
706
+ execute_or_queue_command(command, &block)
707
+ end
708
+
709
+ # List datasets of a bucket.
710
+ # @param [String] parent
711
+ # Required. The parent bucket that owns this collection of datasets. The format
712
+ # is: projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
713
+ # @param [Fixnum] page_size
714
+ # Optional. The maximum number of datasets to return. If unspecified, then at
715
+ # most 100 datasets are returned. The maximum value is 1000; values above 1000
716
+ # are coerced to 1000.
717
+ # @param [String] page_token
718
+ # Optional. A page token, received from a previous `ListDatasets` call. Provide
719
+ # this to retrieve the subsequent page.
720
+ # @param [Boolean] show_deleted
721
+ # Optional. If true, then the response will include deleted datasets.
722
+ # @param [String] fields
723
+ # Selector specifying which fields to include in a partial response.
724
+ # @param [String] quota_user
725
+ # Available to use for quota purposes for server-side applications. Can be any
726
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
727
+ # @param [Google::Apis::RequestOptions] options
728
+ # Request-specific options
729
+ #
730
+ # @yield [result, err] Result & error if block supplied
731
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListDatasetsResponse] parsed result object
732
+ # @yieldparam err [StandardError] error object if request failed
733
+ #
734
+ # @return [Google::Apis::ObservabilityV1::ListDatasetsResponse]
735
+ #
736
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
737
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
738
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
739
+ def list_project_location_bucket_datasets(parent, page_size: nil, page_token: nil, show_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
740
+ command = make_simple_command(:get, 'v1/{+parent}/datasets', options)
741
+ command.response_representation = Google::Apis::ObservabilityV1::ListDatasetsResponse::Representation
742
+ command.response_class = Google::Apis::ObservabilityV1::ListDatasetsResponse
743
+ command.params['parent'] = parent unless parent.nil?
744
+ command.query['pageSize'] = page_size unless page_size.nil?
745
+ command.query['pageToken'] = page_token unless page_token.nil?
746
+ command.query['showDeleted'] = show_deleted unless show_deleted.nil?
747
+ command.query['fields'] = fields unless fields.nil?
748
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
749
+ execute_or_queue_command(command, &block)
750
+ end
751
+
752
+ # Create a new link.
753
+ # @param [String] parent
754
+ # Required. Name of the containing dataset for this link. The format is:
755
+ # projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[
756
+ # DATASET_ID]
757
+ # @param [Google::Apis::ObservabilityV1::Link] link_object
758
+ # @param [String] link_id
759
+ # Required. Id of the link to create.
760
+ # @param [String] fields
761
+ # Selector specifying which fields to include in a partial response.
762
+ # @param [String] quota_user
763
+ # Available to use for quota purposes for server-side applications. Can be any
764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
765
+ # @param [Google::Apis::RequestOptions] options
766
+ # Request-specific options
767
+ #
768
+ # @yield [result, err] Result & error if block supplied
769
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
770
+ # @yieldparam err [StandardError] error object if request failed
771
+ #
772
+ # @return [Google::Apis::ObservabilityV1::Operation]
773
+ #
774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
777
+ def create_project_location_bucket_dataset_link(parent, link_object = nil, link_id: nil, fields: nil, quota_user: nil, options: nil, &block)
778
+ command = make_simple_command(:post, 'v1/{+parent}/links', options)
779
+ command.request_representation = Google::Apis::ObservabilityV1::Link::Representation
780
+ command.request_object = link_object
781
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
782
+ command.response_class = Google::Apis::ObservabilityV1::Operation
783
+ command.params['parent'] = parent unless parent.nil?
784
+ command.query['linkId'] = link_id unless link_id.nil?
785
+ command.query['fields'] = fields unless fields.nil?
786
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
787
+ execute_or_queue_command(command, &block)
788
+ end
789
+
790
+ # Delete a link.
791
+ # @param [String] name
792
+ # Required. Name of the link to delete. The format is: projects/[PROJECT_ID]/
793
+ # locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
794
+ # @param [String] fields
795
+ # Selector specifying which fields to include in a partial response.
796
+ # @param [String] quota_user
797
+ # Available to use for quota purposes for server-side applications. Can be any
798
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
799
+ # @param [Google::Apis::RequestOptions] options
800
+ # Request-specific options
801
+ #
802
+ # @yield [result, err] Result & error if block supplied
803
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
804
+ # @yieldparam err [StandardError] error object if request failed
805
+ #
806
+ # @return [Google::Apis::ObservabilityV1::Operation]
807
+ #
808
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
809
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
810
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
811
+ def delete_project_location_bucket_dataset_link(name, fields: nil, quota_user: nil, options: nil, &block)
812
+ command = make_simple_command(:delete, 'v1/{+name}', options)
813
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
814
+ command.response_class = Google::Apis::ObservabilityV1::Operation
815
+ command.params['name'] = name unless name.nil?
816
+ command.query['fields'] = fields unless fields.nil?
817
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
818
+ execute_or_queue_command(command, &block)
819
+ end
820
+
821
+ # Get a link.
85
822
  # @param [String] name
86
- # The resource that owns the locations collection, if applicable.
87
- # @param [Array<String>, String] extra_location_types
88
- # Optional. A list of extra location types that should be used as conditions for
89
- # controlling the visibility of the locations.
90
- # @param [String] filter
91
- # A filter to narrow down results to a preferred subset. The filtering language
92
- # accepts strings like `"displayName=tokyo"`, and is documented in more detail
93
- # in [AIP-160](https://google.aip.dev/160).
823
+ # Required. Name of the link to retrieve. The format is: projects/[PROJECT_ID]/
824
+ # locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
825
+ # @param [String] fields
826
+ # Selector specifying which fields to include in a partial response.
827
+ # @param [String] quota_user
828
+ # Available to use for quota purposes for server-side applications. Can be any
829
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
830
+ # @param [Google::Apis::RequestOptions] options
831
+ # Request-specific options
832
+ #
833
+ # @yield [result, err] Result & error if block supplied
834
+ # @yieldparam result [Google::Apis::ObservabilityV1::Link] parsed result object
835
+ # @yieldparam err [StandardError] error object if request failed
836
+ #
837
+ # @return [Google::Apis::ObservabilityV1::Link]
838
+ #
839
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
840
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
841
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
842
+ def get_project_location_bucket_dataset_link(name, fields: nil, quota_user: nil, options: nil, &block)
843
+ command = make_simple_command(:get, 'v1/{+name}', options)
844
+ command.response_representation = Google::Apis::ObservabilityV1::Link::Representation
845
+ command.response_class = Google::Apis::ObservabilityV1::Link
846
+ command.params['name'] = name unless name.nil?
847
+ command.query['fields'] = fields unless fields.nil?
848
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
849
+ execute_or_queue_command(command, &block)
850
+ end
851
+
852
+ # List links of a dataset.
853
+ # @param [String] parent
854
+ # Required. The parent dataset that owns this collection of links. The format is:
855
+ # projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[
856
+ # DATASET_ID]
94
857
  # @param [Fixnum] page_size
95
- # The maximum number of results to return. If not set, the service selects a
96
- # default.
858
+ # Optional. The maximum number of links to return. If unspecified, then at most
859
+ # 100 links are returned. The maximum value is 1000; values above 1000 are
860
+ # coerced to 1000.
97
861
  # @param [String] page_token
98
- # A page token received from the `next_page_token` field in the response. Send
99
- # that page token to receive the subsequent page.
862
+ # Optional. A page token, received from a previous `ListLinks` call. Provide
863
+ # this to retrieve the subsequent page.
100
864
  # @param [String] fields
101
865
  # Selector specifying which fields to include in a partial response.
102
866
  # @param [String] quota_user
@@ -106,21 +870,127 @@ module Google
106
870
  # Request-specific options
107
871
  #
108
872
  # @yield [result, err] Result & error if block supplied
109
- # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
873
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLinksResponse] parsed result object
110
874
  # @yieldparam err [StandardError] error object if request failed
111
875
  #
112
- # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
876
+ # @return [Google::Apis::ObservabilityV1::ListLinksResponse]
113
877
  #
114
878
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
115
879
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
116
880
  # @raise [Google::Apis::AuthorizationError] Authorization is required
117
- def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
118
- command = make_simple_command(:get, 'v1/{+name}/locations', options)
119
- command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
120
- command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
881
+ def list_project_location_bucket_dataset_links(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
882
+ command = make_simple_command(:get, 'v1/{+parent}/links', options)
883
+ command.response_representation = Google::Apis::ObservabilityV1::ListLinksResponse::Representation
884
+ command.response_class = Google::Apis::ObservabilityV1::ListLinksResponse
885
+ command.params['parent'] = parent unless parent.nil?
886
+ command.query['pageSize'] = page_size unless page_size.nil?
887
+ command.query['pageToken'] = page_token unless page_token.nil?
888
+ command.query['fields'] = fields unless fields.nil?
889
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
890
+ execute_or_queue_command(command, &block)
891
+ end
892
+
893
+ # Update a link.
894
+ # @param [String] name
895
+ # Identifier. Name of the link. The format is: projects/[PROJECT_ID]/locations/[
896
+ # LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/links/[LINK_ID]
897
+ # @param [Google::Apis::ObservabilityV1::Link] link_object
898
+ # @param [String] update_mask
899
+ # Optional. The list of fields to update.
900
+ # @param [String] fields
901
+ # Selector specifying which fields to include in a partial response.
902
+ # @param [String] quota_user
903
+ # Available to use for quota purposes for server-side applications. Can be any
904
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
905
+ # @param [Google::Apis::RequestOptions] options
906
+ # Request-specific options
907
+ #
908
+ # @yield [result, err] Result & error if block supplied
909
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
910
+ # @yieldparam err [StandardError] error object if request failed
911
+ #
912
+ # @return [Google::Apis::ObservabilityV1::Operation]
913
+ #
914
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
915
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
916
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
917
+ def patch_project_location_bucket_dataset_link(name, link_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
918
+ command = make_simple_command(:patch, 'v1/{+name}', options)
919
+ command.request_representation = Google::Apis::ObservabilityV1::Link::Representation
920
+ command.request_object = link_object
921
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
922
+ command.response_class = Google::Apis::ObservabilityV1::Operation
121
923
  command.params['name'] = name unless name.nil?
122
- command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
123
- command.query['filter'] = filter unless filter.nil?
924
+ command.query['updateMask'] = update_mask unless update_mask.nil?
925
+ command.query['fields'] = fields unless fields.nil?
926
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
927
+ execute_or_queue_command(command, &block)
928
+ end
929
+
930
+ # Get a view.
931
+ # @param [String] name
932
+ # Required. Name of the view to retrieve. The format is: projects/[PROJECT_ID]/
933
+ # locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/views/[VIEW_ID]
934
+ # @param [String] fields
935
+ # Selector specifying which fields to include in a partial response.
936
+ # @param [String] quota_user
937
+ # Available to use for quota purposes for server-side applications. Can be any
938
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
939
+ # @param [Google::Apis::RequestOptions] options
940
+ # Request-specific options
941
+ #
942
+ # @yield [result, err] Result & error if block supplied
943
+ # @yieldparam result [Google::Apis::ObservabilityV1::View] parsed result object
944
+ # @yieldparam err [StandardError] error object if request failed
945
+ #
946
+ # @return [Google::Apis::ObservabilityV1::View]
947
+ #
948
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
949
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
950
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
951
+ def get_project_location_bucket_dataset_view(name, fields: nil, quota_user: nil, options: nil, &block)
952
+ command = make_simple_command(:get, 'v1/{+name}', options)
953
+ command.response_representation = Google::Apis::ObservabilityV1::View::Representation
954
+ command.response_class = Google::Apis::ObservabilityV1::View
955
+ command.params['name'] = name unless name.nil?
956
+ command.query['fields'] = fields unless fields.nil?
957
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
958
+ execute_or_queue_command(command, &block)
959
+ end
960
+
961
+ # List views of a dataset.
962
+ # @param [String] parent
963
+ # Required. Dataset whose views are to be listed. The format is: projects/[
964
+ # PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
965
+ # @param [Fixnum] page_size
966
+ # Optional. The maximum number of views to return. If unspecified, then at most
967
+ # 100 views are returned. The maximum value is 1000; values above 1000 are
968
+ # coerced to 1000.
969
+ # @param [String] page_token
970
+ # Optional. A page token, received from a previous `ListViews` call. Provide
971
+ # this to retrieve the subsequent page.
972
+ # @param [String] fields
973
+ # Selector specifying which fields to include in a partial response.
974
+ # @param [String] quota_user
975
+ # Available to use for quota purposes for server-side applications. Can be any
976
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
977
+ # @param [Google::Apis::RequestOptions] options
978
+ # Request-specific options
979
+ #
980
+ # @yield [result, err] Result & error if block supplied
981
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListViewsResponse] parsed result object
982
+ # @yieldparam err [StandardError] error object if request failed
983
+ #
984
+ # @return [Google::Apis::ObservabilityV1::ListViewsResponse]
985
+ #
986
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
987
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
988
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
989
+ def list_project_location_bucket_dataset_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
990
+ command = make_simple_command(:get, 'v1/{+parent}/views', options)
991
+ command.response_representation = Google::Apis::ObservabilityV1::ListViewsResponse::Representation
992
+ command.response_class = Google::Apis::ObservabilityV1::ListViewsResponse
993
+ command.params['parent'] = parent unless parent.nil?
124
994
  command.query['pageSize'] = page_size unless page_size.nil?
125
995
  command.query['pageToken'] = page_token unless page_token.nil?
126
996
  command.query['fields'] = fields unless fields.nil?
@@ -242,6 +1112,14 @@ module Google
242
1112
  # The standard list page size.
243
1113
  # @param [String] page_token
244
1114
  # The standard list page token.
1115
+ # @param [Boolean] return_partial_success
1116
+ # When set to `true`, operations that are reachable are returned as normal, and
1117
+ # those that are unreachable are returned in the ListOperationsResponse.
1118
+ # unreachable field. This can only be `true` when reading across collections.
1119
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
1120
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
1121
+ # if set unless explicitly documented otherwise in service or product specific
1122
+ # documentation.
245
1123
  # @param [String] fields
246
1124
  # Selector specifying which fields to include in a partial response.
247
1125
  # @param [String] quota_user
@@ -259,7 +1137,7 @@ module Google
259
1137
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
260
1138
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
261
1139
  # @raise [Google::Apis::AuthorizationError] Authorization is required
262
- def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1140
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
263
1141
  command = make_simple_command(:get, 'v1/{+name}/operations', options)
264
1142
  command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
265
1143
  command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
@@ -267,6 +1145,7 @@ module Google
267
1145
  command.query['filter'] = filter unless filter.nil?
268
1146
  command.query['pageSize'] = page_size unless page_size.nil?
269
1147
  command.query['pageToken'] = page_token unless page_token.nil?
1148
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
270
1149
  command.query['fields'] = fields unless fields.nil?
271
1150
  command.query['quotaUser'] = quota_user unless quota_user.nil?
272
1151
  execute_or_queue_command(command, &block)
@@ -313,9 +1192,9 @@ module Google
313
1192
  # @param [String] update_mask
314
1193
  # Optional. Field mask is used to specify the fields to be overwritten in the
315
1194
  # Scope resource by the update. The fields specified in the update_mask are
316
- # relative to the resource, not the full request. A field will be overwritten if
317
- # it is in the mask. If the user does not provide a mask then all fields present
318
- # in the request will be overwritten.
1195
+ # relative to the resource, not the full request. A field is overwritten when it
1196
+ # is in the mask. If the user does not provide a mask, then all fields present
1197
+ # in the request are overwritten.
319
1198
  # @param [String] fields
320
1199
  # Selector specifying which fields to include in a partial response.
321
1200
  # @param [String] quota_user
@@ -345,6 +1224,188 @@ module Google
345
1224
  command.query['quotaUser'] = quota_user unless quota_user.nil?
346
1225
  execute_or_queue_command(command, &block)
347
1226
  end
1227
+
1228
+ # Create a new TraceScope.
1229
+ # @param [String] parent
1230
+ # Required. The full resource name of the location where the trace scope should
1231
+ # be created projects/[PROJECT_ID]/locations/[LOCATION_ID] For example: projects/
1232
+ # my-project/locations/global
1233
+ # @param [Google::Apis::ObservabilityV1::TraceScope] trace_scope_object
1234
+ # @param [String] trace_scope_id
1235
+ # Required. A client-assigned identifier for the trace scope.
1236
+ # @param [String] fields
1237
+ # Selector specifying which fields to include in a partial response.
1238
+ # @param [String] quota_user
1239
+ # Available to use for quota purposes for server-side applications. Can be any
1240
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1241
+ # @param [Google::Apis::RequestOptions] options
1242
+ # Request-specific options
1243
+ #
1244
+ # @yield [result, err] Result & error if block supplied
1245
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
1246
+ # @yieldparam err [StandardError] error object if request failed
1247
+ #
1248
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
1249
+ #
1250
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1251
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1252
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1253
+ def create_project_location_trace_scope(parent, trace_scope_object = nil, trace_scope_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1254
+ command = make_simple_command(:post, 'v1/{+parent}/traceScopes', options)
1255
+ command.request_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
1256
+ command.request_object = trace_scope_object
1257
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
1258
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
1259
+ command.params['parent'] = parent unless parent.nil?
1260
+ command.query['traceScopeId'] = trace_scope_id unless trace_scope_id.nil?
1261
+ command.query['fields'] = fields unless fields.nil?
1262
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1263
+ execute_or_queue_command(command, &block)
1264
+ end
1265
+
1266
+ # Delete a TraceScope.
1267
+ # @param [String] name
1268
+ # Required. The full resource name of the trace scope to delete: projects/[
1269
+ # PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID] For example:
1270
+ # projects/my-project/locations/global/traceScopes/my-trace-scope
1271
+ # @param [String] fields
1272
+ # Selector specifying which fields to include in a partial response.
1273
+ # @param [String] quota_user
1274
+ # Available to use for quota purposes for server-side applications. Can be any
1275
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1276
+ # @param [Google::Apis::RequestOptions] options
1277
+ # Request-specific options
1278
+ #
1279
+ # @yield [result, err] Result & error if block supplied
1280
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
1281
+ # @yieldparam err [StandardError] error object if request failed
1282
+ #
1283
+ # @return [Google::Apis::ObservabilityV1::Empty]
1284
+ #
1285
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1286
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1287
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1288
+ def delete_project_location_trace_scope(name, fields: nil, quota_user: nil, options: nil, &block)
1289
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1290
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
1291
+ command.response_class = Google::Apis::ObservabilityV1::Empty
1292
+ command.params['name'] = name unless name.nil?
1293
+ command.query['fields'] = fields unless fields.nil?
1294
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1295
+ execute_or_queue_command(command, &block)
1296
+ end
1297
+
1298
+ # Get TraceScope resource.
1299
+ # @param [String] name
1300
+ # Required. The resource name of the trace scope: projects/[PROJECT_ID]/
1301
+ # locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID] For example: projects/my-
1302
+ # project/locations/global/traceScopes/my-trace-scope
1303
+ # @param [String] fields
1304
+ # Selector specifying which fields to include in a partial response.
1305
+ # @param [String] quota_user
1306
+ # Available to use for quota purposes for server-side applications. Can be any
1307
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1308
+ # @param [Google::Apis::RequestOptions] options
1309
+ # Request-specific options
1310
+ #
1311
+ # @yield [result, err] Result & error if block supplied
1312
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
1313
+ # @yieldparam err [StandardError] error object if request failed
1314
+ #
1315
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
1316
+ #
1317
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1318
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1319
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1320
+ def get_project_location_trace_scope(name, fields: nil, quota_user: nil, options: nil, &block)
1321
+ command = make_simple_command(:get, 'v1/{+name}', options)
1322
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
1323
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
1324
+ command.params['name'] = name unless name.nil?
1325
+ command.query['fields'] = fields unless fields.nil?
1326
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1327
+ execute_or_queue_command(command, &block)
1328
+ end
1329
+
1330
+ # List TraceScopes of a project in a particular location.
1331
+ # @param [String] parent
1332
+ # Required. The full resource name of the location to look for trace scopes:
1333
+ # projects/[PROJECT_ID]/locations/[LOCATION_ID] For example: projects/my-project/
1334
+ # locations/global
1335
+ # @param [Fixnum] page_size
1336
+ # Optional. The maximum number of results to return from this request. Non-
1337
+ # positive values are ignored. The presence of `next_page_token` in the response
1338
+ # indicates that more results might be available.
1339
+ # @param [String] page_token
1340
+ # Optional. If present, then retrieve the next batch of results from the
1341
+ # preceding call to this method. `page_token` must be the value of `
1342
+ # next_page_token` from the previous response. The values of other method
1343
+ # parameters should be identical to those in the previous call.
1344
+ # @param [String] fields
1345
+ # Selector specifying which fields to include in a partial response.
1346
+ # @param [String] quota_user
1347
+ # Available to use for quota purposes for server-side applications. Can be any
1348
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1349
+ # @param [Google::Apis::RequestOptions] options
1350
+ # Request-specific options
1351
+ #
1352
+ # @yield [result, err] Result & error if block supplied
1353
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListTraceScopesResponse] parsed result object
1354
+ # @yieldparam err [StandardError] error object if request failed
1355
+ #
1356
+ # @return [Google::Apis::ObservabilityV1::ListTraceScopesResponse]
1357
+ #
1358
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1359
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1360
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1361
+ def list_project_location_trace_scopes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1362
+ command = make_simple_command(:get, 'v1/{+parent}/traceScopes', options)
1363
+ command.response_representation = Google::Apis::ObservabilityV1::ListTraceScopesResponse::Representation
1364
+ command.response_class = Google::Apis::ObservabilityV1::ListTraceScopesResponse
1365
+ command.params['parent'] = parent unless parent.nil?
1366
+ command.query['pageSize'] = page_size unless page_size.nil?
1367
+ command.query['pageToken'] = page_token unless page_token.nil?
1368
+ command.query['fields'] = fields unless fields.nil?
1369
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1370
+ execute_or_queue_command(command, &block)
1371
+ end
1372
+
1373
+ # Update a TraceScope.
1374
+ # @param [String] name
1375
+ # Identifier. The resource name of the trace scope. For example: projects/my-
1376
+ # project/locations/global/traceScopes/my-trace-scope
1377
+ # @param [Google::Apis::ObservabilityV1::TraceScope] trace_scope_object
1378
+ # @param [String] update_mask
1379
+ # Optional. The list of fields to update.
1380
+ # @param [String] fields
1381
+ # Selector specifying which fields to include in a partial response.
1382
+ # @param [String] quota_user
1383
+ # Available to use for quota purposes for server-side applications. Can be any
1384
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1385
+ # @param [Google::Apis::RequestOptions] options
1386
+ # Request-specific options
1387
+ #
1388
+ # @yield [result, err] Result & error if block supplied
1389
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
1390
+ # @yieldparam err [StandardError] error object if request failed
1391
+ #
1392
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
1393
+ #
1394
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1395
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1396
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1397
+ def patch_project_location_trace_scope(name, trace_scope_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1398
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1399
+ command.request_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
1400
+ command.request_object = trace_scope_object
1401
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
1402
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
1403
+ command.params['name'] = name unless name.nil?
1404
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1405
+ command.query['fields'] = fields unless fields.nil?
1406
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1407
+ execute_or_queue_command(command, &block)
1408
+ end
348
1409
 
349
1410
  protected
350
1411