google-apis-notebooks_v2 0.2.0 → 0.3.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.
@@ -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: []