google-apis-backupdr_v1 0.11.0 → 0.13.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.
@@ -124,11 +124,1276 @@ module Google
124
124
  execute_or_queue_command(command, &block)
125
125
  end
126
126
 
127
+ # Create a BackupPlanAssociation
128
+ # @param [String] parent
129
+ # Required. The backup plan association project and location in the format `
130
+ # projects/`project_id`/locations/`location``. In Cloud BackupDR locations map
131
+ # to GCP regions, for example **us-central1**.
132
+ # @param [Google::Apis::BackupdrV1::BackupPlanAssociation] backup_plan_association_object
133
+ # @param [String] backup_plan_association_id
134
+ # Required. The name of the backup plan association to create. The name must be
135
+ # unique for the specified project and location.
136
+ # @param [String] request_id
137
+ # Optional. An optional request ID to identify requests. Specify a unique
138
+ # request ID so that if you must retry your request, the server will know to
139
+ # ignore the request if it has already been completed. The server will guarantee
140
+ # that for at least 60 minutes since the first request. For example, consider a
141
+ # situation where you make an initial request and t he request times out. If you
142
+ # make the request again with the same request ID, the server can check if
143
+ # original operation with the same request ID was received, and if so, will
144
+ # ignore the second request. This prevents clients from accidentally creating
145
+ # duplicate commitments. The request ID must be a valid UUID with the exception
146
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
147
+ # @param [String] fields
148
+ # Selector specifying which fields to include in a partial response.
149
+ # @param [String] quota_user
150
+ # Available to use for quota purposes for server-side applications. Can be any
151
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
152
+ # @param [Google::Apis::RequestOptions] options
153
+ # Request-specific options
154
+ #
155
+ # @yield [result, err] Result & error if block supplied
156
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
157
+ # @yieldparam err [StandardError] error object if request failed
158
+ #
159
+ # @return [Google::Apis::BackupdrV1::Operation]
160
+ #
161
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
162
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
163
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
164
+ def create_project_location_backup_plan_association(parent, backup_plan_association_object = nil, backup_plan_association_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
165
+ command = make_simple_command(:post, 'v1/{+parent}/backupPlanAssociations', options)
166
+ command.request_representation = Google::Apis::BackupdrV1::BackupPlanAssociation::Representation
167
+ command.request_object = backup_plan_association_object
168
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
169
+ command.response_class = Google::Apis::BackupdrV1::Operation
170
+ command.params['parent'] = parent unless parent.nil?
171
+ command.query['backupPlanAssociationId'] = backup_plan_association_id unless backup_plan_association_id.nil?
172
+ command.query['requestId'] = request_id unless request_id.nil?
173
+ command.query['fields'] = fields unless fields.nil?
174
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
175
+ execute_or_queue_command(command, &block)
176
+ end
177
+
178
+ # Deletes a single BackupPlanAssociation.
179
+ # @param [String] name
180
+ # Required. Name of the backup plan association resource, in the format `
181
+ # projects/`project`/locations/`location`/backupPlanAssociations/`
182
+ # backupPlanAssociationId``
183
+ # @param [String] request_id
184
+ # Optional. An optional request ID to identify requests. Specify a unique
185
+ # request ID so that if you must retry your request, the server will know to
186
+ # ignore the request if it has already been completed. The server will guarantee
187
+ # that for at least 60 minutes after the first request. For example, consider a
188
+ # situation where you make an initial request and the request times out. If you
189
+ # make the request again with the same request ID, the server can check if
190
+ # original operation with the same request ID was received, and if so, will
191
+ # ignore the second request. This prevents clients from accidentally creating
192
+ # duplicate commitments. The request ID must be a valid UUID with the exception
193
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
194
+ # @param [String] fields
195
+ # Selector specifying which fields to include in a partial response.
196
+ # @param [String] quota_user
197
+ # Available to use for quota purposes for server-side applications. Can be any
198
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
199
+ # @param [Google::Apis::RequestOptions] options
200
+ # Request-specific options
201
+ #
202
+ # @yield [result, err] Result & error if block supplied
203
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
204
+ # @yieldparam err [StandardError] error object if request failed
205
+ #
206
+ # @return [Google::Apis::BackupdrV1::Operation]
207
+ #
208
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
209
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
210
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
211
+ def delete_project_location_backup_plan_association(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
212
+ command = make_simple_command(:delete, 'v1/{+name}', options)
213
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
214
+ command.response_class = Google::Apis::BackupdrV1::Operation
215
+ command.params['name'] = name unless name.nil?
216
+ command.query['requestId'] = request_id unless request_id.nil?
217
+ command.query['fields'] = fields unless fields.nil?
218
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
219
+ execute_or_queue_command(command, &block)
220
+ end
221
+
222
+ # Gets details of a single BackupPlanAssociation.
223
+ # @param [String] name
224
+ # Required. Name of the backup plan association resource, in the format `
225
+ # projects/`project`/locations/`location`/backupPlanAssociations/`
226
+ # backupPlanAssociationId``
227
+ # @param [String] fields
228
+ # Selector specifying which fields to include in a partial response.
229
+ # @param [String] quota_user
230
+ # Available to use for quota purposes for server-side applications. Can be any
231
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
232
+ # @param [Google::Apis::RequestOptions] options
233
+ # Request-specific options
234
+ #
235
+ # @yield [result, err] Result & error if block supplied
236
+ # @yieldparam result [Google::Apis::BackupdrV1::BackupPlanAssociation] parsed result object
237
+ # @yieldparam err [StandardError] error object if request failed
238
+ #
239
+ # @return [Google::Apis::BackupdrV1::BackupPlanAssociation]
240
+ #
241
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
242
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
243
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
244
+ def get_project_location_backup_plan_association(name, fields: nil, quota_user: nil, options: nil, &block)
245
+ command = make_simple_command(:get, 'v1/{+name}', options)
246
+ command.response_representation = Google::Apis::BackupdrV1::BackupPlanAssociation::Representation
247
+ command.response_class = Google::Apis::BackupdrV1::BackupPlanAssociation
248
+ command.params['name'] = name unless name.nil?
249
+ command.query['fields'] = fields unless fields.nil?
250
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
251
+ execute_or_queue_command(command, &block)
252
+ end
253
+
254
+ # Lists BackupPlanAssociations in a given project and location.
255
+ # @param [String] parent
256
+ # Required. The project and location for which to retrieve backup Plan
257
+ # Associations information, in the format `projects/`project_id`/locations/`
258
+ # location``. In Cloud BackupDR, locations map to GCP regions, for example **us-
259
+ # central1**. To retrieve backup plan associations for all locations, use "-"
260
+ # for the ``location`` value.
261
+ # @param [String] filter
262
+ # Optional. Filtering results
263
+ # @param [Fixnum] page_size
264
+ # Optional. Requested page size. Server may return fewer items than requested.
265
+ # If unspecified, server will pick an appropriate default.
266
+ # @param [String] page_token
267
+ # Optional. A token identifying a page of results the server should return.
268
+ # @param [String] fields
269
+ # Selector specifying which fields to include in a partial response.
270
+ # @param [String] quota_user
271
+ # Available to use for quota purposes for server-side applications. Can be any
272
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
273
+ # @param [Google::Apis::RequestOptions] options
274
+ # Request-specific options
275
+ #
276
+ # @yield [result, err] Result & error if block supplied
277
+ # @yieldparam result [Google::Apis::BackupdrV1::ListBackupPlanAssociationsResponse] parsed result object
278
+ # @yieldparam err [StandardError] error object if request failed
279
+ #
280
+ # @return [Google::Apis::BackupdrV1::ListBackupPlanAssociationsResponse]
281
+ #
282
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
283
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
284
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
285
+ def list_project_location_backup_plan_associations(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
286
+ command = make_simple_command(:get, 'v1/{+parent}/backupPlanAssociations', options)
287
+ command.response_representation = Google::Apis::BackupdrV1::ListBackupPlanAssociationsResponse::Representation
288
+ command.response_class = Google::Apis::BackupdrV1::ListBackupPlanAssociationsResponse
289
+ command.params['parent'] = parent unless parent.nil?
290
+ command.query['filter'] = filter unless filter.nil?
291
+ command.query['pageSize'] = page_size unless page_size.nil?
292
+ command.query['pageToken'] = page_token unless page_token.nil?
293
+ command.query['fields'] = fields unless fields.nil?
294
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
295
+ execute_or_queue_command(command, &block)
296
+ end
297
+
298
+ # Triggers a new Backup.
299
+ # @param [String] name
300
+ # Required. Name of the backup plan association resource, in the format `
301
+ # projects/`project`/locations/`location`/backupPlanAssociations/`
302
+ # backupPlanAssociationId``
303
+ # @param [Google::Apis::BackupdrV1::TriggerBackupRequest] trigger_backup_request_object
304
+ # @param [String] fields
305
+ # Selector specifying which fields to include in a partial response.
306
+ # @param [String] quota_user
307
+ # Available to use for quota purposes for server-side applications. Can be any
308
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
309
+ # @param [Google::Apis::RequestOptions] options
310
+ # Request-specific options
311
+ #
312
+ # @yield [result, err] Result & error if block supplied
313
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
314
+ # @yieldparam err [StandardError] error object if request failed
315
+ #
316
+ # @return [Google::Apis::BackupdrV1::Operation]
317
+ #
318
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
319
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
320
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
321
+ def trigger_backup_plan_association_backup(name, trigger_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
322
+ command = make_simple_command(:post, 'v1/{+name}:triggerBackup', options)
323
+ command.request_representation = Google::Apis::BackupdrV1::TriggerBackupRequest::Representation
324
+ command.request_object = trigger_backup_request_object
325
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
326
+ command.response_class = Google::Apis::BackupdrV1::Operation
327
+ command.params['name'] = name unless name.nil?
328
+ command.query['fields'] = fields unless fields.nil?
329
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
330
+ execute_or_queue_command(command, &block)
331
+ end
332
+
333
+ # Create a BackupPlan
334
+ # @param [String] parent
335
+ # Required. The `BackupPlan` project and location in the format `projects/`
336
+ # project`/locations/`location``. In Cloud BackupDR locations map to GCP regions,
337
+ # for example **us-central1**.
338
+ # @param [Google::Apis::BackupdrV1::BackupPlan] backup_plan_object
339
+ # @param [String] backup_plan_id
340
+ # Required. The name of the `BackupPlan` to create. The name must be unique for
341
+ # the specified project and location.The name must start with a lowercase letter
342
+ # followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z`,62`
343
+ # /.
344
+ # @param [String] request_id
345
+ # Optional. An optional request ID to identify requests. Specify a unique
346
+ # request ID so that if you must retry your request, the server will know to
347
+ # ignore the request if it has already been completed. The server will guarantee
348
+ # that for at least 60 minutes since the first request. For example, consider a
349
+ # situation where you make an initial request and t he request times out. If you
350
+ # make the request again with the same request ID, the server can check if
351
+ # original operation with the same request ID was received, and if so, will
352
+ # ignore the second request. This prevents clients from accidentally creating
353
+ # duplicate commitments. The request ID must be a valid UUID with the exception
354
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
355
+ # @param [String] fields
356
+ # Selector specifying which fields to include in a partial response.
357
+ # @param [String] quota_user
358
+ # Available to use for quota purposes for server-side applications. Can be any
359
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
360
+ # @param [Google::Apis::RequestOptions] options
361
+ # Request-specific options
362
+ #
363
+ # @yield [result, err] Result & error if block supplied
364
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
365
+ # @yieldparam err [StandardError] error object if request failed
366
+ #
367
+ # @return [Google::Apis::BackupdrV1::Operation]
368
+ #
369
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
370
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
371
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
372
+ def create_project_location_backup_plan(parent, backup_plan_object = nil, backup_plan_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
373
+ command = make_simple_command(:post, 'v1/{+parent}/backupPlans', options)
374
+ command.request_representation = Google::Apis::BackupdrV1::BackupPlan::Representation
375
+ command.request_object = backup_plan_object
376
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
377
+ command.response_class = Google::Apis::BackupdrV1::Operation
378
+ command.params['parent'] = parent unless parent.nil?
379
+ command.query['backupPlanId'] = backup_plan_id unless backup_plan_id.nil?
380
+ command.query['requestId'] = request_id unless request_id.nil?
381
+ command.query['fields'] = fields unless fields.nil?
382
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
383
+ execute_or_queue_command(command, &block)
384
+ end
385
+
386
+ # Deletes a single BackupPlan.
387
+ # @param [String] name
388
+ # Required. The resource name of the `BackupPlan` to delete. Format: `projects/`
389
+ # project`/locations/`location`/backupPlans/`backup_plan``
390
+ # @param [String] request_id
391
+ # Optional. An optional request ID to identify requests. Specify a unique
392
+ # request ID so that if you must retry your request, the server will know to
393
+ # ignore the request if it has already been completed. The server will guarantee
394
+ # that for at least 60 minutes after the first request. For example, consider a
395
+ # situation where you make an initial request and the request times out. If you
396
+ # make the request again with the same request ID, the server can check if
397
+ # original operation with the same request ID was received, and if so, will
398
+ # ignore the second request. This prevents clients from accidentally creating
399
+ # duplicate commitments. The request ID must be a valid UUID with the exception
400
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
401
+ # @param [String] fields
402
+ # Selector specifying which fields to include in a partial response.
403
+ # @param [String] quota_user
404
+ # Available to use for quota purposes for server-side applications. Can be any
405
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
406
+ # @param [Google::Apis::RequestOptions] options
407
+ # Request-specific options
408
+ #
409
+ # @yield [result, err] Result & error if block supplied
410
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
411
+ # @yieldparam err [StandardError] error object if request failed
412
+ #
413
+ # @return [Google::Apis::BackupdrV1::Operation]
414
+ #
415
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
416
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
417
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
418
+ def delete_project_location_backup_plan(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
419
+ command = make_simple_command(:delete, 'v1/{+name}', options)
420
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
421
+ command.response_class = Google::Apis::BackupdrV1::Operation
422
+ command.params['name'] = name unless name.nil?
423
+ command.query['requestId'] = request_id unless request_id.nil?
424
+ command.query['fields'] = fields unless fields.nil?
425
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
426
+ execute_or_queue_command(command, &block)
427
+ end
428
+
429
+ # Gets details of a single BackupPlan.
430
+ # @param [String] name
431
+ # Required. The resource name of the `BackupPlan` to retrieve. Format: `projects/
432
+ # `project`/locations/`location`/backupPlans/`backup_plan``
433
+ # @param [String] fields
434
+ # Selector specifying which fields to include in a partial response.
435
+ # @param [String] quota_user
436
+ # Available to use for quota purposes for server-side applications. Can be any
437
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
438
+ # @param [Google::Apis::RequestOptions] options
439
+ # Request-specific options
440
+ #
441
+ # @yield [result, err] Result & error if block supplied
442
+ # @yieldparam result [Google::Apis::BackupdrV1::BackupPlan] parsed result object
443
+ # @yieldparam err [StandardError] error object if request failed
444
+ #
445
+ # @return [Google::Apis::BackupdrV1::BackupPlan]
446
+ #
447
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
448
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
449
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
450
+ def get_project_location_backup_plan(name, fields: nil, quota_user: nil, options: nil, &block)
451
+ command = make_simple_command(:get, 'v1/{+name}', options)
452
+ command.response_representation = Google::Apis::BackupdrV1::BackupPlan::Representation
453
+ command.response_class = Google::Apis::BackupdrV1::BackupPlan
454
+ command.params['name'] = name unless name.nil?
455
+ command.query['fields'] = fields unless fields.nil?
456
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
457
+ execute_or_queue_command(command, &block)
458
+ end
459
+
460
+ # Lists BackupPlans in a given project and location.
461
+ # @param [String] parent
462
+ # Required. The project and location for which to retrieve `BackupPlans`
463
+ # information. Format: `projects/`project`/locations/`location``. In Cloud
464
+ # BackupDR, locations map to GCP regions, for e.g. **us-central1**. To retrieve
465
+ # backup plans for all locations, use "-" for the ``location`` value.
466
+ # @param [String] filter
467
+ # Optional. Field match expression used to filter the results.
468
+ # @param [String] order_by
469
+ # Optional. Field by which to sort the results.
470
+ # @param [Fixnum] page_size
471
+ # Optional. The maximum number of `BackupPlans` to return in a single response.
472
+ # If not specified, a default value will be chosen by the service. Note that the
473
+ # response may include a partial list and a caller should only rely on the
474
+ # response's next_page_token to determine if there are more instances left to be
475
+ # queried.
476
+ # @param [String] page_token
477
+ # Optional. The value of next_page_token received from a previous `
478
+ # ListBackupPlans` call. Provide this to retrieve the subsequent page in a multi-
479
+ # page list of results. When paginating, all other parameters provided to `
480
+ # ListBackupPlans` must match the call that provided the page token.
481
+ # @param [String] fields
482
+ # Selector specifying which fields to include in a partial response.
483
+ # @param [String] quota_user
484
+ # Available to use for quota purposes for server-side applications. Can be any
485
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
486
+ # @param [Google::Apis::RequestOptions] options
487
+ # Request-specific options
488
+ #
489
+ # @yield [result, err] Result & error if block supplied
490
+ # @yieldparam result [Google::Apis::BackupdrV1::ListBackupPlansResponse] parsed result object
491
+ # @yieldparam err [StandardError] error object if request failed
492
+ #
493
+ # @return [Google::Apis::BackupdrV1::ListBackupPlansResponse]
494
+ #
495
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
496
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
497
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
498
+ def list_project_location_backup_plans(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
499
+ command = make_simple_command(:get, 'v1/{+parent}/backupPlans', options)
500
+ command.response_representation = Google::Apis::BackupdrV1::ListBackupPlansResponse::Representation
501
+ command.response_class = Google::Apis::BackupdrV1::ListBackupPlansResponse
502
+ command.params['parent'] = parent unless parent.nil?
503
+ command.query['filter'] = filter unless filter.nil?
504
+ command.query['orderBy'] = order_by unless order_by.nil?
505
+ command.query['pageSize'] = page_size unless page_size.nil?
506
+ command.query['pageToken'] = page_token unless page_token.nil?
507
+ command.query['fields'] = fields unless fields.nil?
508
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
509
+ execute_or_queue_command(command, &block)
510
+ end
511
+
512
+ #
513
+ # @param [String] parent
514
+ # Required. Value for parent.
515
+ # @param [Google::Apis::BackupdrV1::BackupVault] backup_vault_object
516
+ # @param [String] backup_vault_id
517
+ # Required. ID of the requesting object If auto-generating ID server-side,
518
+ # remove this field and backup_vault_id from the method_signature of Create RPC
519
+ # @param [String] request_id
520
+ # Optional. An optional request ID to identify requests. Specify a unique
521
+ # request ID so that if you must retry your request, the server will know to
522
+ # ignore the request if it has already been completed. The server will guarantee
523
+ # that for at least 60 minutes since the first request. For example, consider a
524
+ # situation where you make an initial request and the request times out. If you
525
+ # make the request again with the same request ID, the server can check if
526
+ # original operation with the same request ID was received, and if so, will
527
+ # ignore the second request. This prevents clients from accidentally creating
528
+ # duplicate commitments. The request ID must be a valid UUID with the exception
529
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
530
+ # @param [Boolean] validate_only
531
+ # Optional. Only validate the request, but do not perform mutations. The default
532
+ # is 'false'.
533
+ # @param [String] fields
534
+ # Selector specifying which fields to include in a partial response.
535
+ # @param [String] quota_user
536
+ # Available to use for quota purposes for server-side applications. Can be any
537
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
538
+ # @param [Google::Apis::RequestOptions] options
539
+ # Request-specific options
540
+ #
541
+ # @yield [result, err] Result & error if block supplied
542
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
543
+ # @yieldparam err [StandardError] error object if request failed
544
+ #
545
+ # @return [Google::Apis::BackupdrV1::Operation]
546
+ #
547
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
548
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
549
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
550
+ def create_project_location_backup_vault(parent, backup_vault_object = nil, backup_vault_id: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
551
+ command = make_simple_command(:post, 'v1/{+parent}/backupVaults', options)
552
+ command.request_representation = Google::Apis::BackupdrV1::BackupVault::Representation
553
+ command.request_object = backup_vault_object
554
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
555
+ command.response_class = Google::Apis::BackupdrV1::Operation
556
+ command.params['parent'] = parent unless parent.nil?
557
+ command.query['backupVaultId'] = backup_vault_id unless backup_vault_id.nil?
558
+ command.query['requestId'] = request_id unless request_id.nil?
559
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
560
+ command.query['fields'] = fields unless fields.nil?
561
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
562
+ execute_or_queue_command(command, &block)
563
+ end
564
+
565
+ # Deletes a BackupVault.
566
+ # @param [String] name
567
+ # Required. Name of the resource.
568
+ # @param [Boolean] allow_missing
569
+ # Optional. If true and the BackupVault is not found, the request will succeed
570
+ # but no action will be taken.
571
+ # @param [String] etag
572
+ # The current etag of the backup vault. If an etag is provided and does not
573
+ # match the current etag of the connection, deletion will be blocked.
574
+ # @param [Boolean] force
575
+ # Optional. If set to true, any data source from this backup vault will also be
576
+ # deleted.
577
+ # @param [String] request_id
578
+ # Optional. An optional request ID to identify requests. Specify a unique
579
+ # request ID so that if you must retry your request, the server will know to
580
+ # ignore the request if it has already been completed. The server will guarantee
581
+ # that for at least 60 minutes after the first request. For example, consider a
582
+ # situation where you make an initial request and the request times out. If you
583
+ # make the request again with the same request ID, the server can check if
584
+ # original operation with the same request ID was received, and if so, will
585
+ # ignore the second request. This prevents clients from accidentally creating
586
+ # duplicate commitments. The request ID must be a valid UUID with the exception
587
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
588
+ # @param [Boolean] validate_only
589
+ # Optional. Only validate the request, but do not perform mutations. The default
590
+ # is 'false'.
591
+ # @param [String] fields
592
+ # Selector specifying which fields to include in a partial response.
593
+ # @param [String] quota_user
594
+ # Available to use for quota purposes for server-side applications. Can be any
595
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
596
+ # @param [Google::Apis::RequestOptions] options
597
+ # Request-specific options
598
+ #
599
+ # @yield [result, err] Result & error if block supplied
600
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
601
+ # @yieldparam err [StandardError] error object if request failed
602
+ #
603
+ # @return [Google::Apis::BackupdrV1::Operation]
604
+ #
605
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
606
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
607
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
608
+ def delete_project_location_backup_vault(name, allow_missing: nil, etag: nil, force: nil, request_id: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
609
+ command = make_simple_command(:delete, 'v1/{+name}', options)
610
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
611
+ command.response_class = Google::Apis::BackupdrV1::Operation
612
+ command.params['name'] = name unless name.nil?
613
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
614
+ command.query['etag'] = etag unless etag.nil?
615
+ command.query['force'] = force unless force.nil?
616
+ command.query['requestId'] = request_id unless request_id.nil?
617
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
618
+ command.query['fields'] = fields unless fields.nil?
619
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
620
+ execute_or_queue_command(command, &block)
621
+ end
622
+
623
+ # FetchUsableBackupVaults lists usable BackupVaults in a given project and
624
+ # location. Usable BackupVault are the ones that user has backupdr.backupVaults.
625
+ # get permission.
626
+ # @param [String] parent
627
+ # Required. The project and location for which to retrieve backupvault stores
628
+ # information, in the format 'projects/`project_id`/locations/`location`'. In
629
+ # Cloud Backup and DR, locations map to Google Cloud regions, for example **us-
630
+ # central1**. To retrieve backupvault stores for all locations, use "-" for the '
631
+ # `location`' value.
632
+ # @param [String] filter
633
+ # Optional. Filtering results.
634
+ # @param [String] order_by
635
+ # Optional. Hint for how to order the results.
636
+ # @param [Fixnum] page_size
637
+ # Optional. Requested page size. Server may return fewer items than requested.
638
+ # If unspecified, server will pick an appropriate default.
639
+ # @param [String] page_token
640
+ # Optional. A token identifying a page of results the server should return.
641
+ # @param [String] fields
642
+ # Selector specifying which fields to include in a partial response.
643
+ # @param [String] quota_user
644
+ # Available to use for quota purposes for server-side applications. Can be any
645
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
646
+ # @param [Google::Apis::RequestOptions] options
647
+ # Request-specific options
648
+ #
649
+ # @yield [result, err] Result & error if block supplied
650
+ # @yieldparam result [Google::Apis::BackupdrV1::FetchUsableBackupVaultsResponse] parsed result object
651
+ # @yieldparam err [StandardError] error object if request failed
652
+ #
653
+ # @return [Google::Apis::BackupdrV1::FetchUsableBackupVaultsResponse]
654
+ #
655
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
656
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
657
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
658
+ def fetch_project_location_backup_vault_usable(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
659
+ command = make_simple_command(:get, 'v1/{+parent}/backupVaults:fetchUsable', options)
660
+ command.response_representation = Google::Apis::BackupdrV1::FetchUsableBackupVaultsResponse::Representation
661
+ command.response_class = Google::Apis::BackupdrV1::FetchUsableBackupVaultsResponse
662
+ command.params['parent'] = parent unless parent.nil?
663
+ command.query['filter'] = filter unless filter.nil?
664
+ command.query['orderBy'] = order_by unless order_by.nil?
665
+ command.query['pageSize'] = page_size unless page_size.nil?
666
+ command.query['pageToken'] = page_token unless page_token.nil?
667
+ command.query['fields'] = fields unless fields.nil?
668
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
669
+ execute_or_queue_command(command, &block)
670
+ end
671
+
672
+ # Gets details of a BackupVault.
673
+ # @param [String] name
674
+ # Required. Name of the backupvault store resource name, in the format 'projects/
675
+ # `project_id`/locations/`location`/backupVaults/`resource_name`'
676
+ # @param [String] fields
677
+ # Selector specifying which fields to include in a partial response.
678
+ # @param [String] quota_user
679
+ # Available to use for quota purposes for server-side applications. Can be any
680
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
681
+ # @param [Google::Apis::RequestOptions] options
682
+ # Request-specific options
683
+ #
684
+ # @yield [result, err] Result & error if block supplied
685
+ # @yieldparam result [Google::Apis::BackupdrV1::BackupVault] parsed result object
686
+ # @yieldparam err [StandardError] error object if request failed
687
+ #
688
+ # @return [Google::Apis::BackupdrV1::BackupVault]
689
+ #
690
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
691
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
692
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
693
+ def get_project_location_backup_vault(name, fields: nil, quota_user: nil, options: nil, &block)
694
+ command = make_simple_command(:get, 'v1/{+name}', options)
695
+ command.response_representation = Google::Apis::BackupdrV1::BackupVault::Representation
696
+ command.response_class = Google::Apis::BackupdrV1::BackupVault
697
+ command.params['name'] = name unless name.nil?
698
+ command.query['fields'] = fields unless fields.nil?
699
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
700
+ execute_or_queue_command(command, &block)
701
+ end
702
+
703
+ # Lists BackupVaults in a given project and location.
704
+ # @param [String] parent
705
+ # Required. The project and location for which to retrieve backupvault stores
706
+ # information, in the format 'projects/`project_id`/locations/`location`'. In
707
+ # Cloud Backup and DR, locations map to Google Cloud regions, for example **us-
708
+ # central1**. To retrieve backupvault stores for all locations, use "-" for the '
709
+ # `location`' value.
710
+ # @param [String] filter
711
+ # Optional. Filtering results.
712
+ # @param [String] order_by
713
+ # Optional. Hint for how to order the results.
714
+ # @param [Fixnum] page_size
715
+ # Optional. Requested page size. Server may return fewer items than requested.
716
+ # If unspecified, server will pick an appropriate default.
717
+ # @param [String] page_token
718
+ # Optional. A token identifying a page of results the server should return.
719
+ # @param [String] fields
720
+ # Selector specifying which fields to include in a partial response.
721
+ # @param [String] quota_user
722
+ # Available to use for quota purposes for server-side applications. Can be any
723
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
724
+ # @param [Google::Apis::RequestOptions] options
725
+ # Request-specific options
726
+ #
727
+ # @yield [result, err] Result & error if block supplied
728
+ # @yieldparam result [Google::Apis::BackupdrV1::ListBackupVaultsResponse] parsed result object
729
+ # @yieldparam err [StandardError] error object if request failed
730
+ #
731
+ # @return [Google::Apis::BackupdrV1::ListBackupVaultsResponse]
732
+ #
733
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
734
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
735
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
736
+ def list_project_location_backup_vaults(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
737
+ command = make_simple_command(:get, 'v1/{+parent}/backupVaults', options)
738
+ command.response_representation = Google::Apis::BackupdrV1::ListBackupVaultsResponse::Representation
739
+ command.response_class = Google::Apis::BackupdrV1::ListBackupVaultsResponse
740
+ command.params['parent'] = parent unless parent.nil?
741
+ command.query['filter'] = filter unless filter.nil?
742
+ command.query['orderBy'] = order_by unless order_by.nil?
743
+ command.query['pageSize'] = page_size unless page_size.nil?
744
+ command.query['pageToken'] = page_token unless page_token.nil?
745
+ command.query['fields'] = fields unless fields.nil?
746
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
747
+ execute_or_queue_command(command, &block)
748
+ end
749
+
750
+ # Updates the settings of a BackupVault.
751
+ # @param [String] name
752
+ # Output only. Identifier. The resource name.
753
+ # @param [Google::Apis::BackupdrV1::BackupVault] backup_vault_object
754
+ # @param [Boolean] force
755
+ # Optional. If set to true, will not check plan duration against backup vault
756
+ # enforcement duration.
757
+ # @param [String] request_id
758
+ # Optional. An optional request ID to identify requests. Specify a unique
759
+ # request ID so that if you must retry your request, the server will know to
760
+ # ignore the request if it has already been completed. The server will guarantee
761
+ # that for at least 60 minutes since the first request. For example, consider a
762
+ # situation where you make an initial request and the request times out. If you
763
+ # make the request again with the same request ID, the server can check if
764
+ # original operation with the same request ID was received, and if so, will
765
+ # ignore the second request. This prevents clients from accidentally creating
766
+ # duplicate commitments. The request ID must be a valid UUID with the exception
767
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
768
+ # @param [String] update_mask
769
+ # Required. Field mask is used to specify the fields to be overwritten in the
770
+ # BackupVault resource by the update. The fields specified in the update_mask
771
+ # are relative to the resource, not the full request. A field will be
772
+ # overwritten if it is in the mask. If the user does not provide a mask then the
773
+ # request will fail.
774
+ # @param [Boolean] validate_only
775
+ # Optional. Only validate the request, but do not perform mutations. The default
776
+ # is 'false'.
777
+ # @param [String] fields
778
+ # Selector specifying which fields to include in a partial response.
779
+ # @param [String] quota_user
780
+ # Available to use for quota purposes for server-side applications. Can be any
781
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
782
+ # @param [Google::Apis::RequestOptions] options
783
+ # Request-specific options
784
+ #
785
+ # @yield [result, err] Result & error if block supplied
786
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
787
+ # @yieldparam err [StandardError] error object if request failed
788
+ #
789
+ # @return [Google::Apis::BackupdrV1::Operation]
790
+ #
791
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
792
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
793
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
794
+ def patch_project_location_backup_vault(name, backup_vault_object = nil, force: nil, request_id: nil, update_mask: nil, validate_only: nil, fields: nil, quota_user: nil, options: nil, &block)
795
+ command = make_simple_command(:patch, 'v1/{+name}', options)
796
+ command.request_representation = Google::Apis::BackupdrV1::BackupVault::Representation
797
+ command.request_object = backup_vault_object
798
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
799
+ command.response_class = Google::Apis::BackupdrV1::Operation
800
+ command.params['name'] = name unless name.nil?
801
+ command.query['force'] = force unless force.nil?
802
+ command.query['requestId'] = request_id unless request_id.nil?
803
+ command.query['updateMask'] = update_mask unless update_mask.nil?
804
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
805
+ command.query['fields'] = fields unless fields.nil?
806
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
807
+ execute_or_queue_command(command, &block)
808
+ end
809
+
810
+ # Returns the caller's permissions on a BackupVault resource. A caller is not
811
+ # required to have Google IAM permission to make this request.
812
+ # @param [String] resource
813
+ # REQUIRED: The resource for which the policy detail is being requested. See [
814
+ # Resource names](https://cloud.google.com/apis/design/resource_names) for the
815
+ # appropriate value for this field.
816
+ # @param [Google::Apis::BackupdrV1::TestIamPermissionsRequest] test_iam_permissions_request_object
817
+ # @param [String] fields
818
+ # Selector specifying which fields to include in a partial response.
819
+ # @param [String] quota_user
820
+ # Available to use for quota purposes for server-side applications. Can be any
821
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
822
+ # @param [Google::Apis::RequestOptions] options
823
+ # Request-specific options
824
+ #
825
+ # @yield [result, err] Result & error if block supplied
826
+ # @yieldparam result [Google::Apis::BackupdrV1::TestIamPermissionsResponse] parsed result object
827
+ # @yieldparam err [StandardError] error object if request failed
828
+ #
829
+ # @return [Google::Apis::BackupdrV1::TestIamPermissionsResponse]
830
+ #
831
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
832
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
833
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
834
+ def test_backup_vault_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
835
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
836
+ command.request_representation = Google::Apis::BackupdrV1::TestIamPermissionsRequest::Representation
837
+ command.request_object = test_iam_permissions_request_object
838
+ command.response_representation = Google::Apis::BackupdrV1::TestIamPermissionsResponse::Representation
839
+ command.response_class = Google::Apis::BackupdrV1::TestIamPermissionsResponse
840
+ command.params['resource'] = resource unless resource.nil?
841
+ command.query['fields'] = fields unless fields.nil?
842
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
843
+ execute_or_queue_command(command, &block)
844
+ end
845
+
846
+ # Internal only. Abandons a backup.
847
+ # @param [String] data_source
848
+ # Required. The resource name of the instance, in the format 'projects/*/
849
+ # locations/*/backupVaults/*/dataSources/'.
850
+ # @param [Google::Apis::BackupdrV1::AbandonBackupRequest] abandon_backup_request_object
851
+ # @param [String] fields
852
+ # Selector specifying which fields to include in a partial response.
853
+ # @param [String] quota_user
854
+ # Available to use for quota purposes for server-side applications. Can be any
855
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
856
+ # @param [Google::Apis::RequestOptions] options
857
+ # Request-specific options
858
+ #
859
+ # @yield [result, err] Result & error if block supplied
860
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
861
+ # @yieldparam err [StandardError] error object if request failed
862
+ #
863
+ # @return [Google::Apis::BackupdrV1::Operation]
864
+ #
865
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
866
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
867
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
868
+ def abandon_data_source_backup(data_source, abandon_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
869
+ command = make_simple_command(:post, 'v1/{+dataSource}:abandonBackup', options)
870
+ command.request_representation = Google::Apis::BackupdrV1::AbandonBackupRequest::Representation
871
+ command.request_object = abandon_backup_request_object
872
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
873
+ command.response_class = Google::Apis::BackupdrV1::Operation
874
+ command.params['dataSource'] = data_source unless data_source.nil?
875
+ command.query['fields'] = fields unless fields.nil?
876
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
877
+ execute_or_queue_command(command, &block)
878
+ end
879
+
880
+ # Internal only. Fetch access token for a given data source.
881
+ # @param [String] name
882
+ # Required. The resource name for the location for which static IPs should be
883
+ # returned. Must be in the format 'projects/*/locations/*/backupVaults/*/
884
+ # dataSources'.
885
+ # @param [Google::Apis::BackupdrV1::FetchAccessTokenRequest] fetch_access_token_request_object
886
+ # @param [String] fields
887
+ # Selector specifying which fields to include in a partial response.
888
+ # @param [String] quota_user
889
+ # Available to use for quota purposes for server-side applications. Can be any
890
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
891
+ # @param [Google::Apis::RequestOptions] options
892
+ # Request-specific options
893
+ #
894
+ # @yield [result, err] Result & error if block supplied
895
+ # @yieldparam result [Google::Apis::BackupdrV1::FetchAccessTokenResponse] parsed result object
896
+ # @yieldparam err [StandardError] error object if request failed
897
+ #
898
+ # @return [Google::Apis::BackupdrV1::FetchAccessTokenResponse]
899
+ #
900
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
901
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
902
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
903
+ def fetch_data_source_access_token(name, fetch_access_token_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
904
+ command = make_simple_command(:post, 'v1/{+name}:fetchAccessToken', options)
905
+ command.request_representation = Google::Apis::BackupdrV1::FetchAccessTokenRequest::Representation
906
+ command.request_object = fetch_access_token_request_object
907
+ command.response_representation = Google::Apis::BackupdrV1::FetchAccessTokenResponse::Representation
908
+ command.response_class = Google::Apis::BackupdrV1::FetchAccessTokenResponse
909
+ command.params['name'] = name unless name.nil?
910
+ command.query['fields'] = fields unless fields.nil?
911
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
912
+ execute_or_queue_command(command, &block)
913
+ end
914
+
915
+ # Internal only. Finalize a backup that was started by a call to InitiateBackup.
916
+ # @param [String] data_source
917
+ # Required. The resource name of the instance, in the format 'projects/*/
918
+ # locations/*/backupVaults/*/dataSources/'.
919
+ # @param [Google::Apis::BackupdrV1::FinalizeBackupRequest] finalize_backup_request_object
920
+ # @param [String] fields
921
+ # Selector specifying which fields to include in a partial response.
922
+ # @param [String] quota_user
923
+ # Available to use for quota purposes for server-side applications. Can be any
924
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
925
+ # @param [Google::Apis::RequestOptions] options
926
+ # Request-specific options
927
+ #
928
+ # @yield [result, err] Result & error if block supplied
929
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
930
+ # @yieldparam err [StandardError] error object if request failed
931
+ #
932
+ # @return [Google::Apis::BackupdrV1::Operation]
933
+ #
934
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
935
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
936
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
937
+ def finalize_data_source_backup(data_source, finalize_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
938
+ command = make_simple_command(:post, 'v1/{+dataSource}:finalizeBackup', options)
939
+ command.request_representation = Google::Apis::BackupdrV1::FinalizeBackupRequest::Representation
940
+ command.request_object = finalize_backup_request_object
941
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
942
+ command.response_class = Google::Apis::BackupdrV1::Operation
943
+ command.params['dataSource'] = data_source unless data_source.nil?
944
+ command.query['fields'] = fields unless fields.nil?
945
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
946
+ execute_or_queue_command(command, &block)
947
+ end
948
+
949
+ # Gets details of a DataSource.
950
+ # @param [String] name
951
+ # Required. Name of the data source resource name, in the format 'projects/`
952
+ # project_id`/locations/`location`/backupVaults/`resource_name`/dataSource/`
953
+ # resource_name`'
954
+ # @param [String] fields
955
+ # Selector specifying which fields to include in a partial response.
956
+ # @param [String] quota_user
957
+ # Available to use for quota purposes for server-side applications. Can be any
958
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
959
+ # @param [Google::Apis::RequestOptions] options
960
+ # Request-specific options
961
+ #
962
+ # @yield [result, err] Result & error if block supplied
963
+ # @yieldparam result [Google::Apis::BackupdrV1::DataSource] parsed result object
964
+ # @yieldparam err [StandardError] error object if request failed
965
+ #
966
+ # @return [Google::Apis::BackupdrV1::DataSource]
967
+ #
968
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
969
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
970
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
971
+ def get_project_location_backup_vault_data_source(name, fields: nil, quota_user: nil, options: nil, &block)
972
+ command = make_simple_command(:get, 'v1/{+name}', options)
973
+ command.response_representation = Google::Apis::BackupdrV1::DataSource::Representation
974
+ command.response_class = Google::Apis::BackupdrV1::DataSource
975
+ command.params['name'] = name unless name.nil?
976
+ command.query['fields'] = fields unless fields.nil?
977
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
978
+ execute_or_queue_command(command, &block)
979
+ end
980
+
981
+ # Internal only. Initiates a backup.
982
+ # @param [String] data_source
983
+ # Required. The resource name of the instance, in the format 'projects/*/
984
+ # locations/*/backupVaults/*/dataSources/'.
985
+ # @param [Google::Apis::BackupdrV1::InitiateBackupRequest] initiate_backup_request_object
986
+ # @param [String] fields
987
+ # Selector specifying which fields to include in a partial response.
988
+ # @param [String] quota_user
989
+ # Available to use for quota purposes for server-side applications. Can be any
990
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
991
+ # @param [Google::Apis::RequestOptions] options
992
+ # Request-specific options
993
+ #
994
+ # @yield [result, err] Result & error if block supplied
995
+ # @yieldparam result [Google::Apis::BackupdrV1::InitiateBackupResponse] parsed result object
996
+ # @yieldparam err [StandardError] error object if request failed
997
+ #
998
+ # @return [Google::Apis::BackupdrV1::InitiateBackupResponse]
999
+ #
1000
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1001
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1002
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1003
+ def initiate_data_source_backup(data_source, initiate_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1004
+ command = make_simple_command(:post, 'v1/{+dataSource}:initiateBackup', options)
1005
+ command.request_representation = Google::Apis::BackupdrV1::InitiateBackupRequest::Representation
1006
+ command.request_object = initiate_backup_request_object
1007
+ command.response_representation = Google::Apis::BackupdrV1::InitiateBackupResponse::Representation
1008
+ command.response_class = Google::Apis::BackupdrV1::InitiateBackupResponse
1009
+ command.params['dataSource'] = data_source unless data_source.nil?
1010
+ command.query['fields'] = fields unless fields.nil?
1011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1012
+ execute_or_queue_command(command, &block)
1013
+ end
1014
+
1015
+ # Lists DataSources in a given project and location.
1016
+ # @param [String] parent
1017
+ # Required. The project and location for which to retrieve data sources
1018
+ # information, in the format 'projects/`project_id`/locations/`location`'. In
1019
+ # Cloud Backup and DR, locations map to Google Cloud regions, for example **us-
1020
+ # central1**. To retrieve data sources for all locations, use "-" for the '`
1021
+ # location`' value.
1022
+ # @param [String] filter
1023
+ # Optional. Filtering results.
1024
+ # @param [String] order_by
1025
+ # Optional. Hint for how to order the results.
1026
+ # @param [Fixnum] page_size
1027
+ # Optional. Requested page size. Server may return fewer items than requested.
1028
+ # If unspecified, server will pick an appropriate default.
1029
+ # @param [String] page_token
1030
+ # Optional. A token identifying a page of results the server should return.
1031
+ # @param [String] fields
1032
+ # Selector specifying which fields to include in a partial response.
1033
+ # @param [String] quota_user
1034
+ # Available to use for quota purposes for server-side applications. Can be any
1035
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1036
+ # @param [Google::Apis::RequestOptions] options
1037
+ # Request-specific options
1038
+ #
1039
+ # @yield [result, err] Result & error if block supplied
1040
+ # @yieldparam result [Google::Apis::BackupdrV1::ListDataSourcesResponse] parsed result object
1041
+ # @yieldparam err [StandardError] error object if request failed
1042
+ #
1043
+ # @return [Google::Apis::BackupdrV1::ListDataSourcesResponse]
1044
+ #
1045
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1046
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1047
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1048
+ def list_project_location_backup_vault_data_sources(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1049
+ command = make_simple_command(:get, 'v1/{+parent}/dataSources', options)
1050
+ command.response_representation = Google::Apis::BackupdrV1::ListDataSourcesResponse::Representation
1051
+ command.response_class = Google::Apis::BackupdrV1::ListDataSourcesResponse
1052
+ command.params['parent'] = parent unless parent.nil?
1053
+ command.query['filter'] = filter unless filter.nil?
1054
+ command.query['orderBy'] = order_by unless order_by.nil?
1055
+ command.query['pageSize'] = page_size unless page_size.nil?
1056
+ command.query['pageToken'] = page_token unless page_token.nil?
1057
+ command.query['fields'] = fields unless fields.nil?
1058
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1059
+ execute_or_queue_command(command, &block)
1060
+ end
1061
+
1062
+ # Updates the settings of a DataSource.
1063
+ # @param [String] name
1064
+ # Output only. Identifier. The resource name.
1065
+ # @param [Google::Apis::BackupdrV1::DataSource] data_source_object
1066
+ # @param [Boolean] allow_missing
1067
+ # Optional. Enable upsert.
1068
+ # @param [String] request_id
1069
+ # Optional. An optional request ID to identify requests. Specify a unique
1070
+ # request ID so that if you must retry your request, the server will know to
1071
+ # ignore the request if it has already been completed. The server will guarantee
1072
+ # that for at least 60 minutes since the first request. For example, consider a
1073
+ # situation where you make an initial request and the request times out. If you
1074
+ # make the request again with the same request ID, the server can check if
1075
+ # original operation with the same request ID was received, and if so, will
1076
+ # ignore the second request. This prevents clients from accidentally creating
1077
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1078
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1079
+ # @param [String] update_mask
1080
+ # Required. Field mask is used to specify the fields to be overwritten in the
1081
+ # DataSource resource by the update. The fields specified in the update_mask are
1082
+ # relative to the resource, not the full request. A field will be overwritten if
1083
+ # it is in the mask. If the user does not provide a mask then the request will
1084
+ # fail.
1085
+ # @param [String] fields
1086
+ # Selector specifying which fields to include in a partial response.
1087
+ # @param [String] quota_user
1088
+ # Available to use for quota purposes for server-side applications. Can be any
1089
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1090
+ # @param [Google::Apis::RequestOptions] options
1091
+ # Request-specific options
1092
+ #
1093
+ # @yield [result, err] Result & error if block supplied
1094
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1095
+ # @yieldparam err [StandardError] error object if request failed
1096
+ #
1097
+ # @return [Google::Apis::BackupdrV1::Operation]
1098
+ #
1099
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1100
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1101
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1102
+ def patch_project_location_backup_vault_data_source(name, data_source_object = nil, allow_missing: nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1103
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1104
+ command.request_representation = Google::Apis::BackupdrV1::DataSource::Representation
1105
+ command.request_object = data_source_object
1106
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1107
+ command.response_class = Google::Apis::BackupdrV1::Operation
1108
+ command.params['name'] = name unless name.nil?
1109
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
1110
+ command.query['requestId'] = request_id unless request_id.nil?
1111
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1112
+ command.query['fields'] = fields unless fields.nil?
1113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1114
+ execute_or_queue_command(command, &block)
1115
+ end
1116
+
1117
+ # Deletes a DataSource. This is a custom method instead of a standard delete
1118
+ # method because external clients will not delete DataSources except for
1119
+ # BackupDR backup appliances.
1120
+ # @param [String] name
1121
+ # Required. Name of the resource.
1122
+ # @param [Google::Apis::BackupdrV1::RemoveDataSourceRequest] remove_data_source_request_object
1123
+ # @param [String] fields
1124
+ # Selector specifying which fields to include in a partial response.
1125
+ # @param [String] quota_user
1126
+ # Available to use for quota purposes for server-side applications. Can be any
1127
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1128
+ # @param [Google::Apis::RequestOptions] options
1129
+ # Request-specific options
1130
+ #
1131
+ # @yield [result, err] Result & error if block supplied
1132
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1133
+ # @yieldparam err [StandardError] error object if request failed
1134
+ #
1135
+ # @return [Google::Apis::BackupdrV1::Operation]
1136
+ #
1137
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1138
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1139
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1140
+ def remove_data_source(name, remove_data_source_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1141
+ command = make_simple_command(:post, 'v1/{+name}:remove', options)
1142
+ command.request_representation = Google::Apis::BackupdrV1::RemoveDataSourceRequest::Representation
1143
+ command.request_object = remove_data_source_request_object
1144
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1145
+ command.response_class = Google::Apis::BackupdrV1::Operation
1146
+ command.params['name'] = name unless name.nil?
1147
+ command.query['fields'] = fields unless fields.nil?
1148
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1149
+ execute_or_queue_command(command, &block)
1150
+ end
1151
+
1152
+ # Sets the internal status of a DataSource.
1153
+ # @param [String] data_source
1154
+ # Required. The resource name of the instance, in the format 'projects/*/
1155
+ # locations/*/backupVaults/*/dataSources/'.
1156
+ # @param [Google::Apis::BackupdrV1::SetInternalStatusRequest] set_internal_status_request_object
1157
+ # @param [String] fields
1158
+ # Selector specifying which fields to include in a partial response.
1159
+ # @param [String] quota_user
1160
+ # Available to use for quota purposes for server-side applications. Can be any
1161
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1162
+ # @param [Google::Apis::RequestOptions] options
1163
+ # Request-specific options
1164
+ #
1165
+ # @yield [result, err] Result & error if block supplied
1166
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1167
+ # @yieldparam err [StandardError] error object if request failed
1168
+ #
1169
+ # @return [Google::Apis::BackupdrV1::Operation]
1170
+ #
1171
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1172
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1173
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1174
+ def set_data_source_internal_status(data_source, set_internal_status_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1175
+ command = make_simple_command(:post, 'v1/{+dataSource}:setInternalStatus', options)
1176
+ command.request_representation = Google::Apis::BackupdrV1::SetInternalStatusRequest::Representation
1177
+ command.request_object = set_internal_status_request_object
1178
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1179
+ command.response_class = Google::Apis::BackupdrV1::Operation
1180
+ command.params['dataSource'] = data_source unless data_source.nil?
1181
+ command.query['fields'] = fields unless fields.nil?
1182
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1183
+ execute_or_queue_command(command, &block)
1184
+ end
1185
+
1186
+ # Deletes a Backup.
1187
+ # @param [String] name
1188
+ # Required. Name of the resource.
1189
+ # @param [String] request_id
1190
+ # Optional. An optional request ID to identify requests. Specify a unique
1191
+ # request ID so that if you must retry your request, the server will know to
1192
+ # ignore the request if it has already been completed. The server will guarantee
1193
+ # that for at least 60 minutes after the first request. For example, consider a
1194
+ # situation where you make an initial request and the request times out. If you
1195
+ # make the request again with the same request ID, the server can check if
1196
+ # original operation with the same request ID was received, and if so, will
1197
+ # ignore the second request. This prevents clients from accidentally creating
1198
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1199
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1200
+ # @param [String] fields
1201
+ # Selector specifying which fields to include in a partial response.
1202
+ # @param [String] quota_user
1203
+ # Available to use for quota purposes for server-side applications. Can be any
1204
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1205
+ # @param [Google::Apis::RequestOptions] options
1206
+ # Request-specific options
1207
+ #
1208
+ # @yield [result, err] Result & error if block supplied
1209
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1210
+ # @yieldparam err [StandardError] error object if request failed
1211
+ #
1212
+ # @return [Google::Apis::BackupdrV1::Operation]
1213
+ #
1214
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1215
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1216
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1217
+ def delete_project_location_backup_vault_data_source_backup(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1218
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1219
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1220
+ command.response_class = Google::Apis::BackupdrV1::Operation
1221
+ command.params['name'] = name unless name.nil?
1222
+ command.query['requestId'] = request_id unless request_id.nil?
1223
+ command.query['fields'] = fields unless fields.nil?
1224
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1225
+ execute_or_queue_command(command, &block)
1226
+ end
1227
+
1228
+ # Gets details of a Backup.
1229
+ # @param [String] name
1230
+ # Required. Name of the data source resource name, in the format 'projects/`
1231
+ # project_id`/locations/`location`/backupVaults/`backupVault`/dataSources/`
1232
+ # datasource`/backups/`backup`'
1233
+ # @param [String] fields
1234
+ # Selector specifying which fields to include in a partial response.
1235
+ # @param [String] quota_user
1236
+ # Available to use for quota purposes for server-side applications. Can be any
1237
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1238
+ # @param [Google::Apis::RequestOptions] options
1239
+ # Request-specific options
1240
+ #
1241
+ # @yield [result, err] Result & error if block supplied
1242
+ # @yieldparam result [Google::Apis::BackupdrV1::Backup] parsed result object
1243
+ # @yieldparam err [StandardError] error object if request failed
1244
+ #
1245
+ # @return [Google::Apis::BackupdrV1::Backup]
1246
+ #
1247
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1248
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1249
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1250
+ def get_project_location_backup_vault_data_source_backup(name, fields: nil, quota_user: nil, options: nil, &block)
1251
+ command = make_simple_command(:get, 'v1/{+name}', options)
1252
+ command.response_representation = Google::Apis::BackupdrV1::Backup::Representation
1253
+ command.response_class = Google::Apis::BackupdrV1::Backup
1254
+ command.params['name'] = name unless name.nil?
1255
+ command.query['fields'] = fields unless fields.nil?
1256
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1257
+ execute_or_queue_command(command, &block)
1258
+ end
1259
+
1260
+ # Lists Backups in a given project and location.
1261
+ # @param [String] parent
1262
+ # Required. The project and location for which to retrieve backup information,
1263
+ # in the format 'projects/`project_id`/locations/`location`'. In Cloud Backup
1264
+ # and DR, locations map to Google Cloud regions, for example **us-central1**. To
1265
+ # retrieve data sources for all locations, use "-" for the '`location`' value.
1266
+ # @param [String] filter
1267
+ # Optional. Filtering results.
1268
+ # @param [String] order_by
1269
+ # Optional. Hint for how to order the results.
1270
+ # @param [Fixnum] page_size
1271
+ # Optional. Requested page size. Server may return fewer items than requested.
1272
+ # If unspecified, server will pick an appropriate default.
1273
+ # @param [String] page_token
1274
+ # Optional. A token identifying a page of results the server should return.
1275
+ # @param [String] fields
1276
+ # Selector specifying which fields to include in a partial response.
1277
+ # @param [String] quota_user
1278
+ # Available to use for quota purposes for server-side applications. Can be any
1279
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1280
+ # @param [Google::Apis::RequestOptions] options
1281
+ # Request-specific options
1282
+ #
1283
+ # @yield [result, err] Result & error if block supplied
1284
+ # @yieldparam result [Google::Apis::BackupdrV1::ListBackupsResponse] parsed result object
1285
+ # @yieldparam err [StandardError] error object if request failed
1286
+ #
1287
+ # @return [Google::Apis::BackupdrV1::ListBackupsResponse]
1288
+ #
1289
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1290
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1291
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1292
+ def list_project_location_backup_vault_data_source_backups(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1293
+ command = make_simple_command(:get, 'v1/{+parent}/backups', options)
1294
+ command.response_representation = Google::Apis::BackupdrV1::ListBackupsResponse::Representation
1295
+ command.response_class = Google::Apis::BackupdrV1::ListBackupsResponse
1296
+ command.params['parent'] = parent unless parent.nil?
1297
+ command.query['filter'] = filter unless filter.nil?
1298
+ command.query['orderBy'] = order_by unless order_by.nil?
1299
+ command.query['pageSize'] = page_size unless page_size.nil?
1300
+ command.query['pageToken'] = page_token unless page_token.nil?
1301
+ command.query['fields'] = fields unless fields.nil?
1302
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1303
+ execute_or_queue_command(command, &block)
1304
+ end
1305
+
1306
+ # Updates the settings of a Backup.
1307
+ # @param [String] name
1308
+ # Output only. Identifier. Name of the resource.
1309
+ # @param [Google::Apis::BackupdrV1::Backup] backup_object
1310
+ # @param [String] request_id
1311
+ # Optional. An optional request ID to identify requests. Specify a unique
1312
+ # request ID so that if you must retry your request, the server will know to
1313
+ # ignore the request if it has already been completed. The server will guarantee
1314
+ # that for at least 60 minutes since the first request. For example, consider a
1315
+ # situation where you make an initial request and the request times out. If you
1316
+ # make the request again with the same request ID, the server can check if
1317
+ # original operation with the same request ID was received, and if so, will
1318
+ # ignore the second request. This prevents clients from accidentally creating
1319
+ # duplicate commitments. The request ID must be a valid UUID with the exception
1320
+ # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
1321
+ # @param [String] update_mask
1322
+ # Required. Field mask is used to specify the fields to be overwritten in the
1323
+ # Backup resource by the update. The fields specified in the update_mask are
1324
+ # relative to the resource, not the full request. A field will be overwritten if
1325
+ # it is in the mask. If the user does not provide a mask then the request will
1326
+ # fail.
1327
+ # @param [String] fields
1328
+ # Selector specifying which fields to include in a partial response.
1329
+ # @param [String] quota_user
1330
+ # Available to use for quota purposes for server-side applications. Can be any
1331
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1332
+ # @param [Google::Apis::RequestOptions] options
1333
+ # Request-specific options
1334
+ #
1335
+ # @yield [result, err] Result & error if block supplied
1336
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1337
+ # @yieldparam err [StandardError] error object if request failed
1338
+ #
1339
+ # @return [Google::Apis::BackupdrV1::Operation]
1340
+ #
1341
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1342
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1343
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1344
+ def patch_project_location_backup_vault_data_source_backup(name, backup_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1345
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1346
+ command.request_representation = Google::Apis::BackupdrV1::Backup::Representation
1347
+ command.request_object = backup_object
1348
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1349
+ command.response_class = Google::Apis::BackupdrV1::Operation
1350
+ command.params['name'] = name unless name.nil?
1351
+ command.query['requestId'] = request_id unless request_id.nil?
1352
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1353
+ command.query['fields'] = fields unless fields.nil?
1354
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1355
+ execute_or_queue_command(command, &block)
1356
+ end
1357
+
1358
+ # Restore from a Backup
1359
+ # @param [String] name
1360
+ # Required. The resource name of the Backup instance, in the format 'projects/*/
1361
+ # locations/*/backupVaults/*/dataSources/*/backups/'.
1362
+ # @param [Google::Apis::BackupdrV1::RestoreBackupRequest] restore_backup_request_object
1363
+ # @param [String] fields
1364
+ # Selector specifying which fields to include in a partial response.
1365
+ # @param [String] quota_user
1366
+ # Available to use for quota purposes for server-side applications. Can be any
1367
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1368
+ # @param [Google::Apis::RequestOptions] options
1369
+ # Request-specific options
1370
+ #
1371
+ # @yield [result, err] Result & error if block supplied
1372
+ # @yieldparam result [Google::Apis::BackupdrV1::Operation] parsed result object
1373
+ # @yieldparam err [StandardError] error object if request failed
1374
+ #
1375
+ # @return [Google::Apis::BackupdrV1::Operation]
1376
+ #
1377
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1378
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1379
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1380
+ def restore_backup(name, restore_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1381
+ command = make_simple_command(:post, 'v1/{+name}:restore', options)
1382
+ command.request_representation = Google::Apis::BackupdrV1::RestoreBackupRequest::Representation
1383
+ command.request_object = restore_backup_request_object
1384
+ command.response_representation = Google::Apis::BackupdrV1::Operation::Representation
1385
+ command.response_class = Google::Apis::BackupdrV1::Operation
1386
+ command.params['name'] = name unless name.nil?
1387
+ command.query['fields'] = fields unless fields.nil?
1388
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1389
+ execute_or_queue_command(command, &block)
1390
+ end
1391
+
127
1392
  # Creates a new ManagementServer in a given project and location.
128
1393
  # @param [String] parent
129
- # Required. The management server project and location in the format `projects/`
130
- # project_id`/locations/`location``. In Cloud Backup and DR locations map to GCP
131
- # regions, for example **us-central1**.
1394
+ # Required. The management server project and location in the format 'projects/`
1395
+ # project_id`/locations/`location`'. In Cloud Backup and DR locations map to
1396
+ # Google Cloud regions, for example **us-central1**.
132
1397
  # @param [Google::Apis::BackupdrV1::ManagementServer] management_server_object
133
1398
  # @param [String] management_server_id
134
1399
  # Required. The name of the management server to create. The name must be unique
@@ -219,8 +1484,8 @@ module Google
219
1484
 
220
1485
  # Gets details of a single ManagementServer.
221
1486
  # @param [String] name
222
- # Required. Name of the management server resource name, in the format `projects/
223
- # `project_id`/locations/`location`/managementServers/`resource_name``
1487
+ # Required. Name of the management server resource name, in the format 'projects/
1488
+ # `project_id`/locations/`location`/managementServers/`resource_name`'
224
1489
  # @param [String] fields
225
1490
  # Selector specifying which fields to include in a partial response.
226
1491
  # @param [String] quota_user
@@ -296,10 +1561,10 @@ module Google
296
1561
  # Lists ManagementServers in a given project and location.
297
1562
  # @param [String] parent
298
1563
  # Required. The project and location for which to retrieve management servers
299
- # information, in the format `projects/`project_id`/locations/`location``. In
300
- # Cloud BackupDR, locations map to GCP regions, for example **us-central1**. To
301
- # retrieve management servers for all locations, use "-" for the ``location``
302
- # value.
1564
+ # information, in the format 'projects/`project_id`/locations/`location`'. In
1565
+ # Cloud BackupDR, locations map to Google Cloud regions, for example **us-
1566
+ # central1**. To retrieve management servers for all locations, use "-" for the '
1567
+ # `location`' value.
303
1568
  # @param [String] filter
304
1569
  # Optional. Filtering results.
305
1570
  # @param [String] order_by