lib/google/apis/notebooks_v2/service.rb in google-apis-notebooks_v2-0.2.0 vs lib/google/apis/notebooks_v2/service.rb in google-apis-notebooks_v2-0.3.0
- old
+ new
@@ -120,10 +120,179 @@
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
+ # Checks whether a notebook instance is upgradable.
+ # @param [String] notebook_instance
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def check_project_location_instance_upgradability(notebook_instance, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:get, 'v2/{+notebookInstance}:checkUpgradability', options)
+ command.response_representation = Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse::Representation
+ command.response_class = Google::Apis::NotebooksV2::CheckInstanceUpgradabilityResponse
+ command.params['notebookInstance'] = notebook_instance unless notebook_instance.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Creates a new Instance in a given project and location.
+ # @param [String] parent
+ # Required. Format: `parent=projects/`project_id`/locations/`location``
+ # @param [Google::Apis::NotebooksV2::Instance] instance_object
+ # @param [String] instance_id
+ # Required. User-defined unique ID of this instance.
+ # @param [String] request_id
+ # Optional. Idempotent request UUID.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def create_project_location_instance(parent, instance_object = nil, instance_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+parent}/instances', options)
+ command.request_representation = Google::Apis::NotebooksV2::Instance::Representation
+ command.request_object = instance_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['parent'] = parent unless parent.nil?
+ command.query['instanceId'] = instance_id unless instance_id.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Deletes a single Instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [String] request_id
+ # Optional. Idempotent request UUID.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def delete_project_location_instance(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:delete, 'v2/{+name}', options)
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Creates a Diagnostic File and runs Diagnostic Tool given an Instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::DiagnoseInstanceRequest] diagnose_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def diagnose_instance(name, diagnose_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:diagnose', options)
+ command.request_representation = Google::Apis::NotebooksV2::DiagnoseInstanceRequest::Representation
+ command.request_object = diagnose_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Gets details of a single Instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Instance] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Instance]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def get_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:get, 'v2/{+name}', options)
+ command.response_representation = Google::Apis::NotebooksV2::Instance::Representation
+ command.response_class = Google::Apis::NotebooksV2::Instance
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Gets the access control policy for a resource. Returns an empty policy if the
# resource exists and does not have a policy set.
# @param [String] resource
# REQUIRED: The resource for which the policy is being requested. See [Resource
# names](https://cloud.google.com/apis/design/resource_names) for the
@@ -165,10 +334,191 @@
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
+ # Lists instances in a given project and location.
+ # @param [String] parent
+ # Required. Format: `parent=projects/`project_id`/locations/`location``
+ # @param [Fixnum] page_size
+ # Optional. Maximum return size of the list call.
+ # @param [String] page_token
+ # Optional. A previous returned page token that can be used to continue listing
+ # from the last result.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::ListInstancesResponse] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::ListInstancesResponse]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def list_project_location_instances(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:get, 'v2/{+parent}/instances', options)
+ command.response_representation = Google::Apis::NotebooksV2::ListInstancesResponse::Representation
+ command.response_class = Google::Apis::NotebooksV2::ListInstancesResponse
+ command.params['parent'] = parent unless parent.nil?
+ command.query['pageSize'] = page_size unless page_size.nil?
+ command.query['pageToken'] = page_token unless page_token.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # UpdateInstance updates an Instance.
+ # @param [String] name
+ # Output only. The name of this notebook instance. Format: `projects/`project_id`
+ # /locations/`location`/instances/`instance_id``
+ # @param [Google::Apis::NotebooksV2::Instance] instance_object
+ # @param [String] request_id
+ # Optional. Idempotent request UUID.
+ # @param [String] update_mask
+ # Required. Mask used to update an instance
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def patch_project_location_instance(name, instance_object = nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:patch, 'v2/{+name}', options)
+ command.request_representation = Google::Apis::NotebooksV2::Instance::Representation
+ command.request_object = instance_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['updateMask'] = update_mask unless update_mask.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Allows notebook instances to report their latest instance information to the
+ # Notebooks API server. The server will merge the reported information to the
+ # instance metadata store. Do not use this method directly.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::ReportInstanceInfoSystemRequest] report_instance_info_system_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def report_project_location_instance_info_system(name, report_instance_info_system_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:reportInfoSystem', options)
+ command.request_representation = Google::Apis::NotebooksV2::ReportInstanceInfoSystemRequest::Representation
+ command.request_object = report_instance_info_system_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Resets a notebook instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::ResetInstanceRequest] reset_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def reset_instance(name, reset_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:reset', options)
+ command.request_representation = Google::Apis::NotebooksV2::ResetInstanceRequest::Representation
+ command.request_object = reset_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Rollbacks a notebook instance to the previous version.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::RollbackInstanceRequest] rollback_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def rollback_instance(name, rollback_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:rollback', options)
+ command.request_representation = Google::Apis::NotebooksV2::RollbackInstanceRequest::Representation
+ command.request_object = rollback_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Sets the access control policy on the specified resource. Replaces any
# existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
# PERMISSION_DENIED` errors.
# @param [String] resource
# REQUIRED: The resource for which the policy is being specified. See [Resource
@@ -202,10 +552,78 @@
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
+ # Starts a notebook instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::StartInstanceRequest] start_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def start_instance(name, start_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:start', options)
+ command.request_representation = Google::Apis::NotebooksV2::StartInstanceRequest::Representation
+ command.request_object = start_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Stops a notebook instance.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::StopInstanceRequest] stop_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def stop_instance(name, stop_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:stop', options)
+ command.request_representation = Google::Apis::NotebooksV2::StopInstanceRequest::Representation
+ command.request_object = stop_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Returns permissions that a caller has on the specified resource. If the
# resource does not exist, this will return an empty set of permissions, not a `
# NOT_FOUND` error. Note: This operation is designed to be used for building
# permission-aware UIs and command-line tools, not for authorization checking.
# This operation may "fail open" without warning.
@@ -236,9 +654,78 @@
command.request_representation = Google::Apis::NotebooksV2::TestIamPermissionsRequest::Representation
command.request_object = test_iam_permissions_request_object
command.response_representation = Google::Apis::NotebooksV2::TestIamPermissionsResponse::Representation
command.response_class = Google::Apis::NotebooksV2::TestIamPermissionsResponse
command.params['resource'] = resource unless resource.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Upgrades a notebook instance to the latest version.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::UpgradeInstanceRequest] upgrade_instance_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def upgrade_instance(name, upgrade_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:upgrade', options)
+ command.request_representation = Google::Apis::NotebooksV2::UpgradeInstanceRequest::Representation
+ command.request_object = upgrade_instance_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Allows notebook instances to upgrade themselves. Do not use this method
+ # directly.
+ # @param [String] name
+ # Required. Format: `projects/`project_id`/locations/`location`/instances/`
+ # instance_id``
+ # @param [Google::Apis::NotebooksV2::UpgradeInstanceSystemRequest] upgrade_instance_system_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # Available to use for quota purposes for server-side applications. Can be any
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::NotebooksV2::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::NotebooksV2::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def upgrade_project_location_instance_system(name, upgrade_instance_system_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+ command = make_simple_command(:post, 'v2/{+name}:upgradeSystem', options)
+ command.request_representation = Google::Apis::NotebooksV2::UpgradeInstanceSystemRequest::Representation
+ command.request_object = upgrade_instance_system_request_object
+ command.response_representation = Google::Apis::NotebooksV2::Operation::Representation
+ command.response_class = Google::Apis::NotebooksV2::Operation
+ command.params['name'] = name unless name.nil?
command.query['fields'] = fields unless fields.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end