google-apis-datastream_v1 0.1.0 → 0.2.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.
@@ -49,6 +49,46 @@ module Google
49
49
  @batch_path = 'batch'
50
50
  end
51
51
 
52
+ # The FetchStaticIps API call exposes the static ips used by Datastream.
53
+ # Typically, a request returns children data objects under a parent data object
54
+ # that's optionally supplied in the request.
55
+ # @param [String] name
56
+ # Required. The name resource of the Response type. Must be in the format `
57
+ # projects/*/locations/*`.
58
+ # @param [Fixnum] page_size
59
+ # Maximum number of Ips to return, will likely not be specified.
60
+ # @param [String] page_token
61
+ # A page token, received from a previous `ListStaticIps` call. will likely not
62
+ # be specified.
63
+ # @param [String] fields
64
+ # Selector specifying which fields to include in a partial response.
65
+ # @param [String] quota_user
66
+ # Available to use for quota purposes for server-side applications. Can be any
67
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
68
+ # @param [Google::Apis::RequestOptions] options
69
+ # Request-specific options
70
+ #
71
+ # @yield [result, err] Result & error if block supplied
72
+ # @yieldparam result [Google::Apis::DatastreamV1::FetchStaticIpsResponse] parsed result object
73
+ # @yieldparam err [StandardError] error object if request failed
74
+ #
75
+ # @return [Google::Apis::DatastreamV1::FetchStaticIpsResponse]
76
+ #
77
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
78
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
79
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
80
+ def fetch_project_location_static_ips(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
81
+ command = make_simple_command(:get, 'v1/{+name}:fetchStaticIps', options)
82
+ command.response_representation = Google::Apis::DatastreamV1::FetchStaticIpsResponse::Representation
83
+ command.response_class = Google::Apis::DatastreamV1::FetchStaticIpsResponse
84
+ command.params['name'] = name unless name.nil?
85
+ command.query['pageSize'] = page_size unless page_size.nil?
86
+ command.query['pageToken'] = page_token unless page_token.nil?
87
+ command.query['fields'] = fields unless fields.nil?
88
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
89
+ execute_or_queue_command(command, &block)
90
+ end
91
+
52
92
  # Gets information about a location.
53
93
  # @param [String] name
54
94
  # Resource name for the location.
@@ -122,6 +162,268 @@ module Google
122
162
  execute_or_queue_command(command, &block)
123
163
  end
124
164
 
165
+ # Use this method to create a connection profile in a project and location.
166
+ # @param [String] parent
167
+ # Required. The parent that owns the collection of ConnectionProfiles.
168
+ # @param [Google::Apis::DatastreamV1::ConnectionProfile] connection_profile_object
169
+ # @param [String] connection_profile_id
170
+ # Required. The connection profile identifier.
171
+ # @param [Boolean] force
172
+ # Optional. Create the connection profile without validating it.
173
+ # @param [String] request_id
174
+ # Optional. A request ID to identify requests. Specify a unique request ID so
175
+ # that if you must retry your request, the server will know to ignore the
176
+ # request if it has already been completed. The server will guarantee that for
177
+ # at least 60 minutes since the first request. For example, consider a situation
178
+ # where you make an initial request and the request times out. If you make the
179
+ # request again with the same request ID, the server can check if original
180
+ # operation with the same request ID was received, and if so, will ignore the
181
+ # second request. This prevents clients from accidentally creating duplicate
182
+ # commitments. The request ID must be a valid UUID with the exception that zero
183
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
184
+ # @param [String] fields
185
+ # Selector specifying which fields to include in a partial response.
186
+ # @param [String] quota_user
187
+ # Available to use for quota purposes for server-side applications. Can be any
188
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
189
+ # @param [Google::Apis::RequestOptions] options
190
+ # Request-specific options
191
+ #
192
+ # @yield [result, err] Result & error if block supplied
193
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
194
+ # @yieldparam err [StandardError] error object if request failed
195
+ #
196
+ # @return [Google::Apis::DatastreamV1::Operation]
197
+ #
198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
201
+ def create_project_location_connection_profile(parent, connection_profile_object = nil, connection_profile_id: nil, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
202
+ command = make_simple_command(:post, 'v1/{+parent}/connectionProfiles', options)
203
+ command.request_representation = Google::Apis::DatastreamV1::ConnectionProfile::Representation
204
+ command.request_object = connection_profile_object
205
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
206
+ command.response_class = Google::Apis::DatastreamV1::Operation
207
+ command.params['parent'] = parent unless parent.nil?
208
+ command.query['connectionProfileId'] = connection_profile_id unless connection_profile_id.nil?
209
+ command.query['force'] = force unless force.nil?
210
+ command.query['requestId'] = request_id unless request_id.nil?
211
+ command.query['fields'] = fields unless fields.nil?
212
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
213
+ execute_or_queue_command(command, &block)
214
+ end
215
+
216
+ # Use this method to delete a connection profile..
217
+ # @param [String] name
218
+ # Required. The name of the connection profile resource to delete.
219
+ # @param [String] request_id
220
+ # Optional. A request ID to identify requests. Specify a unique request ID so
221
+ # that if you must retry your request, the server will know to ignore the
222
+ # request if it has already been completed. The server will guarantee that for
223
+ # at least 60 minutes after the first request. For example, consider a situation
224
+ # where you make an initial request and the request times out. If you make the
225
+ # request again with the same request ID, the server can check if original
226
+ # operation with the same request ID was received, and if so, will ignore the
227
+ # second request. This prevents clients from accidentally creating duplicate
228
+ # commitments. The request ID must be a valid UUID with the exception that zero
229
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
230
+ # @param [String] fields
231
+ # Selector specifying which fields to include in a partial response.
232
+ # @param [String] quota_user
233
+ # Available to use for quota purposes for server-side applications. Can be any
234
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
235
+ # @param [Google::Apis::RequestOptions] options
236
+ # Request-specific options
237
+ #
238
+ # @yield [result, err] Result & error if block supplied
239
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
240
+ # @yieldparam err [StandardError] error object if request failed
241
+ #
242
+ # @return [Google::Apis::DatastreamV1::Operation]
243
+ #
244
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
245
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
246
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
247
+ def delete_project_location_connection_profile(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
248
+ command = make_simple_command(:delete, 'v1/{+name}', options)
249
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
250
+ command.response_class = Google::Apis::DatastreamV1::Operation
251
+ command.params['name'] = name unless name.nil?
252
+ command.query['requestId'] = request_id unless request_id.nil?
253
+ command.query['fields'] = fields unless fields.nil?
254
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
255
+ execute_or_queue_command(command, &block)
256
+ end
257
+
258
+ # Use this method to discover a connection profile. The discover API call
259
+ # exposes the data objects and metadata belonging to the profile. Typically, a
260
+ # request returns children data objects under a parent data object that's
261
+ # optionally supplied in the request.
262
+ # @param [String] parent
263
+ # Required. The parent resource of the connection profile type. Must be in the
264
+ # format `projects/*/locations/*`.
265
+ # @param [Google::Apis::DatastreamV1::DiscoverConnectionProfileRequest] discover_connection_profile_request_object
266
+ # @param [String] fields
267
+ # Selector specifying which fields to include in a partial response.
268
+ # @param [String] quota_user
269
+ # Available to use for quota purposes for server-side applications. Can be any
270
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
271
+ # @param [Google::Apis::RequestOptions] options
272
+ # Request-specific options
273
+ #
274
+ # @yield [result, err] Result & error if block supplied
275
+ # @yieldparam result [Google::Apis::DatastreamV1::DiscoverConnectionProfileResponse] parsed result object
276
+ # @yieldparam err [StandardError] error object if request failed
277
+ #
278
+ # @return [Google::Apis::DatastreamV1::DiscoverConnectionProfileResponse]
279
+ #
280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
283
+ def discover_connection_profile(parent, discover_connection_profile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
284
+ command = make_simple_command(:post, 'v1/{+parent}/connectionProfiles:discover', options)
285
+ command.request_representation = Google::Apis::DatastreamV1::DiscoverConnectionProfileRequest::Representation
286
+ command.request_object = discover_connection_profile_request_object
287
+ command.response_representation = Google::Apis::DatastreamV1::DiscoverConnectionProfileResponse::Representation
288
+ command.response_class = Google::Apis::DatastreamV1::DiscoverConnectionProfileResponse
289
+ command.params['parent'] = parent unless parent.nil?
290
+ command.query['fields'] = fields unless fields.nil?
291
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
292
+ execute_or_queue_command(command, &block)
293
+ end
294
+
295
+ # Use this method to get details about a connection profile.
296
+ # @param [String] name
297
+ # Required. The name of the connection profile resource to get.
298
+ # @param [String] fields
299
+ # Selector specifying which fields to include in a partial response.
300
+ # @param [String] quota_user
301
+ # Available to use for quota purposes for server-side applications. Can be any
302
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
303
+ # @param [Google::Apis::RequestOptions] options
304
+ # Request-specific options
305
+ #
306
+ # @yield [result, err] Result & error if block supplied
307
+ # @yieldparam result [Google::Apis::DatastreamV1::ConnectionProfile] parsed result object
308
+ # @yieldparam err [StandardError] error object if request failed
309
+ #
310
+ # @return [Google::Apis::DatastreamV1::ConnectionProfile]
311
+ #
312
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
313
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
314
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
315
+ def get_project_location_connection_profile(name, fields: nil, quota_user: nil, options: nil, &block)
316
+ command = make_simple_command(:get, 'v1/{+name}', options)
317
+ command.response_representation = Google::Apis::DatastreamV1::ConnectionProfile::Representation
318
+ command.response_class = Google::Apis::DatastreamV1::ConnectionProfile
319
+ command.params['name'] = name unless name.nil?
320
+ command.query['fields'] = fields unless fields.nil?
321
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
322
+ execute_or_queue_command(command, &block)
323
+ end
324
+
325
+ # Use this method to list connection profiles created in a project and location.
326
+ # @param [String] parent
327
+ # Required. The parent that owns the collection of connection profiles.
328
+ # @param [String] filter
329
+ # Filter request.
330
+ # @param [String] order_by
331
+ # Order by fields for the result.
332
+ # @param [Fixnum] page_size
333
+ # Maximum number of connection profiles to return. If unspecified, at most 50
334
+ # connection profiles will be returned. The maximum value is 1000; values above
335
+ # 1000 will be coerced to 1000.
336
+ # @param [String] page_token
337
+ # Page token received from a previous `ListConnectionProfiles` call. Provide
338
+ # this to retrieve the subsequent page. When paginating, all other parameters
339
+ # provided to `ListConnectionProfiles` must match the call that provided the
340
+ # page token.
341
+ # @param [String] fields
342
+ # Selector specifying which fields to include in a partial response.
343
+ # @param [String] quota_user
344
+ # Available to use for quota purposes for server-side applications. Can be any
345
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
346
+ # @param [Google::Apis::RequestOptions] options
347
+ # Request-specific options
348
+ #
349
+ # @yield [result, err] Result & error if block supplied
350
+ # @yieldparam result [Google::Apis::DatastreamV1::ListConnectionProfilesResponse] parsed result object
351
+ # @yieldparam err [StandardError] error object if request failed
352
+ #
353
+ # @return [Google::Apis::DatastreamV1::ListConnectionProfilesResponse]
354
+ #
355
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
356
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
357
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
358
+ def list_project_location_connection_profiles(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
359
+ command = make_simple_command(:get, 'v1/{+parent}/connectionProfiles', options)
360
+ command.response_representation = Google::Apis::DatastreamV1::ListConnectionProfilesResponse::Representation
361
+ command.response_class = Google::Apis::DatastreamV1::ListConnectionProfilesResponse
362
+ command.params['parent'] = parent unless parent.nil?
363
+ command.query['filter'] = filter unless filter.nil?
364
+ command.query['orderBy'] = order_by unless order_by.nil?
365
+ command.query['pageSize'] = page_size unless page_size.nil?
366
+ command.query['pageToken'] = page_token unless page_token.nil?
367
+ command.query['fields'] = fields unless fields.nil?
368
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
369
+ execute_or_queue_command(command, &block)
370
+ end
371
+
372
+ # Use this method to update the parameters of a connection profile.
373
+ # @param [String] name
374
+ # Output only. The resource's name.
375
+ # @param [Google::Apis::DatastreamV1::ConnectionProfile] connection_profile_object
376
+ # @param [Boolean] force
377
+ # Optional. Execute the update without validating it.
378
+ # @param [String] request_id
379
+ # Optional. A request ID to identify requests. Specify a unique request ID so
380
+ # that if you must retry your request, the server will know to ignore the
381
+ # request if it has already been completed. The server will guarantee that for
382
+ # at least 60 minutes since the first request. For example, consider a situation
383
+ # where you make an initial request and the request times out. If you make the
384
+ # request again with the same request ID, the server can check if original
385
+ # operation with the same request ID was received, and if so, will ignore the
386
+ # second request. This prevents clients from accidentally creating duplicate
387
+ # commitments. The request ID must be a valid UUID with the exception that zero
388
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
389
+ # @param [String] update_mask
390
+ # Optional. Field mask is used to specify the fields to be overwritten in the
391
+ # ConnectionProfile resource by the update. The fields specified in the
392
+ # update_mask are relative to the resource, not the full request. A field will
393
+ # be overwritten if it is in the mask. If the user does not provide a mask then
394
+ # all fields will be overwritten.
395
+ # @param [String] fields
396
+ # Selector specifying which fields to include in a partial response.
397
+ # @param [String] quota_user
398
+ # Available to use for quota purposes for server-side applications. Can be any
399
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
400
+ # @param [Google::Apis::RequestOptions] options
401
+ # Request-specific options
402
+ #
403
+ # @yield [result, err] Result & error if block supplied
404
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
405
+ # @yieldparam err [StandardError] error object if request failed
406
+ #
407
+ # @return [Google::Apis::DatastreamV1::Operation]
408
+ #
409
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
410
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
411
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
412
+ def patch_project_location_connection_profile(name, connection_profile_object = nil, force: nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
413
+ command = make_simple_command(:patch, 'v1/{+name}', options)
414
+ command.request_representation = Google::Apis::DatastreamV1::ConnectionProfile::Representation
415
+ command.request_object = connection_profile_object
416
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
417
+ command.response_class = Google::Apis::DatastreamV1::Operation
418
+ command.params['name'] = name unless name.nil?
419
+ command.query['force'] = force unless force.nil?
420
+ command.query['requestId'] = request_id unless request_id.nil?
421
+ command.query['updateMask'] = update_mask unless update_mask.nil?
422
+ command.query['fields'] = fields unless fields.nil?
423
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
424
+ execute_or_queue_command(command, &block)
425
+ end
426
+
125
427
  # Starts asynchronous cancellation on a long-running operation. The server makes
126
428
  # a best effort to cancel the operation, but success is not guaranteed. If the
127
429
  # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
@@ -271,6 +573,748 @@ module Google
271
573
  command.query['quotaUser'] = quota_user unless quota_user.nil?
272
574
  execute_or_queue_command(command, &block)
273
575
  end
576
+
577
+ # Use this method to create a private connectivity configuration.
578
+ # @param [String] parent
579
+ # Required. The parent that owns the collection of PrivateConnections.
580
+ # @param [Google::Apis::DatastreamV1::PrivateConnection] private_connection_object
581
+ # @param [String] private_connection_id
582
+ # Required. The private connectivity identifier.
583
+ # @param [String] request_id
584
+ # Optional. A request ID to identify requests. Specify a unique request ID so
585
+ # that if you must retry your request, the server will know to ignore the
586
+ # request if it has already been completed. The server will guarantee that for
587
+ # at least 60 minutes since the first request. For example, consider a situation
588
+ # where you make an initial request and the request times out. If you make the
589
+ # request again with the same request ID, the server can check if original
590
+ # operation with the same request ID was received, and if so, will ignore the
591
+ # second request. This prevents clients from accidentally creating duplicate
592
+ # commitments. The request ID must be a valid UUID with the exception that zero
593
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
594
+ # @param [String] fields
595
+ # Selector specifying which fields to include in a partial response.
596
+ # @param [String] quota_user
597
+ # Available to use for quota purposes for server-side applications. Can be any
598
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
599
+ # @param [Google::Apis::RequestOptions] options
600
+ # Request-specific options
601
+ #
602
+ # @yield [result, err] Result & error if block supplied
603
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
604
+ # @yieldparam err [StandardError] error object if request failed
605
+ #
606
+ # @return [Google::Apis::DatastreamV1::Operation]
607
+ #
608
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
609
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
610
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
611
+ def create_project_location_private_connection(parent, private_connection_object = nil, private_connection_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
612
+ command = make_simple_command(:post, 'v1/{+parent}/privateConnections', options)
613
+ command.request_representation = Google::Apis::DatastreamV1::PrivateConnection::Representation
614
+ command.request_object = private_connection_object
615
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
616
+ command.response_class = Google::Apis::DatastreamV1::Operation
617
+ command.params['parent'] = parent unless parent.nil?
618
+ command.query['privateConnectionId'] = private_connection_id unless private_connection_id.nil?
619
+ command.query['requestId'] = request_id unless request_id.nil?
620
+ command.query['fields'] = fields unless fields.nil?
621
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
622
+ execute_or_queue_command(command, &block)
623
+ end
624
+
625
+ # Use this method to delete a private connectivity configuration.
626
+ # @param [String] name
627
+ # Required. The name of the private connectivity configuration to delete.
628
+ # @param [Boolean] force
629
+ # Optional. If set to true, any child routes that belong to this
630
+ # PrivateConnection will also be deleted.
631
+ # @param [String] request_id
632
+ # Optional. A request ID to identify requests. Specify a unique request ID so
633
+ # that if you must retry your request, the server will know to ignore the
634
+ # request if it has already been completed. The server will guarantee that for
635
+ # at least 60 minutes after the first request. For example, consider a situation
636
+ # where you make an initial request and the request times out. If you make the
637
+ # request again with the same request ID, the server can check if original
638
+ # operation with the same request ID was received, and if so, will ignore the
639
+ # second request. This prevents clients from accidentally creating duplicate
640
+ # commitments. The request ID must be a valid UUID with the exception that zero
641
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
642
+ # @param [String] fields
643
+ # Selector specifying which fields to include in a partial response.
644
+ # @param [String] quota_user
645
+ # Available to use for quota purposes for server-side applications. Can be any
646
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
647
+ # @param [Google::Apis::RequestOptions] options
648
+ # Request-specific options
649
+ #
650
+ # @yield [result, err] Result & error if block supplied
651
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
652
+ # @yieldparam err [StandardError] error object if request failed
653
+ #
654
+ # @return [Google::Apis::DatastreamV1::Operation]
655
+ #
656
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
657
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
658
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
659
+ def delete_project_location_private_connection(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
660
+ command = make_simple_command(:delete, 'v1/{+name}', options)
661
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
662
+ command.response_class = Google::Apis::DatastreamV1::Operation
663
+ command.params['name'] = name unless name.nil?
664
+ command.query['force'] = force unless force.nil?
665
+ command.query['requestId'] = request_id unless request_id.nil?
666
+ command.query['fields'] = fields unless fields.nil?
667
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
668
+ execute_or_queue_command(command, &block)
669
+ end
670
+
671
+ # Use this method to get details about a private connectivity configuration.
672
+ # @param [String] name
673
+ # Required. The name of the private connectivity configuration to get.
674
+ # @param [String] fields
675
+ # Selector specifying which fields to include in a partial response.
676
+ # @param [String] quota_user
677
+ # Available to use for quota purposes for server-side applications. Can be any
678
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
679
+ # @param [Google::Apis::RequestOptions] options
680
+ # Request-specific options
681
+ #
682
+ # @yield [result, err] Result & error if block supplied
683
+ # @yieldparam result [Google::Apis::DatastreamV1::PrivateConnection] parsed result object
684
+ # @yieldparam err [StandardError] error object if request failed
685
+ #
686
+ # @return [Google::Apis::DatastreamV1::PrivateConnection]
687
+ #
688
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
689
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
690
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
691
+ def get_project_location_private_connection(name, fields: nil, quota_user: nil, options: nil, &block)
692
+ command = make_simple_command(:get, 'v1/{+name}', options)
693
+ command.response_representation = Google::Apis::DatastreamV1::PrivateConnection::Representation
694
+ command.response_class = Google::Apis::DatastreamV1::PrivateConnection
695
+ command.params['name'] = name unless name.nil?
696
+ command.query['fields'] = fields unless fields.nil?
697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
698
+ execute_or_queue_command(command, &block)
699
+ end
700
+
701
+ # Use this method to list private connectivity configurations in a project and
702
+ # location.
703
+ # @param [String] parent
704
+ # Required. The parent that owns the collection of private connectivity
705
+ # configurations.
706
+ # @param [String] filter
707
+ # Filter request.
708
+ # @param [String] order_by
709
+ # Order by fields for the result.
710
+ # @param [Fixnum] page_size
711
+ # Maximum number of private connectivity configurations to return. If
712
+ # unspecified, at most 50 private connectivity configurations that will be
713
+ # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
714
+ # @param [String] page_token
715
+ # Page token received from a previous `ListPrivateConnections` call. Provide
716
+ # this to retrieve the subsequent page. When paginating, all other parameters
717
+ # provided to `ListPrivateConnections` must match the call that provided the
718
+ # page token.
719
+ # @param [String] fields
720
+ # Selector specifying which fields to include in a partial response.
721
+ # @param [String] quota_user
722
+ # Available to use for quota purposes for server-side applications. Can be any
723
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
724
+ # @param [Google::Apis::RequestOptions] options
725
+ # Request-specific options
726
+ #
727
+ # @yield [result, err] Result & error if block supplied
728
+ # @yieldparam result [Google::Apis::DatastreamV1::ListPrivateConnectionsResponse] parsed result object
729
+ # @yieldparam err [StandardError] error object if request failed
730
+ #
731
+ # @return [Google::Apis::DatastreamV1::ListPrivateConnectionsResponse]
732
+ #
733
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
734
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
735
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
736
+ def list_project_location_private_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
737
+ command = make_simple_command(:get, 'v1/{+parent}/privateConnections', options)
738
+ command.response_representation = Google::Apis::DatastreamV1::ListPrivateConnectionsResponse::Representation
739
+ command.response_class = Google::Apis::DatastreamV1::ListPrivateConnectionsResponse
740
+ command.params['parent'] = parent unless parent.nil?
741
+ command.query['filter'] = filter unless filter.nil?
742
+ command.query['orderBy'] = order_by unless order_by.nil?
743
+ command.query['pageSize'] = page_size unless page_size.nil?
744
+ command.query['pageToken'] = page_token unless page_token.nil?
745
+ command.query['fields'] = fields unless fields.nil?
746
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
747
+ execute_or_queue_command(command, &block)
748
+ end
749
+
750
+ # Use this method to create a route for a private connectivity in a project and
751
+ # location.
752
+ # @param [String] parent
753
+ # Required. The parent that owns the collection of Routes.
754
+ # @param [Google::Apis::DatastreamV1::Route] route_object
755
+ # @param [String] request_id
756
+ # Optional. A request ID to identify requests. Specify a unique request ID so
757
+ # that if you must retry your request, the server will know to ignore the
758
+ # request if it has already been completed. The server will guarantee that for
759
+ # at least 60 minutes since the first request. For example, consider a situation
760
+ # where you make an initial request and the request times out. If you make the
761
+ # request again with the same request ID, the server can check if original
762
+ # operation with the same request ID was received, and if so, will ignore the
763
+ # second request. This prevents clients from accidentally creating duplicate
764
+ # commitments. The request ID must be a valid UUID with the exception that zero
765
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
766
+ # @param [String] route_id
767
+ # Required. The Route identifier.
768
+ # @param [String] fields
769
+ # Selector specifying which fields to include in a partial response.
770
+ # @param [String] quota_user
771
+ # Available to use for quota purposes for server-side applications. Can be any
772
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
773
+ # @param [Google::Apis::RequestOptions] options
774
+ # Request-specific options
775
+ #
776
+ # @yield [result, err] Result & error if block supplied
777
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
778
+ # @yieldparam err [StandardError] error object if request failed
779
+ #
780
+ # @return [Google::Apis::DatastreamV1::Operation]
781
+ #
782
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
783
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
784
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
785
+ def create_project_location_private_connection_route(parent, route_object = nil, request_id: nil, route_id: nil, fields: nil, quota_user: nil, options: nil, &block)
786
+ command = make_simple_command(:post, 'v1/{+parent}/routes', options)
787
+ command.request_representation = Google::Apis::DatastreamV1::Route::Representation
788
+ command.request_object = route_object
789
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
790
+ command.response_class = Google::Apis::DatastreamV1::Operation
791
+ command.params['parent'] = parent unless parent.nil?
792
+ command.query['requestId'] = request_id unless request_id.nil?
793
+ command.query['routeId'] = route_id unless route_id.nil?
794
+ command.query['fields'] = fields unless fields.nil?
795
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
796
+ execute_or_queue_command(command, &block)
797
+ end
798
+
799
+ # Use this method to delete a route.
800
+ # @param [String] name
801
+ # Required. The name of the Route resource to delete.
802
+ # @param [String] request_id
803
+ # Optional. A request ID to identify requests. Specify a unique request ID so
804
+ # that if you must retry your request, the server will know to ignore the
805
+ # request if it has already been completed. The server will guarantee that for
806
+ # at least 60 minutes after the first request. For example, consider a situation
807
+ # where you make an initial request and the request times out. If you make the
808
+ # request again with the same request ID, the server can check if original
809
+ # operation with the same request ID was received, and if so, will ignore the
810
+ # second request. This prevents clients from accidentally creating duplicate
811
+ # commitments. The request ID must be a valid UUID with the exception that zero
812
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
813
+ # @param [String] fields
814
+ # Selector specifying which fields to include in a partial response.
815
+ # @param [String] quota_user
816
+ # Available to use for quota purposes for server-side applications. Can be any
817
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
818
+ # @param [Google::Apis::RequestOptions] options
819
+ # Request-specific options
820
+ #
821
+ # @yield [result, err] Result & error if block supplied
822
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
823
+ # @yieldparam err [StandardError] error object if request failed
824
+ #
825
+ # @return [Google::Apis::DatastreamV1::Operation]
826
+ #
827
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
828
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
829
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
830
+ def delete_project_location_private_connection_route(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
831
+ command = make_simple_command(:delete, 'v1/{+name}', options)
832
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
833
+ command.response_class = Google::Apis::DatastreamV1::Operation
834
+ command.params['name'] = name unless name.nil?
835
+ command.query['requestId'] = request_id unless request_id.nil?
836
+ command.query['fields'] = fields unless fields.nil?
837
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
838
+ execute_or_queue_command(command, &block)
839
+ end
840
+
841
+ # Use this method to get details about a route.
842
+ # @param [String] name
843
+ # Required. The name of the Route resource to get.
844
+ # @param [String] fields
845
+ # Selector specifying which fields to include in a partial response.
846
+ # @param [String] quota_user
847
+ # Available to use for quota purposes for server-side applications. Can be any
848
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
849
+ # @param [Google::Apis::RequestOptions] options
850
+ # Request-specific options
851
+ #
852
+ # @yield [result, err] Result & error if block supplied
853
+ # @yieldparam result [Google::Apis::DatastreamV1::Route] parsed result object
854
+ # @yieldparam err [StandardError] error object if request failed
855
+ #
856
+ # @return [Google::Apis::DatastreamV1::Route]
857
+ #
858
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
859
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
860
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
861
+ def get_project_location_private_connection_route(name, fields: nil, quota_user: nil, options: nil, &block)
862
+ command = make_simple_command(:get, 'v1/{+name}', options)
863
+ command.response_representation = Google::Apis::DatastreamV1::Route::Representation
864
+ command.response_class = Google::Apis::DatastreamV1::Route
865
+ command.params['name'] = name unless name.nil?
866
+ command.query['fields'] = fields unless fields.nil?
867
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
868
+ execute_or_queue_command(command, &block)
869
+ end
870
+
871
+ # Use this method to list routes created for a private connectivity in a project
872
+ # and location.
873
+ # @param [String] parent
874
+ # Required. The parent that owns the collection of Routess.
875
+ # @param [String] filter
876
+ # Filter request.
877
+ # @param [String] order_by
878
+ # Order by fields for the result.
879
+ # @param [Fixnum] page_size
880
+ # Maximum number of Routes to return. The service may return fewer than this
881
+ # value. If unspecified, at most 50 Routes will be returned. The maximum value
882
+ # is 1000; values above 1000 will be coerced to 1000.
883
+ # @param [String] page_token
884
+ # Page token received from a previous `ListRoutes` call. Provide this to
885
+ # retrieve the subsequent page. When paginating, all other parameters provided
886
+ # to `ListRoutes` must match the call that provided the page token.
887
+ # @param [String] fields
888
+ # Selector specifying which fields to include in a partial response.
889
+ # @param [String] quota_user
890
+ # Available to use for quota purposes for server-side applications. Can be any
891
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
892
+ # @param [Google::Apis::RequestOptions] options
893
+ # Request-specific options
894
+ #
895
+ # @yield [result, err] Result & error if block supplied
896
+ # @yieldparam result [Google::Apis::DatastreamV1::ListRoutesResponse] parsed result object
897
+ # @yieldparam err [StandardError] error object if request failed
898
+ #
899
+ # @return [Google::Apis::DatastreamV1::ListRoutesResponse]
900
+ #
901
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
902
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
903
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
904
+ def list_project_location_private_connection_routes(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
905
+ command = make_simple_command(:get, 'v1/{+parent}/routes', options)
906
+ command.response_representation = Google::Apis::DatastreamV1::ListRoutesResponse::Representation
907
+ command.response_class = Google::Apis::DatastreamV1::ListRoutesResponse
908
+ command.params['parent'] = parent unless parent.nil?
909
+ command.query['filter'] = filter unless filter.nil?
910
+ command.query['orderBy'] = order_by unless order_by.nil?
911
+ command.query['pageSize'] = page_size unless page_size.nil?
912
+ command.query['pageToken'] = page_token unless page_token.nil?
913
+ command.query['fields'] = fields unless fields.nil?
914
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
915
+ execute_or_queue_command(command, &block)
916
+ end
917
+
918
+ # Use this method to create a stream.
919
+ # @param [String] parent
920
+ # Required. The parent that owns the collection of streams.
921
+ # @param [Google::Apis::DatastreamV1::Stream] stream_object
922
+ # @param [Boolean] force
923
+ # Optional. Create the stream without validating it.
924
+ # @param [String] request_id
925
+ # Optional. A request ID to identify requests. Specify a unique request ID so
926
+ # that if you must retry your request, the server will know to ignore the
927
+ # request if it has already been completed. The server will guarantee that for
928
+ # at least 60 minutes since the first request. For example, consider a situation
929
+ # where you make an initial request and the request times out. If you make the
930
+ # request again with the same request ID, the server can check if original
931
+ # operation with the same request ID was received, and if so, will ignore the
932
+ # second request. This prevents clients from accidentally creating duplicate
933
+ # commitments. The request ID must be a valid UUID with the exception that zero
934
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
935
+ # @param [String] stream_id
936
+ # Required. The stream identifier.
937
+ # @param [Boolean] validate_only
938
+ # Optional. Only validate the stream, but do not create any resources. The
939
+ # default is false.
940
+ # @param [String] fields
941
+ # Selector specifying which fields to include in a partial response.
942
+ # @param [String] quota_user
943
+ # Available to use for quota purposes for server-side applications. Can be any
944
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
945
+ # @param [Google::Apis::RequestOptions] options
946
+ # Request-specific options
947
+ #
948
+ # @yield [result, err] Result & error if block supplied
949
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
950
+ # @yieldparam err [StandardError] error object if request failed
951
+ #
952
+ # @return [Google::Apis::DatastreamV1::Operation]
953
+ #
954
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
955
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
956
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
957
+ def create_project_location_stream(parent, stream_object = nil, force: nil, request_id: nil, stream_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
958
+ command = make_simple_command(:post, 'v1/{+parent}/streams', options)
959
+ command.request_representation = Google::Apis::DatastreamV1::Stream::Representation
960
+ command.request_object = stream_object
961
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
962
+ command.response_class = Google::Apis::DatastreamV1::Operation
963
+ command.params['parent'] = parent unless parent.nil?
964
+ command.query['force'] = force unless force.nil?
965
+ command.query['requestId'] = request_id unless request_id.nil?
966
+ command.query['streamId'] = stream_id unless stream_id.nil?
967
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
968
+ command.query['fields'] = fields unless fields.nil?
969
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
970
+ execute_or_queue_command(command, &block)
971
+ end
972
+
973
+ # Use this method to delete a stream.
974
+ # @param [String] name
975
+ # Required. The name of the stream resource to delete.
976
+ # @param [String] request_id
977
+ # Optional. A request ID to identify requests. Specify a unique request ID so
978
+ # that if you must retry your request, the server will know to ignore the
979
+ # request if it has already been completed. The server will guarantee that for
980
+ # at least 60 minutes after the first request. For example, consider a situation
981
+ # where you make an initial request and the request times out. If you make the
982
+ # request again with the same request ID, the server can check if original
983
+ # operation with the same request ID was received, and if so, will ignore the
984
+ # second request. This prevents clients from accidentally creating duplicate
985
+ # commitments. The request ID must be a valid UUID with the exception that zero
986
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
987
+ # @param [String] fields
988
+ # Selector specifying which fields to include in a partial response.
989
+ # @param [String] quota_user
990
+ # Available to use for quota purposes for server-side applications. Can be any
991
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
992
+ # @param [Google::Apis::RequestOptions] options
993
+ # Request-specific options
994
+ #
995
+ # @yield [result, err] Result & error if block supplied
996
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
997
+ # @yieldparam err [StandardError] error object if request failed
998
+ #
999
+ # @return [Google::Apis::DatastreamV1::Operation]
1000
+ #
1001
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1002
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1003
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1004
+ def delete_project_location_stream(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1005
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1006
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
1007
+ command.response_class = Google::Apis::DatastreamV1::Operation
1008
+ command.params['name'] = name unless name.nil?
1009
+ command.query['requestId'] = request_id unless request_id.nil?
1010
+ command.query['fields'] = fields unless fields.nil?
1011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1012
+ execute_or_queue_command(command, &block)
1013
+ end
1014
+
1015
+ # Use this method to get details about a stream.
1016
+ # @param [String] name
1017
+ # Required. The name of the stream resource to get.
1018
+ # @param [String] fields
1019
+ # Selector specifying which fields to include in a partial response.
1020
+ # @param [String] quota_user
1021
+ # Available to use for quota purposes for server-side applications. Can be any
1022
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1023
+ # @param [Google::Apis::RequestOptions] options
1024
+ # Request-specific options
1025
+ #
1026
+ # @yield [result, err] Result & error if block supplied
1027
+ # @yieldparam result [Google::Apis::DatastreamV1::Stream] parsed result object
1028
+ # @yieldparam err [StandardError] error object if request failed
1029
+ #
1030
+ # @return [Google::Apis::DatastreamV1::Stream]
1031
+ #
1032
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1033
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1034
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1035
+ def get_project_location_stream(name, fields: nil, quota_user: nil, options: nil, &block)
1036
+ command = make_simple_command(:get, 'v1/{+name}', options)
1037
+ command.response_representation = Google::Apis::DatastreamV1::Stream::Representation
1038
+ command.response_class = Google::Apis::DatastreamV1::Stream
1039
+ command.params['name'] = name unless name.nil?
1040
+ command.query['fields'] = fields unless fields.nil?
1041
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1042
+ execute_or_queue_command(command, &block)
1043
+ end
1044
+
1045
+ # Use this method to list streams in a project and location.
1046
+ # @param [String] parent
1047
+ # Required. The parent that owns the collection of streams.
1048
+ # @param [String] filter
1049
+ # Filter request.
1050
+ # @param [String] order_by
1051
+ # Order by fields for the result.
1052
+ # @param [Fixnum] page_size
1053
+ # Maximum number of streams to return. If unspecified, at most 50 streams will
1054
+ # be returned. The maximum value is 1000; values above 1000 will be coerced to
1055
+ # 1000.
1056
+ # @param [String] page_token
1057
+ # Page token received from a previous `ListStreams` call. Provide this to
1058
+ # retrieve the subsequent page. When paginating, all other parameters provided
1059
+ # to `ListStreams` must match the call that provided the page token.
1060
+ # @param [String] fields
1061
+ # Selector specifying which fields to include in a partial response.
1062
+ # @param [String] quota_user
1063
+ # Available to use for quota purposes for server-side applications. Can be any
1064
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1065
+ # @param [Google::Apis::RequestOptions] options
1066
+ # Request-specific options
1067
+ #
1068
+ # @yield [result, err] Result & error if block supplied
1069
+ # @yieldparam result [Google::Apis::DatastreamV1::ListStreamsResponse] parsed result object
1070
+ # @yieldparam err [StandardError] error object if request failed
1071
+ #
1072
+ # @return [Google::Apis::DatastreamV1::ListStreamsResponse]
1073
+ #
1074
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1075
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1076
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1077
+ def list_project_location_streams(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1078
+ command = make_simple_command(:get, 'v1/{+parent}/streams', options)
1079
+ command.response_representation = Google::Apis::DatastreamV1::ListStreamsResponse::Representation
1080
+ command.response_class = Google::Apis::DatastreamV1::ListStreamsResponse
1081
+ command.params['parent'] = parent unless parent.nil?
1082
+ command.query['filter'] = filter unless filter.nil?
1083
+ command.query['orderBy'] = order_by unless order_by.nil?
1084
+ command.query['pageSize'] = page_size unless page_size.nil?
1085
+ command.query['pageToken'] = page_token unless page_token.nil?
1086
+ command.query['fields'] = fields unless fields.nil?
1087
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1088
+ execute_or_queue_command(command, &block)
1089
+ end
1090
+
1091
+ # Use this method to update the configuration of a stream.
1092
+ # @param [String] name
1093
+ # Output only. The stream's name.
1094
+ # @param [Google::Apis::DatastreamV1::Stream] stream_object
1095
+ # @param [Boolean] force
1096
+ # Optional. Create the stream without validating it.
1097
+ # @param [String] request_id
1098
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1099
+ # that if you must retry your request, the server will know to ignore the
1100
+ # request if it has already been completed. The server will guarantee that for
1101
+ # at least 60 minutes since the first request. For example, consider a situation
1102
+ # where you make an initial request and the request times out. If you make the
1103
+ # request again with the same request ID, the server can check if original
1104
+ # operation with the same request ID was received, and if so, will ignore the
1105
+ # second request. This prevents clients from accidentally creating duplicate
1106
+ # commitments. The request ID must be a valid UUID with the exception that zero
1107
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1108
+ # @param [String] update_mask
1109
+ # Optional. Field mask is used to specify the fields to be overwritten in the
1110
+ # stream resource by the update. The fields specified in the update_mask are
1111
+ # relative to the resource, not the full request. A field will be overwritten if
1112
+ # it is in the mask. If the user does not provide a mask then all fields will be
1113
+ # overwritten.
1114
+ # @param [Boolean] validate_only
1115
+ # Optional. Only validate the stream with the changes, without actually updating
1116
+ # it. The default is false.
1117
+ # @param [String] fields
1118
+ # Selector specifying which fields to include in a partial response.
1119
+ # @param [String] quota_user
1120
+ # Available to use for quota purposes for server-side applications. Can be any
1121
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1122
+ # @param [Google::Apis::RequestOptions] options
1123
+ # Request-specific options
1124
+ #
1125
+ # @yield [result, err] Result & error if block supplied
1126
+ # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
1127
+ # @yieldparam err [StandardError] error object if request failed
1128
+ #
1129
+ # @return [Google::Apis::DatastreamV1::Operation]
1130
+ #
1131
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1132
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1133
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1134
+ def patch_project_location_stream(name, stream_object = nil, force: nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1135
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1136
+ command.request_representation = Google::Apis::DatastreamV1::Stream::Representation
1137
+ command.request_object = stream_object
1138
+ command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
1139
+ command.response_class = Google::Apis::DatastreamV1::Operation
1140
+ command.params['name'] = name unless name.nil?
1141
+ command.query['force'] = force unless force.nil?
1142
+ command.query['requestId'] = request_id unless request_id.nil?
1143
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1144
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1145
+ command.query['fields'] = fields unless fields.nil?
1146
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1147
+ execute_or_queue_command(command, &block)
1148
+ end
1149
+
1150
+ # Use this method to get details about a stream object.
1151
+ # @param [String] name
1152
+ # Required. The name of the stream object resource to get.
1153
+ # @param [String] fields
1154
+ # Selector specifying which fields to include in a partial response.
1155
+ # @param [String] quota_user
1156
+ # Available to use for quota purposes for server-side applications. Can be any
1157
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1158
+ # @param [Google::Apis::RequestOptions] options
1159
+ # Request-specific options
1160
+ #
1161
+ # @yield [result, err] Result & error if block supplied
1162
+ # @yieldparam result [Google::Apis::DatastreamV1::StreamObject] parsed result object
1163
+ # @yieldparam err [StandardError] error object if request failed
1164
+ #
1165
+ # @return [Google::Apis::DatastreamV1::StreamObject]
1166
+ #
1167
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1168
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1169
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1170
+ def get_project_location_stream_object(name, fields: nil, quota_user: nil, options: nil, &block)
1171
+ command = make_simple_command(:get, 'v1/{+name}', options)
1172
+ command.response_representation = Google::Apis::DatastreamV1::StreamObject::Representation
1173
+ command.response_class = Google::Apis::DatastreamV1::StreamObject
1174
+ command.params['name'] = name unless name.nil?
1175
+ command.query['fields'] = fields unless fields.nil?
1176
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1177
+ execute_or_queue_command(command, &block)
1178
+ end
1179
+
1180
+ # Use this method to list the objects of a specific stream.
1181
+ # @param [String] parent
1182
+ # Required. The parent stream that owns the collection of objects.
1183
+ # @param [Fixnum] page_size
1184
+ # Maximum number of objects to return. Default is 50. The maximum value is 1000;
1185
+ # values above 1000 will be coerced to 1000.
1186
+ # @param [String] page_token
1187
+ # Page token received from a previous `ListStreamObjectsRequest` call. Provide
1188
+ # this to retrieve the subsequent page. When paginating, all other parameters
1189
+ # provided to `ListStreamObjectsRequest` must match the call that provided the
1190
+ # page token.
1191
+ # @param [String] fields
1192
+ # Selector specifying which fields to include in a partial response.
1193
+ # @param [String] quota_user
1194
+ # Available to use for quota purposes for server-side applications. Can be any
1195
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1196
+ # @param [Google::Apis::RequestOptions] options
1197
+ # Request-specific options
1198
+ #
1199
+ # @yield [result, err] Result & error if block supplied
1200
+ # @yieldparam result [Google::Apis::DatastreamV1::ListStreamObjectsResponse] parsed result object
1201
+ # @yieldparam err [StandardError] error object if request failed
1202
+ #
1203
+ # @return [Google::Apis::DatastreamV1::ListStreamObjectsResponse]
1204
+ #
1205
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1206
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1207
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1208
+ def list_project_location_stream_objects(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1209
+ command = make_simple_command(:get, 'v1/{+parent}/objects', options)
1210
+ command.response_representation = Google::Apis::DatastreamV1::ListStreamObjectsResponse::Representation
1211
+ command.response_class = Google::Apis::DatastreamV1::ListStreamObjectsResponse
1212
+ command.params['parent'] = parent unless parent.nil?
1213
+ command.query['pageSize'] = page_size unless page_size.nil?
1214
+ command.query['pageToken'] = page_token unless page_token.nil?
1215
+ command.query['fields'] = fields unless fields.nil?
1216
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1217
+ execute_or_queue_command(command, &block)
1218
+ end
1219
+
1220
+ # Use this method to look up a stream object by its source object identifier.
1221
+ # @param [String] parent
1222
+ # Required. The parent stream that owns the collection of objects.
1223
+ # @param [Google::Apis::DatastreamV1::LookupStreamObjectRequest] lookup_stream_object_request_object
1224
+ # @param [String] fields
1225
+ # Selector specifying which fields to include in a partial response.
1226
+ # @param [String] quota_user
1227
+ # Available to use for quota purposes for server-side applications. Can be any
1228
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1229
+ # @param [Google::Apis::RequestOptions] options
1230
+ # Request-specific options
1231
+ #
1232
+ # @yield [result, err] Result & error if block supplied
1233
+ # @yieldparam result [Google::Apis::DatastreamV1::StreamObject] parsed result object
1234
+ # @yieldparam err [StandardError] error object if request failed
1235
+ #
1236
+ # @return [Google::Apis::DatastreamV1::StreamObject]
1237
+ #
1238
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1239
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1240
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1241
+ def lookup_stream_object(parent, lookup_stream_object_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1242
+ command = make_simple_command(:post, 'v1/{+parent}/objects:lookup', options)
1243
+ command.request_representation = Google::Apis::DatastreamV1::LookupStreamObjectRequest::Representation
1244
+ command.request_object = lookup_stream_object_request_object
1245
+ command.response_representation = Google::Apis::DatastreamV1::StreamObject::Representation
1246
+ command.response_class = Google::Apis::DatastreamV1::StreamObject
1247
+ command.params['parent'] = parent unless parent.nil?
1248
+ command.query['fields'] = fields unless fields.nil?
1249
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1250
+ execute_or_queue_command(command, &block)
1251
+ end
1252
+
1253
+ # Starts backfill job for the specified stream object.
1254
+ # @param [String] object
1255
+ # Required. The name of the stream object resource to start a backfill job for.
1256
+ # @param [Google::Apis::DatastreamV1::StartBackfillJobRequest] start_backfill_job_request_object
1257
+ # @param [String] fields
1258
+ # Selector specifying which fields to include in a partial response.
1259
+ # @param [String] quota_user
1260
+ # Available to use for quota purposes for server-side applications. Can be any
1261
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1262
+ # @param [Google::Apis::RequestOptions] options
1263
+ # Request-specific options
1264
+ #
1265
+ # @yield [result, err] Result & error if block supplied
1266
+ # @yieldparam result [Google::Apis::DatastreamV1::StartBackfillJobResponse] parsed result object
1267
+ # @yieldparam err [StandardError] error object if request failed
1268
+ #
1269
+ # @return [Google::Apis::DatastreamV1::StartBackfillJobResponse]
1270
+ #
1271
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1272
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1273
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1274
+ def start_object_backfill_job(object, start_backfill_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1275
+ command = make_simple_command(:post, 'v1/{+object}:startBackfillJob', options)
1276
+ command.request_representation = Google::Apis::DatastreamV1::StartBackfillJobRequest::Representation
1277
+ command.request_object = start_backfill_job_request_object
1278
+ command.response_representation = Google::Apis::DatastreamV1::StartBackfillJobResponse::Representation
1279
+ command.response_class = Google::Apis::DatastreamV1::StartBackfillJobResponse
1280
+ command.params['object'] = object unless object.nil?
1281
+ command.query['fields'] = fields unless fields.nil?
1282
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1283
+ execute_or_queue_command(command, &block)
1284
+ end
1285
+
1286
+ # Stops the backfill job for the specified stream object.
1287
+ # @param [String] object
1288
+ # Required. The name of the stream object resource to stop the backfill job for.
1289
+ # @param [Google::Apis::DatastreamV1::StopBackfillJobRequest] stop_backfill_job_request_object
1290
+ # @param [String] fields
1291
+ # Selector specifying which fields to include in a partial response.
1292
+ # @param [String] quota_user
1293
+ # Available to use for quota purposes for server-side applications. Can be any
1294
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1295
+ # @param [Google::Apis::RequestOptions] options
1296
+ # Request-specific options
1297
+ #
1298
+ # @yield [result, err] Result & error if block supplied
1299
+ # @yieldparam result [Google::Apis::DatastreamV1::StopBackfillJobResponse] parsed result object
1300
+ # @yieldparam err [StandardError] error object if request failed
1301
+ #
1302
+ # @return [Google::Apis::DatastreamV1::StopBackfillJobResponse]
1303
+ #
1304
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1305
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1306
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1307
+ def stop_object_backfill_job(object, stop_backfill_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1308
+ command = make_simple_command(:post, 'v1/{+object}:stopBackfillJob', options)
1309
+ command.request_representation = Google::Apis::DatastreamV1::StopBackfillJobRequest::Representation
1310
+ command.request_object = stop_backfill_job_request_object
1311
+ command.response_representation = Google::Apis::DatastreamV1::StopBackfillJobResponse::Representation
1312
+ command.response_class = Google::Apis::DatastreamV1::StopBackfillJobResponse
1313
+ command.params['object'] = object unless object.nil?
1314
+ command.query['fields'] = fields unless fields.nil?
1315
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1316
+ execute_or_queue_command(command, &block)
1317
+ end
274
1318
 
275
1319
  protected
276
1320