google-apis-notebooks_v2 0.2.0 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -122,6 +122,175 @@ module Google
122
122
  execute_or_queue_command(command, &block)
123
123
  end
124
124
 
125
+ # Checks whether a notebook instance is upgradable.
126
+ # @param [String] notebook_instance
127
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
128
+ # instance_id``
129
+ # @param [String] fields
130
+ # Selector specifying which fields to include in a partial response.
131
+ # @param [String] quota_user
132
+ # Available to use for quota purposes for server-side applications. Can be any
133
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
134
+ # @param [Google::Apis::RequestOptions] options
135
+ # Request-specific options
136
+ #
137
+ # @yield [result, err] Result & error if block supplied
138
+ # @yieldparam result [Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse] parsed result object
139
+ # @yieldparam err [StandardError] error object if request failed
140
+ #
141
+ # @return [Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse]
142
+ #
143
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
144
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
145
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
146
+ def check_project_location_instance_upgradability(notebook_instance, fields: nil, quota_user: nil, options: nil, &block)
147
+ command = make_simple_command(:get, 'v2/{+notebookInstance}:checkUpgradability', options)
148
+ command.response_representation = Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse::Representation
149
+ command.response_class = Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse
150
+ command.params['notebookInstance'] = notebook_instance unless notebook_instance.nil?
151
+ command.query['fields'] = fields unless fields.nil?
152
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
153
+ execute_or_queue_command(command, &block)
154
+ end
155
+
156
+ # Creates a new Instance in a given project and location.
157
+ # @param [String] parent
158
+ # Required. Format: `parent=projects/`project_id`/locations/`location``
159
+ # @param [Google::Apis::NotebooksV2::Instance] instance_object
160
+ # @param [String] instance_id
161
+ # Required. User-defined unique ID of this instance.
162
+ # @param [String] request_id
163
+ # Optional. Idempotent request UUID.
164
+ # @param [String] fields
165
+ # Selector specifying which fields to include in a partial response.
166
+ # @param [String] quota_user
167
+ # Available to use for quota purposes for server-side applications. Can be any
168
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
169
+ # @param [Google::Apis::RequestOptions] options
170
+ # Request-specific options
171
+ #
172
+ # @yield [result, err] Result & error if block supplied
173
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
174
+ # @yieldparam err [StandardError] error object if request failed
175
+ #
176
+ # @return [Google::Apis::NotebooksV2::Operation]
177
+ #
178
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
179
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
180
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
181
+ def create_project_location_instance(parent, instance_object = nil, instance_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
182
+ command = make_simple_command(:post, 'v2/{+parent}/instances', options)
183
+ command.request_representation = Google::Apis::NotebooksV2::Instance::Representation
184
+ command.request_object = instance_object
185
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
186
+ command.response_class = Google::Apis::NotebooksV2::Operation
187
+ command.params['parent'] = parent unless parent.nil?
188
+ command.query['instanceId'] = instance_id unless instance_id.nil?
189
+ command.query['requestId'] = request_id unless request_id.nil?
190
+ command.query['fields'] = fields unless fields.nil?
191
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
192
+ execute_or_queue_command(command, &block)
193
+ end
194
+
195
+ # Deletes a single Instance.
196
+ # @param [String] name
197
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
198
+ # instance_id``
199
+ # @param [String] request_id
200
+ # Optional. Idempotent request UUID.
201
+ # @param [String] fields
202
+ # Selector specifying which fields to include in a partial response.
203
+ # @param [String] quota_user
204
+ # Available to use for quota purposes for server-side applications. Can be any
205
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
206
+ # @param [Google::Apis::RequestOptions] options
207
+ # Request-specific options
208
+ #
209
+ # @yield [result, err] Result & error if block supplied
210
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
211
+ # @yieldparam err [StandardError] error object if request failed
212
+ #
213
+ # @return [Google::Apis::NotebooksV2::Operation]
214
+ #
215
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
216
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
217
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
218
+ def delete_project_location_instance(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
219
+ command = make_simple_command(:delete, 'v2/{+name}', options)
220
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
221
+ command.response_class = Google::Apis::NotebooksV2::Operation
222
+ command.params['name'] = name unless name.nil?
223
+ command.query['requestId'] = request_id unless request_id.nil?
224
+ command.query['fields'] = fields unless fields.nil?
225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
226
+ execute_or_queue_command(command, &block)
227
+ end
228
+
229
+ # Creates a Diagnostic File and runs Diagnostic Tool given an Instance.
230
+ # @param [String] name
231
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
232
+ # instance_id``
233
+ # @param [Google::Apis::NotebooksV2::DiagnoseInstanceRequest] diagnose_instance_request_object
234
+ # @param [String] fields
235
+ # Selector specifying which fields to include in a partial response.
236
+ # @param [String] quota_user
237
+ # Available to use for quota purposes for server-side applications. Can be any
238
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
239
+ # @param [Google::Apis::RequestOptions] options
240
+ # Request-specific options
241
+ #
242
+ # @yield [result, err] Result & error if block supplied
243
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
244
+ # @yieldparam err [StandardError] error object if request failed
245
+ #
246
+ # @return [Google::Apis::NotebooksV2::Operation]
247
+ #
248
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
249
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
250
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
251
+ def diagnose_instance(name, diagnose_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
252
+ command = make_simple_command(:post, 'v2/{+name}:diagnose', options)
253
+ command.request_representation = Google::Apis::NotebooksV2::DiagnoseInstanceRequest::Representation
254
+ command.request_object = diagnose_instance_request_object
255
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
256
+ command.response_class = Google::Apis::NotebooksV2::Operation
257
+ command.params['name'] = name unless name.nil?
258
+ command.query['fields'] = fields unless fields.nil?
259
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
260
+ execute_or_queue_command(command, &block)
261
+ end
262
+
263
+ # Gets details of a single Instance.
264
+ # @param [String] name
265
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
266
+ # instance_id``
267
+ # @param [String] fields
268
+ # Selector specifying which fields to include in a partial response.
269
+ # @param [String] quota_user
270
+ # Available to use for quota purposes for server-side applications. Can be any
271
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
272
+ # @param [Google::Apis::RequestOptions] options
273
+ # Request-specific options
274
+ #
275
+ # @yield [result, err] Result & error if block supplied
276
+ # @yieldparam result [Google::Apis::NotebooksV2::Instance] parsed result object
277
+ # @yieldparam err [StandardError] error object if request failed
278
+ #
279
+ # @return [Google::Apis::NotebooksV2::Instance]
280
+ #
281
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
282
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
283
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
284
+ def get_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
285
+ command = make_simple_command(:get, 'v2/{+name}', options)
286
+ command.response_representation = Google::Apis::NotebooksV2::Instance::Representation
287
+ command.response_class = Google::Apis::NotebooksV2::Instance
288
+ command.params['name'] = name unless name.nil?
289
+ command.query['fields'] = fields unless fields.nil?
290
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
291
+ execute_or_queue_command(command, &block)
292
+ end
293
+
125
294
  # Gets the access control policy for a resource. Returns an empty policy if the
126
295
  # resource exists and does not have a policy set.
127
296
  # @param [String] resource
@@ -167,6 +336,187 @@ module Google
167
336
  execute_or_queue_command(command, &block)
168
337
  end
169
338
 
339
+ # Lists instances in a given project and location.
340
+ # @param [String] parent
341
+ # Required. Format: `parent=projects/`project_id`/locations/`location``
342
+ # @param [Fixnum] page_size
343
+ # Optional. Maximum return size of the list call.
344
+ # @param [String] page_token
345
+ # Optional. A previous returned page token that can be used to continue listing
346
+ # from the last result.
347
+ # @param [String] fields
348
+ # Selector specifying which fields to include in a partial response.
349
+ # @param [String] quota_user
350
+ # Available to use for quota purposes for server-side applications. Can be any
351
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
352
+ # @param [Google::Apis::RequestOptions] options
353
+ # Request-specific options
354
+ #
355
+ # @yield [result, err] Result & error if block supplied
356
+ # @yieldparam result [Google::Apis::NotebooksV2::ListInstancesResponse] parsed result object
357
+ # @yieldparam err [StandardError] error object if request failed
358
+ #
359
+ # @return [Google::Apis::NotebooksV2::ListInstancesResponse]
360
+ #
361
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
362
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
363
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
364
+ def list_project_location_instances(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
365
+ command = make_simple_command(:get, 'v2/{+parent}/instances', options)
366
+ command.response_representation = Google::Apis::NotebooksV2::ListInstancesResponse::Representation
367
+ command.response_class = Google::Apis::NotebooksV2::ListInstancesResponse
368
+ command.params['parent'] = parent unless parent.nil?
369
+ command.query['pageSize'] = page_size unless page_size.nil?
370
+ command.query['pageToken'] = page_token unless page_token.nil?
371
+ command.query['fields'] = fields unless fields.nil?
372
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
373
+ execute_or_queue_command(command, &block)
374
+ end
375
+
376
+ # UpdateInstance updates an Instance.
377
+ # @param [String] name
378
+ # Output only. The name of this notebook instance. Format: `projects/`project_id`
379
+ # /locations/`location`/instances/`instance_id``
380
+ # @param [Google::Apis::NotebooksV2::Instance] instance_object
381
+ # @param [String] request_id
382
+ # Optional. Idempotent request UUID.
383
+ # @param [String] update_mask
384
+ # Required. Mask used to update an instance
385
+ # @param [String] fields
386
+ # Selector specifying which fields to include in a partial response.
387
+ # @param [String] quota_user
388
+ # Available to use for quota purposes for server-side applications. Can be any
389
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
390
+ # @param [Google::Apis::RequestOptions] options
391
+ # Request-specific options
392
+ #
393
+ # @yield [result, err] Result & error if block supplied
394
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
395
+ # @yieldparam err [StandardError] error object if request failed
396
+ #
397
+ # @return [Google::Apis::NotebooksV2::Operation]
398
+ #
399
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
400
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
401
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
402
+ def patch_project_location_instance(name, instance_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
403
+ command = make_simple_command(:patch, 'v2/{+name}', options)
404
+ command.request_representation = Google::Apis::NotebooksV2::Instance::Representation
405
+ command.request_object = instance_object
406
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
407
+ command.response_class = Google::Apis::NotebooksV2::Operation
408
+ command.params['name'] = name unless name.nil?
409
+ command.query['requestId'] = request_id unless request_id.nil?
410
+ command.query['updateMask'] = update_mask unless update_mask.nil?
411
+ command.query['fields'] = fields unless fields.nil?
412
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
413
+ execute_or_queue_command(command, &block)
414
+ end
415
+
416
+ # Allows notebook instances to report their latest instance information to the
417
+ # Notebooks API server. The server will merge the reported information to the
418
+ # instance metadata store. Do not use this method directly.
419
+ # @param [String] name
420
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
421
+ # instance_id``
422
+ # @param [Google::Apis::NotebooksV2::ReportInstanceInfoSystemRequest] report_instance_info_system_request_object
423
+ # @param [String] fields
424
+ # Selector specifying which fields to include in a partial response.
425
+ # @param [String] quota_user
426
+ # Available to use for quota purposes for server-side applications. Can be any
427
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
428
+ # @param [Google::Apis::RequestOptions] options
429
+ # Request-specific options
430
+ #
431
+ # @yield [result, err] Result & error if block supplied
432
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
433
+ # @yieldparam err [StandardError] error object if request failed
434
+ #
435
+ # @return [Google::Apis::NotebooksV2::Operation]
436
+ #
437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
440
+ def report_project_location_instance_info_system(name, report_instance_info_system_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
441
+ command = make_simple_command(:post, 'v2/{+name}:reportInfoSystem', options)
442
+ command.request_representation = Google::Apis::NotebooksV2::ReportInstanceInfoSystemRequest::Representation
443
+ command.request_object = report_instance_info_system_request_object
444
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
445
+ command.response_class = Google::Apis::NotebooksV2::Operation
446
+ command.params['name'] = name unless name.nil?
447
+ command.query['fields'] = fields unless fields.nil?
448
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
449
+ execute_or_queue_command(command, &block)
450
+ end
451
+
452
+ # Resets a notebook instance.
453
+ # @param [String] name
454
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
455
+ # instance_id``
456
+ # @param [Google::Apis::NotebooksV2::ResetInstanceRequest] reset_instance_request_object
457
+ # @param [String] fields
458
+ # Selector specifying which fields to include in a partial response.
459
+ # @param [String] quota_user
460
+ # Available to use for quota purposes for server-side applications. Can be any
461
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
462
+ # @param [Google::Apis::RequestOptions] options
463
+ # Request-specific options
464
+ #
465
+ # @yield [result, err] Result & error if block supplied
466
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
467
+ # @yieldparam err [StandardError] error object if request failed
468
+ #
469
+ # @return [Google::Apis::NotebooksV2::Operation]
470
+ #
471
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
472
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
473
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
474
+ def reset_instance(name, reset_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
475
+ command = make_simple_command(:post, 'v2/{+name}:reset', options)
476
+ command.request_representation = Google::Apis::NotebooksV2::ResetInstanceRequest::Representation
477
+ command.request_object = reset_instance_request_object
478
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
479
+ command.response_class = Google::Apis::NotebooksV2::Operation
480
+ command.params['name'] = name unless name.nil?
481
+ command.query['fields'] = fields unless fields.nil?
482
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
483
+ execute_or_queue_command(command, &block)
484
+ end
485
+
486
+ # Rollbacks a notebook instance to the previous version.
487
+ # @param [String] name
488
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
489
+ # instance_id``
490
+ # @param [Google::Apis::NotebooksV2::RollbackInstanceRequest] rollback_instance_request_object
491
+ # @param [String] fields
492
+ # Selector specifying which fields to include in a partial response.
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # @param [Google::Apis::RequestOptions] options
497
+ # Request-specific options
498
+ #
499
+ # @yield [result, err] Result & error if block supplied
500
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
501
+ # @yieldparam err [StandardError] error object if request failed
502
+ #
503
+ # @return [Google::Apis::NotebooksV2::Operation]
504
+ #
505
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
506
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
507
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
508
+ def rollback_instance(name, rollback_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
509
+ command = make_simple_command(:post, 'v2/{+name}:rollback', options)
510
+ command.request_representation = Google::Apis::NotebooksV2::RollbackInstanceRequest::Representation
511
+ command.request_object = rollback_instance_request_object
512
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
513
+ command.response_class = Google::Apis::NotebooksV2::Operation
514
+ command.params['name'] = name unless name.nil?
515
+ command.query['fields'] = fields unless fields.nil?
516
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
517
+ execute_or_queue_command(command, &block)
518
+ end
519
+
170
520
  # Sets the access control policy on the specified resource. Replaces any
171
521
  # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
172
522
  # PERMISSION_DENIED` errors.
@@ -204,6 +554,74 @@ module Google
204
554
  execute_or_queue_command(command, &block)
205
555
  end
206
556
 
557
+ # Starts a notebook instance.
558
+ # @param [String] name
559
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
560
+ # instance_id``
561
+ # @param [Google::Apis::NotebooksV2::StartInstanceRequest] start_instance_request_object
562
+ # @param [String] fields
563
+ # Selector specifying which fields to include in a partial response.
564
+ # @param [String] quota_user
565
+ # Available to use for quota purposes for server-side applications. Can be any
566
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
567
+ # @param [Google::Apis::RequestOptions] options
568
+ # Request-specific options
569
+ #
570
+ # @yield [result, err] Result & error if block supplied
571
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
572
+ # @yieldparam err [StandardError] error object if request failed
573
+ #
574
+ # @return [Google::Apis::NotebooksV2::Operation]
575
+ #
576
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
577
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
578
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
579
+ def start_instance(name, start_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
580
+ command = make_simple_command(:post, 'v2/{+name}:start', options)
581
+ command.request_representation = Google::Apis::NotebooksV2::StartInstanceRequest::Representation
582
+ command.request_object = start_instance_request_object
583
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
584
+ command.response_class = Google::Apis::NotebooksV2::Operation
585
+ command.params['name'] = name unless name.nil?
586
+ command.query['fields'] = fields unless fields.nil?
587
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
588
+ execute_or_queue_command(command, &block)
589
+ end
590
+
591
+ # Stops a notebook instance.
592
+ # @param [String] name
593
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
594
+ # instance_id``
595
+ # @param [Google::Apis::NotebooksV2::StopInstanceRequest] stop_instance_request_object
596
+ # @param [String] fields
597
+ # Selector specifying which fields to include in a partial response.
598
+ # @param [String] quota_user
599
+ # Available to use for quota purposes for server-side applications. Can be any
600
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
601
+ # @param [Google::Apis::RequestOptions] options
602
+ # Request-specific options
603
+ #
604
+ # @yield [result, err] Result & error if block supplied
605
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
606
+ # @yieldparam err [StandardError] error object if request failed
607
+ #
608
+ # @return [Google::Apis::NotebooksV2::Operation]
609
+ #
610
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
611
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
612
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
613
+ def stop_instance(name, stop_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
614
+ command = make_simple_command(:post, 'v2/{+name}:stop', options)
615
+ command.request_representation = Google::Apis::NotebooksV2::StopInstanceRequest::Representation
616
+ command.request_object = stop_instance_request_object
617
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
618
+ command.response_class = Google::Apis::NotebooksV2::Operation
619
+ command.params['name'] = name unless name.nil?
620
+ command.query['fields'] = fields unless fields.nil?
621
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
622
+ execute_or_queue_command(command, &block)
623
+ end
624
+
207
625
  # Returns permissions that a caller has on the specified resource. If the
208
626
  # resource does not exist, this will return an empty set of permissions, not a `
209
627
  # NOT_FOUND` error. Note: This operation is designed to be used for building
@@ -243,6 +661,75 @@ module Google
243
661
  execute_or_queue_command(command, &block)
244
662
  end
245
663
 
664
+ # Upgrades a notebook instance to the latest version.
665
+ # @param [String] name
666
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
667
+ # instance_id``
668
+ # @param [Google::Apis::NotebooksV2::UpgradeInstanceRequest] upgrade_instance_request_object
669
+ # @param [String] fields
670
+ # Selector specifying which fields to include in a partial response.
671
+ # @param [String] quota_user
672
+ # Available to use for quota purposes for server-side applications. Can be any
673
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
674
+ # @param [Google::Apis::RequestOptions] options
675
+ # Request-specific options
676
+ #
677
+ # @yield [result, err] Result & error if block supplied
678
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
679
+ # @yieldparam err [StandardError] error object if request failed
680
+ #
681
+ # @return [Google::Apis::NotebooksV2::Operation]
682
+ #
683
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
684
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
685
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
686
+ def upgrade_instance(name, upgrade_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
687
+ command = make_simple_command(:post, 'v2/{+name}:upgrade', options)
688
+ command.request_representation = Google::Apis::NotebooksV2::UpgradeInstanceRequest::Representation
689
+ command.request_object = upgrade_instance_request_object
690
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
691
+ command.response_class = Google::Apis::NotebooksV2::Operation
692
+ command.params['name'] = name unless name.nil?
693
+ command.query['fields'] = fields unless fields.nil?
694
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
695
+ execute_or_queue_command(command, &block)
696
+ end
697
+
698
+ # Allows notebook instances to upgrade themselves. Do not use this method
699
+ # directly.
700
+ # @param [String] name
701
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
702
+ # instance_id``
703
+ # @param [Google::Apis::NotebooksV2::UpgradeInstanceSystemRequest] upgrade_instance_system_request_object
704
+ # @param [String] fields
705
+ # Selector specifying which fields to include in a partial response.
706
+ # @param [String] quota_user
707
+ # Available to use for quota purposes for server-side applications. Can be any
708
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
709
+ # @param [Google::Apis::RequestOptions] options
710
+ # Request-specific options
711
+ #
712
+ # @yield [result, err] Result & error if block supplied
713
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
714
+ # @yieldparam err [StandardError] error object if request failed
715
+ #
716
+ # @return [Google::Apis::NotebooksV2::Operation]
717
+ #
718
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
719
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
720
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
721
+ def upgrade_project_location_instance_system(name, upgrade_instance_system_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
722
+ command = make_simple_command(:post, 'v2/{+name}:upgradeSystem', options)
723
+ command.request_representation = Google::Apis::NotebooksV2::UpgradeInstanceSystemRequest::Representation
724
+ command.request_object = upgrade_instance_system_request_object
725
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
726
+ command.response_class = Google::Apis::NotebooksV2::Operation
727
+ command.params['name'] = name unless name.nil?
728
+ command.query['fields'] = fields unless fields.nil?
729
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
730
+ execute_or_queue_command(command, &block)
731
+ end
732
+
246
733
  # Starts asynchronous cancellation on a long-running operation. The server makes
247
734
  # a best effort to cancel the operation, but success is not guaranteed. If the
248
735
  # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-notebooks_v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-05-14 00:00:00.000000000 Z
11
+ date: 2023-07-16 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-notebooks_v2/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-notebooks_v2/v0.2.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-notebooks_v2/v0.3.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-notebooks_v2
63
63
  post_install_message:
64
64
  rdoc_options: []