google-apis-migrationcenter_v1 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,2269 @@
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 MigrationcenterV1
23
+ # Migration Center API
24
+ #
25
+ # A unified platform that helps you accelerate your end-to-end cloud journey
26
+ # from your current on-premises or cloud environments to Google Cloud.
27
+ #
28
+ # @example
29
+ # require 'google/apis/migrationcenter_v1'
30
+ #
31
+ # Migrationcenter = Google::Apis::MigrationcenterV1 # Alias the module
32
+ # service = Migrationcenter::MigrationCenterAPIService.new
33
+ #
34
+ # @see https://cloud.google.com/migration-center
35
+ class MigrationCenterAPIService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ attr_accessor :quota_user
45
+
46
+ def initialize
47
+ super('https://migrationcenter.googleapis.com/', '',
48
+ client_name: 'google-apis-migrationcenter_v1',
49
+ client_version: Google::Apis::MigrationcenterV1::GEM_VERSION)
50
+ @batch_path = 'batch'
51
+ end
52
+
53
+ # Gets information about a location.
54
+ # @param [String] name
55
+ # Resource name for the location.
56
+ # @param [String] fields
57
+ # Selector specifying which fields to include in a partial response.
58
+ # @param [String] quota_user
59
+ # Available to use for quota purposes for server-side applications. Can be any
60
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
61
+ # @param [Google::Apis::RequestOptions] options
62
+ # Request-specific options
63
+ #
64
+ # @yield [result, err] Result & error if block supplied
65
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Location] parsed result object
66
+ # @yieldparam err [StandardError] error object if request failed
67
+ #
68
+ # @return [Google::Apis::MigrationcenterV1::Location]
69
+ #
70
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
71
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
72
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
73
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
74
+ command = make_simple_command(:get, 'v1/{+name}', options)
75
+ command.response_representation = Google::Apis::MigrationcenterV1::Location::Representation
76
+ command.response_class = Google::Apis::MigrationcenterV1::Location
77
+ command.params['name'] = name unless name.nil?
78
+ command.query['fields'] = fields unless fields.nil?
79
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
80
+ execute_or_queue_command(command, &block)
81
+ end
82
+
83
+ # Gets the details of regional settings.
84
+ # @param [String] name
85
+ # Required. Name of the resource.
86
+ # @param [String] fields
87
+ # Selector specifying which fields to include in a partial response.
88
+ # @param [String] quota_user
89
+ # Available to use for quota purposes for server-side applications. Can be any
90
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
91
+ # @param [Google::Apis::RequestOptions] options
92
+ # Request-specific options
93
+ #
94
+ # @yield [result, err] Result & error if block supplied
95
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Settings] parsed result object
96
+ # @yieldparam err [StandardError] error object if request failed
97
+ #
98
+ # @return [Google::Apis::MigrationcenterV1::Settings]
99
+ #
100
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
101
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
102
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
103
+ def get_project_location_settings(name, fields: nil, quota_user: nil, options: nil, &block)
104
+ command = make_simple_command(:get, 'v1/{+name}', options)
105
+ command.response_representation = Google::Apis::MigrationcenterV1::Settings::Representation
106
+ command.response_class = Google::Apis::MigrationcenterV1::Settings
107
+ command.params['name'] = name unless name.nil?
108
+ command.query['fields'] = fields unless fields.nil?
109
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
110
+ execute_or_queue_command(command, &block)
111
+ end
112
+
113
+ # Lists information about the supported locations for this service.
114
+ # @param [String] name
115
+ # The resource that owns the locations collection, if applicable.
116
+ # @param [String] filter
117
+ # A filter to narrow down results to a preferred subset. The filtering language
118
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
119
+ # in [AIP-160](https://google.aip.dev/160).
120
+ # @param [Fixnum] page_size
121
+ # The maximum number of results to return. If not set, the service selects a
122
+ # default.
123
+ # @param [String] page_token
124
+ # A page token received from the `next_page_token` field in the response. Send
125
+ # that page token to receive the subsequent page.
126
+ # @param [String] fields
127
+ # Selector specifying which fields to include in a partial response.
128
+ # @param [String] quota_user
129
+ # Available to use for quota purposes for server-side applications. Can be any
130
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
131
+ # @param [Google::Apis::RequestOptions] options
132
+ # Request-specific options
133
+ #
134
+ # @yield [result, err] Result & error if block supplied
135
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListLocationsResponse] parsed result object
136
+ # @yieldparam err [StandardError] error object if request failed
137
+ #
138
+ # @return [Google::Apis::MigrationcenterV1::ListLocationsResponse]
139
+ #
140
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
141
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
142
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
143
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
144
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
145
+ command.response_representation = Google::Apis::MigrationcenterV1::ListLocationsResponse::Representation
146
+ command.response_class = Google::Apis::MigrationcenterV1::ListLocationsResponse
147
+ command.params['name'] = name unless name.nil?
148
+ command.query['filter'] = filter unless filter.nil?
149
+ command.query['pageSize'] = page_size unless page_size.nil?
150
+ command.query['pageToken'] = page_token unless page_token.nil?
151
+ command.query['fields'] = fields unless fields.nil?
152
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
153
+ execute_or_queue_command(command, &block)
154
+ end
155
+
156
+ # Updates the regional-level project settings.
157
+ # @param [String] name
158
+ # Output only. The name of the resource.
159
+ # @param [Google::Apis::MigrationcenterV1::Settings] settings_object
160
+ # @param [String] request_id
161
+ # Optional. An optional request ID to identify requests. Specify a unique
162
+ # request ID so that if you must retry your request, the server will know to
163
+ # ignore the request if it has already been completed. The server will guarantee
164
+ # that for at least 60 minutes since the first request. For example, consider a
165
+ # situation where you make an initial request and the request times out. If you
166
+ # make the request again with the same request ID, the server can check if
167
+ # original operation with the same request ID was received, and if so, will
168
+ # ignore the second request. This prevents clients from accidentally creating
169
+ # duplicate commitments. The request ID must be a valid UUID with the exception
170
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
171
+ # @param [String] update_mask
172
+ # Required. Field mask is used to specify the fields to be overwritten in the `
173
+ # Settings` resource by the update. The values specified in the `update_mask`
174
+ # field are relative to the resource, not the full request. A field will be
175
+ # overwritten if it is in the mask. A single * value in the mask lets you to
176
+ # overwrite all fields.
177
+ # @param [String] fields
178
+ # Selector specifying which fields to include in a partial response.
179
+ # @param [String] quota_user
180
+ # Available to use for quota purposes for server-side applications. Can be any
181
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
182
+ # @param [Google::Apis::RequestOptions] options
183
+ # Request-specific options
184
+ #
185
+ # @yield [result, err] Result & error if block supplied
186
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
187
+ # @yieldparam err [StandardError] error object if request failed
188
+ #
189
+ # @return [Google::Apis::MigrationcenterV1::Operation]
190
+ #
191
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
192
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
193
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
194
+ def update_project_location_settings(name, settings_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
195
+ command = make_simple_command(:patch, 'v1/{+name}', options)
196
+ command.request_representation = Google::Apis::MigrationcenterV1::Settings::Representation
197
+ command.request_object = settings_object
198
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
199
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
200
+ command.params['name'] = name unless name.nil?
201
+ command.query['requestId'] = request_id unless request_id.nil?
202
+ command.query['updateMask'] = update_mask unless update_mask.nil?
203
+ command.query['fields'] = fields unless fields.nil?
204
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
205
+ execute_or_queue_command(command, &block)
206
+ end
207
+
208
+ # Aggregates the requested fields based on provided function.
209
+ # @param [String] parent
210
+ # Required. Parent value for `AggregateAssetsValuesRequest`.
211
+ # @param [Google::Apis::MigrationcenterV1::AggregateAssetsValuesRequest] aggregate_assets_values_request_object
212
+ # @param [String] fields
213
+ # Selector specifying which fields to include in a partial response.
214
+ # @param [String] quota_user
215
+ # Available to use for quota purposes for server-side applications. Can be any
216
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
217
+ # @param [Google::Apis::RequestOptions] options
218
+ # Request-specific options
219
+ #
220
+ # @yield [result, err] Result & error if block supplied
221
+ # @yieldparam result [Google::Apis::MigrationcenterV1::AggregateAssetsValuesResponse] parsed result object
222
+ # @yieldparam err [StandardError] error object if request failed
223
+ #
224
+ # @return [Google::Apis::MigrationcenterV1::AggregateAssetsValuesResponse]
225
+ #
226
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
227
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
228
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
229
+ def aggregate_project_location_asset_values(parent, aggregate_assets_values_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
230
+ command = make_simple_command(:post, 'v1/{+parent}/assets:aggregateValues', options)
231
+ command.request_representation = Google::Apis::MigrationcenterV1::AggregateAssetsValuesRequest::Representation
232
+ command.request_object = aggregate_assets_values_request_object
233
+ command.response_representation = Google::Apis::MigrationcenterV1::AggregateAssetsValuesResponse::Representation
234
+ command.response_class = Google::Apis::MigrationcenterV1::AggregateAssetsValuesResponse
235
+ command.params['parent'] = parent unless parent.nil?
236
+ command.query['fields'] = fields unless fields.nil?
237
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
238
+ execute_or_queue_command(command, &block)
239
+ end
240
+
241
+ # Deletes list of Assets.
242
+ # @param [String] parent
243
+ # Required. Parent value for batch asset delete.
244
+ # @param [Google::Apis::MigrationcenterV1::BatchDeleteAssetsRequest] batch_delete_assets_request_object
245
+ # @param [String] fields
246
+ # Selector specifying which fields to include in a partial response.
247
+ # @param [String] quota_user
248
+ # Available to use for quota purposes for server-side applications. Can be any
249
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
250
+ # @param [Google::Apis::RequestOptions] options
251
+ # Request-specific options
252
+ #
253
+ # @yield [result, err] Result & error if block supplied
254
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Empty] parsed result object
255
+ # @yieldparam err [StandardError] error object if request failed
256
+ #
257
+ # @return [Google::Apis::MigrationcenterV1::Empty]
258
+ #
259
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
260
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
261
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
262
+ def batch_delete_assets(parent, batch_delete_assets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
263
+ command = make_simple_command(:post, 'v1/{+parent}/assets:batchDelete', options)
264
+ command.request_representation = Google::Apis::MigrationcenterV1::BatchDeleteAssetsRequest::Representation
265
+ command.request_object = batch_delete_assets_request_object
266
+ command.response_representation = Google::Apis::MigrationcenterV1::Empty::Representation
267
+ command.response_class = Google::Apis::MigrationcenterV1::Empty
268
+ command.params['parent'] = parent unless parent.nil?
269
+ command.query['fields'] = fields unless fields.nil?
270
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
271
+ execute_or_queue_command(command, &block)
272
+ end
273
+
274
+ # Updates the parameters of a list of assets.
275
+ # @param [String] parent
276
+ # Required. Parent value for batch asset update.
277
+ # @param [Google::Apis::MigrationcenterV1::BatchUpdateAssetsRequest] batch_update_assets_request_object
278
+ # @param [String] fields
279
+ # Selector specifying which fields to include in a partial response.
280
+ # @param [String] quota_user
281
+ # Available to use for quota purposes for server-side applications. Can be any
282
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
283
+ # @param [Google::Apis::RequestOptions] options
284
+ # Request-specific options
285
+ #
286
+ # @yield [result, err] Result & error if block supplied
287
+ # @yieldparam result [Google::Apis::MigrationcenterV1::BatchUpdateAssetsResponse] parsed result object
288
+ # @yieldparam err [StandardError] error object if request failed
289
+ #
290
+ # @return [Google::Apis::MigrationcenterV1::BatchUpdateAssetsResponse]
291
+ #
292
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
293
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
294
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
295
+ def batch_update_assets(parent, batch_update_assets_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
296
+ command = make_simple_command(:post, 'v1/{+parent}/assets:batchUpdate', options)
297
+ command.request_representation = Google::Apis::MigrationcenterV1::BatchUpdateAssetsRequest::Representation
298
+ command.request_object = batch_update_assets_request_object
299
+ command.response_representation = Google::Apis::MigrationcenterV1::BatchUpdateAssetsResponse::Representation
300
+ command.response_class = Google::Apis::MigrationcenterV1::BatchUpdateAssetsResponse
301
+ command.params['parent'] = parent unless parent.nil?
302
+ command.query['fields'] = fields unless fields.nil?
303
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
304
+ execute_or_queue_command(command, &block)
305
+ end
306
+
307
+ # Deletes an asset.
308
+ # @param [String] name
309
+ # Required. Name of the resource.
310
+ # @param [String] request_id
311
+ # Optional. An optional request ID to identify requests. Specify a unique
312
+ # request ID so that if you must retry your request, the server will know to
313
+ # ignore the request if it has already been completed. The server will guarantee
314
+ # that for at least 60 minutes after the first request. For example, consider a
315
+ # situation where you make an initial request and the request times out. If you
316
+ # make the request again with the same request ID, the server can check if
317
+ # original operation with the same request ID was received, and if so, will
318
+ # ignore the second request. This prevents clients from accidentally creating
319
+ # duplicate commitments. The request ID must be a valid UUID with the exception
320
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
321
+ # @param [String] fields
322
+ # Selector specifying which fields to include in a partial response.
323
+ # @param [String] quota_user
324
+ # Available to use for quota purposes for server-side applications. Can be any
325
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
326
+ # @param [Google::Apis::RequestOptions] options
327
+ # Request-specific options
328
+ #
329
+ # @yield [result, err] Result & error if block supplied
330
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Empty] parsed result object
331
+ # @yieldparam err [StandardError] error object if request failed
332
+ #
333
+ # @return [Google::Apis::MigrationcenterV1::Empty]
334
+ #
335
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
336
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
337
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
338
+ def delete_project_location_asset(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
339
+ command = make_simple_command(:delete, 'v1/{+name}', options)
340
+ command.response_representation = Google::Apis::MigrationcenterV1::Empty::Representation
341
+ command.response_class = Google::Apis::MigrationcenterV1::Empty
342
+ command.params['name'] = name unless name.nil?
343
+ command.query['requestId'] = request_id unless request_id.nil?
344
+ command.query['fields'] = fields unless fields.nil?
345
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
346
+ execute_or_queue_command(command, &block)
347
+ end
348
+
349
+ # Gets the details of an asset.
350
+ # @param [String] name
351
+ # Required. Name of the resource.
352
+ # @param [String] view
353
+ # View of the assets. Defaults to BASIC.
354
+ # @param [String] fields
355
+ # Selector specifying which fields to include in a partial response.
356
+ # @param [String] quota_user
357
+ # Available to use for quota purposes for server-side applications. Can be any
358
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
359
+ # @param [Google::Apis::RequestOptions] options
360
+ # Request-specific options
361
+ #
362
+ # @yield [result, err] Result & error if block supplied
363
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Asset] parsed result object
364
+ # @yieldparam err [StandardError] error object if request failed
365
+ #
366
+ # @return [Google::Apis::MigrationcenterV1::Asset]
367
+ #
368
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
369
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
370
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
371
+ def get_project_location_asset(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
372
+ command = make_simple_command(:get, 'v1/{+name}', options)
373
+ command.response_representation = Google::Apis::MigrationcenterV1::Asset::Representation
374
+ command.response_class = Google::Apis::MigrationcenterV1::Asset
375
+ command.params['name'] = name unless name.nil?
376
+ command.query['view'] = view unless view.nil?
377
+ command.query['fields'] = fields unless fields.nil?
378
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
379
+ execute_or_queue_command(command, &block)
380
+ end
381
+
382
+ # Lists all the assets in a given project and location.
383
+ # @param [String] parent
384
+ # Required. Parent value for `ListAssetsRequest`.
385
+ # @param [String] filter
386
+ # Filtering results.
387
+ # @param [String] order_by
388
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
389
+ # @param [Fixnum] page_size
390
+ # Requested page size. Server may return fewer items than requested. If
391
+ # unspecified, server will pick an appropriate default.
392
+ # @param [String] page_token
393
+ # A token identifying a page of results the server should return.
394
+ # @param [String] view
395
+ # View of the assets. Defaults to BASIC.
396
+ # @param [String] fields
397
+ # Selector specifying which fields to include in a partial response.
398
+ # @param [String] quota_user
399
+ # Available to use for quota purposes for server-side applications. Can be any
400
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
401
+ # @param [Google::Apis::RequestOptions] options
402
+ # Request-specific options
403
+ #
404
+ # @yield [result, err] Result & error if block supplied
405
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListAssetsResponse] parsed result object
406
+ # @yieldparam err [StandardError] error object if request failed
407
+ #
408
+ # @return [Google::Apis::MigrationcenterV1::ListAssetsResponse]
409
+ #
410
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
411
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
412
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
413
+ def list_project_location_assets(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
414
+ command = make_simple_command(:get, 'v1/{+parent}/assets', options)
415
+ command.response_representation = Google::Apis::MigrationcenterV1::ListAssetsResponse::Representation
416
+ command.response_class = Google::Apis::MigrationcenterV1::ListAssetsResponse
417
+ command.params['parent'] = parent unless parent.nil?
418
+ command.query['filter'] = filter unless filter.nil?
419
+ command.query['orderBy'] = order_by unless order_by.nil?
420
+ command.query['pageSize'] = page_size unless page_size.nil?
421
+ command.query['pageToken'] = page_token unless page_token.nil?
422
+ command.query['view'] = view unless view.nil?
423
+ command.query['fields'] = fields unless fields.nil?
424
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
425
+ execute_or_queue_command(command, &block)
426
+ end
427
+
428
+ # Updates the parameters of an asset.
429
+ # @param [String] name
430
+ # Output only. The full name of the asset.
431
+ # @param [Google::Apis::MigrationcenterV1::Asset] asset_object
432
+ # @param [String] request_id
433
+ # Optional. An optional request ID to identify requests. Specify a unique
434
+ # request ID so that if you must retry your request, the server will know to
435
+ # ignore the request if it has already been completed. The server will guarantee
436
+ # that for at least 60 minutes since the first request. For example, consider a
437
+ # situation where you make an initial request and the request times out. If you
438
+ # make the request again with the same request ID, the server can check if
439
+ # original operation with the same request ID was received, and if so, will
440
+ # ignore the second request. This prevents clients from accidentally creating
441
+ # duplicate commitments. The request ID must be a valid UUID with the exception
442
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
443
+ # @param [String] update_mask
444
+ # Required. Field mask is used to specify the fields to be overwritten in the `
445
+ # Asset` resource by the update. The values specified in the `update_mask` field
446
+ # are relative to the resource, not the full request. A field will be
447
+ # overwritten if it is in the mask. A single * value in the mask lets you to
448
+ # overwrite all fields.
449
+ # @param [String] fields
450
+ # Selector specifying which fields to include in a partial response.
451
+ # @param [String] quota_user
452
+ # Available to use for quota purposes for server-side applications. Can be any
453
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
454
+ # @param [Google::Apis::RequestOptions] options
455
+ # Request-specific options
456
+ #
457
+ # @yield [result, err] Result & error if block supplied
458
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Asset] parsed result object
459
+ # @yieldparam err [StandardError] error object if request failed
460
+ #
461
+ # @return [Google::Apis::MigrationcenterV1::Asset]
462
+ #
463
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
464
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
465
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
466
+ def patch_project_location_asset(name, asset_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
467
+ command = make_simple_command(:patch, 'v1/{+name}', options)
468
+ command.request_representation = Google::Apis::MigrationcenterV1::Asset::Representation
469
+ command.request_object = asset_object
470
+ command.response_representation = Google::Apis::MigrationcenterV1::Asset::Representation
471
+ command.response_class = Google::Apis::MigrationcenterV1::Asset
472
+ command.params['name'] = name unless name.nil?
473
+ command.query['requestId'] = request_id unless request_id.nil?
474
+ command.query['updateMask'] = update_mask unless update_mask.nil?
475
+ command.query['fields'] = fields unless fields.nil?
476
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
477
+ execute_or_queue_command(command, &block)
478
+ end
479
+
480
+ # Reports a set of frames.
481
+ # @param [String] parent
482
+ # Required. Parent of the resource.
483
+ # @param [Google::Apis::MigrationcenterV1::Frames] frames_object
484
+ # @param [String] source
485
+ # Required. Reference to a source.
486
+ # @param [String] fields
487
+ # Selector specifying which fields to include in a partial response.
488
+ # @param [String] quota_user
489
+ # Available to use for quota purposes for server-side applications. Can be any
490
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
491
+ # @param [Google::Apis::RequestOptions] options
492
+ # Request-specific options
493
+ #
494
+ # @yield [result, err] Result & error if block supplied
495
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ReportAssetFramesResponse] parsed result object
496
+ # @yieldparam err [StandardError] error object if request failed
497
+ #
498
+ # @return [Google::Apis::MigrationcenterV1::ReportAssetFramesResponse]
499
+ #
500
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
501
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
502
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
503
+ def report_project_location_asset_asset_frames(parent, frames_object = nil, source: nil, fields: nil, quota_user: nil, options: nil, &block)
504
+ command = make_simple_command(:post, 'v1/{+parent}/assets:reportAssetFrames', options)
505
+ command.request_representation = Google::Apis::MigrationcenterV1::Frames::Representation
506
+ command.request_object = frames_object
507
+ command.response_representation = Google::Apis::MigrationcenterV1::ReportAssetFramesResponse::Representation
508
+ command.response_class = Google::Apis::MigrationcenterV1::ReportAssetFramesResponse
509
+ command.params['parent'] = parent unless parent.nil?
510
+ command.query['source'] = source unless source.nil?
511
+ command.query['fields'] = fields unless fields.nil?
512
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
513
+ execute_or_queue_command(command, &block)
514
+ end
515
+
516
+ # Adds assets to a group.
517
+ # @param [String] group
518
+ # Required. Group reference.
519
+ # @param [Google::Apis::MigrationcenterV1::AddAssetsToGroupRequest] add_assets_to_group_request_object
520
+ # @param [String] fields
521
+ # Selector specifying which fields to include in a partial response.
522
+ # @param [String] quota_user
523
+ # Available to use for quota purposes for server-side applications. Can be any
524
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
525
+ # @param [Google::Apis::RequestOptions] options
526
+ # Request-specific options
527
+ #
528
+ # @yield [result, err] Result & error if block supplied
529
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
530
+ # @yieldparam err [StandardError] error object if request failed
531
+ #
532
+ # @return [Google::Apis::MigrationcenterV1::Operation]
533
+ #
534
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
535
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
536
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
537
+ def add_assets_to_group(group, add_assets_to_group_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
538
+ command = make_simple_command(:post, 'v1/{+group}:addAssets', options)
539
+ command.request_representation = Google::Apis::MigrationcenterV1::AddAssetsToGroupRequest::Representation
540
+ command.request_object = add_assets_to_group_request_object
541
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
542
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
543
+ command.params['group'] = group unless group.nil?
544
+ command.query['fields'] = fields unless fields.nil?
545
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
546
+ execute_or_queue_command(command, &block)
547
+ end
548
+
549
+ # Creates a new group in a given project and location.
550
+ # @param [String] parent
551
+ # Required. Value for parent.
552
+ # @param [Google::Apis::MigrationcenterV1::Group] group_object
553
+ # @param [String] group_id
554
+ # Required. User specified ID for the group. It will become the last component
555
+ # of the group name. The ID must be unique within the project, must conform with
556
+ # RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63
557
+ # characters. The ID must match the regular expression: `[a-z]([a-z0-9-]`0,61`[a-
558
+ # z0-9])?`.
559
+ # @param [String] request_id
560
+ # Optional. An optional request ID to identify requests. Specify a unique
561
+ # request ID so that if you must retry your request, the server will know to
562
+ # ignore the request if it has already been completed. The server will guarantee
563
+ # that for at least 60 minutes since the first request. For example, consider a
564
+ # situation where you make an initial request and the request times out. If you
565
+ # make the request again with the same request ID, the server can check if
566
+ # original operation with the same request ID was received, and if so, will
567
+ # ignore the second request. This prevents clients from accidentally creating
568
+ # duplicate commitments. The request ID must be a valid UUID with the exception
569
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
570
+ # @param [String] fields
571
+ # Selector specifying which fields to include in a partial response.
572
+ # @param [String] quota_user
573
+ # Available to use for quota purposes for server-side applications. Can be any
574
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
575
+ # @param [Google::Apis::RequestOptions] options
576
+ # Request-specific options
577
+ #
578
+ # @yield [result, err] Result & error if block supplied
579
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
580
+ # @yieldparam err [StandardError] error object if request failed
581
+ #
582
+ # @return [Google::Apis::MigrationcenterV1::Operation]
583
+ #
584
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
585
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
586
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
587
+ def create_project_location_group(parent, group_object = nil, group_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
588
+ command = make_simple_command(:post, 'v1/{+parent}/groups', options)
589
+ command.request_representation = Google::Apis::MigrationcenterV1::Group::Representation
590
+ command.request_object = group_object
591
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
592
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
593
+ command.params['parent'] = parent unless parent.nil?
594
+ command.query['groupId'] = group_id unless group_id.nil?
595
+ command.query['requestId'] = request_id unless request_id.nil?
596
+ command.query['fields'] = fields unless fields.nil?
597
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
598
+ execute_or_queue_command(command, &block)
599
+ end
600
+
601
+ # Deletes a group.
602
+ # @param [String] name
603
+ # Required. Name of the group resource.
604
+ # @param [String] request_id
605
+ # Optional. An optional request ID to identify requests. Specify a unique
606
+ # request ID so that if you must retry your request, the server will know to
607
+ # ignore the request if it has already been completed. The server will guarantee
608
+ # that for at least 60 minutes after the first request. For example, consider a
609
+ # situation where you make an initial request and the request times out. If you
610
+ # make the request again with the same request ID, the server can check if
611
+ # original operation with the same request ID was received, and if so, will
612
+ # ignore the second request. This prevents clients from accidentally creating
613
+ # duplicate commitments. The request ID must be a valid UUID with the exception
614
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
615
+ # @param [String] fields
616
+ # Selector specifying which fields to include in a partial response.
617
+ # @param [String] quota_user
618
+ # Available to use for quota purposes for server-side applications. Can be any
619
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
620
+ # @param [Google::Apis::RequestOptions] options
621
+ # Request-specific options
622
+ #
623
+ # @yield [result, err] Result & error if block supplied
624
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
625
+ # @yieldparam err [StandardError] error object if request failed
626
+ #
627
+ # @return [Google::Apis::MigrationcenterV1::Operation]
628
+ #
629
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
630
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
631
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
632
+ def delete_project_location_group(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
633
+ command = make_simple_command(:delete, 'v1/{+name}', options)
634
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
635
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
636
+ command.params['name'] = name unless name.nil?
637
+ command.query['requestId'] = request_id unless request_id.nil?
638
+ command.query['fields'] = fields unless fields.nil?
639
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
640
+ execute_or_queue_command(command, &block)
641
+ end
642
+
643
+ # Gets the details of a group.
644
+ # @param [String] name
645
+ # Required. Name of the resource.
646
+ # @param [String] fields
647
+ # Selector specifying which fields to include in a partial response.
648
+ # @param [String] quota_user
649
+ # Available to use for quota purposes for server-side applications. Can be any
650
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
651
+ # @param [Google::Apis::RequestOptions] options
652
+ # Request-specific options
653
+ #
654
+ # @yield [result, err] Result & error if block supplied
655
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Group] parsed result object
656
+ # @yieldparam err [StandardError] error object if request failed
657
+ #
658
+ # @return [Google::Apis::MigrationcenterV1::Group]
659
+ #
660
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
661
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
662
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
663
+ def get_project_location_group(name, fields: nil, quota_user: nil, options: nil, &block)
664
+ command = make_simple_command(:get, 'v1/{+name}', options)
665
+ command.response_representation = Google::Apis::MigrationcenterV1::Group::Representation
666
+ command.response_class = Google::Apis::MigrationcenterV1::Group
667
+ command.params['name'] = name unless name.nil?
668
+ command.query['fields'] = fields unless fields.nil?
669
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
670
+ execute_or_queue_command(command, &block)
671
+ end
672
+
673
+ # Lists all groups in a given project and location.
674
+ # @param [String] parent
675
+ # Required. Parent value for `ListGroupsRequest`.
676
+ # @param [String] filter
677
+ # Filtering results.
678
+ # @param [String] order_by
679
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
680
+ # @param [Fixnum] page_size
681
+ # Requested page size. Server may return fewer items than requested. If
682
+ # unspecified, server will pick an appropriate default.
683
+ # @param [String] page_token
684
+ # A token identifying a page of results the server should return.
685
+ # @param [String] fields
686
+ # Selector specifying which fields to include in a partial response.
687
+ # @param [String] quota_user
688
+ # Available to use for quota purposes for server-side applications. Can be any
689
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
690
+ # @param [Google::Apis::RequestOptions] options
691
+ # Request-specific options
692
+ #
693
+ # @yield [result, err] Result & error if block supplied
694
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListGroupsResponse] parsed result object
695
+ # @yieldparam err [StandardError] error object if request failed
696
+ #
697
+ # @return [Google::Apis::MigrationcenterV1::ListGroupsResponse]
698
+ #
699
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
700
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
701
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
702
+ def list_project_location_groups(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
703
+ command = make_simple_command(:get, 'v1/{+parent}/groups', options)
704
+ command.response_representation = Google::Apis::MigrationcenterV1::ListGroupsResponse::Representation
705
+ command.response_class = Google::Apis::MigrationcenterV1::ListGroupsResponse
706
+ command.params['parent'] = parent unless parent.nil?
707
+ command.query['filter'] = filter unless filter.nil?
708
+ command.query['orderBy'] = order_by unless order_by.nil?
709
+ command.query['pageSize'] = page_size unless page_size.nil?
710
+ command.query['pageToken'] = page_token unless page_token.nil?
711
+ command.query['fields'] = fields unless fields.nil?
712
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
713
+ execute_or_queue_command(command, &block)
714
+ end
715
+
716
+ # Updates the parameters of a group.
717
+ # @param [String] name
718
+ # Output only. The name of the group.
719
+ # @param [Google::Apis::MigrationcenterV1::Group] group_object
720
+ # @param [String] request_id
721
+ # Optional. An optional request ID to identify requests. Specify a unique
722
+ # request ID so that if you must retry your request, the server will know to
723
+ # ignore the request if it has already been completed. The server will guarantee
724
+ # that for at least 60 minutes since the first request. For example, consider a
725
+ # situation where you make an initial request and the request times out. If you
726
+ # make the request again with the same request ID, the server can check if
727
+ # original operation with the same request ID was received, and if so, will
728
+ # ignore the second request. This prevents clients from accidentally creating
729
+ # duplicate commitments. The request ID must be a valid UUID with the exception
730
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
731
+ # @param [String] update_mask
732
+ # Required. Field mask is used to specify the fields to be overwritten in the `
733
+ # Group` resource by the update. The values specified in the `update_mask` are
734
+ # relative to the resource, not the full request. A field will be overwritten if
735
+ # it is in the mask. A single * value in the mask lets you to overwrite all
736
+ # fields.
737
+ # @param [String] fields
738
+ # Selector specifying which fields to include in a partial response.
739
+ # @param [String] quota_user
740
+ # Available to use for quota purposes for server-side applications. Can be any
741
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
742
+ # @param [Google::Apis::RequestOptions] options
743
+ # Request-specific options
744
+ #
745
+ # @yield [result, err] Result & error if block supplied
746
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
747
+ # @yieldparam err [StandardError] error object if request failed
748
+ #
749
+ # @return [Google::Apis::MigrationcenterV1::Operation]
750
+ #
751
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
752
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
753
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
754
+ def patch_project_location_group(name, group_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
755
+ command = make_simple_command(:patch, 'v1/{+name}', options)
756
+ command.request_representation = Google::Apis::MigrationcenterV1::Group::Representation
757
+ command.request_object = group_object
758
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
759
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
760
+ command.params['name'] = name unless name.nil?
761
+ command.query['requestId'] = request_id unless request_id.nil?
762
+ command.query['updateMask'] = update_mask unless update_mask.nil?
763
+ command.query['fields'] = fields unless fields.nil?
764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
765
+ execute_or_queue_command(command, &block)
766
+ end
767
+
768
+ # Removes assets from a group.
769
+ # @param [String] group
770
+ # Required. Group reference.
771
+ # @param [Google::Apis::MigrationcenterV1::RemoveAssetsFromGroupRequest] remove_assets_from_group_request_object
772
+ # @param [String] fields
773
+ # Selector specifying which fields to include in a partial response.
774
+ # @param [String] quota_user
775
+ # Available to use for quota purposes for server-side applications. Can be any
776
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
777
+ # @param [Google::Apis::RequestOptions] options
778
+ # Request-specific options
779
+ #
780
+ # @yield [result, err] Result & error if block supplied
781
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
782
+ # @yieldparam err [StandardError] error object if request failed
783
+ #
784
+ # @return [Google::Apis::MigrationcenterV1::Operation]
785
+ #
786
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
787
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
788
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
789
+ def remove_assets_from_group(group, remove_assets_from_group_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
790
+ command = make_simple_command(:post, 'v1/{+group}:removeAssets', options)
791
+ command.request_representation = Google::Apis::MigrationcenterV1::RemoveAssetsFromGroupRequest::Representation
792
+ command.request_object = remove_assets_from_group_request_object
793
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
794
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
795
+ command.params['group'] = group unless group.nil?
796
+ command.query['fields'] = fields unless fields.nil?
797
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
798
+ execute_or_queue_command(command, &block)
799
+ end
800
+
801
+ # Creates an import job.
802
+ # @param [String] parent
803
+ # Required. Value for parent.
804
+ # @param [Google::Apis::MigrationcenterV1::ImportJob] import_job_object
805
+ # @param [String] import_job_id
806
+ # Required. ID of the import job.
807
+ # @param [String] request_id
808
+ # Optional. An optional request ID to identify requests. Specify a unique
809
+ # request ID so that if you must retry your request, the server will know to
810
+ # ignore the request if it has already been completed. The server will guarantee
811
+ # that for at least 60 minutes since the first request. For example, consider a
812
+ # situation where you make an initial request and the request times out. If you
813
+ # make the request again with the same request ID, the server can check if
814
+ # original operation with the same request ID was received, and if so, will
815
+ # ignore the second request. This prevents clients from accidentally creating
816
+ # duplicate commitments. The request ID must be a valid UUID with the exception
817
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
818
+ # @param [String] fields
819
+ # Selector specifying which fields to include in a partial response.
820
+ # @param [String] quota_user
821
+ # Available to use for quota purposes for server-side applications. Can be any
822
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
823
+ # @param [Google::Apis::RequestOptions] options
824
+ # Request-specific options
825
+ #
826
+ # @yield [result, err] Result & error if block supplied
827
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
828
+ # @yieldparam err [StandardError] error object if request failed
829
+ #
830
+ # @return [Google::Apis::MigrationcenterV1::Operation]
831
+ #
832
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
833
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
834
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
835
+ def create_project_location_import_job(parent, import_job_object = nil, import_job_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
836
+ command = make_simple_command(:post, 'v1/{+parent}/importJobs', options)
837
+ command.request_representation = Google::Apis::MigrationcenterV1::ImportJob::Representation
838
+ command.request_object = import_job_object
839
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
840
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
841
+ command.params['parent'] = parent unless parent.nil?
842
+ command.query['importJobId'] = import_job_id unless import_job_id.nil?
843
+ command.query['requestId'] = request_id unless request_id.nil?
844
+ command.query['fields'] = fields unless fields.nil?
845
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
846
+ execute_or_queue_command(command, &block)
847
+ end
848
+
849
+ # Deletes an import job.
850
+ # @param [String] name
851
+ # Required. Name of the resource.
852
+ # @param [Boolean] force
853
+ # Optional. If set to `true`, any `ImportDataFiles` of this job will also be
854
+ # deleted If set to `false`, the request only works if the job has no data files.
855
+ # @param [String] request_id
856
+ # Optional. An optional request ID to identify requests. Specify a unique
857
+ # request ID so that if you must retry your request, the server will know to
858
+ # ignore the request if it has already been completed. The server will guarantee
859
+ # that for at least 60 minutes after the first request. For example, consider a
860
+ # situation where you make an initial request and the request times out. If you
861
+ # make the request again with the same request ID, the server can check if
862
+ # original operation with the same request ID was received, and if so, will
863
+ # ignore the second request. This prevents clients from accidentally creating
864
+ # duplicate commitments. The request ID must be a valid UUID with the exception
865
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
866
+ # @param [String] fields
867
+ # Selector specifying which fields to include in a partial response.
868
+ # @param [String] quota_user
869
+ # Available to use for quota purposes for server-side applications. Can be any
870
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
871
+ # @param [Google::Apis::RequestOptions] options
872
+ # Request-specific options
873
+ #
874
+ # @yield [result, err] Result & error if block supplied
875
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
876
+ # @yieldparam err [StandardError] error object if request failed
877
+ #
878
+ # @return [Google::Apis::MigrationcenterV1::Operation]
879
+ #
880
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
881
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
882
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
883
+ def delete_project_location_import_job(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
884
+ command = make_simple_command(:delete, 'v1/{+name}', options)
885
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
886
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
887
+ command.params['name'] = name unless name.nil?
888
+ command.query['force'] = force unless force.nil?
889
+ command.query['requestId'] = request_id unless request_id.nil?
890
+ command.query['fields'] = fields unless fields.nil?
891
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
892
+ execute_or_queue_command(command, &block)
893
+ end
894
+
895
+ # Gets the details of an import job.
896
+ # @param [String] name
897
+ # Required. Name of the resource.
898
+ # @param [String] view
899
+ # Optional. The level of details of the import job. Default value is FULL.
900
+ # @param [String] fields
901
+ # Selector specifying which fields to include in a partial response.
902
+ # @param [String] quota_user
903
+ # Available to use for quota purposes for server-side applications. Can be any
904
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
905
+ # @param [Google::Apis::RequestOptions] options
906
+ # Request-specific options
907
+ #
908
+ # @yield [result, err] Result & error if block supplied
909
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ImportJob] parsed result object
910
+ # @yieldparam err [StandardError] error object if request failed
911
+ #
912
+ # @return [Google::Apis::MigrationcenterV1::ImportJob]
913
+ #
914
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
915
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
916
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
917
+ def get_project_location_import_job(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
918
+ command = make_simple_command(:get, 'v1/{+name}', options)
919
+ command.response_representation = Google::Apis::MigrationcenterV1::ImportJob::Representation
920
+ command.response_class = Google::Apis::MigrationcenterV1::ImportJob
921
+ command.params['name'] = name unless name.nil?
922
+ command.query['view'] = view unless view.nil?
923
+ command.query['fields'] = fields unless fields.nil?
924
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
925
+ execute_or_queue_command(command, &block)
926
+ end
927
+
928
+ # Lists all import jobs.
929
+ # @param [String] parent
930
+ # Required. Parent value for `ListImportJobsRequest`.
931
+ # @param [String] filter
932
+ # Filtering results.
933
+ # @param [String] order_by
934
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
935
+ # @param [Fixnum] page_size
936
+ # Requested page size. Server may return fewer items than requested. If
937
+ # unspecified, server will pick an appropriate default.
938
+ # @param [String] page_token
939
+ # A token identifying a page of results the server should return.
940
+ # @param [String] view
941
+ # Optional. The level of details of each import job. Default value is BASIC.
942
+ # @param [String] fields
943
+ # Selector specifying which fields to include in a partial response.
944
+ # @param [String] quota_user
945
+ # Available to use for quota purposes for server-side applications. Can be any
946
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
947
+ # @param [Google::Apis::RequestOptions] options
948
+ # Request-specific options
949
+ #
950
+ # @yield [result, err] Result & error if block supplied
951
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListImportJobsResponse] parsed result object
952
+ # @yieldparam err [StandardError] error object if request failed
953
+ #
954
+ # @return [Google::Apis::MigrationcenterV1::ListImportJobsResponse]
955
+ #
956
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
957
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
958
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
959
+ def list_project_location_import_jobs(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
960
+ command = make_simple_command(:get, 'v1/{+parent}/importJobs', options)
961
+ command.response_representation = Google::Apis::MigrationcenterV1::ListImportJobsResponse::Representation
962
+ command.response_class = Google::Apis::MigrationcenterV1::ListImportJobsResponse
963
+ command.params['parent'] = parent unless parent.nil?
964
+ command.query['filter'] = filter unless filter.nil?
965
+ command.query['orderBy'] = order_by unless order_by.nil?
966
+ command.query['pageSize'] = page_size unless page_size.nil?
967
+ command.query['pageToken'] = page_token unless page_token.nil?
968
+ command.query['view'] = view unless view.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Updates an import job.
975
+ # @param [String] name
976
+ # Output only. The full name of the import job.
977
+ # @param [Google::Apis::MigrationcenterV1::ImportJob] import_job_object
978
+ # @param [String] request_id
979
+ # Optional. An optional request ID to identify requests. Specify a unique
980
+ # request ID so that if you must retry your request, the server will know to
981
+ # ignore the request if it has already been completed. The server will guarantee
982
+ # that for at least 60 minutes since the first request. For example, consider a
983
+ # situation where you make an initial request and the request times out. If you
984
+ # make the request again with the same request ID, the server can check if
985
+ # original operation with the same request ID was received, and if so, will
986
+ # ignore the second request. This prevents clients from accidentally creating
987
+ # duplicate commitments. The request ID must be a valid UUID with the exception
988
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
989
+ # @param [String] update_mask
990
+ # Required. Field mask is used to specify the fields to be overwritten in the `
991
+ # Asset` resource by the update. The values specified in the `update_mask` field
992
+ # are relative to the resource, not the full request. A field will be
993
+ # overwritten if it is in the mask. A single * value in the mask lets you to
994
+ # overwrite all fields.
995
+ # @param [String] fields
996
+ # Selector specifying which fields to include in a partial response.
997
+ # @param [String] quota_user
998
+ # Available to use for quota purposes for server-side applications. Can be any
999
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1000
+ # @param [Google::Apis::RequestOptions] options
1001
+ # Request-specific options
1002
+ #
1003
+ # @yield [result, err] Result & error if block supplied
1004
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1005
+ # @yieldparam err [StandardError] error object if request failed
1006
+ #
1007
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1008
+ #
1009
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1010
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1011
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1012
+ def patch_project_location_import_job(name, import_job_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1013
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1014
+ command.request_representation = Google::Apis::MigrationcenterV1::ImportJob::Representation
1015
+ command.request_object = import_job_object
1016
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1017
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1018
+ command.params['name'] = name unless name.nil?
1019
+ command.query['requestId'] = request_id unless request_id.nil?
1020
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1021
+ command.query['fields'] = fields unless fields.nil?
1022
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1023
+ execute_or_queue_command(command, &block)
1024
+ end
1025
+
1026
+ # Runs an import job.
1027
+ # @param [String] name
1028
+ # Required. The name of the import job to run.
1029
+ # @param [Google::Apis::MigrationcenterV1::RunImportJobRequest] run_import_job_request_object
1030
+ # @param [String] fields
1031
+ # Selector specifying which fields to include in a partial response.
1032
+ # @param [String] quota_user
1033
+ # Available to use for quota purposes for server-side applications. Can be any
1034
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1035
+ # @param [Google::Apis::RequestOptions] options
1036
+ # Request-specific options
1037
+ #
1038
+ # @yield [result, err] Result & error if block supplied
1039
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1040
+ # @yieldparam err [StandardError] error object if request failed
1041
+ #
1042
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1043
+ #
1044
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1045
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1046
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1047
+ def run_import_job(name, run_import_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1048
+ command = make_simple_command(:post, 'v1/{+name}:run', options)
1049
+ command.request_representation = Google::Apis::MigrationcenterV1::RunImportJobRequest::Representation
1050
+ command.request_object = run_import_job_request_object
1051
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1052
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1053
+ command.params['name'] = name unless name.nil?
1054
+ command.query['fields'] = fields unless fields.nil?
1055
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1056
+ execute_or_queue_command(command, &block)
1057
+ end
1058
+
1059
+ # Validates an import job.
1060
+ # @param [String] name
1061
+ # Required. The name of the import job to validate.
1062
+ # @param [Google::Apis::MigrationcenterV1::ValidateImportJobRequest] validate_import_job_request_object
1063
+ # @param [String] fields
1064
+ # Selector specifying which fields to include in a partial response.
1065
+ # @param [String] quota_user
1066
+ # Available to use for quota purposes for server-side applications. Can be any
1067
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1068
+ # @param [Google::Apis::RequestOptions] options
1069
+ # Request-specific options
1070
+ #
1071
+ # @yield [result, err] Result & error if block supplied
1072
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1073
+ # @yieldparam err [StandardError] error object if request failed
1074
+ #
1075
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1076
+ #
1077
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1078
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1079
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1080
+ def validate_import_job(name, validate_import_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1081
+ command = make_simple_command(:post, 'v1/{+name}:validate', options)
1082
+ command.request_representation = Google::Apis::MigrationcenterV1::ValidateImportJobRequest::Representation
1083
+ command.request_object = validate_import_job_request_object
1084
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1085
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1086
+ command.params['name'] = name unless name.nil?
1087
+ command.query['fields'] = fields unless fields.nil?
1088
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1089
+ execute_or_queue_command(command, &block)
1090
+ end
1091
+
1092
+ # Creates an import data file.
1093
+ # @param [String] parent
1094
+ # Required. Name of the parent of the ImportDataFile.
1095
+ # @param [Google::Apis::MigrationcenterV1::ImportDataFile] import_data_file_object
1096
+ # @param [String] import_data_file_id
1097
+ # Required. The ID of the new data file.
1098
+ # @param [String] request_id
1099
+ # Optional. An optional request ID to identify requests. Specify a unique
1100
+ # request ID so that if you must retry your request, the server will know to
1101
+ # ignore the request if it has already been completed. The server will guarantee
1102
+ # that for at least 60 minutes since the first request. For example, consider a
1103
+ # situation where you make an initial request and the request times out. If you
1104
+ # make the request again with the same request ID, the server can check if
1105
+ # original operation with the same request ID was received, and if so, will
1106
+ # ignore the second request. This prevents clients from accidentally creating
1107
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1108
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1109
+ # @param [String] fields
1110
+ # Selector specifying which fields to include in a partial response.
1111
+ # @param [String] quota_user
1112
+ # Available to use for quota purposes for server-side applications. Can be any
1113
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1114
+ # @param [Google::Apis::RequestOptions] options
1115
+ # Request-specific options
1116
+ #
1117
+ # @yield [result, err] Result & error if block supplied
1118
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1119
+ # @yieldparam err [StandardError] error object if request failed
1120
+ #
1121
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1122
+ #
1123
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1124
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1125
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1126
+ def create_project_location_import_job_import_data_file(parent, import_data_file_object = nil, import_data_file_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1127
+ command = make_simple_command(:post, 'v1/{+parent}/importDataFiles', options)
1128
+ command.request_representation = Google::Apis::MigrationcenterV1::ImportDataFile::Representation
1129
+ command.request_object = import_data_file_object
1130
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1131
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1132
+ command.params['parent'] = parent unless parent.nil?
1133
+ command.query['importDataFileId'] = import_data_file_id unless import_data_file_id.nil?
1134
+ command.query['requestId'] = request_id unless request_id.nil?
1135
+ command.query['fields'] = fields unless fields.nil?
1136
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1137
+ execute_or_queue_command(command, &block)
1138
+ end
1139
+
1140
+ # Delete an import data file.
1141
+ # @param [String] name
1142
+ # Required. Name of the ImportDataFile to delete.
1143
+ # @param [String] request_id
1144
+ # Optional. An optional request ID to identify requests. Specify a unique
1145
+ # request ID so that if you must retry your request, the server will know to
1146
+ # ignore the request if it has already been completed. The server will guarantee
1147
+ # that for at least 60 minutes after the first request. For example, consider a
1148
+ # situation where you make an initial request and the request times out. If you
1149
+ # make the request again with the same request ID, the server can check if
1150
+ # original operation with the same request ID was received, and if so, will
1151
+ # ignore the second request. This prevents clients from accidentally creating
1152
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1153
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1154
+ # @param [String] fields
1155
+ # Selector specifying which fields to include in a partial response.
1156
+ # @param [String] quota_user
1157
+ # Available to use for quota purposes for server-side applications. Can be any
1158
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1159
+ # @param [Google::Apis::RequestOptions] options
1160
+ # Request-specific options
1161
+ #
1162
+ # @yield [result, err] Result & error if block supplied
1163
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1164
+ # @yieldparam err [StandardError] error object if request failed
1165
+ #
1166
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1167
+ #
1168
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1169
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1170
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1171
+ def delete_project_location_import_job_import_data_file(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1172
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1173
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1174
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1175
+ command.params['name'] = name unless name.nil?
1176
+ command.query['requestId'] = request_id unless request_id.nil?
1177
+ command.query['fields'] = fields unless fields.nil?
1178
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1179
+ execute_or_queue_command(command, &block)
1180
+ end
1181
+
1182
+ # Gets an import data file.
1183
+ # @param [String] name
1184
+ # Required. Name of the ImportDataFile.
1185
+ # @param [String] fields
1186
+ # Selector specifying which fields to include in a partial response.
1187
+ # @param [String] quota_user
1188
+ # Available to use for quota purposes for server-side applications. Can be any
1189
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1190
+ # @param [Google::Apis::RequestOptions] options
1191
+ # Request-specific options
1192
+ #
1193
+ # @yield [result, err] Result & error if block supplied
1194
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ImportDataFile] parsed result object
1195
+ # @yieldparam err [StandardError] error object if request failed
1196
+ #
1197
+ # @return [Google::Apis::MigrationcenterV1::ImportDataFile]
1198
+ #
1199
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1200
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1201
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1202
+ def get_project_location_import_job_import_data_file(name, fields: nil, quota_user: nil, options: nil, &block)
1203
+ command = make_simple_command(:get, 'v1/{+name}', options)
1204
+ command.response_representation = Google::Apis::MigrationcenterV1::ImportDataFile::Representation
1205
+ command.response_class = Google::Apis::MigrationcenterV1::ImportDataFile
1206
+ command.params['name'] = name unless name.nil?
1207
+ command.query['fields'] = fields unless fields.nil?
1208
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1209
+ execute_or_queue_command(command, &block)
1210
+ end
1211
+
1212
+ # List import data files.
1213
+ # @param [String] parent
1214
+ # Required. Name of the parent of the `ImportDataFiles` resource.
1215
+ # @param [String] filter
1216
+ # Filtering results.
1217
+ # @param [String] order_by
1218
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
1219
+ # @param [Fixnum] page_size
1220
+ # The maximum number of data files to return. The service may return fewer than
1221
+ # this value. If unspecified, at most 500 data files will be returned. The
1222
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
1223
+ # @param [String] page_token
1224
+ # A page token, received from a previous `ListImportDataFiles` call. Provide
1225
+ # this to retrieve the subsequent page. When paginating, all other parameters
1226
+ # provided to `ListImportDataFiles` must match the call that provided the page
1227
+ # token.
1228
+ # @param [String] fields
1229
+ # Selector specifying which fields to include in a partial response.
1230
+ # @param [String] quota_user
1231
+ # Available to use for quota purposes for server-side applications. Can be any
1232
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1233
+ # @param [Google::Apis::RequestOptions] options
1234
+ # Request-specific options
1235
+ #
1236
+ # @yield [result, err] Result & error if block supplied
1237
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListImportDataFilesResponse] parsed result object
1238
+ # @yieldparam err [StandardError] error object if request failed
1239
+ #
1240
+ # @return [Google::Apis::MigrationcenterV1::ListImportDataFilesResponse]
1241
+ #
1242
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1243
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1244
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1245
+ def list_project_location_import_job_import_data_files(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1246
+ command = make_simple_command(:get, 'v1/{+parent}/importDataFiles', options)
1247
+ command.response_representation = Google::Apis::MigrationcenterV1::ListImportDataFilesResponse::Representation
1248
+ command.response_class = Google::Apis::MigrationcenterV1::ListImportDataFilesResponse
1249
+ command.params['parent'] = parent unless parent.nil?
1250
+ command.query['filter'] = filter unless filter.nil?
1251
+ command.query['orderBy'] = order_by unless order_by.nil?
1252
+ command.query['pageSize'] = page_size unless page_size.nil?
1253
+ command.query['pageToken'] = page_token unless page_token.nil?
1254
+ command.query['fields'] = fields unless fields.nil?
1255
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1256
+ execute_or_queue_command(command, &block)
1257
+ end
1258
+
1259
+ # Starts asynchronous cancellation on a long-running operation. The server makes
1260
+ # a best effort to cancel the operation, but success is not guaranteed. If the
1261
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
1262
+ # Clients can use Operations.GetOperation or other methods to check whether the
1263
+ # cancellation succeeded or whether the operation completed despite cancellation.
1264
+ # On successful cancellation, the operation is not deleted; instead, it becomes
1265
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
1266
+ # corresponding to `Code.CANCELLED`.
1267
+ # @param [String] name
1268
+ # The name of the operation resource to be cancelled.
1269
+ # @param [Google::Apis::MigrationcenterV1::CancelOperationRequest] cancel_operation_request_object
1270
+ # @param [String] fields
1271
+ # Selector specifying which fields to include in a partial response.
1272
+ # @param [String] quota_user
1273
+ # Available to use for quota purposes for server-side applications. Can be any
1274
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1275
+ # @param [Google::Apis::RequestOptions] options
1276
+ # Request-specific options
1277
+ #
1278
+ # @yield [result, err] Result & error if block supplied
1279
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Empty] parsed result object
1280
+ # @yieldparam err [StandardError] error object if request failed
1281
+ #
1282
+ # @return [Google::Apis::MigrationcenterV1::Empty]
1283
+ #
1284
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1285
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1286
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1287
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1288
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1289
+ command.request_representation = Google::Apis::MigrationcenterV1::CancelOperationRequest::Representation
1290
+ command.request_object = cancel_operation_request_object
1291
+ command.response_representation = Google::Apis::MigrationcenterV1::Empty::Representation
1292
+ command.response_class = Google::Apis::MigrationcenterV1::Empty
1293
+ command.params['name'] = name unless name.nil?
1294
+ command.query['fields'] = fields unless fields.nil?
1295
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1296
+ execute_or_queue_command(command, &block)
1297
+ end
1298
+
1299
+ # Deletes a long-running operation. This method indicates that the client is no
1300
+ # longer interested in the operation result. It does not cancel the operation.
1301
+ # If the server doesn't support this method, it returns `google.rpc.Code.
1302
+ # UNIMPLEMENTED`.
1303
+ # @param [String] name
1304
+ # The name of the operation resource to be deleted.
1305
+ # @param [String] fields
1306
+ # Selector specifying which fields to include in a partial response.
1307
+ # @param [String] quota_user
1308
+ # Available to use for quota purposes for server-side applications. Can be any
1309
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1310
+ # @param [Google::Apis::RequestOptions] options
1311
+ # Request-specific options
1312
+ #
1313
+ # @yield [result, err] Result & error if block supplied
1314
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Empty] parsed result object
1315
+ # @yieldparam err [StandardError] error object if request failed
1316
+ #
1317
+ # @return [Google::Apis::MigrationcenterV1::Empty]
1318
+ #
1319
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1320
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1321
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1322
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1323
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1324
+ command.response_representation = Google::Apis::MigrationcenterV1::Empty::Representation
1325
+ command.response_class = Google::Apis::MigrationcenterV1::Empty
1326
+ command.params['name'] = name unless name.nil?
1327
+ command.query['fields'] = fields unless fields.nil?
1328
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1329
+ execute_or_queue_command(command, &block)
1330
+ end
1331
+
1332
+ # Gets the latest state of a long-running operation. Clients can use this method
1333
+ # to poll the operation result at intervals as recommended by the API service.
1334
+ # @param [String] name
1335
+ # The name of the operation resource.
1336
+ # @param [String] fields
1337
+ # Selector specifying which fields to include in a partial response.
1338
+ # @param [String] quota_user
1339
+ # Available to use for quota purposes for server-side applications. Can be any
1340
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1341
+ # @param [Google::Apis::RequestOptions] options
1342
+ # Request-specific options
1343
+ #
1344
+ # @yield [result, err] Result & error if block supplied
1345
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1346
+ # @yieldparam err [StandardError] error object if request failed
1347
+ #
1348
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1349
+ #
1350
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1351
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1352
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1353
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1354
+ command = make_simple_command(:get, 'v1/{+name}', options)
1355
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1356
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1357
+ command.params['name'] = name unless name.nil?
1358
+ command.query['fields'] = fields unless fields.nil?
1359
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1360
+ execute_or_queue_command(command, &block)
1361
+ end
1362
+
1363
+ # Lists operations that match the specified filter in the request. If the server
1364
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1365
+ # @param [String] name
1366
+ # The name of the operation's parent resource.
1367
+ # @param [String] filter
1368
+ # The standard list filter.
1369
+ # @param [Fixnum] page_size
1370
+ # The standard list page size.
1371
+ # @param [String] page_token
1372
+ # The standard list page token.
1373
+ # @param [String] fields
1374
+ # Selector specifying which fields to include in a partial response.
1375
+ # @param [String] quota_user
1376
+ # Available to use for quota purposes for server-side applications. Can be any
1377
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1378
+ # @param [Google::Apis::RequestOptions] options
1379
+ # Request-specific options
1380
+ #
1381
+ # @yield [result, err] Result & error if block supplied
1382
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListOperationsResponse] parsed result object
1383
+ # @yieldparam err [StandardError] error object if request failed
1384
+ #
1385
+ # @return [Google::Apis::MigrationcenterV1::ListOperationsResponse]
1386
+ #
1387
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1388
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1389
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1390
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1391
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1392
+ command.response_representation = Google::Apis::MigrationcenterV1::ListOperationsResponse::Representation
1393
+ command.response_class = Google::Apis::MigrationcenterV1::ListOperationsResponse
1394
+ command.params['name'] = name unless name.nil?
1395
+ command.query['filter'] = filter unless filter.nil?
1396
+ command.query['pageSize'] = page_size unless page_size.nil?
1397
+ command.query['pageToken'] = page_token unless page_token.nil?
1398
+ command.query['fields'] = fields unless fields.nil?
1399
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1400
+ execute_or_queue_command(command, &block)
1401
+ end
1402
+
1403
+ # Creates a new preference set in a given project and location.
1404
+ # @param [String] parent
1405
+ # Required. Value for parent.
1406
+ # @param [Google::Apis::MigrationcenterV1::PreferenceSet] preference_set_object
1407
+ # @param [String] preference_set_id
1408
+ # Required. User specified ID for the preference set. It will become the last
1409
+ # component of the preference set name. The ID must be unique within the project,
1410
+ # must conform with RFC-1034, is restricted to lower-cased letters, and has a
1411
+ # maximum length of 63 characters. The ID must match the regular expression `[a-
1412
+ # z]([a-z0-9-]`0,61`[a-z0-9])?`.
1413
+ # @param [String] request_id
1414
+ # Optional. An optional request ID to identify requests. Specify a unique
1415
+ # request ID so that if you must retry your request, the server will know to
1416
+ # ignore the request if it has already been completed. The server will guarantee
1417
+ # that for at least 60 minutes since the first request. For example, consider a
1418
+ # situation where you make an initial request and the request times out. If you
1419
+ # make the request again with the same request ID, the server can check if
1420
+ # original operation with the same request ID was received, and if so, will
1421
+ # ignore the second request. This prevents clients from accidentally creating
1422
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1423
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1424
+ # @param [String] fields
1425
+ # Selector specifying which fields to include in a partial response.
1426
+ # @param [String] quota_user
1427
+ # Available to use for quota purposes for server-side applications. Can be any
1428
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1429
+ # @param [Google::Apis::RequestOptions] options
1430
+ # Request-specific options
1431
+ #
1432
+ # @yield [result, err] Result & error if block supplied
1433
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1434
+ # @yieldparam err [StandardError] error object if request failed
1435
+ #
1436
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1437
+ #
1438
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1439
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1440
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1441
+ def create_project_location_preference_set(parent, preference_set_object = nil, preference_set_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1442
+ command = make_simple_command(:post, 'v1/{+parent}/preferenceSets', options)
1443
+ command.request_representation = Google::Apis::MigrationcenterV1::PreferenceSet::Representation
1444
+ command.request_object = preference_set_object
1445
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1446
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1447
+ command.params['parent'] = parent unless parent.nil?
1448
+ command.query['preferenceSetId'] = preference_set_id unless preference_set_id.nil?
1449
+ command.query['requestId'] = request_id unless request_id.nil?
1450
+ command.query['fields'] = fields unless fields.nil?
1451
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1452
+ execute_or_queue_command(command, &block)
1453
+ end
1454
+
1455
+ # Deletes a preference set.
1456
+ # @param [String] name
1457
+ # Required. Name of the group resource.
1458
+ # @param [String] request_id
1459
+ # Optional. An optional request ID to identify requests. Specify a unique
1460
+ # request ID so that if you must retry your request, the server will know to
1461
+ # ignore the request if it has already been completed. The server will guarantee
1462
+ # that for at least 60 minutes after the first request. For example, consider a
1463
+ # situation where you make an initial request and the request times out. If you
1464
+ # make the request again with the same request ID, the server can check if
1465
+ # original operation with the same request ID was received, and if so, will
1466
+ # ignore the second request. This prevents clients from accidentally creating
1467
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1468
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1469
+ # @param [String] fields
1470
+ # Selector specifying which fields to include in a partial response.
1471
+ # @param [String] quota_user
1472
+ # Available to use for quota purposes for server-side applications. Can be any
1473
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1474
+ # @param [Google::Apis::RequestOptions] options
1475
+ # Request-specific options
1476
+ #
1477
+ # @yield [result, err] Result & error if block supplied
1478
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1479
+ # @yieldparam err [StandardError] error object if request failed
1480
+ #
1481
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1482
+ #
1483
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1484
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1485
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1486
+ def delete_project_location_preference_set(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1487
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1488
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1489
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1490
+ command.params['name'] = name unless name.nil?
1491
+ command.query['requestId'] = request_id unless request_id.nil?
1492
+ command.query['fields'] = fields unless fields.nil?
1493
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1494
+ execute_or_queue_command(command, &block)
1495
+ end
1496
+
1497
+ # Gets the details of a preference set.
1498
+ # @param [String] name
1499
+ # Required. Name of the resource.
1500
+ # @param [String] fields
1501
+ # Selector specifying which fields to include in a partial response.
1502
+ # @param [String] quota_user
1503
+ # Available to use for quota purposes for server-side applications. Can be any
1504
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1505
+ # @param [Google::Apis::RequestOptions] options
1506
+ # Request-specific options
1507
+ #
1508
+ # @yield [result, err] Result & error if block supplied
1509
+ # @yieldparam result [Google::Apis::MigrationcenterV1::PreferenceSet] parsed result object
1510
+ # @yieldparam err [StandardError] error object if request failed
1511
+ #
1512
+ # @return [Google::Apis::MigrationcenterV1::PreferenceSet]
1513
+ #
1514
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1515
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1516
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1517
+ def get_project_location_preference_set(name, fields: nil, quota_user: nil, options: nil, &block)
1518
+ command = make_simple_command(:get, 'v1/{+name}', options)
1519
+ command.response_representation = Google::Apis::MigrationcenterV1::PreferenceSet::Representation
1520
+ command.response_class = Google::Apis::MigrationcenterV1::PreferenceSet
1521
+ command.params['name'] = name unless name.nil?
1522
+ command.query['fields'] = fields unless fields.nil?
1523
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1524
+ execute_or_queue_command(command, &block)
1525
+ end
1526
+
1527
+ # Lists all the preference sets in a given project and location.
1528
+ # @param [String] parent
1529
+ # Required. Parent value for `ListPreferenceSetsRequest`.
1530
+ # @param [String] order_by
1531
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
1532
+ # @param [Fixnum] page_size
1533
+ # Requested page size. Server may return fewer items than requested. If
1534
+ # unspecified, at most 500 preference sets will be returned. The maximum value
1535
+ # is 1000; values above 1000 will be coerced to 1000.
1536
+ # @param [String] page_token
1537
+ # A token identifying a page of results the server should return.
1538
+ # @param [String] fields
1539
+ # Selector specifying which fields to include in a partial response.
1540
+ # @param [String] quota_user
1541
+ # Available to use for quota purposes for server-side applications. Can be any
1542
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1543
+ # @param [Google::Apis::RequestOptions] options
1544
+ # Request-specific options
1545
+ #
1546
+ # @yield [result, err] Result & error if block supplied
1547
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListPreferenceSetsResponse] parsed result object
1548
+ # @yieldparam err [StandardError] error object if request failed
1549
+ #
1550
+ # @return [Google::Apis::MigrationcenterV1::ListPreferenceSetsResponse]
1551
+ #
1552
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1553
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1554
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1555
+ def list_project_location_preference_sets(parent, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1556
+ command = make_simple_command(:get, 'v1/{+parent}/preferenceSets', options)
1557
+ command.response_representation = Google::Apis::MigrationcenterV1::ListPreferenceSetsResponse::Representation
1558
+ command.response_class = Google::Apis::MigrationcenterV1::ListPreferenceSetsResponse
1559
+ command.params['parent'] = parent unless parent.nil?
1560
+ command.query['orderBy'] = order_by unless order_by.nil?
1561
+ command.query['pageSize'] = page_size unless page_size.nil?
1562
+ command.query['pageToken'] = page_token unless page_token.nil?
1563
+ command.query['fields'] = fields unless fields.nil?
1564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1565
+ execute_or_queue_command(command, &block)
1566
+ end
1567
+
1568
+ # Updates the parameters of a preference set.
1569
+ # @param [String] name
1570
+ # Output only. Name of the preference set.
1571
+ # @param [Google::Apis::MigrationcenterV1::PreferenceSet] preference_set_object
1572
+ # @param [String] request_id
1573
+ # Optional. An optional request ID to identify requests. Specify a unique
1574
+ # request ID so that if you must retry your request, the server will know to
1575
+ # ignore the request if it has already been completed. The server will guarantee
1576
+ # that for at least 60 minutes since the first request. For example, consider a
1577
+ # situation where you make an initial request and the request times out. If you
1578
+ # make the request again with the same request ID, the server can check if
1579
+ # original operation with the same request ID was received, and if so, will
1580
+ # ignore the second request. This prevents clients from accidentally creating
1581
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1582
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1583
+ # @param [String] update_mask
1584
+ # Required. Field mask is used to specify the fields to be overwritten in the `
1585
+ # PreferenceSet` resource by the update. The values specified in the `
1586
+ # update_mask` field are relative to the resource, not the full request. A field
1587
+ # will be overwritten if it is in the mask. A single * value in the mask lets
1588
+ # you to overwrite all fields.
1589
+ # @param [String] fields
1590
+ # Selector specifying which fields to include in a partial response.
1591
+ # @param [String] quota_user
1592
+ # Available to use for quota purposes for server-side applications. Can be any
1593
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1594
+ # @param [Google::Apis::RequestOptions] options
1595
+ # Request-specific options
1596
+ #
1597
+ # @yield [result, err] Result & error if block supplied
1598
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1599
+ # @yieldparam err [StandardError] error object if request failed
1600
+ #
1601
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1602
+ #
1603
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1604
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1605
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1606
+ def patch_project_location_preference_set(name, preference_set_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1607
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1608
+ command.request_representation = Google::Apis::MigrationcenterV1::PreferenceSet::Representation
1609
+ command.request_object = preference_set_object
1610
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1611
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1612
+ command.params['name'] = name unless name.nil?
1613
+ command.query['requestId'] = request_id unless request_id.nil?
1614
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1615
+ command.query['fields'] = fields unless fields.nil?
1616
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1617
+ execute_or_queue_command(command, &block)
1618
+ end
1619
+
1620
+ # Creates a report configuration.
1621
+ # @param [String] parent
1622
+ # Required. Value for parent.
1623
+ # @param [Google::Apis::MigrationcenterV1::ReportConfig] report_config_object
1624
+ # @param [String] report_config_id
1625
+ # Required. User specified ID for the report config. It will become the last
1626
+ # component of the report config name. The ID must be unique within the project,
1627
+ # must conform with RFC-1034, is restricted to lower-cased letters, and has a
1628
+ # maximum length of 63 characters. The ID must match the regular expression: [a-
1629
+ # z]([a-z0-9-]`0,61`[a-z0-9])?.
1630
+ # @param [String] request_id
1631
+ # Optional. An optional request ID to identify requests. Specify a unique
1632
+ # request ID so that if you must retry your request, the server will know to
1633
+ # ignore the request if it has already been completed. The server will guarantee
1634
+ # that for at least 60 minutes since the first request. For example, consider a
1635
+ # situation where you make an initial request and the request times out. If you
1636
+ # make the request again with the same request ID, the server can check if
1637
+ # original operation with the same request ID was received, and if so, will
1638
+ # ignore the second request. This prevents clients from accidentally creating
1639
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1640
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1641
+ # @param [String] fields
1642
+ # Selector specifying which fields to include in a partial response.
1643
+ # @param [String] quota_user
1644
+ # Available to use for quota purposes for server-side applications. Can be any
1645
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1646
+ # @param [Google::Apis::RequestOptions] options
1647
+ # Request-specific options
1648
+ #
1649
+ # @yield [result, err] Result & error if block supplied
1650
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1651
+ # @yieldparam err [StandardError] error object if request failed
1652
+ #
1653
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1654
+ #
1655
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1656
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1657
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1658
+ def create_project_location_report_config(parent, report_config_object = nil, report_config_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1659
+ command = make_simple_command(:post, 'v1/{+parent}/reportConfigs', options)
1660
+ command.request_representation = Google::Apis::MigrationcenterV1::ReportConfig::Representation
1661
+ command.request_object = report_config_object
1662
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1663
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1664
+ command.params['parent'] = parent unless parent.nil?
1665
+ command.query['reportConfigId'] = report_config_id unless report_config_id.nil?
1666
+ command.query['requestId'] = request_id unless request_id.nil?
1667
+ command.query['fields'] = fields unless fields.nil?
1668
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1669
+ execute_or_queue_command(command, &block)
1670
+ end
1671
+
1672
+ # Deletes a ReportConfig.
1673
+ # @param [String] name
1674
+ # Required. Name of the resource.
1675
+ # @param [Boolean] force
1676
+ # Optional. If set to `true`, any child `Reports` of this entity will also be
1677
+ # deleted. If set to `false`, the request only works if the resource has no
1678
+ # children.
1679
+ # @param [String] request_id
1680
+ # Optional. An optional request ID to identify requests. Specify a unique
1681
+ # request ID so that if you must retry your request, the server will know to
1682
+ # ignore the request if it has already been completed. The server will guarantee
1683
+ # that for at least 60 minutes after the first request. For example, consider a
1684
+ # situation where you make an initial request and the request times out. If you
1685
+ # make the request again with the same request ID, the server can check if
1686
+ # original operation with the same request ID was received, and if so, will
1687
+ # ignore the second request. This prevents clients from accidentally creating
1688
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1689
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1690
+ # @param [String] fields
1691
+ # Selector specifying which fields to include in a partial response.
1692
+ # @param [String] quota_user
1693
+ # Available to use for quota purposes for server-side applications. Can be any
1694
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1695
+ # @param [Google::Apis::RequestOptions] options
1696
+ # Request-specific options
1697
+ #
1698
+ # @yield [result, err] Result & error if block supplied
1699
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1700
+ # @yieldparam err [StandardError] error object if request failed
1701
+ #
1702
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1703
+ #
1704
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1705
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1706
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1707
+ def delete_project_location_report_config(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1708
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1709
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1710
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1711
+ command.params['name'] = name unless name.nil?
1712
+ command.query['force'] = force unless force.nil?
1713
+ command.query['requestId'] = request_id unless request_id.nil?
1714
+ command.query['fields'] = fields unless fields.nil?
1715
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1716
+ execute_or_queue_command(command, &block)
1717
+ end
1718
+
1719
+ # Gets details of a single ReportConfig.
1720
+ # @param [String] name
1721
+ # Required. Name of the resource.
1722
+ # @param [String] fields
1723
+ # Selector specifying which fields to include in a partial response.
1724
+ # @param [String] quota_user
1725
+ # Available to use for quota purposes for server-side applications. Can be any
1726
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1727
+ # @param [Google::Apis::RequestOptions] options
1728
+ # Request-specific options
1729
+ #
1730
+ # @yield [result, err] Result & error if block supplied
1731
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ReportConfig] parsed result object
1732
+ # @yieldparam err [StandardError] error object if request failed
1733
+ #
1734
+ # @return [Google::Apis::MigrationcenterV1::ReportConfig]
1735
+ #
1736
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1737
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1738
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1739
+ def get_project_location_report_config(name, fields: nil, quota_user: nil, options: nil, &block)
1740
+ command = make_simple_command(:get, 'v1/{+name}', options)
1741
+ command.response_representation = Google::Apis::MigrationcenterV1::ReportConfig::Representation
1742
+ command.response_class = Google::Apis::MigrationcenterV1::ReportConfig
1743
+ command.params['name'] = name unless name.nil?
1744
+ command.query['fields'] = fields unless fields.nil?
1745
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1746
+ execute_or_queue_command(command, &block)
1747
+ end
1748
+
1749
+ # Lists ReportConfigs in a given project and location.
1750
+ # @param [String] parent
1751
+ # Required. Parent value for `ListReportConfigsRequest`.
1752
+ # @param [String] filter
1753
+ # Filtering results.
1754
+ # @param [String] order_by
1755
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
1756
+ # @param [Fixnum] page_size
1757
+ # Requested page size. Server may return fewer items than requested. If
1758
+ # unspecified, server will pick an appropriate default.
1759
+ # @param [String] page_token
1760
+ # A token identifying a page of results the server should return.
1761
+ # @param [String] fields
1762
+ # Selector specifying which fields to include in a partial response.
1763
+ # @param [String] quota_user
1764
+ # Available to use for quota purposes for server-side applications. Can be any
1765
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1766
+ # @param [Google::Apis::RequestOptions] options
1767
+ # Request-specific options
1768
+ #
1769
+ # @yield [result, err] Result & error if block supplied
1770
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListReportConfigsResponse] parsed result object
1771
+ # @yieldparam err [StandardError] error object if request failed
1772
+ #
1773
+ # @return [Google::Apis::MigrationcenterV1::ListReportConfigsResponse]
1774
+ #
1775
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1776
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1777
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1778
+ def list_project_location_report_configs(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1779
+ command = make_simple_command(:get, 'v1/{+parent}/reportConfigs', options)
1780
+ command.response_representation = Google::Apis::MigrationcenterV1::ListReportConfigsResponse::Representation
1781
+ command.response_class = Google::Apis::MigrationcenterV1::ListReportConfigsResponse
1782
+ command.params['parent'] = parent unless parent.nil?
1783
+ command.query['filter'] = filter unless filter.nil?
1784
+ command.query['orderBy'] = order_by unless order_by.nil?
1785
+ command.query['pageSize'] = page_size unless page_size.nil?
1786
+ command.query['pageToken'] = page_token unless page_token.nil?
1787
+ command.query['fields'] = fields unless fields.nil?
1788
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1789
+ execute_or_queue_command(command, &block)
1790
+ end
1791
+
1792
+ # Creates a report.
1793
+ # @param [String] parent
1794
+ # Required. Value for parent.
1795
+ # @param [Google::Apis::MigrationcenterV1::Report] report_object
1796
+ # @param [String] report_id
1797
+ # Required. User specified id for the report. It will become the last component
1798
+ # of the report name. The id must be unique within the project, must conform
1799
+ # with RFC-1034, is restricted to lower-cased letters, and has a maximum length
1800
+ # of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]`0,
1801
+ # 61`[a-z0-9])?.
1802
+ # @param [String] request_id
1803
+ # Optional. An optional request ID to identify requests. Specify a unique
1804
+ # request ID so that if you must retry your request, the server will know to
1805
+ # ignore the request if it has already been completed. The server will guarantee
1806
+ # that for at least 60 minutes since the first request. For example, consider a
1807
+ # situation where you make an initial request and the request times out. If you
1808
+ # make the request again with the same request ID, the server can check if
1809
+ # original operation with the same request ID was received, and if so, will
1810
+ # ignore the second request. This prevents clients from accidentally creating
1811
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1812
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1813
+ # @param [String] fields
1814
+ # Selector specifying which fields to include in a partial response.
1815
+ # @param [String] quota_user
1816
+ # Available to use for quota purposes for server-side applications. Can be any
1817
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1818
+ # @param [Google::Apis::RequestOptions] options
1819
+ # Request-specific options
1820
+ #
1821
+ # @yield [result, err] Result & error if block supplied
1822
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1823
+ # @yieldparam err [StandardError] error object if request failed
1824
+ #
1825
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1826
+ #
1827
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1828
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1829
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1830
+ def create_project_location_report_config_report(parent, report_object = nil, report_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1831
+ command = make_simple_command(:post, 'v1/{+parent}/reports', options)
1832
+ command.request_representation = Google::Apis::MigrationcenterV1::Report::Representation
1833
+ command.request_object = report_object
1834
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1835
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1836
+ command.params['parent'] = parent unless parent.nil?
1837
+ command.query['reportId'] = report_id unless report_id.nil?
1838
+ command.query['requestId'] = request_id unless request_id.nil?
1839
+ command.query['fields'] = fields unless fields.nil?
1840
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1841
+ execute_or_queue_command(command, &block)
1842
+ end
1843
+
1844
+ # Deletes a Report.
1845
+ # @param [String] name
1846
+ # Required. Name of the resource.
1847
+ # @param [String] request_id
1848
+ # Optional. An optional request ID to identify requests. Specify a unique
1849
+ # request ID so that if you must retry your request, the server will know to
1850
+ # ignore the request if it has already been completed. The server will guarantee
1851
+ # that for at least 60 minutes after the first request. For example, consider a
1852
+ # situation where you make an initial request and the request times out. If you
1853
+ # make the request again with the same request ID, the server can check if
1854
+ # original operation with the same request ID was received, and if so, will
1855
+ # ignore the second request. This prevents clients from accidentally creating
1856
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1857
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1858
+ # @param [String] fields
1859
+ # Selector specifying which fields to include in a partial response.
1860
+ # @param [String] quota_user
1861
+ # Available to use for quota purposes for server-side applications. Can be any
1862
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1863
+ # @param [Google::Apis::RequestOptions] options
1864
+ # Request-specific options
1865
+ #
1866
+ # @yield [result, err] Result & error if block supplied
1867
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1868
+ # @yieldparam err [StandardError] error object if request failed
1869
+ #
1870
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1871
+ #
1872
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1873
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1874
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1875
+ def delete_project_location_report_config_report(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1876
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1877
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
1878
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
1879
+ command.params['name'] = name unless name.nil?
1880
+ command.query['requestId'] = request_id unless request_id.nil?
1881
+ command.query['fields'] = fields unless fields.nil?
1882
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1883
+ execute_or_queue_command(command, &block)
1884
+ end
1885
+
1886
+ # Gets details of a single Report.
1887
+ # @param [String] name
1888
+ # Required. Name of the resource.
1889
+ # @param [String] view
1890
+ # Determines what information to retrieve for the Report.
1891
+ # @param [String] fields
1892
+ # Selector specifying which fields to include in a partial response.
1893
+ # @param [String] quota_user
1894
+ # Available to use for quota purposes for server-side applications. Can be any
1895
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1896
+ # @param [Google::Apis::RequestOptions] options
1897
+ # Request-specific options
1898
+ #
1899
+ # @yield [result, err] Result & error if block supplied
1900
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Report] parsed result object
1901
+ # @yieldparam err [StandardError] error object if request failed
1902
+ #
1903
+ # @return [Google::Apis::MigrationcenterV1::Report]
1904
+ #
1905
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1906
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1907
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1908
+ def get_project_location_report_config_report(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
1909
+ command = make_simple_command(:get, 'v1/{+name}', options)
1910
+ command.response_representation = Google::Apis::MigrationcenterV1::Report::Representation
1911
+ command.response_class = Google::Apis::MigrationcenterV1::Report
1912
+ command.params['name'] = name unless name.nil?
1913
+ command.query['view'] = view unless view.nil?
1914
+ command.query['fields'] = fields unless fields.nil?
1915
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1916
+ execute_or_queue_command(command, &block)
1917
+ end
1918
+
1919
+ # Lists Reports in a given ReportConfig.
1920
+ # @param [String] parent
1921
+ # Required. Parent value for `ListReportsRequest`.
1922
+ # @param [String] filter
1923
+ # Filtering results.
1924
+ # @param [String] order_by
1925
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
1926
+ # @param [Fixnum] page_size
1927
+ # Requested page size. The server may return fewer items than requested. If
1928
+ # unspecified, the server will pick an appropriate default value.
1929
+ # @param [String] page_token
1930
+ # A token identifying a page of results that the server should return.
1931
+ # @param [String] view
1932
+ # Determines what information to retrieve for each Report.
1933
+ # @param [String] fields
1934
+ # Selector specifying which fields to include in a partial response.
1935
+ # @param [String] quota_user
1936
+ # Available to use for quota purposes for server-side applications. Can be any
1937
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1938
+ # @param [Google::Apis::RequestOptions] options
1939
+ # Request-specific options
1940
+ #
1941
+ # @yield [result, err] Result & error if block supplied
1942
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListReportsResponse] parsed result object
1943
+ # @yieldparam err [StandardError] error object if request failed
1944
+ #
1945
+ # @return [Google::Apis::MigrationcenterV1::ListReportsResponse]
1946
+ #
1947
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1948
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1949
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1950
+ def list_project_location_report_config_reports(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
1951
+ command = make_simple_command(:get, 'v1/{+parent}/reports', options)
1952
+ command.response_representation = Google::Apis::MigrationcenterV1::ListReportsResponse::Representation
1953
+ command.response_class = Google::Apis::MigrationcenterV1::ListReportsResponse
1954
+ command.params['parent'] = parent unless parent.nil?
1955
+ command.query['filter'] = filter unless filter.nil?
1956
+ command.query['orderBy'] = order_by unless order_by.nil?
1957
+ command.query['pageSize'] = page_size unless page_size.nil?
1958
+ command.query['pageToken'] = page_token unless page_token.nil?
1959
+ command.query['view'] = view unless view.nil?
1960
+ command.query['fields'] = fields unless fields.nil?
1961
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1962
+ execute_or_queue_command(command, &block)
1963
+ end
1964
+
1965
+ # Creates a new source in a given project and location.
1966
+ # @param [String] parent
1967
+ # Required. Value for parent.
1968
+ # @param [Google::Apis::MigrationcenterV1::Source] source_object
1969
+ # @param [String] request_id
1970
+ # Optional. An optional request ID to identify requests. Specify a unique
1971
+ # request ID so that if you must retry your request, the server will know to
1972
+ # ignore the request if it has already been completed. The server will guarantee
1973
+ # that for at least 60 minutes since the first request. For example, consider a
1974
+ # situation where you make an initial request and the request times out. If you
1975
+ # make the request again with the same request ID, the server can check if
1976
+ # original operation with the same request ID was received, and if so, will
1977
+ # ignore the second request. This prevents clients from accidentally creating
1978
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1979
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1980
+ # @param [String] source_id
1981
+ # Required. User specified ID for the source. It will become the last component
1982
+ # of the source name. The ID must be unique within the project, must conform
1983
+ # with RFC-1034, is restricted to lower-cased letters, and has a maximum length
1984
+ # of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]`0,
1985
+ # 61`[a-z0-9])?`.
1986
+ # @param [String] fields
1987
+ # Selector specifying which fields to include in a partial response.
1988
+ # @param [String] quota_user
1989
+ # Available to use for quota purposes for server-side applications. Can be any
1990
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1991
+ # @param [Google::Apis::RequestOptions] options
1992
+ # Request-specific options
1993
+ #
1994
+ # @yield [result, err] Result & error if block supplied
1995
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
1996
+ # @yieldparam err [StandardError] error object if request failed
1997
+ #
1998
+ # @return [Google::Apis::MigrationcenterV1::Operation]
1999
+ #
2000
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2001
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2002
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2003
+ def create_project_location_source(parent, source_object = nil, request_id: nil, source_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2004
+ command = make_simple_command(:post, 'v1/{+parent}/sources', options)
2005
+ command.request_representation = Google::Apis::MigrationcenterV1::Source::Representation
2006
+ command.request_object = source_object
2007
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
2008
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
2009
+ command.params['parent'] = parent unless parent.nil?
2010
+ command.query['requestId'] = request_id unless request_id.nil?
2011
+ command.query['sourceId'] = source_id unless source_id.nil?
2012
+ command.query['fields'] = fields unless fields.nil?
2013
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2014
+ execute_or_queue_command(command, &block)
2015
+ end
2016
+
2017
+ # Deletes a source.
2018
+ # @param [String] name
2019
+ # Required. Name of the resource.
2020
+ # @param [String] request_id
2021
+ # Optional. An optional request ID to identify requests. Specify a unique
2022
+ # request ID so that if you must retry your request, the server will know to
2023
+ # ignore the request if it has already been completed. The server will guarantee
2024
+ # that for at least 60 minutes after the first request. For example, consider a
2025
+ # situation where you make an initial request and the request times out. If you
2026
+ # make the request again with the same request ID, the server can check if
2027
+ # original operation with the same request ID was received, and if so, will
2028
+ # ignore the second request. This prevents clients from accidentally creating
2029
+ # duplicate commitments. The request ID must be a valid UUID with the exception
2030
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
2031
+ # @param [String] fields
2032
+ # Selector specifying which fields to include in a partial response.
2033
+ # @param [String] quota_user
2034
+ # Available to use for quota purposes for server-side applications. Can be any
2035
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2036
+ # @param [Google::Apis::RequestOptions] options
2037
+ # Request-specific options
2038
+ #
2039
+ # @yield [result, err] Result & error if block supplied
2040
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
2041
+ # @yieldparam err [StandardError] error object if request failed
2042
+ #
2043
+ # @return [Google::Apis::MigrationcenterV1::Operation]
2044
+ #
2045
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2046
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2047
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2048
+ def delete_project_location_source(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2049
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2050
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
2051
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
2052
+ command.params['name'] = name unless name.nil?
2053
+ command.query['requestId'] = request_id unless request_id.nil?
2054
+ command.query['fields'] = fields unless fields.nil?
2055
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2056
+ execute_or_queue_command(command, &block)
2057
+ end
2058
+
2059
+ # Gets the details of a source.
2060
+ # @param [String] name
2061
+ # Required. Name of the resource.
2062
+ # @param [String] fields
2063
+ # Selector specifying which fields to include in a partial response.
2064
+ # @param [String] quota_user
2065
+ # Available to use for quota purposes for server-side applications. Can be any
2066
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2067
+ # @param [Google::Apis::RequestOptions] options
2068
+ # Request-specific options
2069
+ #
2070
+ # @yield [result, err] Result & error if block supplied
2071
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Source] parsed result object
2072
+ # @yieldparam err [StandardError] error object if request failed
2073
+ #
2074
+ # @return [Google::Apis::MigrationcenterV1::Source]
2075
+ #
2076
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2077
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2078
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2079
+ def get_project_location_source(name, fields: nil, quota_user: nil, options: nil, &block)
2080
+ command = make_simple_command(:get, 'v1/{+name}', options)
2081
+ command.response_representation = Google::Apis::MigrationcenterV1::Source::Representation
2082
+ command.response_class = Google::Apis::MigrationcenterV1::Source
2083
+ command.params['name'] = name unless name.nil?
2084
+ command.query['fields'] = fields unless fields.nil?
2085
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2086
+ execute_or_queue_command(command, &block)
2087
+ end
2088
+
2089
+ # Lists all the sources in a given project and location.
2090
+ # @param [String] parent
2091
+ # Required. Parent value for `ListSourcesRequest`.
2092
+ # @param [String] filter
2093
+ # Filtering results.
2094
+ # @param [String] order_by
2095
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
2096
+ # @param [Fixnum] page_size
2097
+ # Requested page size. The server may return fewer items than requested. If
2098
+ # unspecified, the server will pick an appropriate default value.
2099
+ # @param [String] page_token
2100
+ # A token identifying a page of results that the server should return.
2101
+ # @param [String] fields
2102
+ # Selector specifying which fields to include in a partial response.
2103
+ # @param [String] quota_user
2104
+ # Available to use for quota purposes for server-side applications. Can be any
2105
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2106
+ # @param [Google::Apis::RequestOptions] options
2107
+ # Request-specific options
2108
+ #
2109
+ # @yield [result, err] Result & error if block supplied
2110
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListSourcesResponse] parsed result object
2111
+ # @yieldparam err [StandardError] error object if request failed
2112
+ #
2113
+ # @return [Google::Apis::MigrationcenterV1::ListSourcesResponse]
2114
+ #
2115
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2116
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2117
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2118
+ def list_project_location_sources(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2119
+ command = make_simple_command(:get, 'v1/{+parent}/sources', options)
2120
+ command.response_representation = Google::Apis::MigrationcenterV1::ListSourcesResponse::Representation
2121
+ command.response_class = Google::Apis::MigrationcenterV1::ListSourcesResponse
2122
+ command.params['parent'] = parent unless parent.nil?
2123
+ command.query['filter'] = filter unless filter.nil?
2124
+ command.query['orderBy'] = order_by unless order_by.nil?
2125
+ command.query['pageSize'] = page_size unless page_size.nil?
2126
+ command.query['pageToken'] = page_token unless page_token.nil?
2127
+ command.query['fields'] = fields unless fields.nil?
2128
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2129
+ execute_or_queue_command(command, &block)
2130
+ end
2131
+
2132
+ # Updates the parameters of a source.
2133
+ # @param [String] name
2134
+ # Output only. The full name of the source.
2135
+ # @param [Google::Apis::MigrationcenterV1::Source] source_object
2136
+ # @param [String] request_id
2137
+ # Optional. An optional request ID to identify requests. Specify a unique
2138
+ # request ID so that if you must retry your request, the server will know to
2139
+ # ignore the request if it has already been completed. The server will guarantee
2140
+ # that for at least 60 minutes since the first request. For example, consider a
2141
+ # situation where you make an initial request and the request times out. If you
2142
+ # make the request again with the same request ID, the server can check if
2143
+ # original operation with the same request ID was received, and if so, will
2144
+ # ignore the second request. This prevents clients from accidentally creating
2145
+ # duplicate commitments. The request ID must be a valid UUID with the exception
2146
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
2147
+ # @param [String] update_mask
2148
+ # Required. Field mask is used to specify the fields to be overwritten in the `
2149
+ # Source` resource by the update. The values specified in the `update_mask`
2150
+ # field are relative to the resource, not the full request. A field will be
2151
+ # overwritten if it is in the mask. A single * value in the mask lets you to
2152
+ # overwrite all fields.
2153
+ # @param [String] fields
2154
+ # Selector specifying which fields to include in a partial response.
2155
+ # @param [String] quota_user
2156
+ # Available to use for quota purposes for server-side applications. Can be any
2157
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2158
+ # @param [Google::Apis::RequestOptions] options
2159
+ # Request-specific options
2160
+ #
2161
+ # @yield [result, err] Result & error if block supplied
2162
+ # @yieldparam result [Google::Apis::MigrationcenterV1::Operation] parsed result object
2163
+ # @yieldparam err [StandardError] error object if request failed
2164
+ #
2165
+ # @return [Google::Apis::MigrationcenterV1::Operation]
2166
+ #
2167
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2168
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2169
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2170
+ def patch_project_location_source(name, source_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2171
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2172
+ command.request_representation = Google::Apis::MigrationcenterV1::Source::Representation
2173
+ command.request_object = source_object
2174
+ command.response_representation = Google::Apis::MigrationcenterV1::Operation::Representation
2175
+ command.response_class = Google::Apis::MigrationcenterV1::Operation
2176
+ command.params['name'] = name unless name.nil?
2177
+ command.query['requestId'] = request_id unless request_id.nil?
2178
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2179
+ command.query['fields'] = fields unless fields.nil?
2180
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2181
+ execute_or_queue_command(command, &block)
2182
+ end
2183
+
2184
+ # Gets the details of an error frame.
2185
+ # @param [String] name
2186
+ # Required. The name of the frame to retrieve. Format: projects/`project`/
2187
+ # locations/`location`/sources/`source`/errorFrames/`error_frame`
2188
+ # @param [String] view
2189
+ # Optional. An optional view mode to control the level of details for the frame.
2190
+ # The default is a basic frame view.
2191
+ # @param [String] fields
2192
+ # Selector specifying which fields to include in a partial response.
2193
+ # @param [String] quota_user
2194
+ # Available to use for quota purposes for server-side applications. Can be any
2195
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2196
+ # @param [Google::Apis::RequestOptions] options
2197
+ # Request-specific options
2198
+ #
2199
+ # @yield [result, err] Result & error if block supplied
2200
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ErrorFrame] parsed result object
2201
+ # @yieldparam err [StandardError] error object if request failed
2202
+ #
2203
+ # @return [Google::Apis::MigrationcenterV1::ErrorFrame]
2204
+ #
2205
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2206
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2207
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2208
+ def get_project_location_source_error_frame(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
2209
+ command = make_simple_command(:get, 'v1/{+name}', options)
2210
+ command.response_representation = Google::Apis::MigrationcenterV1::ErrorFrame::Representation
2211
+ command.response_class = Google::Apis::MigrationcenterV1::ErrorFrame
2212
+ command.params['name'] = name unless name.nil?
2213
+ command.query['view'] = view unless view.nil?
2214
+ command.query['fields'] = fields unless fields.nil?
2215
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2216
+ execute_or_queue_command(command, &block)
2217
+ end
2218
+
2219
+ # Lists all error frames in a given source and location.
2220
+ # @param [String] parent
2221
+ # Required. Parent value (the source) for `ListErrorFramesRequest`.
2222
+ # @param [Fixnum] page_size
2223
+ # Requested page size. Server may return fewer items than requested. If
2224
+ # unspecified, server will pick an appropriate default.
2225
+ # @param [String] page_token
2226
+ # A token identifying a page of results the server should return.
2227
+ # @param [String] view
2228
+ # Optional. An optional view mode to control the level of details of each error
2229
+ # frame. The default is a BASIC frame view.
2230
+ # @param [String] fields
2231
+ # Selector specifying which fields to include in a partial response.
2232
+ # @param [String] quota_user
2233
+ # Available to use for quota purposes for server-side applications. Can be any
2234
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2235
+ # @param [Google::Apis::RequestOptions] options
2236
+ # Request-specific options
2237
+ #
2238
+ # @yield [result, err] Result & error if block supplied
2239
+ # @yieldparam result [Google::Apis::MigrationcenterV1::ListErrorFramesResponse] parsed result object
2240
+ # @yieldparam err [StandardError] error object if request failed
2241
+ #
2242
+ # @return [Google::Apis::MigrationcenterV1::ListErrorFramesResponse]
2243
+ #
2244
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2245
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2246
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2247
+ def list_project_location_source_error_frames(parent, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
2248
+ command = make_simple_command(:get, 'v1/{+parent}/errorFrames', options)
2249
+ command.response_representation = Google::Apis::MigrationcenterV1::ListErrorFramesResponse::Representation
2250
+ command.response_class = Google::Apis::MigrationcenterV1::ListErrorFramesResponse
2251
+ command.params['parent'] = parent unless parent.nil?
2252
+ command.query['pageSize'] = page_size unless page_size.nil?
2253
+ command.query['pageToken'] = page_token unless page_token.nil?
2254
+ command.query['view'] = view unless view.nil?
2255
+ command.query['fields'] = fields unless fields.nil?
2256
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2257
+ execute_or_queue_command(command, &block)
2258
+ end
2259
+
2260
+ protected
2261
+
2262
+ def apply_command_defaults(command)
2263
+ command.query['key'] = key unless key.nil?
2264
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2265
+ end
2266
+ end
2267
+ end
2268
+ end
2269
+ end