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.
- checksums.yaml +4 -4
- data/lib/google/cloud/notebooks/v1/event_pb.rb +5 -0
- data/lib/google/cloud/notebooks/v1/execution_pb.rb +9 -0
- data/lib/google/cloud/notebooks/v1/instance_pb.rb +5 -0
- data/lib/google/cloud/notebooks/v1/managed_notebook_service/client.rb +115 -6
- data/lib/google/cloud/notebooks/v1/managed_service_pb.rb +17 -0
- data/lib/google/cloud/notebooks/v1/managed_service_services_pb.rb +3 -0
- data/lib/google/cloud/notebooks/v1/notebook_service/client.rb +108 -4
- data/lib/google/cloud/notebooks/v1/notebook_service/paths.rb +19 -0
- data/lib/google/cloud/notebooks/v1/runtime_pb.rb +11 -0
- data/lib/google/cloud/notebooks/v1/service_pb.rb +20 -0
- data/lib/google/cloud/notebooks/v1/service_services_pb.rb +3 -1
- data/lib/google/cloud/notebooks/v1/version.rb +1 -1
- data/proto_docs/google/cloud/notebooks/v1/event.rb +28 -1
- data/proto_docs/google/cloud/notebooks/v1/execution.rb +58 -24
- data/proto_docs/google/cloud/notebooks/v1/instance.rb +18 -2
- data/proto_docs/google/cloud/notebooks/v1/managed_service.rb +45 -1
- data/proto_docs/google/cloud/notebooks/v1/runtime.rb +55 -4
- data/proto_docs/google/cloud/notebooks/v1/schedule.rb +2 -2
- data/proto_docs/google/cloud/notebooks/v1/service.rb +72 -1
- metadata +2 -2
@@ -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
|
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
|
|
@@ -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
|
-
#
|
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
|
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://{
|
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://{
|
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 `
|
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}/
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
-
# * `
|
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
|
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
|