google-apis-datastream_v1alpha1 0.1.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.
@@ -0,0 +1,1190 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module DatastreamV1alpha1
23
+ # Datastream API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/datastream_v1alpha1'
29
+ #
30
+ # Datastream = Google::Apis::DatastreamV1alpha1 # Alias the module
31
+ # service = Datastream::DatastreamService.new
32
+ #
33
+ # @see https://cloud.google.com/datastream/
34
+ class DatastreamService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://datastream.googleapis.com/', '',
47
+ client_name: 'google-apis-datastream_v1alpha1',
48
+ client_version: Google::Apis::DatastreamV1alpha1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
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::DatastreamV1alpha1::FetchStaticIpsResponse] parsed result object
73
+ # @yieldparam err [StandardError] error object if request failed
74
+ #
75
+ # @return [Google::Apis::DatastreamV1alpha1::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, 'v1alpha1/{+name}:fetchStaticIps', options)
82
+ command.response_representation = Google::Apis::DatastreamV1alpha1::FetchStaticIpsResponse::Representation
83
+ command.response_class = Google::Apis::DatastreamV1alpha1::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
+
92
+ # Gets information about a location.
93
+ # @param [String] name
94
+ # Resource name for the location.
95
+ # @param [String] fields
96
+ # Selector specifying which fields to include in a partial response.
97
+ # @param [String] quota_user
98
+ # Available to use for quota purposes for server-side applications. Can be any
99
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [Google::Apis::RequestOptions] options
101
+ # Request-specific options
102
+ #
103
+ # @yield [result, err] Result & error if block supplied
104
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Location] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::DatastreamV1alpha1::Location]
108
+ #
109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
112
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
113
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
114
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Location::Representation
115
+ command.response_class = Google::Apis::DatastreamV1alpha1::Location
116
+ command.params['name'] = name unless name.nil?
117
+ command.query['fields'] = fields unless fields.nil?
118
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
119
+ execute_or_queue_command(command, &block)
120
+ end
121
+
122
+ # Lists information about the supported locations for this service.
123
+ # @param [String] name
124
+ # The resource that owns the locations collection, if applicable.
125
+ # @param [String] filter
126
+ # A filter to narrow down results to a preferred subset. The filtering language
127
+ # accepts strings like "displayName=tokyo", and is documented in more detail in [
128
+ # AIP-160](https://google.aip.dev/160).
129
+ # @param [Fixnum] page_size
130
+ # The maximum number of results to return. If not set, the service selects a
131
+ # default.
132
+ # @param [String] page_token
133
+ # A page token received from the `next_page_token` field in the response. Send
134
+ # that page token to receive the subsequent page.
135
+ # @param [String] fields
136
+ # Selector specifying which fields to include in a partial response.
137
+ # @param [String] quota_user
138
+ # Available to use for quota purposes for server-side applications. Can be any
139
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
140
+ # @param [Google::Apis::RequestOptions] options
141
+ # Request-specific options
142
+ #
143
+ # @yield [result, err] Result & error if block supplied
144
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListLocationsResponse] parsed result object
145
+ # @yieldparam err [StandardError] error object if request failed
146
+ #
147
+ # @return [Google::Apis::DatastreamV1alpha1::ListLocationsResponse]
148
+ #
149
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
150
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
151
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
152
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
153
+ command = make_simple_command(:get, 'v1alpha1/{+name}/locations', options)
154
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListLocationsResponse::Representation
155
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListLocationsResponse
156
+ command.params['name'] = name unless name.nil?
157
+ command.query['filter'] = filter unless filter.nil?
158
+ command.query['pageSize'] = page_size unless page_size.nil?
159
+ command.query['pageToken'] = page_token unless page_token.nil?
160
+ command.query['fields'] = fields unless fields.nil?
161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
162
+ execute_or_queue_command(command, &block)
163
+ end
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::DatastreamV1alpha1::ConnectionProfile] connection_profile_object
169
+ # @param [String] connection_profile_id
170
+ # Required. The connection profile identifier.
171
+ # @param [String] request_id
172
+ # Optional. A request ID to identify requests. Specify a unique request ID so
173
+ # that if you must retry your request, the server will know to ignore the
174
+ # request if it has already been completed. The server will guarantee that for
175
+ # at least 60 minutes since the first request. For example, consider a situation
176
+ # where you make an initial request and the request times out. If you make the
177
+ # request again with the same request ID, the server can check if original
178
+ # operation with the same request ID was received, and if so, will ignore the
179
+ # second request. This prevents clients from accidentally creating duplicate
180
+ # commitments. The request ID must be a valid UUID with the exception that zero
181
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
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::DatastreamV1alpha1::Operation] parsed result object
192
+ # @yieldparam err [StandardError] error object if request failed
193
+ #
194
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
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 create_project_location_connection_profile(parent, connection_profile_object = nil, connection_profile_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
200
+ command = make_simple_command(:post, 'v1alpha1/{+parent}/connectionProfiles', options)
201
+ command.request_representation = Google::Apis::DatastreamV1alpha1::ConnectionProfile::Representation
202
+ command.request_object = connection_profile_object
203
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
204
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
205
+ command.params['parent'] = parent unless parent.nil?
206
+ command.query['connectionProfileId'] = connection_profile_id unless connection_profile_id.nil?
207
+ command.query['requestId'] = request_id unless request_id.nil?
208
+ command.query['fields'] = fields unless fields.nil?
209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
210
+ execute_or_queue_command(command, &block)
211
+ end
212
+
213
+ # Use this method to delete a connection profile..
214
+ # @param [String] name
215
+ # Required. The name of the connection profile resource to delete.
216
+ # @param [String] request_id
217
+ # Optional. A request ID to identify requests. Specify a unique request ID so
218
+ # that if you must retry your request, the server will know to ignore the
219
+ # request if it has already been completed. The server will guarantee that for
220
+ # at least 60 minutes after the first request. For example, consider a situation
221
+ # where you make an initial request and the request times out. If you make the
222
+ # request again with the same request ID, the server can check if original
223
+ # operation with the same request ID was received, and if so, will ignore the
224
+ # second request. This prevents clients from accidentally creating duplicate
225
+ # commitments. The request ID must be a valid UUID with the exception that zero
226
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
227
+ # @param [String] fields
228
+ # Selector specifying which fields to include in a partial response.
229
+ # @param [String] quota_user
230
+ # Available to use for quota purposes for server-side applications. Can be any
231
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
232
+ # @param [Google::Apis::RequestOptions] options
233
+ # Request-specific options
234
+ #
235
+ # @yield [result, err] Result & error if block supplied
236
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
237
+ # @yieldparam err [StandardError] error object if request failed
238
+ #
239
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
240
+ #
241
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
242
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
243
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
244
+ def delete_project_location_connection_profile(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
245
+ command = make_simple_command(:delete, 'v1alpha1/{+name}', options)
246
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
247
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
248
+ command.params['name'] = name unless name.nil?
249
+ command.query['requestId'] = request_id unless request_id.nil?
250
+ command.query['fields'] = fields unless fields.nil?
251
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
252
+ execute_or_queue_command(command, &block)
253
+ end
254
+
255
+ # Use this method to discover a connection profile. The discover API call
256
+ # exposes the data objects and metadata belonging to the profile. Typically, a
257
+ # request returns children data objects under a parent data object that's
258
+ # optionally supplied in the request.
259
+ # @param [String] parent
260
+ # Required. The parent resource of the ConnectionProfile type. Must be in the
261
+ # format `projects/*/locations/*`.
262
+ # @param [Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileRequest] discover_connection_profile_request_object
263
+ # @param [String] fields
264
+ # Selector specifying which fields to include in a partial response.
265
+ # @param [String] quota_user
266
+ # Available to use for quota purposes for server-side applications. Can be any
267
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
268
+ # @param [Google::Apis::RequestOptions] options
269
+ # Request-specific options
270
+ #
271
+ # @yield [result, err] Result & error if block supplied
272
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileResponse] parsed result object
273
+ # @yieldparam err [StandardError] error object if request failed
274
+ #
275
+ # @return [Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileResponse]
276
+ #
277
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
278
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
279
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
280
+ def discover_connection_profile(parent, discover_connection_profile_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
281
+ command = make_simple_command(:post, 'v1alpha1/{+parent}/connectionProfiles:discover', options)
282
+ command.request_representation = Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileRequest::Representation
283
+ command.request_object = discover_connection_profile_request_object
284
+ command.response_representation = Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileResponse::Representation
285
+ command.response_class = Google::Apis::DatastreamV1alpha1::DiscoverConnectionProfileResponse
286
+ command.params['parent'] = parent unless parent.nil?
287
+ command.query['fields'] = fields unless fields.nil?
288
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
289
+ execute_or_queue_command(command, &block)
290
+ end
291
+
292
+ # Use this method to get details about a connection profile.
293
+ # @param [String] name
294
+ # Required. The name of the connection profile resource to get.
295
+ # @param [String] fields
296
+ # Selector specifying which fields to include in a partial response.
297
+ # @param [String] quota_user
298
+ # Available to use for quota purposes for server-side applications. Can be any
299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
300
+ # @param [Google::Apis::RequestOptions] options
301
+ # Request-specific options
302
+ #
303
+ # @yield [result, err] Result & error if block supplied
304
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ConnectionProfile] parsed result object
305
+ # @yieldparam err [StandardError] error object if request failed
306
+ #
307
+ # @return [Google::Apis::DatastreamV1alpha1::ConnectionProfile]
308
+ #
309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
312
+ def get_project_location_connection_profile(name, fields: nil, quota_user: nil, options: nil, &block)
313
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
314
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ConnectionProfile::Representation
315
+ command.response_class = Google::Apis::DatastreamV1alpha1::ConnectionProfile
316
+ command.params['name'] = name unless name.nil?
317
+ command.query['fields'] = fields unless fields.nil?
318
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
319
+ execute_or_queue_command(command, &block)
320
+ end
321
+
322
+ # Use this method to list connection profiles created in a project and location.
323
+ # @param [String] parent
324
+ # Required. The parent that owns the collection of connection profiles.
325
+ # @param [String] filter
326
+ # Filter request.
327
+ # @param [String] order_by
328
+ # Order by fields for the result.
329
+ # @param [Fixnum] page_size
330
+ # Maximum number of connection profiles to return. If unspecified, at most 50
331
+ # connection profiles will be returned. The maximum value is 1000; values above
332
+ # 1000 will be coerced to 1000.
333
+ # @param [String] page_token
334
+ # Page token received from a previous `ListConnectionProfiles` call. Provide
335
+ # this to retrieve the subsequent page. When paginating, all other parameters
336
+ # provided to `ListConnectionProfiles` must match the call that provided the
337
+ # page token.
338
+ # @param [String] fields
339
+ # Selector specifying which fields to include in a partial response.
340
+ # @param [String] quota_user
341
+ # Available to use for quota purposes for server-side applications. Can be any
342
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
343
+ # @param [Google::Apis::RequestOptions] options
344
+ # Request-specific options
345
+ #
346
+ # @yield [result, err] Result & error if block supplied
347
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListConnectionProfilesResponse] parsed result object
348
+ # @yieldparam err [StandardError] error object if request failed
349
+ #
350
+ # @return [Google::Apis::DatastreamV1alpha1::ListConnectionProfilesResponse]
351
+ #
352
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
353
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
354
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
355
+ 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)
356
+ command = make_simple_command(:get, 'v1alpha1/{+parent}/connectionProfiles', options)
357
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListConnectionProfilesResponse::Representation
358
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListConnectionProfilesResponse
359
+ command.params['parent'] = parent unless parent.nil?
360
+ command.query['filter'] = filter unless filter.nil?
361
+ command.query['orderBy'] = order_by unless order_by.nil?
362
+ command.query['pageSize'] = page_size unless page_size.nil?
363
+ command.query['pageToken'] = page_token unless page_token.nil?
364
+ command.query['fields'] = fields unless fields.nil?
365
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
366
+ execute_or_queue_command(command, &block)
367
+ end
368
+
369
+ # Use this method to update the parameters of a connection profile.
370
+ # @param [String] name
371
+ # Output only. The resource's name.
372
+ # @param [Google::Apis::DatastreamV1alpha1::ConnectionProfile] connection_profile_object
373
+ # @param [String] request_id
374
+ # Optional. A request ID to identify requests. Specify a unique request ID so
375
+ # that if you must retry your request, the server will know to ignore the
376
+ # request if it has already been completed. The server will guarantee that for
377
+ # at least 60 minutes since the first request. For example, consider a situation
378
+ # where you make an initial request and the request times out. If you make the
379
+ # request again with the same request ID, the server can check if original
380
+ # operation with the same request ID was received, and if so, will ignore the
381
+ # second request. This prevents clients from accidentally creating duplicate
382
+ # commitments. The request ID must be a valid UUID with the exception that zero
383
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
384
+ # @param [String] update_mask
385
+ # Optional. Field mask is used to specify the fields to be overwritten in the
386
+ # ConnectionProfile resource by the update. The fields specified in the
387
+ # update_mask are relative to the resource, not the full request. A field will
388
+ # be overwritten if it is in the mask. If the user does not provide a mask then
389
+ # all fields will be overwritten.
390
+ # @param [Boolean] validate_only
391
+ # Optional. Only validate the connection profile, but do not update any
392
+ # resources. The default is false.
393
+ # @param [String] fields
394
+ # Selector specifying which fields to include in a partial response.
395
+ # @param [String] quota_user
396
+ # Available to use for quota purposes for server-side applications. Can be any
397
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
398
+ # @param [Google::Apis::RequestOptions] options
399
+ # Request-specific options
400
+ #
401
+ # @yield [result, err] Result & error if block supplied
402
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
403
+ # @yieldparam err [StandardError] error object if request failed
404
+ #
405
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
406
+ #
407
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
408
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
409
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
410
+ def patch_project_location_connection_profile(name, connection_profile_object = nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
411
+ command = make_simple_command(:patch, 'v1alpha1/{+name}', options)
412
+ command.request_representation = Google::Apis::DatastreamV1alpha1::ConnectionProfile::Representation
413
+ command.request_object = connection_profile_object
414
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
415
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
416
+ command.params['name'] = name unless name.nil?
417
+ command.query['requestId'] = request_id unless request_id.nil?
418
+ command.query['updateMask'] = update_mask unless update_mask.nil?
419
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
420
+ command.query['fields'] = fields unless fields.nil?
421
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
422
+ execute_or_queue_command(command, &block)
423
+ end
424
+
425
+ # Starts asynchronous cancellation on a long-running operation. The server makes
426
+ # a best effort to cancel the operation, but success is not guaranteed. If the
427
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
428
+ # Clients can use Operations.GetOperation or other methods to check whether the
429
+ # cancellation succeeded or whether the operation completed despite cancellation.
430
+ # On successful cancellation, the operation is not deleted; instead, it becomes
431
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
432
+ # corresponding to `Code.CANCELLED`.
433
+ # @param [String] name
434
+ # The name of the operation resource to be cancelled.
435
+ # @param [Google::Apis::DatastreamV1alpha1::CancelOperationRequest] cancel_operation_request_object
436
+ # @param [String] fields
437
+ # Selector specifying which fields to include in a partial response.
438
+ # @param [String] quota_user
439
+ # Available to use for quota purposes for server-side applications. Can be any
440
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
441
+ # @param [Google::Apis::RequestOptions] options
442
+ # Request-specific options
443
+ #
444
+ # @yield [result, err] Result & error if block supplied
445
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Empty] parsed result object
446
+ # @yieldparam err [StandardError] error object if request failed
447
+ #
448
+ # @return [Google::Apis::DatastreamV1alpha1::Empty]
449
+ #
450
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
451
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
452
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
453
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
454
+ command = make_simple_command(:post, 'v1alpha1/{+name}:cancel', options)
455
+ command.request_representation = Google::Apis::DatastreamV1alpha1::CancelOperationRequest::Representation
456
+ command.request_object = cancel_operation_request_object
457
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Empty::Representation
458
+ command.response_class = Google::Apis::DatastreamV1alpha1::Empty
459
+ command.params['name'] = name unless name.nil?
460
+ command.query['fields'] = fields unless fields.nil?
461
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
462
+ execute_or_queue_command(command, &block)
463
+ end
464
+
465
+ # Deletes a long-running operation. This method indicates that the client is no
466
+ # longer interested in the operation result. It does not cancel the operation.
467
+ # If the server doesn't support this method, it returns `google.rpc.Code.
468
+ # UNIMPLEMENTED`.
469
+ # @param [String] name
470
+ # The name of the operation resource to be deleted.
471
+ # @param [String] fields
472
+ # Selector specifying which fields to include in a partial response.
473
+ # @param [String] quota_user
474
+ # Available to use for quota purposes for server-side applications. Can be any
475
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
476
+ # @param [Google::Apis::RequestOptions] options
477
+ # Request-specific options
478
+ #
479
+ # @yield [result, err] Result & error if block supplied
480
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Empty] parsed result object
481
+ # @yieldparam err [StandardError] error object if request failed
482
+ #
483
+ # @return [Google::Apis::DatastreamV1alpha1::Empty]
484
+ #
485
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
486
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
487
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
488
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
489
+ command = make_simple_command(:delete, 'v1alpha1/{+name}', options)
490
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Empty::Representation
491
+ command.response_class = Google::Apis::DatastreamV1alpha1::Empty
492
+ command.params['name'] = name unless name.nil?
493
+ command.query['fields'] = fields unless fields.nil?
494
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
495
+ execute_or_queue_command(command, &block)
496
+ end
497
+
498
+ # Gets the latest state of a long-running operation. Clients can use this method
499
+ # to poll the operation result at intervals as recommended by the API service.
500
+ # @param [String] name
501
+ # The name of the operation resource.
502
+ # @param [String] fields
503
+ # Selector specifying which fields to include in a partial response.
504
+ # @param [String] quota_user
505
+ # Available to use for quota purposes for server-side applications. Can be any
506
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
507
+ # @param [Google::Apis::RequestOptions] options
508
+ # Request-specific options
509
+ #
510
+ # @yield [result, err] Result & error if block supplied
511
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
512
+ # @yieldparam err [StandardError] error object if request failed
513
+ #
514
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
515
+ #
516
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
517
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
518
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
519
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
520
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
521
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
522
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
523
+ command.params['name'] = name unless name.nil?
524
+ command.query['fields'] = fields unless fields.nil?
525
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
526
+ execute_or_queue_command(command, &block)
527
+ end
528
+
529
+ # Lists operations that match the specified filter in the request. If the server
530
+ # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
531
+ # binding allows API services to override the binding to use different resource
532
+ # name schemes, such as `users/*/operations`. To override the binding, API
533
+ # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
534
+ # service configuration. For backwards compatibility, the default name includes
535
+ # the operations collection id, however overriding users must ensure the name
536
+ # binding is the parent resource, without the operations collection id.
537
+ # @param [String] name
538
+ # The name of the operation's parent resource.
539
+ # @param [String] filter
540
+ # The standard list filter.
541
+ # @param [Fixnum] page_size
542
+ # The standard list page size.
543
+ # @param [String] page_token
544
+ # The standard list page token.
545
+ # @param [String] fields
546
+ # Selector specifying which fields to include in a partial response.
547
+ # @param [String] quota_user
548
+ # Available to use for quota purposes for server-side applications. Can be any
549
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
550
+ # @param [Google::Apis::RequestOptions] options
551
+ # Request-specific options
552
+ #
553
+ # @yield [result, err] Result & error if block supplied
554
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListOperationsResponse] parsed result object
555
+ # @yieldparam err [StandardError] error object if request failed
556
+ #
557
+ # @return [Google::Apis::DatastreamV1alpha1::ListOperationsResponse]
558
+ #
559
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
560
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
561
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
562
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
563
+ command = make_simple_command(:get, 'v1alpha1/{+name}/operations', options)
564
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListOperationsResponse::Representation
565
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListOperationsResponse
566
+ command.params['name'] = name unless name.nil?
567
+ command.query['filter'] = filter unless filter.nil?
568
+ command.query['pageSize'] = page_size unless page_size.nil?
569
+ command.query['pageToken'] = page_token unless page_token.nil?
570
+ command.query['fields'] = fields unless fields.nil?
571
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
572
+ execute_or_queue_command(command, &block)
573
+ end
574
+
575
+ # Use this method to create a private connectivity configuration.
576
+ # @param [String] parent
577
+ # Required. The parent that owns the collection of PrivateConnections.
578
+ # @param [Google::Apis::DatastreamV1alpha1::PrivateConnection] private_connection_object
579
+ # @param [String] private_connection_id
580
+ # Required. The private connectivity identifier.
581
+ # @param [String] request_id
582
+ # Optional. A request ID to identify requests. Specify a unique request ID so
583
+ # that if you must retry your request, the server will know to ignore the
584
+ # request if it has already been completed. The server will guarantee that for
585
+ # at least 60 minutes since the first request. For example, consider a situation
586
+ # where you make an initial request and the request times out. If you make the
587
+ # request again with the same request ID, the server can check if original
588
+ # operation with the same request ID was received, and if so, will ignore the
589
+ # second request. This prevents clients from accidentally creating duplicate
590
+ # commitments. The request ID must be a valid UUID with the exception that zero
591
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
592
+ # @param [String] fields
593
+ # Selector specifying which fields to include in a partial response.
594
+ # @param [String] quota_user
595
+ # Available to use for quota purposes for server-side applications. Can be any
596
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
597
+ # @param [Google::Apis::RequestOptions] options
598
+ # Request-specific options
599
+ #
600
+ # @yield [result, err] Result & error if block supplied
601
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
602
+ # @yieldparam err [StandardError] error object if request failed
603
+ #
604
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
605
+ #
606
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
607
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
608
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
609
+ 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)
610
+ command = make_simple_command(:post, 'v1alpha1/{+parent}/privateConnections', options)
611
+ command.request_representation = Google::Apis::DatastreamV1alpha1::PrivateConnection::Representation
612
+ command.request_object = private_connection_object
613
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
614
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
615
+ command.params['parent'] = parent unless parent.nil?
616
+ command.query['privateConnectionId'] = private_connection_id unless private_connection_id.nil?
617
+ command.query['requestId'] = request_id unless request_id.nil?
618
+ command.query['fields'] = fields unless fields.nil?
619
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
620
+ execute_or_queue_command(command, &block)
621
+ end
622
+
623
+ # Use this method to delete a private connectivity configuration.
624
+ # @param [String] name
625
+ # Required. The name of the private connectivity configuration to delete.
626
+ # @param [Boolean] force
627
+ # Optional. If set to true, any child routes that belong to this
628
+ # PrivateConnection will also be deleted.
629
+ # @param [String] request_id
630
+ # Optional. A request ID to identify requests. Specify a unique request ID so
631
+ # that if you must retry your request, the server will know to ignore the
632
+ # request if it has already been completed. The server will guarantee that for
633
+ # at least 60 minutes after the first request. For example, consider a situation
634
+ # where you make an initial request and the request times out. If you make the
635
+ # request again with the same request ID, the server can check if original
636
+ # operation with the same request ID was received, and if so, will ignore the
637
+ # second request. This prevents clients from accidentally creating duplicate
638
+ # commitments. The request ID must be a valid UUID with the exception that zero
639
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
640
+ # @param [String] fields
641
+ # Selector specifying which fields to include in a partial response.
642
+ # @param [String] quota_user
643
+ # Available to use for quota purposes for server-side applications. Can be any
644
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
645
+ # @param [Google::Apis::RequestOptions] options
646
+ # Request-specific options
647
+ #
648
+ # @yield [result, err] Result & error if block supplied
649
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
650
+ # @yieldparam err [StandardError] error object if request failed
651
+ #
652
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
653
+ #
654
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
655
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
656
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
657
+ def delete_project_location_private_connection(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
658
+ command = make_simple_command(:delete, 'v1alpha1/{+name}', options)
659
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
660
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
661
+ command.params['name'] = name unless name.nil?
662
+ command.query['force'] = force unless force.nil?
663
+ command.query['requestId'] = request_id unless request_id.nil?
664
+ command.query['fields'] = fields unless fields.nil?
665
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
666
+ execute_or_queue_command(command, &block)
667
+ end
668
+
669
+ # Use this method to get details about a private connectivity configuration.
670
+ # @param [String] name
671
+ # Required. The name of the private connectivity configuration to get.
672
+ # @param [String] fields
673
+ # Selector specifying which fields to include in a partial response.
674
+ # @param [String] quota_user
675
+ # Available to use for quota purposes for server-side applications. Can be any
676
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
677
+ # @param [Google::Apis::RequestOptions] options
678
+ # Request-specific options
679
+ #
680
+ # @yield [result, err] Result & error if block supplied
681
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::PrivateConnection] parsed result object
682
+ # @yieldparam err [StandardError] error object if request failed
683
+ #
684
+ # @return [Google::Apis::DatastreamV1alpha1::PrivateConnection]
685
+ #
686
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
687
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
688
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
689
+ def get_project_location_private_connection(name, fields: nil, quota_user: nil, options: nil, &block)
690
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
691
+ command.response_representation = Google::Apis::DatastreamV1alpha1::PrivateConnection::Representation
692
+ command.response_class = Google::Apis::DatastreamV1alpha1::PrivateConnection
693
+ command.params['name'] = name unless name.nil?
694
+ command.query['fields'] = fields unless fields.nil?
695
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
696
+ execute_or_queue_command(command, &block)
697
+ end
698
+
699
+ # Use this method to list private connectivity configurations in a project and
700
+ # location.
701
+ # @param [String] parent
702
+ # Required. The parent that owns the collection of private connectivity
703
+ # configurations.
704
+ # @param [String] filter
705
+ # Filter request.
706
+ # @param [String] order_by
707
+ # Order by fields for the result.
708
+ # @param [Fixnum] page_size
709
+ # Maximum number of private connectivity configurations to return. If
710
+ # unspecified, at most 50 private connectivity configurations that will be
711
+ # returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
712
+ # @param [String] page_token
713
+ # Page token received from a previous `ListPrivateConnections` call. Provide
714
+ # this to retrieve the subsequent page. When paginating, all other parameters
715
+ # provided to `ListPrivateConnections` must match the call that provided the
716
+ # page token.
717
+ # @param [String] fields
718
+ # Selector specifying which fields to include in a partial response.
719
+ # @param [String] quota_user
720
+ # Available to use for quota purposes for server-side applications. Can be any
721
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
722
+ # @param [Google::Apis::RequestOptions] options
723
+ # Request-specific options
724
+ #
725
+ # @yield [result, err] Result & error if block supplied
726
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListPrivateConnectionsResponse] parsed result object
727
+ # @yieldparam err [StandardError] error object if request failed
728
+ #
729
+ # @return [Google::Apis::DatastreamV1alpha1::ListPrivateConnectionsResponse]
730
+ #
731
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
732
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
733
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
734
+ 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)
735
+ command = make_simple_command(:get, 'v1alpha1/{+parent}/privateConnections', options)
736
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListPrivateConnectionsResponse::Representation
737
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListPrivateConnectionsResponse
738
+ command.params['parent'] = parent unless parent.nil?
739
+ command.query['filter'] = filter unless filter.nil?
740
+ command.query['orderBy'] = order_by unless order_by.nil?
741
+ command.query['pageSize'] = page_size unless page_size.nil?
742
+ command.query['pageToken'] = page_token unless page_token.nil?
743
+ command.query['fields'] = fields unless fields.nil?
744
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
745
+ execute_or_queue_command(command, &block)
746
+ end
747
+
748
+ # Use this method to create a route for a private connectivity in a project and
749
+ # location.
750
+ # @param [String] parent
751
+ # Required. The parent that owns the collection of Routes.
752
+ # @param [Google::Apis::DatastreamV1alpha1::Route] route_object
753
+ # @param [String] request_id
754
+ # Optional. A request ID to identify requests. Specify a unique request ID so
755
+ # that if you must retry your request, the server will know to ignore the
756
+ # request if it has already been completed. The server will guarantee that for
757
+ # at least 60 minutes since the first request. For example, consider a situation
758
+ # where you make an initial request and the request times out. If you make the
759
+ # request again with the same request ID, the server can check if original
760
+ # operation with the same request ID was received, and if so, will ignore the
761
+ # second request. This prevents clients from accidentally creating duplicate
762
+ # commitments. The request ID must be a valid UUID with the exception that zero
763
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
764
+ # @param [String] route_id
765
+ # Required. The Route identifier.
766
+ # @param [String] fields
767
+ # Selector specifying which fields to include in a partial response.
768
+ # @param [String] quota_user
769
+ # Available to use for quota purposes for server-side applications. Can be any
770
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
771
+ # @param [Google::Apis::RequestOptions] options
772
+ # Request-specific options
773
+ #
774
+ # @yield [result, err] Result & error if block supplied
775
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
776
+ # @yieldparam err [StandardError] error object if request failed
777
+ #
778
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
779
+ #
780
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
781
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
782
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
783
+ 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)
784
+ command = make_simple_command(:post, 'v1alpha1/{+parent}/routes', options)
785
+ command.request_representation = Google::Apis::DatastreamV1alpha1::Route::Representation
786
+ command.request_object = route_object
787
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
788
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
789
+ command.params['parent'] = parent unless parent.nil?
790
+ command.query['requestId'] = request_id unless request_id.nil?
791
+ command.query['routeId'] = route_id unless route_id.nil?
792
+ command.query['fields'] = fields unless fields.nil?
793
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
794
+ execute_or_queue_command(command, &block)
795
+ end
796
+
797
+ # Use this method to delete a route.
798
+ # @param [String] name
799
+ # Required. The name of the Route resource to delete.
800
+ # @param [String] request_id
801
+ # Optional. A request ID to identify requests. Specify a unique request ID so
802
+ # that if you must retry your request, the server will know to ignore the
803
+ # request if it has already been completed. The server will guarantee that for
804
+ # at least 60 minutes after the first request. For example, consider a situation
805
+ # where you make an initial request and the request times out. If you make the
806
+ # request again with the same request ID, the server can check if original
807
+ # operation with the same request ID was received, and if so, will ignore the
808
+ # second request. This prevents clients from accidentally creating duplicate
809
+ # commitments. The request ID must be a valid UUID with the exception that zero
810
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
811
+ # @param [String] fields
812
+ # Selector specifying which fields to include in a partial response.
813
+ # @param [String] quota_user
814
+ # Available to use for quota purposes for server-side applications. Can be any
815
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
816
+ # @param [Google::Apis::RequestOptions] options
817
+ # Request-specific options
818
+ #
819
+ # @yield [result, err] Result & error if block supplied
820
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
821
+ # @yieldparam err [StandardError] error object if request failed
822
+ #
823
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
824
+ #
825
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
826
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
827
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
828
+ def delete_project_location_private_connection_route(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
829
+ command = make_simple_command(:delete, 'v1alpha1/{+name}', options)
830
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
831
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
832
+ command.params['name'] = name unless name.nil?
833
+ command.query['requestId'] = request_id unless request_id.nil?
834
+ command.query['fields'] = fields unless fields.nil?
835
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
836
+ execute_or_queue_command(command, &block)
837
+ end
838
+
839
+ # Use this method to get details about a route.
840
+ # @param [String] name
841
+ # Required. The name of the Route resource to get.
842
+ # @param [String] fields
843
+ # Selector specifying which fields to include in a partial response.
844
+ # @param [String] quota_user
845
+ # Available to use for quota purposes for server-side applications. Can be any
846
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
847
+ # @param [Google::Apis::RequestOptions] options
848
+ # Request-specific options
849
+ #
850
+ # @yield [result, err] Result & error if block supplied
851
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Route] parsed result object
852
+ # @yieldparam err [StandardError] error object if request failed
853
+ #
854
+ # @return [Google::Apis::DatastreamV1alpha1::Route]
855
+ #
856
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
857
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
858
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
859
+ def get_project_location_private_connection_route(name, fields: nil, quota_user: nil, options: nil, &block)
860
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
861
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Route::Representation
862
+ command.response_class = Google::Apis::DatastreamV1alpha1::Route
863
+ command.params['name'] = name unless name.nil?
864
+ command.query['fields'] = fields unless fields.nil?
865
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
866
+ execute_or_queue_command(command, &block)
867
+ end
868
+
869
+ # Use this method to list routes created for a private connectivity in a project
870
+ # and location.
871
+ # @param [String] parent
872
+ # Required. The parent that owns the collection of Routess.
873
+ # @param [String] filter
874
+ # Filter request.
875
+ # @param [String] order_by
876
+ # Order by fields for the result.
877
+ # @param [Fixnum] page_size
878
+ # Maximum number of Routes to return. The service may return fewer than this
879
+ # value. If unspecified, at most 50 Routes will be returned. The maximum value
880
+ # is 1000; values above 1000 will be coerced to 1000.
881
+ # @param [String] page_token
882
+ # Page token received from a previous `ListRoutes` call. Provide this to
883
+ # retrieve the subsequent page. When paginating, all other parameters provided
884
+ # to `ListRoutes` must match the call that provided the page token.
885
+ # @param [String] fields
886
+ # Selector specifying which fields to include in a partial response.
887
+ # @param [String] quota_user
888
+ # Available to use for quota purposes for server-side applications. Can be any
889
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
890
+ # @param [Google::Apis::RequestOptions] options
891
+ # Request-specific options
892
+ #
893
+ # @yield [result, err] Result & error if block supplied
894
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListRoutesResponse] parsed result object
895
+ # @yieldparam err [StandardError] error object if request failed
896
+ #
897
+ # @return [Google::Apis::DatastreamV1alpha1::ListRoutesResponse]
898
+ #
899
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
900
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
901
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
902
+ 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)
903
+ command = make_simple_command(:get, 'v1alpha1/{+parent}/routes', options)
904
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListRoutesResponse::Representation
905
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListRoutesResponse
906
+ command.params['parent'] = parent unless parent.nil?
907
+ command.query['filter'] = filter unless filter.nil?
908
+ command.query['orderBy'] = order_by unless order_by.nil?
909
+ command.query['pageSize'] = page_size unless page_size.nil?
910
+ command.query['pageToken'] = page_token unless page_token.nil?
911
+ command.query['fields'] = fields unless fields.nil?
912
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
913
+ execute_or_queue_command(command, &block)
914
+ end
915
+
916
+ # Use this method to create a stream.
917
+ # @param [String] parent
918
+ # Required. The parent that owns the collection of streams.
919
+ # @param [Google::Apis::DatastreamV1alpha1::Stream] stream_object
920
+ # @param [Boolean] force
921
+ # Optional. Create the stream without validating it.
922
+ # @param [String] request_id
923
+ # Optional. A request ID to identify requests. Specify a unique request ID so
924
+ # that if you must retry your request, the server will know to ignore the
925
+ # request if it has already been completed. The server will guarantee that for
926
+ # at least 60 minutes since the first request. For example, consider a situation
927
+ # where you make an initial request and the request times out. If you make the
928
+ # request again with the same request ID, the server can check if original
929
+ # operation with the same request ID was received, and if so, will ignore the
930
+ # second request. This prevents clients from accidentally creating duplicate
931
+ # commitments. The request ID must be a valid UUID with the exception that zero
932
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
933
+ # @param [String] stream_id
934
+ # Required. The stream identifier.
935
+ # @param [Boolean] validate_only
936
+ # Optional. Only validate the stream, but do not create any resources. The
937
+ # default is false.
938
+ # @param [String] fields
939
+ # Selector specifying which fields to include in a partial response.
940
+ # @param [String] quota_user
941
+ # Available to use for quota purposes for server-side applications. Can be any
942
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
943
+ # @param [Google::Apis::RequestOptions] options
944
+ # Request-specific options
945
+ #
946
+ # @yield [result, err] Result & error if block supplied
947
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
948
+ # @yieldparam err [StandardError] error object if request failed
949
+ #
950
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
951
+ #
952
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
953
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
954
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
955
+ 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)
956
+ command = make_simple_command(:post, 'v1alpha1/{+parent}/streams', options)
957
+ command.request_representation = Google::Apis::DatastreamV1alpha1::Stream::Representation
958
+ command.request_object = stream_object
959
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
960
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
961
+ command.params['parent'] = parent unless parent.nil?
962
+ command.query['force'] = force unless force.nil?
963
+ command.query['requestId'] = request_id unless request_id.nil?
964
+ command.query['streamId'] = stream_id unless stream_id.nil?
965
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
966
+ command.query['fields'] = fields unless fields.nil?
967
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
968
+ execute_or_queue_command(command, &block)
969
+ end
970
+
971
+ # Use this method to delete a stream.
972
+ # @param [String] name
973
+ # Required. The name of the stream resource to delete.
974
+ # @param [String] request_id
975
+ # Optional. A request ID to identify requests. Specify a unique request ID so
976
+ # that if you must retry your request, the server will know to ignore the
977
+ # request if it has already been completed. The server will guarantee that for
978
+ # at least 60 minutes after the first request. For example, consider a situation
979
+ # where you make an initial request and the request times out. If you make the
980
+ # request again with the same request ID, the server can check if original
981
+ # operation with the same request ID was received, and if so, will ignore the
982
+ # second request. This prevents clients from accidentally creating duplicate
983
+ # commitments. The request ID must be a valid UUID with the exception that zero
984
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
985
+ # @param [String] fields
986
+ # Selector specifying which fields to include in a partial response.
987
+ # @param [String] quota_user
988
+ # Available to use for quota purposes for server-side applications. Can be any
989
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
990
+ # @param [Google::Apis::RequestOptions] options
991
+ # Request-specific options
992
+ #
993
+ # @yield [result, err] Result & error if block supplied
994
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
995
+ # @yieldparam err [StandardError] error object if request failed
996
+ #
997
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
998
+ #
999
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1000
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1001
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1002
+ def delete_project_location_stream(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1003
+ command = make_simple_command(:delete, 'v1alpha1/{+name}', options)
1004
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
1005
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
1006
+ command.params['name'] = name unless name.nil?
1007
+ command.query['requestId'] = request_id unless request_id.nil?
1008
+ command.query['fields'] = fields unless fields.nil?
1009
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1010
+ execute_or_queue_command(command, &block)
1011
+ end
1012
+
1013
+ # Use this method to fetch any errors associated with a stream.
1014
+ # @param [String] stream
1015
+ # Name of the Stream resource for which to fetch any errors.
1016
+ # @param [Google::Apis::DatastreamV1alpha1::FetchErrorsRequest] fetch_errors_request_object
1017
+ # @param [String] fields
1018
+ # Selector specifying which fields to include in a partial response.
1019
+ # @param [String] quota_user
1020
+ # Available to use for quota purposes for server-side applications. Can be any
1021
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1022
+ # @param [Google::Apis::RequestOptions] options
1023
+ # Request-specific options
1024
+ #
1025
+ # @yield [result, err] Result & error if block supplied
1026
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
1027
+ # @yieldparam err [StandardError] error object if request failed
1028
+ #
1029
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
1030
+ #
1031
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1032
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1033
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1034
+ def fetch_stream_errors(stream, fetch_errors_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1035
+ command = make_simple_command(:post, 'v1alpha1/{+stream}:fetchErrors', options)
1036
+ command.request_representation = Google::Apis::DatastreamV1alpha1::FetchErrorsRequest::Representation
1037
+ command.request_object = fetch_errors_request_object
1038
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
1039
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
1040
+ command.params['stream'] = stream unless stream.nil?
1041
+ command.query['fields'] = fields unless fields.nil?
1042
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1043
+ execute_or_queue_command(command, &block)
1044
+ end
1045
+
1046
+ # Use this method to get details about a stream.
1047
+ # @param [String] name
1048
+ # Required. The name of the stream resource to get.
1049
+ # @param [String] fields
1050
+ # Selector specifying which fields to include in a partial response.
1051
+ # @param [String] quota_user
1052
+ # Available to use for quota purposes for server-side applications. Can be any
1053
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1054
+ # @param [Google::Apis::RequestOptions] options
1055
+ # Request-specific options
1056
+ #
1057
+ # @yield [result, err] Result & error if block supplied
1058
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Stream] parsed result object
1059
+ # @yieldparam err [StandardError] error object if request failed
1060
+ #
1061
+ # @return [Google::Apis::DatastreamV1alpha1::Stream]
1062
+ #
1063
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1064
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1065
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1066
+ def get_project_location_stream(name, fields: nil, quota_user: nil, options: nil, &block)
1067
+ command = make_simple_command(:get, 'v1alpha1/{+name}', options)
1068
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Stream::Representation
1069
+ command.response_class = Google::Apis::DatastreamV1alpha1::Stream
1070
+ command.params['name'] = name unless name.nil?
1071
+ command.query['fields'] = fields unless fields.nil?
1072
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1073
+ execute_or_queue_command(command, &block)
1074
+ end
1075
+
1076
+ # Use this method to list streams in a project and location.
1077
+ # @param [String] parent
1078
+ # Required. The parent that owns the collection of streams.
1079
+ # @param [String] filter
1080
+ # Filter request.
1081
+ # @param [String] order_by
1082
+ # Order by fields for the result.
1083
+ # @param [Fixnum] page_size
1084
+ # Maximum number of streams to return. If unspecified, at most 50 streams will
1085
+ # be returned. The maximum value is 1000; values above 1000 will be coerced to
1086
+ # 1000.
1087
+ # @param [String] page_token
1088
+ # Page token received from a previous `ListStreams` call. Provide this to
1089
+ # retrieve the subsequent page. When paginating, all other parameters provided
1090
+ # to `ListStreams` must match the call that provided the page token.
1091
+ # @param [String] fields
1092
+ # Selector specifying which fields to include in a partial response.
1093
+ # @param [String] quota_user
1094
+ # Available to use for quota purposes for server-side applications. Can be any
1095
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1096
+ # @param [Google::Apis::RequestOptions] options
1097
+ # Request-specific options
1098
+ #
1099
+ # @yield [result, err] Result & error if block supplied
1100
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::ListStreamsResponse] parsed result object
1101
+ # @yieldparam err [StandardError] error object if request failed
1102
+ #
1103
+ # @return [Google::Apis::DatastreamV1alpha1::ListStreamsResponse]
1104
+ #
1105
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1106
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1107
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1108
+ 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)
1109
+ command = make_simple_command(:get, 'v1alpha1/{+parent}/streams', options)
1110
+ command.response_representation = Google::Apis::DatastreamV1alpha1::ListStreamsResponse::Representation
1111
+ command.response_class = Google::Apis::DatastreamV1alpha1::ListStreamsResponse
1112
+ command.params['parent'] = parent unless parent.nil?
1113
+ command.query['filter'] = filter unless filter.nil?
1114
+ command.query['orderBy'] = order_by unless order_by.nil?
1115
+ command.query['pageSize'] = page_size unless page_size.nil?
1116
+ command.query['pageToken'] = page_token unless page_token.nil?
1117
+ command.query['fields'] = fields unless fields.nil?
1118
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1119
+ execute_or_queue_command(command, &block)
1120
+ end
1121
+
1122
+ # Use this method to update the configuration of a stream.
1123
+ # @param [String] name
1124
+ # Output only. The stream's name.
1125
+ # @param [Google::Apis::DatastreamV1alpha1::Stream] stream_object
1126
+ # @param [Boolean] force
1127
+ # Optional. Execute the update without validating it.
1128
+ # @param [String] request_id
1129
+ # Optional. A request ID to identify requests. Specify a unique request ID so
1130
+ # that if you must retry your request, the server will know to ignore the
1131
+ # request if it has already been completed. The server will guarantee that for
1132
+ # at least 60 minutes since the first request. For example, consider a situation
1133
+ # where you make an initial request and the request times out. If you make the
1134
+ # request again with the same request ID, the server can check if original
1135
+ # operation with the same request ID was received, and if so, will ignore the
1136
+ # second request. This prevents clients from accidentally creating duplicate
1137
+ # commitments. The request ID must be a valid UUID with the exception that zero
1138
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
1139
+ # @param [String] update_mask
1140
+ # Optional. Field mask is used to specify the fields to be overwritten in the
1141
+ # stream resource by the update. The fields specified in the update_mask are
1142
+ # relative to the resource, not the full request. A field will be overwritten if
1143
+ # it is in the mask. If the user does not provide a mask then all fields will be
1144
+ # overwritten.
1145
+ # @param [Boolean] validate_only
1146
+ # Optional. Only validate the stream with the changes, without actually updating
1147
+ # it. The default is false.
1148
+ # @param [String] fields
1149
+ # Selector specifying which fields to include in a partial response.
1150
+ # @param [String] quota_user
1151
+ # Available to use for quota purposes for server-side applications. Can be any
1152
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1153
+ # @param [Google::Apis::RequestOptions] options
1154
+ # Request-specific options
1155
+ #
1156
+ # @yield [result, err] Result & error if block supplied
1157
+ # @yieldparam result [Google::Apis::DatastreamV1alpha1::Operation] parsed result object
1158
+ # @yieldparam err [StandardError] error object if request failed
1159
+ #
1160
+ # @return [Google::Apis::DatastreamV1alpha1::Operation]
1161
+ #
1162
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1163
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1164
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1165
+ 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)
1166
+ command = make_simple_command(:patch, 'v1alpha1/{+name}', options)
1167
+ command.request_representation = Google::Apis::DatastreamV1alpha1::Stream::Representation
1168
+ command.request_object = stream_object
1169
+ command.response_representation = Google::Apis::DatastreamV1alpha1::Operation::Representation
1170
+ command.response_class = Google::Apis::DatastreamV1alpha1::Operation
1171
+ command.params['name'] = name unless name.nil?
1172
+ command.query['force'] = force unless force.nil?
1173
+ command.query['requestId'] = request_id unless request_id.nil?
1174
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1175
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
1176
+ command.query['fields'] = fields unless fields.nil?
1177
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1178
+ execute_or_queue_command(command, &block)
1179
+ end
1180
+
1181
+ protected
1182
+
1183
+ def apply_command_defaults(command)
1184
+ command.query['key'] = key unless key.nil?
1185
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1186
+ end
1187
+ end
1188
+ end
1189
+ end
1190
+ end