google-apis-datastream_v1alpha1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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