google-cloud-notebooks-v1 0.1.0 → 0.2.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.
@@ -65,6 +65,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
65
65
  optional :name, :string, 1
66
66
  map :labels, :string, :string, 2
67
67
  end
68
+ add_message "google.cloud.notebooks.v1.UpdateInstanceMetadataItemsRequest" do
69
+ optional :name, :string, 1
70
+ map :items, :string, :string, 2
71
+ end
72
+ add_message "google.cloud.notebooks.v1.UpdateInstanceMetadataItemsResponse" do
73
+ map :items, :string, :string, 1
74
+ end
68
75
  add_message "google.cloud.notebooks.v1.UpdateShieldedInstanceConfigRequest" do
69
76
  optional :name, :string, 1
70
77
  optional :shielded_instance_config, :message, 2, "google.cloud.notebooks.v1.Instance.ShieldedInstanceConfig"
@@ -88,6 +95,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
88
95
  end
89
96
  add_message "google.cloud.notebooks.v1.IsInstanceUpgradeableRequest" do
90
97
  optional :notebook_instance, :string, 1
98
+ optional :type, :enum, 2, "google.cloud.notebooks.v1.UpgradeType"
91
99
  end
92
100
  add_message "google.cloud.notebooks.v1.IsInstanceUpgradeableResponse" do
93
101
  optional :upgradeable, :bool, 1
@@ -111,6 +119,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
111
119
  end
112
120
  add_message "google.cloud.notebooks.v1.UpgradeInstanceRequest" do
113
121
  optional :name, :string, 1
122
+ optional :type, :enum, 2, "google.cloud.notebooks.v1.UpgradeType"
114
123
  end
115
124
  add_message "google.cloud.notebooks.v1.RollbackInstanceRequest" do
116
125
  optional :name, :string, 1
@@ -119,6 +128,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
119
128
  add_message "google.cloud.notebooks.v1.UpgradeInstanceInternalRequest" do
120
129
  optional :name, :string, 1
121
130
  optional :vm_id, :string, 2
131
+ optional :type, :enum, 3, "google.cloud.notebooks.v1.UpgradeType"
122
132
  end
123
133
  add_message "google.cloud.notebooks.v1.ListEnvironmentsRequest" do
124
134
  optional :parent, :string, 1
@@ -190,6 +200,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
190
200
  optional :execution_id, :string, 2
191
201
  optional :execution, :message, 3, "google.cloud.notebooks.v1.Execution"
192
202
  end
203
+ add_enum "google.cloud.notebooks.v1.UpgradeType" do
204
+ value :UPGRADE_TYPE_UNSPECIFIED, 0
205
+ value :UPGRADE_FRAMEWORK, 1
206
+ value :UPGRADE_OS, 2
207
+ value :UPGRADE_CUDA, 3
208
+ value :UPGRADE_ALL, 4
209
+ end
193
210
  end
194
211
  end
195
212
 
@@ -207,6 +224,8 @@ module Google
207
224
  SetInstanceMachineTypeRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.SetInstanceMachineTypeRequest").msgclass
208
225
  UpdateInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceConfigRequest").msgclass
209
226
  SetInstanceLabelsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.SetInstanceLabelsRequest").msgclass
227
+ UpdateInstanceMetadataItemsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceMetadataItemsRequest").msgclass
228
+ UpdateInstanceMetadataItemsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateInstanceMetadataItemsResponse").msgclass
210
229
  UpdateShieldedInstanceConfigRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpdateShieldedInstanceConfigRequest").msgclass
211
230
  DeleteInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.DeleteInstanceRequest").msgclass
212
231
  StartInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.StartInstanceRequest").msgclass
@@ -237,6 +256,7 @@ module Google
237
256
  GetExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.GetExecutionRequest").msgclass
238
257
  DeleteExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.DeleteExecutionRequest").msgclass
239
258
  CreateExecutionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.CreateExecutionRequest").msgclass
259
+ UpgradeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1.UpgradeType").enummodule
240
260
  end
241
261
  end
242
262
  end
@@ -54,6 +54,8 @@ module Google
54
54
  rpc :UpdateShieldedInstanceConfig, ::Google::Cloud::Notebooks::V1::UpdateShieldedInstanceConfigRequest, ::Google::Longrunning::Operation
55
55
  # Replaces all the labels of an Instance.
56
56
  rpc :SetInstanceLabels, ::Google::Cloud::Notebooks::V1::SetInstanceLabelsRequest, ::Google::Longrunning::Operation
57
+ # Add/update metadata items for an instance.
58
+ rpc :UpdateInstanceMetadataItems, ::Google::Cloud::Notebooks::V1::UpdateInstanceMetadataItemsRequest, ::Google::Cloud::Notebooks::V1::UpdateInstanceMetadataItemsResponse
57
59
  # Deletes a single Instance.
58
60
  rpc :DeleteInstance, ::Google::Cloud::Notebooks::V1::DeleteInstanceRequest, ::Google::Longrunning::Operation
59
61
  # Starts a notebook instance.
@@ -102,7 +104,7 @@ module Google
102
104
  rpc :GetExecution, ::Google::Cloud::Notebooks::V1::GetExecutionRequest, ::Google::Cloud::Notebooks::V1::Execution
103
105
  # Deletes execution
104
106
  rpc :DeleteExecution, ::Google::Cloud::Notebooks::V1::DeleteExecutionRequest, ::Google::Longrunning::Operation
105
- # Creates a new Scheduled Notebook in a given project and location.
107
+ # Creates a new Execution in a given project and location.
106
108
  rpc :CreateExecution, ::Google::Cloud::Notebooks::V1::CreateExecutionRequest, ::Google::Longrunning::Operation
107
109
  end
108
110
 
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Notebooks
23
23
  module V1
24
- VERSION = "0.1.0"
24
+ VERSION = "0.2.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,17 +28,44 @@ module Google
28
28
  # @!attribute [rw] type
29
29
  # @return [::Google::Cloud::Notebooks::V1::Event::EventType]
30
30
  # Event type.
31
+ # @!attribute [rw] details
32
+ # @return [::Google::Protobuf::Map{::String => ::String}]
33
+ # Optional. Event details. This field is used to pass event information.
31
34
  class Event
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
34
37
 
35
- # The definition of the even types.
38
+ # @!attribute [rw] key
39
+ # @return [::String]
40
+ # @!attribute [rw] value
41
+ # @return [::String]
42
+ class DetailsEntry
43
+ include ::Google::Protobuf::MessageExts
44
+ extend ::Google::Protobuf::MessageExts::ClassMethods
45
+ end
46
+
47
+ # The definition of the event types.
36
48
  module EventType
37
49
  # Event is not specified.
38
50
  EVENT_TYPE_UNSPECIFIED = 0
39
51
 
40
52
  # The instance / runtime is idle
41
53
  IDLE = 1
54
+
55
+ # The instance / runtime is available.
56
+ # This event indicates that instance / runtime underlying compute is
57
+ # operational.
58
+ HEARTBEAT = 2
59
+
60
+ # The instance / runtime health is available.
61
+ # This event indicates that instance / runtime health information.
62
+ HEALTH = 3
63
+
64
+ # The instance / runtime is available.
65
+ # This event allows instance / runtime to send Host maintenance
66
+ # information to Control Plane.
67
+ # https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance
68
+ MAINTENANCE = 4
42
69
  end
43
70
  end
44
71
  end
@@ -74,7 +74,8 @@ module Google
74
74
  #
75
75
  # Finally, if you want to use a TPU for training, specify `cloud_tpu` in this
76
76
  # field. Learn more about the [special configuration options for training
77
- # with TPU.
77
+ # with
78
+ # TPU](https://cloud.google.com/ai-platform/training/docs/using-tpus#configuring_a_custom_tpu_machine).
78
79
  # @!attribute [rw] accelerator_config
79
80
  # @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::SchedulerAcceleratorConfig]
80
81
  # Configuration (count and accelerator type) for hardware running notebook
@@ -90,7 +91,7 @@ module Google
90
91
  # @return [::String]
91
92
  # Path to the notebook file to execute.
92
93
  # Must be in a Google Cloud Storage bucket.
93
- # Format: `gs://{project_id}/{folder}/{notebook_file_name}`
94
+ # Format: `gs://{bucket_name}/{folder}/{notebook_file_name}`
94
95
  # Ex: `gs://notebook_user/scheduled_notebooks/sentiment_notebook.ipynb`
95
96
  # @!attribute [rw] container_image_uri
96
97
  # @return [::String]
@@ -102,7 +103,7 @@ module Google
102
103
  # @return [::String]
103
104
  # Path to the notebook folder to write to.
104
105
  # Must be in a Google Cloud Storage bucket path.
105
- # Format: `gs://{project_id}/{folder}`
106
+ # Format: `gs://{bucket_name}/{folder}`
106
107
  # Ex: `gs://notebook_user/scheduled_notebooks`
107
108
  # @!attribute [rw] params_yaml_file
108
109
  # @return [::String]
@@ -125,13 +126,27 @@ module Google
125
126
  # @!attribute [rw] dataproc_parameters
126
127
  # @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::DataprocParameters]
127
128
  # Parameters used in Dataproc JobType executions.
129
+ # @!attribute [rw] vertex_ai_parameters
130
+ # @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::VertexAIParameters]
131
+ # Parameters used in Vertex AI JobType executions.
132
+ # @!attribute [rw] kernel_spec
133
+ # @return [::String]
134
+ # Name of the kernel spec to use. This must be specified if the
135
+ # kernel spec name on the execution target does not match the name in the
136
+ # input notebook file.
137
+ # @!attribute [rw] tensorboard
138
+ # @return [::String]
139
+ # The name of a Vertex AI [Tensorboard] resource to which this execution
140
+ # will upload Tensorboard logs.
141
+ # Format:
142
+ # `projects/{project}/locations/{location}/tensorboards/{tensorboard}`
128
143
  class ExecutionTemplate
129
144
  include ::Google::Protobuf::MessageExts
130
145
  extend ::Google::Protobuf::MessageExts::ClassMethods
131
146
 
132
147
  # Definition of a hardware accelerator. Note that not all combinations
133
- # of `type` and `core_count` are valid. Check GPUs on
134
- # Compute Engine to find a valid
148
+ # of `type` and `core_count` are valid. Check [GPUs on
149
+ # Compute Engine](https://cloud.google.com/compute/docs/gpus) to find a valid
135
150
  # combination. TPUs are not supported.
136
151
  # @!attribute [rw] type
137
152
  # @return [::Google::Cloud::Notebooks::V1::ExecutionTemplate::SchedulerAcceleratorType]
@@ -154,6 +169,38 @@ module Google
154
169
  extend ::Google::Protobuf::MessageExts::ClassMethods
155
170
  end
156
171
 
172
+ # Parameters used in Vertex AI JobType executions.
173
+ # @!attribute [rw] network
174
+ # @return [::String]
175
+ # The full name of the Compute Engine
176
+ # [network](/compute/docs/networks-and-firewalls#networks) to which the Job
177
+ # should be peered. For example, `projects/12345/global/networks/myVPC`.
178
+ # [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert)
179
+ # is of the form `projects/{project}/global/networks/{network}`.
180
+ # Where \\{project} is a project number, as in `12345`, and \\{network} is a
181
+ # network name.
182
+ #
183
+ # Private services access must already be configured for the network. If
184
+ # left unspecified, the job is not peered with any network.
185
+ # @!attribute [rw] env
186
+ # @return [::Google::Protobuf::Map{::String => ::String}]
187
+ # Environment variables.
188
+ # At most 100 environment variables can be specified and unique.
189
+ # Example: GCP_BUCKET=gs://my-bucket/samples/
190
+ class VertexAIParameters
191
+ include ::Google::Protobuf::MessageExts
192
+ extend ::Google::Protobuf::MessageExts::ClassMethods
193
+
194
+ # @!attribute [rw] key
195
+ # @return [::String]
196
+ # @!attribute [rw] value
197
+ # @return [::String]
198
+ class EnvEntry
199
+ include ::Google::Protobuf::MessageExts
200
+ extend ::Google::Protobuf::MessageExts::ClassMethods
201
+ end
202
+ end
203
+
157
204
  # @!attribute [rw] key
158
205
  # @return [::String]
159
206
  # @!attribute [rw] value
@@ -189,25 +236,9 @@ module Google
189
236
  # own cluster specification. When you use this tier, set values to
190
237
  # configure your processing cluster according to these guidelines:
191
238
  #
192
- # * You _must_ set `TrainingInput.masterType` to specify the type
239
+ # * You _must_ set `ExecutionTemplate.masterType` to specify the type
193
240
  # of machine to use for your master node. This is the only required
194
241
  # setting.
195
- #
196
- # * You _may_ set `TrainingInput.workerCount` to specify the number of
197
- # workers to use. If you specify one or more workers, you _must_ also
198
- # set `TrainingInput.workerType` to specify the type of machine to use
199
- # for your worker nodes.
200
- #
201
- # * You _may_ set `TrainingInput.parameterServerCount` to specify the
202
- # number of parameter servers to use. If you specify one or more
203
- # parameter servers, you _must_ also set
204
- # `TrainingInput.parameterServerType` to specify the type of machine to
205
- # use for your parameter servers.
206
- #
207
- # Note that all of your workers must use the same machine type, which can
208
- # be different from your parameter server type and master type. Your
209
- # parameter servers must likewise use the same machine type, which can be
210
- # different from your worker type and master type.
211
242
  CUSTOM = 6
212
243
  end
213
244
 
@@ -231,6 +262,9 @@ module Google
231
262
  # Nvidia Tesla T4 GPU.
232
263
  NVIDIA_TESLA_T4 = 5
233
264
 
265
+ # Nvidia Tesla A100 GPU.
266
+ NVIDIA_TESLA_A100 = 10
267
+
234
268
  # TPU v2.
235
269
  TPU_V2 = 6
236
270
 
@@ -260,7 +294,7 @@ module Google
260
294
  # @!attribute [r] name
261
295
  # @return [::String]
262
296
  # Output only. The resource name of the execute. Format:
263
- # `projects/{project_id}/locations/{location}/execution/{execution_id}`
297
+ # `projects/{project_id}/locations/{location}/executions/{execution_id}`
264
298
  # @!attribute [r] display_name
265
299
  # @return [::String]
266
300
  # Output only. Name used for UI purposes.
@@ -316,7 +350,7 @@ module Google
316
350
  # `error_message` should describe the reason for the cancellation.
317
351
  CANCELLED = 7
318
352
 
319
- # The jobs has become expired (added for uCAIP jobs)
353
+ # The job has become expired (relevant to Vertex AI jobs)
320
354
  # https://cloud.google.com/vertex-ai/docs/reference/rest/v1/JobState
321
355
  EXPIRED = 9
322
356
 
@@ -204,6 +204,13 @@ module Google
204
204
  # the specified [Zonal Compute
205
205
  # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
206
206
  # to this notebook instance.
207
+ # @!attribute [r] creator
208
+ # @return [::String]
209
+ # Output only. Email address of entity that sent original CreateInstance request.
210
+ # @!attribute [rw] can_ip_forward
211
+ # @return [::Boolean]
212
+ # Optional. Flag to enable ip forwarding or not, default false/off.
213
+ # https://cloud.google.com/vpc/docs/using-routes#canipforward
207
214
  # @!attribute [r] create_time
208
215
  # @return [::Google::Protobuf::Timestamp]
209
216
  # Output only. Instance creation time.
@@ -446,7 +453,7 @@ module Google
446
453
  # Accelerator type is Nvidia Tesla V100.
447
454
  NVIDIA_TESLA_V100 = 3
448
455
 
449
- # Accelerator type is Nvidia Tesla P4 GPU.
456
+ # Accelerator type is Nvidia Tesla P4.
450
457
  NVIDIA_TESLA_P4 = 4
451
458
 
452
459
  # Accelerator type is Nvidia Tesla T4.
@@ -461,7 +468,7 @@ module Google
461
468
  # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
462
469
  NVIDIA_TESLA_P100_VWS = 9
463
470
 
464
- # Accelerator type is Nvidia Tesla P4 GPU Virtual Workstations.
471
+ # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
465
472
  NVIDIA_TESLA_P4_VWS = 10
466
473
 
467
474
  # (Coming soon) Accelerator type is TPU V2.
@@ -503,6 +510,12 @@ module Google
503
510
 
504
511
  # The instance is getting registered.
505
512
  REGISTERING = 9
513
+
514
+ # The instance is suspending.
515
+ SUSPENDING = 10
516
+
517
+ # The instance is suspended.
518
+ SUSPENDED = 11
506
519
  end
507
520
 
508
521
  # Possible disk types for notebook instances.
@@ -518,6 +531,9 @@ module Google
518
531
 
519
532
  # Balanced persistent disk type.
520
533
  PD_BALANCED = 3
534
+
535
+ # Extreme persistent disk type.
536
+ PD_EXTREME = 4
521
537
  end
522
538
 
523
539
  # Definition of the disk encryption options.
@@ -77,6 +77,9 @@ module Google
77
77
  # @!attribute [rw] runtime
78
78
  # @return [::Google::Cloud::Notebooks::V1::Runtime]
79
79
  # Required. The Runtime to be created.
80
+ # @!attribute [rw] request_id
81
+ # @return [::String]
82
+ # Idempotent request UUID.
80
83
  class CreateRuntimeRequest
81
84
  include ::Google::Protobuf::MessageExts
82
85
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -87,6 +90,9 @@ module Google
87
90
  # @return [::String]
88
91
  # Required. Format:
89
92
  # `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
93
+ # @!attribute [rw] request_id
94
+ # @return [::String]
95
+ # Idempotent request UUID.
90
96
  class DeleteRuntimeRequest
91
97
  include ::Google::Protobuf::MessageExts
92
98
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -97,6 +103,9 @@ module Google
97
103
  # @return [::String]
98
104
  # Required. Format:
99
105
  # `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
106
+ # @!attribute [rw] request_id
107
+ # @return [::String]
108
+ # Idempotent request UUID.
100
109
  class StartRuntimeRequest
101
110
  include ::Google::Protobuf::MessageExts
102
111
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -107,6 +116,9 @@ module Google
107
116
  # @return [::String]
108
117
  # Required. Format:
109
118
  # `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
119
+ # @!attribute [rw] request_id
120
+ # @return [::String]
121
+ # Idempotent request UUID.
110
122
  class StopRuntimeRequest
111
123
  include ::Google::Protobuf::MessageExts
112
124
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -123,16 +135,22 @@ module Google
123
135
  # @!attribute [rw] accelerator_config
124
136
  # @return [::Google::Cloud::Notebooks::V1::RuntimeAcceleratorConfig]
125
137
  # accelerator config.
138
+ # @!attribute [rw] request_id
139
+ # @return [::String]
140
+ # Idempotent request UUID.
126
141
  class SwitchRuntimeRequest
127
142
  include ::Google::Protobuf::MessageExts
128
143
  extend ::Google::Protobuf::MessageExts::ClassMethods
129
144
  end
130
145
 
131
- # Request for reseting a Managed Notebook Runtime.
146
+ # Request for resetting a Managed Notebook Runtime.
132
147
  # @!attribute [rw] name
133
148
  # @return [::String]
134
149
  # Required. Format:
135
150
  # `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
151
+ # @!attribute [rw] request_id
152
+ # @return [::String]
153
+ # Idempotent request UUID.
136
154
  class ResetRuntimeRequest
137
155
  include ::Google::Protobuf::MessageExts
138
156
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -154,6 +172,32 @@ module Google
154
172
  include ::Google::Protobuf::MessageExts
155
173
  extend ::Google::Protobuf::MessageExts::ClassMethods
156
174
  end
175
+
176
+ # Request for getting a new access token.
177
+ # @!attribute [rw] name
178
+ # @return [::String]
179
+ # Required. Format:
180
+ # `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
181
+ # @!attribute [rw] vm_id
182
+ # @return [::String]
183
+ # Required. The VM hardware token for authenticating the VM.
184
+ # https://cloud.google.com/compute/docs/instances/verifying-instance-identity
185
+ class RefreshRuntimeTokenInternalRequest
186
+ include ::Google::Protobuf::MessageExts
187
+ extend ::Google::Protobuf::MessageExts::ClassMethods
188
+ end
189
+
190
+ # Response with a new access token.
191
+ # @!attribute [rw] access_token
192
+ # @return [::String]
193
+ # The OAuth 2.0 access token.
194
+ # @!attribute [r] expire_time
195
+ # @return [::Google::Protobuf::Timestamp]
196
+ # Output only. Token expiration time.
197
+ class RefreshRuntimeTokenInternalResponse
198
+ include ::Google::Protobuf::MessageExts
199
+ extend ::Google::Protobuf::MessageExts::ClassMethods
200
+ end
157
201
  end
158
202
  end
159
203
  end
@@ -101,6 +101,14 @@ module Google
101
101
  # (for example, critical daemons are not running)
102
102
  # Applies to ACTIVE state.
103
103
  UNHEALTHY = 2
104
+
105
+ # The runtime has not installed health monitoring agent.
106
+ # Applies to ACTIVE state.
107
+ AGENT_NOT_INSTALLED = 3
108
+
109
+ # The runtime health monitoring agent is not running.
110
+ # Applies to ACTIVE state.
111
+ AGENT_NOT_RUNNING = 4
104
112
  end
105
113
  end
106
114
 
@@ -113,6 +121,7 @@ module Google
113
121
  # * `nvidia-tesla-k80`
114
122
  # * `nvidia-tesla-p100`
115
123
  # * `nvidia-tesla-v100`
124
+ # * `nvidia-tesla-p4`
116
125
  # * `nvidia-tesla-t4`
117
126
  # * `nvidia-tesla-a100`
118
127
  # @!attribute [rw] type
@@ -139,7 +148,7 @@ module Google
139
148
  # Accelerator type is Nvidia Tesla V100.
140
149
  NVIDIA_TESLA_V100 = 3
141
150
 
142
- # Accelerator type is Nvidia Tesla P4 GPU.
151
+ # Accelerator type is Nvidia Tesla P4.
143
152
  NVIDIA_TESLA_P4 = 4
144
153
 
145
154
  # Accelerator type is Nvidia Tesla T4.
@@ -160,7 +169,7 @@ module Google
160
169
  # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
161
170
  NVIDIA_TESLA_P100_VWS = 10
162
171
 
163
- # Accelerator type is Nvidia Tesla P.4 GPU Virtual Workstations.
172
+ # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
164
173
  NVIDIA_TESLA_P4_VWS = 11
165
174
  end
166
175
  end
@@ -335,6 +344,9 @@ module Google
335
344
 
336
345
  # Balanced persistent disk type.
337
346
  PD_BALANCED = 3
347
+
348
+ # Extreme persistent disk type.
349
+ PD_EXTREME = 4
338
350
  end
339
351
  end
340
352
 
@@ -361,6 +373,12 @@ module Google
361
373
 
362
374
  # Single user login.
363
375
  SINGLE_USER = 1
376
+
377
+ # Service Account mode.
378
+ # In Service Account mode, Runtime creator will specify a SA that exists
379
+ # in the consumer project. Using Runtime Service Account field.
380
+ # Users accessing the Runtime need ActAs (Service Account User) permission.
381
+ SERVICE_ACCOUNT = 2
364
382
  end
365
383
  end
366
384
 
@@ -370,7 +388,7 @@ module Google
370
388
  #
371
389
  # * `idle_shutdown: true`
372
390
  # * `idle_shutdown_timeout: 180`
373
- # * `report-system-health: true`
391
+ # * `enable_health_monitoring: true`
374
392
  # @!attribute [rw] notebook_upgrade_schedule
375
393
  # @return [::String]
376
394
  # Cron expression in UTC timezone, used to schedule instance auto upgrade.
@@ -389,6 +407,7 @@ module Google
389
407
  # @!attribute [rw] install_gpu_driver
390
408
  # @return [::Boolean]
391
409
  # Install Nvidia Driver automatically.
410
+ # Default: True
392
411
  # @!attribute [rw] custom_gpu_driver_path
393
412
  # @return [::String]
394
413
  # Specify a custom Cloud Storage path where the GPU driver is stored.
@@ -398,6 +417,12 @@ module Google
398
417
  # Path to a Bash script that automatically runs after a notebook instance
399
418
  # fully boots up. The path must be a URL or
400
419
  # Cloud Storage path (`gs://path-to-file/file-name`).
420
+ # @!attribute [rw] kernels
421
+ # @return [::Array<::Google::Cloud::Notebooks::V1::ContainerImage>]
422
+ # Optional. Use a list of container images to use as Kernels in the notebook instance.
423
+ # @!attribute [r] upgradeable
424
+ # @return [::Boolean]
425
+ # Output only. Bool indicating whether an newer image is available in an image family.
401
426
  class RuntimeSoftwareConfig
402
427
  include ::Google::Protobuf::MessageExts
403
428
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -479,7 +504,7 @@ module Google
479
504
  # * `e2-standard-8`
480
505
  # @!attribute [rw] container_images
481
506
  # @return [::Array<::Google::Cloud::Notebooks::V1::ContainerImage>]
482
- # Optional. Use a list of container images to start the notebook instance.
507
+ # Optional. Use a list of container images to use as Kernels in the notebook instance.
483
508
  # @!attribute [rw] data_disk
484
509
  # @return [::Google::Cloud::Notebooks::V1::LocalDisk]
485
510
  # Required. Data disk option configuration settings.
@@ -557,10 +582,36 @@ module Google
557
582
  # @return [::Google::Cloud::Notebooks::V1::VirtualMachineConfig::NicType]
558
583
  # Optional. The type of vNIC to be used on this interface. This may be gVNIC or
559
584
  # VirtioNet.
585
+ # @!attribute [rw] reserved_ip_range
586
+ # @return [::String]
587
+ # Optional. Reserved IP Range name is used for VPC Peering.
588
+ # The subnetwork allocation will use the range *name* if it's assigned.
589
+ #
590
+ # Example: managed-notebooks-range-c
591
+ # PEERING_RANGE_NAME_3=managed-notebooks-range-c
592
+ # gcloud compute addresses create $PEERING_RANGE_NAME_3 \
593
+ # --global \
594
+ # --prefix-length=24 \
595
+ # --description="Google Cloud Managed Notebooks Range 24 c" \
596
+ # --network=$NETWORK \
597
+ # --addresses=192.168.0.0 \
598
+ # --purpose=VPC_PEERING
599
+ #
600
+ # Field value will be: `managed-notebooks-range-c`
601
+ # @!attribute [rw] boot_image
602
+ # @return [::Google::Cloud::Notebooks::V1::VirtualMachineConfig::BootImage]
603
+ # Optional. Boot image metadata used for runtime upgradeability.
560
604
  class VirtualMachineConfig
561
605
  include ::Google::Protobuf::MessageExts
562
606
  extend ::Google::Protobuf::MessageExts::ClassMethods
563
607
 
608
+ # Definition of the boot image used by the Runtime.
609
+ # Used to facilitate runtime upgradeability.
610
+ class BootImage
611
+ include ::Google::Protobuf::MessageExts
612
+ extend ::Google::Protobuf::MessageExts::ClassMethods
613
+ end
614
+
564
615
  # @!attribute [rw] key
565
616
  # @return [::String]
566
617
  # @!attribute [rw] value
@@ -38,8 +38,8 @@ module Google
38
38
  # @return [::Google::Cloud::Notebooks::V1::Schedule::State]
39
39
  # @!attribute [rw] cron_schedule
40
40
  # @return [::String]
41
- # Cron-tab formatted schedule by which the job will execute
42
- # Format: minute, hour, day of month, month, day of week
41
+ # Cron-tab formatted schedule by which the job will execute.
42
+ # Format: minute, hour, day of month, month, day of week,
43
43
  # e.g. 0 0 * * WED = every Wednesday
44
44
  # More examples: https://crontab.guru/examples.html
45
45
  # @!attribute [rw] time_zone