google-apis-gkebackup_v1 0.41.0 → 0.43.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.
@@ -85,6 +85,9 @@ module Google
85
85
  # Lists information about the supported locations for this service.
86
86
  # @param [String] name
87
87
  # The resource that owns the locations collection, if applicable.
88
+ # @param [Array<String>, String] extra_location_types
89
+ # Optional. A list of extra location types that should be used as conditions for
90
+ # controlling the visibility of the locations.
88
91
  # @param [String] filter
89
92
  # A filter to narrow down results to a preferred subset. The filtering language
90
93
  # accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -112,11 +115,12 @@ module Google
112
115
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
113
116
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
114
117
  # @raise [Google::Apis::AuthorizationError] Authorization is required
115
- def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
118
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
116
119
  command = make_simple_command(:get, 'v1/{+name}/locations', options)
117
120
  command.response_representation = Google::Apis::GkebackupV1::ListLocationsResponse::Representation
118
121
  command.response_class = Google::Apis::GkebackupV1::ListLocationsResponse
119
122
  command.params['name'] = name unless name.nil?
123
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
120
124
  command.query['filter'] = filter unless filter.nil?
121
125
  command.query['pageSize'] = page_size unless page_size.nil?
122
126
  command.query['pageToken'] = page_token unless page_token.nil?
@@ -125,6 +129,294 @@ module Google
125
129
  execute_or_queue_command(command, &block)
126
130
  end
127
131
 
132
+ # Creates a new BackupChannel in a given location.
133
+ # @param [String] parent
134
+ # Required. The location within which to create the BackupChannel. Format: `
135
+ # projects/*/locations/*`
136
+ # @param [Google::Apis::GkebackupV1::BackupChannel] backup_channel_object
137
+ # @param [String] backup_channel_id
138
+ # Optional. The client-provided short name for the BackupChannel resource. This
139
+ # name must: - be between 1 and 63 characters long (inclusive) - consist of only
140
+ # lower-case ASCII letters, numbers, and dashes - start with a lower-case letter
141
+ # - end with a lower-case letter or number - be unique within the set of
142
+ # BackupChannels in this location If the user does not provide a name, a uuid
143
+ # will be used as the name.
144
+ # @param [String] fields
145
+ # Selector specifying which fields to include in a partial response.
146
+ # @param [String] quota_user
147
+ # Available to use for quota purposes for server-side applications. Can be any
148
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
149
+ # @param [Google::Apis::RequestOptions] options
150
+ # Request-specific options
151
+ #
152
+ # @yield [result, err] Result & error if block supplied
153
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
154
+ # @yieldparam err [StandardError] error object if request failed
155
+ #
156
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
157
+ #
158
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
159
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
160
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
161
+ def create_project_location_backup_channel(parent, backup_channel_object = nil, backup_channel_id: nil, fields: nil, quota_user: nil, options: nil, &block)
162
+ command = make_simple_command(:post, 'v1/{+parent}/backupChannels', options)
163
+ command.request_representation = Google::Apis::GkebackupV1::BackupChannel::Representation
164
+ command.request_object = backup_channel_object
165
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
166
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
167
+ command.params['parent'] = parent unless parent.nil?
168
+ command.query['backupChannelId'] = backup_channel_id unless backup_channel_id.nil?
169
+ command.query['fields'] = fields unless fields.nil?
170
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
171
+ execute_or_queue_command(command, &block)
172
+ end
173
+
174
+ # Deletes an existing BackupChannel.
175
+ # @param [String] name
176
+ # Required. Fully qualified BackupChannel name. Format: `projects/*/locations/*/
177
+ # backupChannels/*`
178
+ # @param [String] etag
179
+ # Optional. If provided, this value must match the current value of the target
180
+ # BackupChannel's etag field or the request is rejected.
181
+ # @param [Boolean] force
182
+ # Optional. If set to true, any BackupPlanAssociations below this BackupChannel
183
+ # will also be deleted. Otherwise, the request will only succeed if the
184
+ # BackupChannel has no BackupPlanAssociations.
185
+ # @param [String] fields
186
+ # Selector specifying which fields to include in a partial response.
187
+ # @param [String] quota_user
188
+ # Available to use for quota purposes for server-side applications. Can be any
189
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
190
+ # @param [Google::Apis::RequestOptions] options
191
+ # Request-specific options
192
+ #
193
+ # @yield [result, err] Result & error if block supplied
194
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
195
+ # @yieldparam err [StandardError] error object if request failed
196
+ #
197
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
198
+ #
199
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
200
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
201
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
202
+ def delete_project_location_backup_channel(name, etag: nil, force: nil, fields: nil, quota_user: nil, options: nil, &block)
203
+ command = make_simple_command(:delete, 'v1/{+name}', options)
204
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
205
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
206
+ command.params['name'] = name unless name.nil?
207
+ command.query['etag'] = etag unless etag.nil?
208
+ command.query['force'] = force unless force.nil?
209
+ command.query['fields'] = fields unless fields.nil?
210
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
211
+ execute_or_queue_command(command, &block)
212
+ end
213
+
214
+ # Retrieve the details of a single BackupChannel.
215
+ # @param [String] name
216
+ # Required. Fully qualified BackupChannel name. Format: `projects/*/locations/*/
217
+ # backupChannels/*`
218
+ # @param [String] fields
219
+ # Selector specifying which fields to include in a partial response.
220
+ # @param [String] quota_user
221
+ # Available to use for quota purposes for server-side applications. Can be any
222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
223
+ # @param [Google::Apis::RequestOptions] options
224
+ # Request-specific options
225
+ #
226
+ # @yield [result, err] Result & error if block supplied
227
+ # @yieldparam result [Google::Apis::GkebackupV1::BackupChannel] parsed result object
228
+ # @yieldparam err [StandardError] error object if request failed
229
+ #
230
+ # @return [Google::Apis::GkebackupV1::BackupChannel]
231
+ #
232
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
233
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
234
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
235
+ def get_project_location_backup_channel(name, fields: nil, quota_user: nil, options: nil, &block)
236
+ command = make_simple_command(:get, 'v1/{+name}', options)
237
+ command.response_representation = Google::Apis::GkebackupV1::BackupChannel::Representation
238
+ command.response_class = Google::Apis::GkebackupV1::BackupChannel
239
+ command.params['name'] = name unless name.nil?
240
+ command.query['fields'] = fields unless fields.nil?
241
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
242
+ execute_or_queue_command(command, &block)
243
+ end
244
+
245
+ # Lists BackupChannels in a given location.
246
+ # @param [String] parent
247
+ # Required. The location that contains the BackupChannels to list. Format: `
248
+ # projects/*/locations/*`
249
+ # @param [String] filter
250
+ # Optional. Field match expression used to filter the results.
251
+ # @param [String] order_by
252
+ # Optional. Field by which to sort the results.
253
+ # @param [Fixnum] page_size
254
+ # Optional. The target number of results to return in a single response. If not
255
+ # specified, a default value will be chosen by the service. Note that the
256
+ # response may include a partial list and a caller should only rely on the
257
+ # response's next_page_token to determine if there are more instances left to be
258
+ # queried.
259
+ # @param [String] page_token
260
+ # Optional. The value of next_page_token received from a previous `
261
+ # ListBackupChannels` call. Provide this to retrieve the subsequent page in a
262
+ # multi-page list of results. When paginating, all other parameters provided to `
263
+ # ListBackupChannels` must match the call that provided the page token.
264
+ # @param [String] fields
265
+ # Selector specifying which fields to include in a partial response.
266
+ # @param [String] quota_user
267
+ # Available to use for quota purposes for server-side applications. Can be any
268
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
269
+ # @param [Google::Apis::RequestOptions] options
270
+ # Request-specific options
271
+ #
272
+ # @yield [result, err] Result & error if block supplied
273
+ # @yieldparam result [Google::Apis::GkebackupV1::ListBackupChannelsResponse] parsed result object
274
+ # @yieldparam err [StandardError] error object if request failed
275
+ #
276
+ # @return [Google::Apis::GkebackupV1::ListBackupChannelsResponse]
277
+ #
278
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
279
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
280
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
281
+ def list_project_location_backup_channels(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
282
+ command = make_simple_command(:get, 'v1/{+parent}/backupChannels', options)
283
+ command.response_representation = Google::Apis::GkebackupV1::ListBackupChannelsResponse::Representation
284
+ command.response_class = Google::Apis::GkebackupV1::ListBackupChannelsResponse
285
+ command.params['parent'] = parent unless parent.nil?
286
+ command.query['filter'] = filter unless filter.nil?
287
+ command.query['orderBy'] = order_by unless order_by.nil?
288
+ command.query['pageSize'] = page_size unless page_size.nil?
289
+ command.query['pageToken'] = page_token unless page_token.nil?
290
+ command.query['fields'] = fields unless fields.nil?
291
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
292
+ execute_or_queue_command(command, &block)
293
+ end
294
+
295
+ # Update a BackupChannel.
296
+ # @param [String] name
297
+ # Identifier. The fully qualified name of the BackupChannel. `projects/*/
298
+ # locations/*/backupChannels/*`
299
+ # @param [Google::Apis::GkebackupV1::BackupChannel] backup_channel_object
300
+ # @param [String] update_mask
301
+ # Optional. This is used to specify the fields to be overwritten in the
302
+ # BackupChannel targeted for update. The values for each of these updated fields
303
+ # will be taken from the `backup_channel` provided with this request. Field
304
+ # names are relative to the root of the resource (e.g., `description`, `labels`,
305
+ # etc.) If no `update_mask` is provided, all fields in `backup_channel` will be
306
+ # written to the target BackupChannel resource. Note that OUTPUT_ONLY and
307
+ # IMMUTABLE fields in `backup_channel` are ignored and are not used to update
308
+ # the target BackupChannel.
309
+ # @param [String] fields
310
+ # Selector specifying which fields to include in a partial response.
311
+ # @param [String] quota_user
312
+ # Available to use for quota purposes for server-side applications. Can be any
313
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
314
+ # @param [Google::Apis::RequestOptions] options
315
+ # Request-specific options
316
+ #
317
+ # @yield [result, err] Result & error if block supplied
318
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
319
+ # @yieldparam err [StandardError] error object if request failed
320
+ #
321
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
322
+ #
323
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
324
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
325
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
326
+ def patch_project_location_backup_channel(name, backup_channel_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
327
+ command = make_simple_command(:patch, 'v1/{+name}', options)
328
+ command.request_representation = Google::Apis::GkebackupV1::BackupChannel::Representation
329
+ command.request_object = backup_channel_object
330
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
331
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
332
+ command.params['name'] = name unless name.nil?
333
+ command.query['updateMask'] = update_mask unless update_mask.nil?
334
+ command.query['fields'] = fields unless fields.nil?
335
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
336
+ execute_or_queue_command(command, &block)
337
+ end
338
+
339
+ # Retrieve the details of a single BackupPlanBinding.
340
+ # @param [String] name
341
+ # Required. Fully qualified BackupPlanBinding name. Format: `projects/*/
342
+ # locations/*/backupChannels/*/backupPlanBindings/*`
343
+ # @param [String] fields
344
+ # Selector specifying which fields to include in a partial response.
345
+ # @param [String] quota_user
346
+ # Available to use for quota purposes for server-side applications. Can be any
347
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
348
+ # @param [Google::Apis::RequestOptions] options
349
+ # Request-specific options
350
+ #
351
+ # @yield [result, err] Result & error if block supplied
352
+ # @yieldparam result [Google::Apis::GkebackupV1::BackupPlanBinding] parsed result object
353
+ # @yieldparam err [StandardError] error object if request failed
354
+ #
355
+ # @return [Google::Apis::GkebackupV1::BackupPlanBinding]
356
+ #
357
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
358
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
359
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
360
+ def get_project_location_backup_channel_backup_plan_binding(name, fields: nil, quota_user: nil, options: nil, &block)
361
+ command = make_simple_command(:get, 'v1/{+name}', options)
362
+ command.response_representation = Google::Apis::GkebackupV1::BackupPlanBinding::Representation
363
+ command.response_class = Google::Apis::GkebackupV1::BackupPlanBinding
364
+ command.params['name'] = name unless name.nil?
365
+ command.query['fields'] = fields unless fields.nil?
366
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
367
+ execute_or_queue_command(command, &block)
368
+ end
369
+
370
+ # Lists BackupPlanBindings in a given location.
371
+ # @param [String] parent
372
+ # Required. The BackupChannel that contains the BackupPlanBindings to list.
373
+ # Format: `projects/*/locations/*/backupChannels/*`
374
+ # @param [String] filter
375
+ # Optional. Field match expression used to filter the results.
376
+ # @param [String] order_by
377
+ # Optional. Field by which to sort the results.
378
+ # @param [Fixnum] page_size
379
+ # Optional. The target number of results to return in a single response. If not
380
+ # specified, a default value will be chosen by the service. Note that the
381
+ # response may include a partial list and a caller should only rely on the
382
+ # response's next_page_token to determine if there are more instances left to be
383
+ # queried.
384
+ # @param [String] page_token
385
+ # Optional. The value of next_page_token received from a previous `
386
+ # ListBackupPlanBindings` call. Provide this to retrieve the subsequent page in
387
+ # a multi-page list of results. When paginating, all other parameters provided
388
+ # to `ListBackupPlanBindings` must match the call that provided the page token.
389
+ # @param [String] fields
390
+ # Selector specifying which fields to include in a partial response.
391
+ # @param [String] quota_user
392
+ # Available to use for quota purposes for server-side applications. Can be any
393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
394
+ # @param [Google::Apis::RequestOptions] options
395
+ # Request-specific options
396
+ #
397
+ # @yield [result, err] Result & error if block supplied
398
+ # @yieldparam result [Google::Apis::GkebackupV1::ListBackupPlanBindingsResponse] parsed result object
399
+ # @yieldparam err [StandardError] error object if request failed
400
+ #
401
+ # @return [Google::Apis::GkebackupV1::ListBackupPlanBindingsResponse]
402
+ #
403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
406
+ def list_project_location_backup_channel_backup_plan_bindings(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
407
+ command = make_simple_command(:get, 'v1/{+parent}/backupPlanBindings', options)
408
+ command.response_representation = Google::Apis::GkebackupV1::ListBackupPlanBindingsResponse::Representation
409
+ command.response_class = Google::Apis::GkebackupV1::ListBackupPlanBindingsResponse
410
+ command.params['parent'] = parent unless parent.nil?
411
+ command.query['filter'] = filter unless filter.nil?
412
+ command.query['orderBy'] = order_by unless order_by.nil?
413
+ command.query['pageSize'] = page_size unless page_size.nil?
414
+ command.query['pageToken'] = page_token unless page_token.nil?
415
+ command.query['fields'] = fields unless fields.nil?
416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
417
+ execute_or_queue_command(command, &block)
418
+ end
419
+
128
420
  # Creates a new BackupPlan in a given location.
129
421
  # @param [String] parent
130
422
  # Required. The location within which to create the BackupPlan. Format: `
@@ -1154,6 +1446,289 @@ module Google
1154
1446
  execute_or_queue_command(command, &block)
1155
1447
  end
1156
1448
 
1449
+ # Creates a new RestoreChannel in a given location.
1450
+ # @param [String] parent
1451
+ # Required. The location within which to create the RestoreChannel. Format: `
1452
+ # projects/*/locations/*`
1453
+ # @param [Google::Apis::GkebackupV1::RestoreChannel] restore_channel_object
1454
+ # @param [String] restore_channel_id
1455
+ # Optional. The client-provided short name for the RestoreChannel resource. This
1456
+ # name must: - be between 1 and 63 characters long (inclusive) - consist of only
1457
+ # lower-case ASCII letters, numbers, and dashes - start with a lower-case letter
1458
+ # - end with a lower-case letter or number - be unique within the set of
1459
+ # RestoreChannels in this location If the user does not provide a name, a uuid
1460
+ # will be used as the name.
1461
+ # @param [String] fields
1462
+ # Selector specifying which fields to include in a partial response.
1463
+ # @param [String] quota_user
1464
+ # Available to use for quota purposes for server-side applications. Can be any
1465
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1466
+ # @param [Google::Apis::RequestOptions] options
1467
+ # Request-specific options
1468
+ #
1469
+ # @yield [result, err] Result & error if block supplied
1470
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
1471
+ # @yieldparam err [StandardError] error object if request failed
1472
+ #
1473
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
1474
+ #
1475
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1476
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1477
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1478
+ def create_project_location_restore_channel(parent, restore_channel_object = nil, restore_channel_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1479
+ command = make_simple_command(:post, 'v1/{+parent}/restoreChannels', options)
1480
+ command.request_representation = Google::Apis::GkebackupV1::RestoreChannel::Representation
1481
+ command.request_object = restore_channel_object
1482
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
1483
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
1484
+ command.params['parent'] = parent unless parent.nil?
1485
+ command.query['restoreChannelId'] = restore_channel_id unless restore_channel_id.nil?
1486
+ command.query['fields'] = fields unless fields.nil?
1487
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1488
+ execute_or_queue_command(command, &block)
1489
+ end
1490
+
1491
+ # Deletes an existing RestoreChannel.
1492
+ # @param [String] name
1493
+ # Required. Fully qualified RestoreChannel name. Format: `projects/*/locations/*/
1494
+ # restoreChannels/*`
1495
+ # @param [String] etag
1496
+ # Optional. If provided, this value must match the current value of the target
1497
+ # RestoreChannel's etag field or the request is rejected.
1498
+ # @param [String] fields
1499
+ # Selector specifying which fields to include in a partial response.
1500
+ # @param [String] quota_user
1501
+ # Available to use for quota purposes for server-side applications. Can be any
1502
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1503
+ # @param [Google::Apis::RequestOptions] options
1504
+ # Request-specific options
1505
+ #
1506
+ # @yield [result, err] Result & error if block supplied
1507
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
1508
+ # @yieldparam err [StandardError] error object if request failed
1509
+ #
1510
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
1511
+ #
1512
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1513
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1514
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1515
+ def delete_project_location_restore_channel(name, etag: nil, fields: nil, quota_user: nil, options: nil, &block)
1516
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1517
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
1518
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
1519
+ command.params['name'] = name unless name.nil?
1520
+ command.query['etag'] = etag unless etag.nil?
1521
+ command.query['fields'] = fields unless fields.nil?
1522
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1523
+ execute_or_queue_command(command, &block)
1524
+ end
1525
+
1526
+ # Retrieve the details of a single RestoreChannel.
1527
+ # @param [String] name
1528
+ # Required. Fully qualified RestoreChannel name. Format: `projects/*/locations/*/
1529
+ # restoreChannels/*`
1530
+ # @param [String] fields
1531
+ # Selector specifying which fields to include in a partial response.
1532
+ # @param [String] quota_user
1533
+ # Available to use for quota purposes for server-side applications. Can be any
1534
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1535
+ # @param [Google::Apis::RequestOptions] options
1536
+ # Request-specific options
1537
+ #
1538
+ # @yield [result, err] Result & error if block supplied
1539
+ # @yieldparam result [Google::Apis::GkebackupV1::RestoreChannel] parsed result object
1540
+ # @yieldparam err [StandardError] error object if request failed
1541
+ #
1542
+ # @return [Google::Apis::GkebackupV1::RestoreChannel]
1543
+ #
1544
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1545
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1546
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1547
+ def get_project_location_restore_channel(name, fields: nil, quota_user: nil, options: nil, &block)
1548
+ command = make_simple_command(:get, 'v1/{+name}', options)
1549
+ command.response_representation = Google::Apis::GkebackupV1::RestoreChannel::Representation
1550
+ command.response_class = Google::Apis::GkebackupV1::RestoreChannel
1551
+ command.params['name'] = name unless name.nil?
1552
+ command.query['fields'] = fields unless fields.nil?
1553
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1554
+ execute_or_queue_command(command, &block)
1555
+ end
1556
+
1557
+ # Lists RestoreChannels in a given location.
1558
+ # @param [String] parent
1559
+ # Required. The location that contains the RestoreChannels to list. Format: `
1560
+ # projects/*/locations/*`
1561
+ # @param [String] filter
1562
+ # Optional. Field match expression used to filter the results.
1563
+ # @param [String] order_by
1564
+ # Optional. Field by which to sort the results.
1565
+ # @param [Fixnum] page_size
1566
+ # Optional. The target number of results to return in a single response. If not
1567
+ # specified, a default value will be chosen by the service. Note that the
1568
+ # response may include a partial list and a caller should only rely on the
1569
+ # response's next_page_token to determine if there are more instances left to be
1570
+ # queried.
1571
+ # @param [String] page_token
1572
+ # Optional. The value of next_page_token received from a previous `
1573
+ # ListRestoreChannels` call. Provide this to retrieve the subsequent page in a
1574
+ # multi-page list of results. When paginating, all other parameters provided to `
1575
+ # ListRestoreChannels` must match the call that provided the page token.
1576
+ # @param [String] fields
1577
+ # Selector specifying which fields to include in a partial response.
1578
+ # @param [String] quota_user
1579
+ # Available to use for quota purposes for server-side applications. Can be any
1580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1581
+ # @param [Google::Apis::RequestOptions] options
1582
+ # Request-specific options
1583
+ #
1584
+ # @yield [result, err] Result & error if block supplied
1585
+ # @yieldparam result [Google::Apis::GkebackupV1::ListRestoreChannelsResponse] parsed result object
1586
+ # @yieldparam err [StandardError] error object if request failed
1587
+ #
1588
+ # @return [Google::Apis::GkebackupV1::ListRestoreChannelsResponse]
1589
+ #
1590
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1591
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1592
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1593
+ def list_project_location_restore_channels(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1594
+ command = make_simple_command(:get, 'v1/{+parent}/restoreChannels', options)
1595
+ command.response_representation = Google::Apis::GkebackupV1::ListRestoreChannelsResponse::Representation
1596
+ command.response_class = Google::Apis::GkebackupV1::ListRestoreChannelsResponse
1597
+ command.params['parent'] = parent unless parent.nil?
1598
+ command.query['filter'] = filter unless filter.nil?
1599
+ command.query['orderBy'] = order_by unless order_by.nil?
1600
+ command.query['pageSize'] = page_size unless page_size.nil?
1601
+ command.query['pageToken'] = page_token unless page_token.nil?
1602
+ command.query['fields'] = fields unless fields.nil?
1603
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1604
+ execute_or_queue_command(command, &block)
1605
+ end
1606
+
1607
+ # Update a RestoreChannel.
1608
+ # @param [String] name
1609
+ # Identifier. The fully qualified name of the RestoreChannel. `projects/*/
1610
+ # locations/*/restoreChannels/*`
1611
+ # @param [Google::Apis::GkebackupV1::RestoreChannel] restore_channel_object
1612
+ # @param [String] update_mask
1613
+ # Optional. This is used to specify the fields to be overwritten in the
1614
+ # RestoreChannel targeted for update. The values for each of these updated
1615
+ # fields will be taken from the `restore_channel` provided with this request.
1616
+ # Field names are relative to the root of the resource (e.g., `description`, `
1617
+ # destination_project_id`, etc.) If no `update_mask` is provided, all fields in `
1618
+ # restore_channel` will be written to the target RestoreChannel resource. Note
1619
+ # that OUTPUT_ONLY and IMMUTABLE fields in `restore_channel` are ignored and are
1620
+ # not used to update the target RestoreChannel.
1621
+ # @param [String] fields
1622
+ # Selector specifying which fields to include in a partial response.
1623
+ # @param [String] quota_user
1624
+ # Available to use for quota purposes for server-side applications. Can be any
1625
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1626
+ # @param [Google::Apis::RequestOptions] options
1627
+ # Request-specific options
1628
+ #
1629
+ # @yield [result, err] Result & error if block supplied
1630
+ # @yieldparam result [Google::Apis::GkebackupV1::GoogleLongrunningOperation] parsed result object
1631
+ # @yieldparam err [StandardError] error object if request failed
1632
+ #
1633
+ # @return [Google::Apis::GkebackupV1::GoogleLongrunningOperation]
1634
+ #
1635
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1636
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1637
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1638
+ def patch_project_location_restore_channel(name, restore_channel_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1639
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1640
+ command.request_representation = Google::Apis::GkebackupV1::RestoreChannel::Representation
1641
+ command.request_object = restore_channel_object
1642
+ command.response_representation = Google::Apis::GkebackupV1::GoogleLongrunningOperation::Representation
1643
+ command.response_class = Google::Apis::GkebackupV1::GoogleLongrunningOperation
1644
+ command.params['name'] = name unless name.nil?
1645
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1646
+ command.query['fields'] = fields unless fields.nil?
1647
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1648
+ execute_or_queue_command(command, &block)
1649
+ end
1650
+
1651
+ # Retrieve the details of a single RestorePlanBinding.
1652
+ # @param [String] name
1653
+ # Required. Fully qualified RestorePlanBinding name. Format: `projects/*/
1654
+ # locations/*/restoreChannels/*/restorePlanBindings/*`
1655
+ # @param [String] fields
1656
+ # Selector specifying which fields to include in a partial response.
1657
+ # @param [String] quota_user
1658
+ # Available to use for quota purposes for server-side applications. Can be any
1659
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1660
+ # @param [Google::Apis::RequestOptions] options
1661
+ # Request-specific options
1662
+ #
1663
+ # @yield [result, err] Result & error if block supplied
1664
+ # @yieldparam result [Google::Apis::GkebackupV1::RestorePlanBinding] parsed result object
1665
+ # @yieldparam err [StandardError] error object if request failed
1666
+ #
1667
+ # @return [Google::Apis::GkebackupV1::RestorePlanBinding]
1668
+ #
1669
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1670
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1671
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1672
+ def get_project_location_restore_channel_restore_plan_binding(name, fields: nil, quota_user: nil, options: nil, &block)
1673
+ command = make_simple_command(:get, 'v1/{+name}', options)
1674
+ command.response_representation = Google::Apis::GkebackupV1::RestorePlanBinding::Representation
1675
+ command.response_class = Google::Apis::GkebackupV1::RestorePlanBinding
1676
+ command.params['name'] = name unless name.nil?
1677
+ command.query['fields'] = fields unless fields.nil?
1678
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1679
+ execute_or_queue_command(command, &block)
1680
+ end
1681
+
1682
+ # Lists RestorePlanBindings in a given location.
1683
+ # @param [String] parent
1684
+ # Required. The RestoreChannel that contains the ListRestorePlanBindings to list.
1685
+ # Format: `projects/*/locations/*/restoreChannels/*`
1686
+ # @param [String] filter
1687
+ # Optional. Field match expression used to filter the results.
1688
+ # @param [String] order_by
1689
+ # Optional. Field by which to sort the results.
1690
+ # @param [Fixnum] page_size
1691
+ # Optional. The target number of results to return in a single response. If not
1692
+ # specified, a default value will be chosen by the service. Note that the
1693
+ # response may include a partial list and a caller should only rely on the
1694
+ # response's next_page_token to determine if there are more instances left to be
1695
+ # queried.
1696
+ # @param [String] page_token
1697
+ # Optional. The value of next_page_token received from a previous `
1698
+ # ListRestorePlanBindings` call. Provide this to retrieve the subsequent page in
1699
+ # a multi-page list of results. When paginating, all other parameters provided
1700
+ # to `ListRestorePlanBindings` must match the call that provided the page token.
1701
+ # @param [String] fields
1702
+ # Selector specifying which fields to include in a partial response.
1703
+ # @param [String] quota_user
1704
+ # Available to use for quota purposes for server-side applications. Can be any
1705
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1706
+ # @param [Google::Apis::RequestOptions] options
1707
+ # Request-specific options
1708
+ #
1709
+ # @yield [result, err] Result & error if block supplied
1710
+ # @yieldparam result [Google::Apis::GkebackupV1::ListRestorePlanBindingsResponse] parsed result object
1711
+ # @yieldparam err [StandardError] error object if request failed
1712
+ #
1713
+ # @return [Google::Apis::GkebackupV1::ListRestorePlanBindingsResponse]
1714
+ #
1715
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1716
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1717
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1718
+ def list_project_location_restore_channel_restore_plan_bindings(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1719
+ command = make_simple_command(:get, 'v1/{+parent}/restorePlanBindings', options)
1720
+ command.response_representation = Google::Apis::GkebackupV1::ListRestorePlanBindingsResponse::Representation
1721
+ command.response_class = Google::Apis::GkebackupV1::ListRestorePlanBindingsResponse
1722
+ command.params['parent'] = parent unless parent.nil?
1723
+ command.query['filter'] = filter unless filter.nil?
1724
+ command.query['orderBy'] = order_by unless order_by.nil?
1725
+ command.query['pageSize'] = page_size unless page_size.nil?
1726
+ command.query['pageToken'] = page_token unless page_token.nil?
1727
+ command.query['fields'] = fields unless fields.nil?
1728
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1729
+ execute_or_queue_command(command, &block)
1730
+ end
1731
+
1157
1732
  # Creates a new RestorePlan in a given location.
1158
1733
  # @param [String] parent
1159
1734
  # Required. The location within which to create the RestorePlan. Format: `
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-gkebackup_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.41.0
4
+ version: 0.43.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-03-16 00:00:00.000000000 Z
10
+ date: 2025-04-20 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkebackup_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-gkebackup_v1/v0.41.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-gkebackup_v1/v0.43.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkebackup_v1
62
62
  rdoc_options: []
63
63
  require_paths: