google-cloud-notebooks-v1 0.1.0 → 0.2.0

data/lib/google/cloud/notebooks/v1/service_pb.rb

@@ -65,6 +65,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       map :labels, :string, :string, 2
     end
+    add_message "google.cloud.notebooks.v1.UpdateInstanceMetadataItemsRequest" do
+      optional :name, :string, 1
+      map :items, :string, :string, 2
+    end
+    add_message "google.cloud.notebooks.v1.UpdateInstanceMetadataItemsResponse" do
+      map :items, :string, :string, 1
+    end
     add_message "google.cloud.notebooks.v1.UpdateShieldedInstanceConfigRequest" do
       optional :name, :string, 1
       optional :shielded_instance_config, :message, 2, "google.cloud.notebooks.v1.Instance.ShieldedInstanceConfig"
@@ -88,6 +95,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.notebooks.v1.IsInstanceUpgradeableRequest" do
       optional :notebook_instance, :string, 1
+      optional :type, :enum, 2, "google.cloud.notebooks.v1.UpgradeType"
     end
     add_message "google.cloud.notebooks.v1.IsInstanceUpgradeableResponse" do
       optional :upgradeable, :bool, 1
@@ -111,6 +119,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.notebooks.v1.UpgradeInstanceRequest" do
       optional :name, :string, 1
+      optional :type, :enum, 2, "google.cloud.notebooks.v1.UpgradeType"
     end
     add_message "google.cloud.notebooks.v1.RollbackInstanceRequest" do
       optional :name, :string, 1
@@ -119,6 +128,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.notebooks.v1.UpgradeInstanceInternalRequest" do
       optional :name, :string, 1
       optional :vm_id, :string, 2
+      optional :type, :enum, 3, "google.cloud.notebooks.v1.UpgradeType"
     end
     add_message "google.cloud.notebooks.v1.ListEnvironmentsRequest" do
       optional :parent, :string, 1
@@ -190,6 +200,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :execution_id, :string, 2
       optional :execution, :message, 3, "google.cloud.notebooks.v1.Execution"
     end
+    add_enum "google.cloud.notebooks.v1.UpgradeType" do
+      value :UPGRADE_TYPE_UNSPECIFIED, 0
+      value :UPGRADE_FRAMEWORK, 1
+      value :UPGRADE_OS, 2
+      value :UPGRADE_CUDA, 3
+      value :UPGRADE_ALL, 4
+    end
   end
 end
 
@@ -207,6 +224,8 @@ module Google
         SetInstanceMachineTypeRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.SetInstanceMachineTypeRequest").msgclass
         UpdateInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceConfigRequest").msgclass
         SetInstanceLabelsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.SetInstanceLabelsRequest").msgclass
+        UpdateInstanceMetadataItemsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceMetadataItemsRequest").msgclass
+        UpdateInstanceMetadataItemsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceMetadataItemsResponse").msgclass
         UpdateShieldedInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateShieldedInstanceConfigRequest").msgclass
         DeleteInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.DeleteInstanceRequest").msgclass
         StartInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.StartInstanceRequest").msgclass
@@ -237,6 +256,7 @@ module Google
         GetExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.GetExecutionRequest").msgclass
         DeleteExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.DeleteExecutionRequest").msgclass
         CreateExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.CreateExecutionRequest").msgclass
+        UpgradeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpgradeType").enummodule
       end
     end
   end

data/lib/google/cloud/notebooks/v1/service_services_pb.rb

@@ -54,6 +54,8 @@ module Google
             rpc :UpdateShieldedInstanceConfig, ::Google::Cloud::Notebooks::V1::UpdateShieldedInstanceConfigRequest, ::Google::Longrunning::Operation
             # Replaces all the labels of an Instance.
             rpc :SetInstanceLabels, ::Google::Cloud::Notebooks::V1::SetInstanceLabelsRequest, ::Google::Longrunning::Operation
+            # Add/update metadata items for an instance.
+            rpc :UpdateInstanceMetadataItems, ::Google::Cloud::Notebooks::V1::UpdateInstanceMetadataItemsRequest, ::Google::Cloud::Notebooks::V1::UpdateInstanceMetadataItemsResponse
             # Deletes a single Instance.
             rpc :DeleteInstance, ::Google::Cloud::Notebooks::V1::DeleteInstanceRequest, ::Google::Longrunning::Operation
             # Starts a notebook instance.
@@ -102,7 +104,7 @@ module Google
             rpc :GetExecution, ::Google::Cloud::Notebooks::V1::GetExecutionRequest, ::Google::Cloud::Notebooks::V1::Execution
             # Deletes execution
             rpc :DeleteExecution, ::Google::Cloud::Notebooks::V1::DeleteExecutionRequest, ::Google::Longrunning::Operation
-            # Creates a new Scheduled Notebook in a given project and location.
+            # Creates a new Execution in a given project and location.
             rpc :CreateExecution, ::Google::Cloud::Notebooks::V1::CreateExecutionRequest, ::Google::Longrunning::Operation
           end
 

data/lib/google/cloud/notebooks/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Notebooks
       module V1
-        VERSION = "0.1.0"
+        VERSION = "0.2.0"
       end
     end
   end

data/proto_docs/google/cloud/notebooks/v1/event.rb

@@ -28,17 +28,44 @@ module Google
         # @!attribute [rw] type
         #   @return [::Google::Cloud::Notebooks::V1::Event::EventType]
         #     Event type.
+        # @!attribute [rw] details
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Event details. This field is used to pass event information.
         class Event
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # The definition of the even types.
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class DetailsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The definition of the event types.
           module EventType
             # Event is not specified.
             EVENT_TYPE_UNSPECIFIED = 0
 
             # The instance / runtime is idle
             IDLE = 1
+
+            # The instance / runtime is available.
+            # This event indicates that instance / runtime underlying compute is
+            # operational.
+            HEARTBEAT = 2
+
+            # The instance / runtime health is available.
+            # This event indicates that instance / runtime health information.
+            HEALTH = 3
+
+            # The instance / runtime is available.
+            # This event allows instance / runtime to send Host maintenance
+            # information to Control Plane.
+            # https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance
+            MAINTENANCE = 4
           end
         end
       end

data/proto_docs/google/cloud/notebooks/v1/execution.rb

@@ -74,7 +74,8 @@ module Google
         #
         #     Finally, if you want to use a TPU for training, specify `cloud_tpu` in this
         #     field. Learn more about the [special configuration options for training
-        #     with TPU.
+        #     with
+        #     TPU](https://cloud.google.com/ai-platform/training/docs/using-tpus#configuring_a_custom_tpu_machine).
         # @!attribute [rw] accelerator_config
         #   @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::SchedulerAcceleratorConfig]
         #     Configuration (count and accelerator type) for hardware running notebook
@@ -90,7 +91,7 @@ module Google
         #   @return [::String]
         #     Path to the notebook file to execute.
         #     Must be in a Google Cloud Storage bucket.
-        #     Format: `gs://{project_id}/{folder}/{notebook_file_name}`
+        #     Format: `gs://{bucket_name}/{folder}/{notebook_file_name}`
         #     Ex: `gs://notebook_user/scheduled_notebooks/sentiment_notebook.ipynb`
         # @!attribute [rw] container_image_uri
         #   @return [::String]
@@ -102,7 +103,7 @@ module Google
         #   @return [::String]
         #     Path to the notebook folder to write to.
         #     Must be in a Google Cloud Storage bucket path.
-        #     Format: `gs://{project_id}/{folder}`
+        #     Format: `gs://{bucket_name}/{folder}`
         #     Ex: `gs://notebook_user/scheduled_notebooks`
         # @!attribute [rw] params_yaml_file
         #   @return [::String]
@@ -125,13 +126,27 @@ module Google
         # @!attribute [rw] dataproc_parameters
         #   @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::DataprocParameters]
         #     Parameters used in Dataproc JobType executions.
+        # @!attribute [rw] vertex_ai_parameters
+        #   @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::VertexAIParameters]
+        #     Parameters used in Vertex AI JobType executions.
+        # @!attribute [rw] kernel_spec
+        #   @return [::String]
+        #     Name of the kernel spec to use. This must be specified if the
+        #     kernel spec name on the execution target does not match the name in the
+        #     input notebook file.
+        # @!attribute [rw] tensorboard
+        #   @return [::String]
+        #     The name of a Vertex AI [Tensorboard] resource to which this execution
+        #     will upload Tensorboard logs.
+        #     Format:
+        #     `projects/{project}/locations/{location}/tensorboards/{tensorboard}`
         class ExecutionTemplate
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Definition of a hardware accelerator. Note that not all combinations
-          # of `type` and `core_count` are valid. Check GPUs on
-          # Compute Engine to find a valid
+          # of `type` and `core_count` are valid. Check [GPUs on
+          # Compute Engine](https://cloud.google.com/compute/docs/gpus) to find a valid
           # combination. TPUs are not supported.
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::SchedulerAcceleratorType]
@@ -154,6 +169,38 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Parameters used in Vertex AI JobType executions.
+          # @!attribute [rw] network
+          #   @return [::String]
+          #     The full name of the Compute Engine
+          #     [network](/compute/docs/networks-and-firewalls#networks) to which the Job
+          #     should be peered. For example, `projects/12345/global/networks/myVPC`.
+          #     [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert)
+          #     is of the form `projects/{project}/global/networks/{network}`.
+          #     Where \\{project} is a project number, as in `12345`, and \\{network} is a
+          #     network name.
+          #
+          #     Private services access must already be configured for the network. If
+          #     left unspecified, the job is not peered with any network.
+          # @!attribute [rw] env
+          #   @return [::Google::Protobuf::Map{::String => ::String}]
+          #     Environment variables.
+          #      At most 100 environment variables can be specified and unique.
+          #     Example: GCP_BUCKET=gs://my-bucket/samples/
+          class VertexAIParameters
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::String]
+            class EnvEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -189,25 +236,9 @@ module Google
             # own cluster specification. When you use this tier, set values to
             # configure your processing cluster according to these guidelines:
             #
-            # *   You _must_ set `TrainingInput.masterType` to specify the type
+            # *   You _must_ set `ExecutionTemplate.masterType` to specify the type
             #     of machine to use for your master node. This is the only required
             #     setting.
-            #
-            # *   You _may_ set `TrainingInput.workerCount` to specify the number of
-            #     workers to use. If you specify one or more workers, you _must_ also
-            #     set `TrainingInput.workerType` to specify the type of machine to use
-            #     for your worker nodes.
-            #
-            # *   You _may_ set `TrainingInput.parameterServerCount` to specify the
-            #     number of parameter servers to use. If you specify one or more
-            #     parameter servers, you _must_ also set
-            #     `TrainingInput.parameterServerType` to specify the type of machine to
-            #     use for your parameter servers.
-            #
-            # Note that all of your workers must use the same machine type, which can
-            # be different from your parameter server type and master type. Your
-            # parameter servers must likewise use the same machine type, which can be
-            # different from your worker type and master type.
             CUSTOM = 6
           end
 
@@ -231,6 +262,9 @@ module Google
             # Nvidia Tesla T4 GPU.
             NVIDIA_TESLA_T4 = 5
 
+            # Nvidia Tesla A100 GPU.
+            NVIDIA_TESLA_A100 = 10
+
             # TPU v2.
             TPU_V2 = 6
 
@@ -260,7 +294,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The resource name of the execute. Format:
-        #     `projects/{project_id}/locations/{location}/execution/{execution_id}`
+        #     `projects/{project_id}/locations/{location}/executions/{execution_id}`
         # @!attribute [r] display_name
         #   @return [::String]
         #     Output only. Name used for UI purposes.
@@ -316,7 +350,7 @@ module Google
             # `error_message` should describe the reason for the cancellation.
             CANCELLED = 7
 
-            # The jobs has become expired (added for uCAIP jobs)
+            # The job has become expired (relevant to Vertex AI jobs)
             # https://cloud.google.com/vertex-ai/docs/reference/rest/v1/JobState
             EXPIRED = 9
 

data/proto_docs/google/cloud/notebooks/v1/instance.rb

@@ -204,6 +204,13 @@ module Google
         #     the specified [Zonal Compute
         #     Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
         #     to this notebook instance.
+        # @!attribute [r] creator
+        #   @return [::String]
+        #     Output only. Email address of entity that sent original CreateInstance request.
+        # @!attribute [rw] can_ip_forward
+        #   @return [::Boolean]
+        #     Optional. Flag to enable ip forwarding or not, default false/off.
+        #     https://cloud.google.com/vpc/docs/using-routes#canipforward
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Instance creation time.
@@ -446,7 +453,7 @@ module Google
             # Accelerator type is Nvidia Tesla V100.
             NVIDIA_TESLA_V100 = 3
 
-            # Accelerator type is Nvidia Tesla P4 GPU.
+            # Accelerator type is Nvidia Tesla P4.
             NVIDIA_TESLA_P4 = 4
 
             # Accelerator type is Nvidia Tesla T4.
@@ -461,7 +468,7 @@ module Google
             # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
             NVIDIA_TESLA_P100_VWS = 9
 
-            # Accelerator type is Nvidia Tesla P4 GPU Virtual Workstations.
+            # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
             NVIDIA_TESLA_P4_VWS = 10
 
             # (Coming soon) Accelerator type is TPU V2.
@@ -503,6 +510,12 @@ module Google
 
             # The instance is getting registered.
             REGISTERING = 9
+
+            # The instance is suspending.
+            SUSPENDING = 10
+
+            # The instance is suspended.
+            SUSPENDED = 11
           end
 
           # Possible disk types for notebook instances.
@@ -518,6 +531,9 @@ module Google
 
             # Balanced persistent disk type.
             PD_BALANCED = 3
+
+            # Extreme persistent disk type.
+            PD_EXTREME = 4
           end
 
           # Definition of the disk encryption options.

data/proto_docs/google/cloud/notebooks/v1/managed_service.rb

@@ -77,6 +77,9 @@ module Google
         # @!attribute [rw] runtime
         #   @return [::Google::Cloud::Notebooks::V1::Runtime]
         #     Required. The Runtime to be created.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class CreateRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -87,6 +90,9 @@ module Google
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class DeleteRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -97,6 +103,9 @@ module Google
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class StartRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -107,6 +116,9 @@ module Google
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class StopRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -123,16 +135,22 @@ module Google
         # @!attribute [rw] accelerator_config
         #   @return [::Google::Cloud::Notebooks::V1::RuntimeAcceleratorConfig]
         #     accelerator config.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class SwitchRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for reseting a Managed Notebook Runtime.
+        # Request for resetting a Managed Notebook Runtime.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Idempotent request UUID.
         class ResetRuntimeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -154,6 +172,32 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request for getting a new access token.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Format:
+        #     `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
+        # @!attribute [rw] vm_id
+        #   @return [::String]
+        #     Required. The VM hardware token for authenticating the VM.
+        #     https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+        class RefreshRuntimeTokenInternalRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response with a new access token.
+        # @!attribute [rw] access_token
+        #   @return [::String]
+        #     The OAuth 2.0 access token.
+        # @!attribute [r] expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Token expiration time.
+        class RefreshRuntimeTokenInternalResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/notebooks/v1/runtime.rb

@@ -101,6 +101,14 @@ module Google
             # (for example, critical daemons are not running)
             # Applies to ACTIVE state.
             UNHEALTHY = 2
+
+            # The runtime has not installed health monitoring agent.
+            # Applies to ACTIVE state.
+            AGENT_NOT_INSTALLED = 3
+
+            # The runtime health monitoring agent is not running.
+            # Applies to ACTIVE state.
+            AGENT_NOT_RUNNING = 4
           end
         end
 
@@ -113,6 +121,7 @@ module Google
         # * `nvidia-tesla-k80`
         # * `nvidia-tesla-p100`
         # * `nvidia-tesla-v100`
+        # * `nvidia-tesla-p4`
         # * `nvidia-tesla-t4`
         # * `nvidia-tesla-a100`
         # @!attribute [rw] type
@@ -139,7 +148,7 @@ module Google
             # Accelerator type is Nvidia Tesla V100.
             NVIDIA_TESLA_V100 = 3
 
-            # Accelerator type is Nvidia Tesla P4 GPU.
+            # Accelerator type is Nvidia Tesla P4.
             NVIDIA_TESLA_P4 = 4
 
             # Accelerator type is Nvidia Tesla T4.
@@ -160,7 +169,7 @@ module Google
             # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
             NVIDIA_TESLA_P100_VWS = 10
 
-            # Accelerator type is Nvidia Tesla P.4 GPU Virtual Workstations.
+            # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
             NVIDIA_TESLA_P4_VWS = 11
           end
         end
@@ -335,6 +344,9 @@ module Google
 
             # Balanced persistent disk type.
             PD_BALANCED = 3
+
+            # Extreme persistent disk type.
+            PD_EXTREME = 4
           end
         end
 
@@ -361,6 +373,12 @@ module Google
 
             # Single user login.
             SINGLE_USER = 1
+
+            # Service Account mode.
+            # In Service Account mode, Runtime creator will specify a SA that exists
+            # in the consumer project. Using Runtime Service Account field.
+            # Users accessing the Runtime need ActAs (Service Account User) permission.
+            SERVICE_ACCOUNT = 2
           end
         end
 
@@ -370,7 +388,7 @@ module Google
         #
         # * `idle_shutdown: true`
         # * `idle_shutdown_timeout: 180`
-        # * `report-system-health: true`
+        # * `enable_health_monitoring: true`
         # @!attribute [rw] notebook_upgrade_schedule
         #   @return [::String]
         #     Cron expression in UTC timezone, used to schedule instance auto upgrade.
@@ -389,6 +407,7 @@ module Google
         # @!attribute [rw] install_gpu_driver
         #   @return [::Boolean]
         #     Install Nvidia Driver automatically.
+        #     Default: True
         # @!attribute [rw] custom_gpu_driver_path
         #   @return [::String]
         #     Specify a custom Cloud Storage path where the GPU driver is stored.
@@ -398,6 +417,12 @@ module Google
         #     Path to a Bash script that automatically runs after a notebook instance
         #     fully boots up. The path must be a URL or
         #     Cloud Storage path (`gs://path-to-file/file-name`).
+        # @!attribute [rw] kernels
+        #   @return [::Array<::Google::Cloud::Notebooks::V1::ContainerImage>]
+        #     Optional. Use a list of container images to use as Kernels in the notebook instance.
+        # @!attribute [r] upgradeable
+        #   @return [::Boolean]
+        #     Output only. Bool indicating whether an newer image is available in an image family.
         class RuntimeSoftwareConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -479,7 +504,7 @@ module Google
         #     * `e2-standard-8`
         # @!attribute [rw] container_images
         #   @return [::Array<::Google::Cloud::Notebooks::V1::ContainerImage>]
-        #     Optional. Use a list of container images to start the notebook instance.
+        #     Optional. Use a list of container images to use as Kernels in the notebook instance.
         # @!attribute [rw] data_disk
         #   @return [::Google::Cloud::Notebooks::V1::LocalDisk]
         #     Required. Data disk option configuration settings.
@@ -557,10 +582,36 @@ module Google
         #   @return [::Google::Cloud::Notebooks::V1::VirtualMachineConfig::NicType]
         #     Optional. The type of vNIC to be used on this interface. This may be gVNIC or
         #     VirtioNet.
+        # @!attribute [rw] reserved_ip_range
+        #   @return [::String]
+        #     Optional. Reserved IP Range name is used for VPC Peering.
+        #     The subnetwork allocation will use the range *name* if it's assigned.
+        #
+        #     Example: managed-notebooks-range-c
+        #     PEERING_RANGE_NAME_3=managed-notebooks-range-c
+        #     gcloud compute addresses create $PEERING_RANGE_NAME_3 \
+        #       --global \
+        #       --prefix-length=24 \
+        #       --description="Google Cloud Managed Notebooks Range 24 c" \
+        #       --network=$NETWORK \
+        #       --addresses=192.168.0.0 \
+        #       --purpose=VPC_PEERING
+        #
+        #     Field value will be: `managed-notebooks-range-c`
+        # @!attribute [rw] boot_image
+        #   @return [::Google::Cloud::Notebooks::V1::VirtualMachineConfig::BootImage]
+        #     Optional. Boot image metadata used for runtime upgradeability.
         class VirtualMachineConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Definition of the boot image used by the Runtime.
+          # Used to facilitate runtime upgradeability.
+          class BootImage
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value

data/proto_docs/google/cloud/notebooks/v1/schedule.rb

@@ -38,8 +38,8 @@ module Google
         #   @return [::Google::Cloud::Notebooks::V1::Schedule::State]
         # @!attribute [rw] cron_schedule
         #   @return [::String]
-        #     Cron-tab formatted schedule by which the job will execute
-        #     Format: minute, hour, day of month, month, day of week
+        #     Cron-tab formatted schedule by which the job will execute.
+        #     Format: minute, hour, day of month, month, day of week,
         #     e.g. 0 0 * * WED = every Wednesday
         #     More examples: https://crontab.guru/examples.html
         # @!attribute [rw] time_zone