google-cloud-notebooks-v1 0.1.0 → 0.3.0

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

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

@@ -200,6 +200,46 @@ module Google
           end
         end
 
+        # Request for adding/changing metadata items  for an instance.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Format:
+        #     `projects/{project_id}/locations/{location}/instances/{instance_id}`
+        # @!attribute [rw] items
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Metadata items to add/update for the instance.
+        class UpdateInstanceMetadataItemsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class ItemsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Response for adding/changing metadata items for an instance.
+        # @!attribute [rw] items
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Map of items that were added/updated to/in the metadata.
+        class UpdateInstanceMetadataItemsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class ItemsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Request for updating the Shielded Instance config for a notebook instance.
         # You can only use this method on a stopped instance
         # @!attribute [rw] name
@@ -244,7 +284,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for reseting a notebook instance
+        # Request for resetting a notebook instance
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Format:
@@ -286,6 +326,10 @@ module Google
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/instances/{instance_id}`
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Notebooks::V1::UpgradeType]
+        #     Optional. The optional UpgradeType. Setting this field will search for additional
+        #     compute images to upgrade this instance.
         class IsInstanceUpgradeableRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -380,6 +424,10 @@ module Google
         #   @return [::String]
         #     Required. Format:
         #     `projects/{project_id}/locations/{location}/instances/{instance_id}`
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Notebooks::V1::UpgradeType]
+        #     Optional. The optional UpgradeType. Setting this field will search for additional
+        #     compute images to upgrade this instance.
         class UpgradeInstanceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -408,6 +456,10 @@ module Google
         #   @return [::String]
         #     Required. The VM hardware token for authenticating the VM.
         #     https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Notebooks::V1::UpgradeType]
+        #     Optional. The optional UpgradeType. Setting this field will search for additional
+        #     compute images to upgrade this instance.
         class UpgradeInstanceInternalRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -650,6 +702,25 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Definition of the types of upgrade that can be used on this
+        # instance.
+        module UpgradeType
+          # Upgrade type is not specified.
+          UPGRADE_TYPE_UNSPECIFIED = 0
+
+          # Upgrade ML framework.
+          UPGRADE_FRAMEWORK = 1
+
+          # Upgrade Operating System.
+          UPGRADE_OS = 2
+
+          # Upgrade CUDA.
+          UPGRADE_CUDA = 3
+
+          # Upgrade All (OS, Framework and CUDA).
+          UPGRADE_ALL = 4
+        end
       end
     end
   end

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-notebooks-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-01 00:00:00.000000000 Z
+date: 2022-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,28 +50,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -225,14 +225,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the AI Platform Notebooks V1 API