google-cloud-notebooks-v1beta1 0.5.0 → 0.6.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0ea8b96c318af54895541e16495689f4bd95fc389360c8b30f98158a98874e60
4
- data.tar.gz: a83234ee25e25e5d3cfb29097e0e9c9b75c803c67cc8db30d33626e4d569cebe
3
+ metadata.gz: b1e33d32b2b464040081f9c1d0b733b6ddde42d8744a1b71c0f5a2a2e4fe9801
4
+ data.tar.gz: f9aabf3a9396b00880a6596aecd8b91ee39a0827222862ce1252f962f08c6214
5
5
  SHA512:
6
- metadata.gz: b082526b48218cf229600a865c8b2c7a15a8aff61744c1bafce5dda274d89d976771ec344b13981599e194315dcd4fd0c03c9eed639ac91eec76ab8d0c7273a8
7
- data.tar.gz: 7ca10d14c2c52444e896a19261f5c990782893f95a06fad85910755a17f3f8524692ac67d55c7dedfbd92d25ac5348c4e019fa8b50869c2d40b93c644bc23ba9
6
+ metadata.gz: 2bbc38566b30c7ac8e21338aab293db432d9ee87d63c5e4386b2cf6fbb9ee2a4f3dfa62c651e6c65d06f2932bf51cae50615637f5fba8c52113119aab2760b71
7
+ data.tar.gz: fd70574c20b8721228295fe8ec402bf9e1dcb9aee3902930312e62061da2ff1a44893dfa08fefb18e3ea0175ab87cded94f790699f0131d7213cf143899296e2
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
@@ -6,7 +6,6 @@ require 'google/protobuf'
6
6
  require 'google/api/field_behavior_pb'
7
7
  require 'google/api/resource_pb'
8
8
  require 'google/protobuf/timestamp_pb'
9
- require 'google/api/annotations_pb'
10
9
 
11
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
12
11
  add_file("google/cloud/notebooks/v1beta1/environment.proto", :syntax => :proto3) do
@@ -7,10 +7,20 @@ require 'google/api/field_behavior_pb'
7
7
  require 'google/api/resource_pb'
8
8
  require 'google/cloud/notebooks/v1beta1/environment_pb'
9
9
  require 'google/protobuf/timestamp_pb'
10
- require 'google/api/annotations_pb'
11
10
 
12
11
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
12
  add_file("google/cloud/notebooks/v1beta1/instance.proto", :syntax => :proto3) do
13
+ add_message "google.cloud.notebooks.v1beta1.ReservationAffinity" do
14
+ optional :consume_reservation_type, :enum, 1, "google.cloud.notebooks.v1beta1.ReservationAffinity.Type"
15
+ optional :key, :string, 2
16
+ repeated :values, :string, 3
17
+ end
18
+ add_enum "google.cloud.notebooks.v1beta1.ReservationAffinity.Type" do
19
+ value :TYPE_UNSPECIFIED, 0
20
+ value :NO_RESERVATION, 1
21
+ value :ANY_RESERVATION, 2
22
+ value :SPECIFIC_RESERVATION, 3
23
+ end
14
24
  add_message "google.cloud.notebooks.v1beta1.Instance" do
15
25
  optional :name, :string, 1
16
26
  optional :post_startup_script, :string, 4
@@ -35,6 +45,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
35
45
  optional :subnet, :string, 20
36
46
  map :labels, :string, :string, 21
37
47
  map :metadata, :string, :string, 22
48
+ optional :nic_type, :enum, 28, "google.cloud.notebooks.v1beta1.Instance.NicType"
49
+ optional :reservation_affinity, :message, 29, "google.cloud.notebooks.v1beta1.ReservationAffinity"
50
+ optional :can_ip_forward, :bool, 31
38
51
  optional :create_time, :message, 23, "google.protobuf.Timestamp"
39
52
  optional :update_time, :message, 24, "google.protobuf.Timestamp"
40
53
  oneof :environment do
@@ -70,6 +83,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
70
83
  value :UPGRADING, 7
71
84
  value :INITIALIZING, 8
72
85
  value :REGISTERING, 9
86
+ value :SUSPENDING, 10
87
+ value :SUSPENDED, 11
73
88
  end
74
89
  add_enum "google.cloud.notebooks.v1beta1.Instance.DiskType" do
75
90
  value :DISK_TYPE_UNSPECIFIED, 0
@@ -82,6 +97,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
82
97
  value :GMEK, 1
83
98
  value :CMEK, 2
84
99
  end
100
+ add_enum "google.cloud.notebooks.v1beta1.Instance.NicType" do
101
+ value :UNSPECIFIED_NIC_TYPE, 0
102
+ value :VIRTIO_NET, 1
103
+ value :GVNIC, 2
104
+ end
85
105
  end
86
106
  end
87
107
 
@@ -89,12 +109,15 @@ module Google
89
109
  module Cloud
90
110
  module Notebooks
91
111
  module V1beta1
112
+ ReservationAffinity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.ReservationAffinity").msgclass
113
+ ReservationAffinity::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.ReservationAffinity.Type").enummodule
92
114
  Instance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance").msgclass
93
115
  Instance::AcceleratorConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.AcceleratorConfig").msgclass
94
116
  Instance::AcceleratorType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.AcceleratorType").enummodule
95
117
  Instance::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.State").enummodule
96
118
  Instance::DiskType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.DiskType").enummodule
97
119
  Instance::DiskEncryption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.DiskEncryption").enummodule
120
+ Instance::NicType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.notebooks.v1beta1.Instance.NicType").enummodule
98
121
  end
99
122
  end
100
123
  end
@@ -18,6 +18,8 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/notebooks/v1beta1/service_pb"
21
+ require "google/cloud/location"
22
+ require "google/iam/v1"
21
23
 
22
24
  module Google
23
25
  module Cloud
@@ -182,6 +184,18 @@ module Google
182
184
  config.endpoint = @config.endpoint
183
185
  end
184
186
 
187
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
188
+ config.credentials = credentials
189
+ config.quota_project = @quota_project_id
190
+ config.endpoint = @config.endpoint
191
+ end
192
+
193
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
194
+ config.credentials = credentials
195
+ config.quota_project = @quota_project_id
196
+ config.endpoint = @config.endpoint
197
+ end
198
+
185
199
  @notebook_service_stub = ::Gapic::ServiceStub.new(
186
200
  ::Google::Cloud::Notebooks::V1beta1::NotebookService::Stub,
187
201
  credentials: credentials,
@@ -198,6 +212,20 @@ module Google
198
212
  #
199
213
  attr_reader :operations_client
200
214
 
215
+ ##
216
+ # Get the associated client for mix-in of the Locations.
217
+ #
218
+ # @return [Google::Cloud::Location::Locations::Client]
219
+ #
220
+ attr_reader :location_client
221
+
222
+ ##
223
+ # Get the associated client for mix-in of the IAMPolicy.
224
+ #
225
+ # @return [Google::Iam::V1::IAMPolicy::Client]
226
+ #
227
+ attr_reader :iam_policy_client
228
+
201
229
  # Service calls
202
230
 
203
231
  ##
@@ -608,10 +636,10 @@ module Google
608
636
  # @param type [::Google::Cloud::Notebooks::V1beta1::Instance::AcceleratorType]
609
637
  # Required. Type of this accelerator.
610
638
  # @param core_count [::Integer]
611
- # Required. Count of cores of this accelerator. Note that not all
612
- # combinations of `type` and `core_count` are valid. Check [GPUs on Compute
613
- # Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a
614
- # valid combination. TPUs are not supported.
639
+ # Required. Count of cores of this accelerator. Note that not all combinations
640
+ # of `type` and `core_count` are valid. Check [GPUs on
641
+ # Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to
642
+ # find a valid combination. TPUs are not supported.
615
643
  #
616
644
  # @yield [response, operation] Access the result along with the RPC operation
617
645
  # @yieldparam response [::Gapic::Operation]
@@ -1360,6 +1388,9 @@ module Google
1360
1388
 
1361
1389
  ##
1362
1390
  # Check if a notebook instance is upgradable.
1391
+ # Deprecated. Please consider using v1.
1392
+ #
1393
+ # @deprecated This method is deprecated and may be removed in the next major version update.
1363
1394
  #
1364
1395
  # @overload is_instance_upgradeable(request, options = nil)
1365
1396
  # Pass arguments to `is_instance_upgradeable` via a request object, either of type
@@ -1446,6 +1477,9 @@ module Google
1446
1477
 
1447
1478
  ##
1448
1479
  # Upgrades a notebook instance to the latest version.
1480
+ # Deprecated. Please consider using v1.
1481
+ #
1482
+ # @deprecated This method is deprecated and may be removed in the next major version update.
1449
1483
  #
1450
1484
  # @overload upgrade_instance(request, options = nil)
1451
1485
  # Pass arguments to `upgrade_instance` via a request object, either of type
@@ -1541,6 +1575,9 @@ module Google
1541
1575
  ##
1542
1576
  # Allows notebook instances to
1543
1577
  # call this endpoint to upgrade themselves. Do not use this method directly.
1578
+ # Deprecated. Please consider using v1.
1579
+ #
1580
+ # @deprecated This method is deprecated and may be removed in the next major version update.
1544
1581
  #
1545
1582
  # @overload upgrade_instance_internal(request, options = nil)
1546
1583
  # Pass arguments to `upgrade_instance_internal` via a request object, either of type
@@ -1840,10 +1877,10 @@ module Google
1840
1877
  # @param parent [::String]
1841
1878
  # Required. Format: `projects/{project_id}/locations/{location}`
1842
1879
  # @param environment_id [::String]
1843
- # Required. User-defined unique ID of this environment. The `environment_id`
1844
- # must be 1 to 63 characters long and contain only lowercase letters, numeric
1845
- # characters, and dashes. The first character must be a lowercase letter and
1846
- # the last character cannot be a dash.
1880
+ # Required. User-defined unique ID of this environment. The `environment_id` must
1881
+ # be 1 to 63 characters long and contain only lowercase letters,
1882
+ # numeric characters, and dashes. The first character must be a lowercase
1883
+ # letter and the last character cannot be a dash.
1847
1884
  # @param environment [::Google::Cloud::Notebooks::V1beta1::Environment, ::Hash]
1848
1885
  # Required. The environment to be created.
1849
1886
  #
@@ -4,12 +4,12 @@
4
4
  require 'google/protobuf'
5
5
 
6
6
  require 'google/api/annotations_pb'
7
+ require 'google/api/client_pb'
7
8
  require 'google/api/field_behavior_pb'
8
9
  require 'google/cloud/notebooks/v1beta1/environment_pb'
9
10
  require 'google/cloud/notebooks/v1beta1/instance_pb'
10
11
  require 'google/longrunning/operations_pb'
11
12
  require 'google/protobuf/timestamp_pb'
12
- require 'google/api/client_pb'
13
13
 
14
14
  Google::Protobuf::DescriptorPool.generated_pool.build do
15
15
  add_file("google/cloud/notebooks/v1beta1/service.proto", :syntax => :proto3) do
@@ -82,6 +82,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
82
82
  optional :upgradeable, :bool, 1
83
83
  optional :upgrade_version, :string, 2
84
84
  optional :upgrade_info, :string, 3
85
+ optional :upgrade_image, :string, 4
85
86
  end
86
87
  add_message "google.cloud.notebooks.v1beta1.UpgradeInstanceRequest" do
87
88
  optional :name, :string, 1
@@ -64,11 +64,14 @@ module Google
64
64
  # the instance metadata store. Do not use this method directly.
65
65
  rpc :ReportInstanceInfo, ::Google::Cloud::Notebooks::V1beta1::ReportInstanceInfoRequest, ::Google::Longrunning::Operation
66
66
  # Check if a notebook instance is upgradable.
67
+ # Deprecated. Please consider using v1.
67
68
  rpc :IsInstanceUpgradeable, ::Google::Cloud::Notebooks::V1beta1::IsInstanceUpgradeableRequest, ::Google::Cloud::Notebooks::V1beta1::IsInstanceUpgradeableResponse
68
69
  # Upgrades a notebook instance to the latest version.
70
+ # Deprecated. Please consider using v1.
69
71
  rpc :UpgradeInstance, ::Google::Cloud::Notebooks::V1beta1::UpgradeInstanceRequest, ::Google::Longrunning::Operation
70
72
  # Allows notebook instances to
71
73
  # call this endpoint to upgrade themselves. Do not use this method directly.
74
+ # Deprecated. Please consider using v1.
72
75
  rpc :UpgradeInstanceInternal, ::Google::Cloud::Notebooks::V1beta1::UpgradeInstanceInternalRequest, ::Google::Longrunning::Operation
73
76
  # Lists environments in a project.
74
77
  rpc :ListEnvironments, ::Google::Cloud::Notebooks::V1beta1::ListEnvironmentsRequest, ::Google::Cloud::Notebooks::V1beta1::ListEnvironmentsResponse
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Notebooks
23
23
  module V1beta1
24
- VERSION = "0.5.0"
24
+ VERSION = "0.6.0"
25
25
  end
26
26
  end
27
27
  end
@@ -0,0 +1,318 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Required information for every language.
23
+ # @!attribute [rw] reference_docs_uri
24
+ # @return [::String]
25
+ # Link to automatically generated reference documentation. Example:
26
+ # https://cloud.google.com/nodejs/docs/reference/asset/latest
27
+ # @!attribute [rw] destinations
28
+ # @return [::Array<::Google::Api::ClientLibraryDestination>]
29
+ # The destination where API teams want this client library to be published.
30
+ class CommonLanguageSettings
31
+ include ::Google::Protobuf::MessageExts
32
+ extend ::Google::Protobuf::MessageExts::ClassMethods
33
+ end
34
+
35
+ # Details about how and where to publish client libraries.
36
+ # @!attribute [rw] version
37
+ # @return [::String]
38
+ # Version of the API to apply these settings to.
39
+ # @!attribute [rw] launch_stage
40
+ # @return [::Google::Api::LaunchStage]
41
+ # Launch stage of this version of the API.
42
+ # @!attribute [rw] rest_numeric_enums
43
+ # @return [::Boolean]
44
+ # When using transport=rest, the client request will encode enums as
45
+ # numbers rather than strings.
46
+ # @!attribute [rw] java_settings
47
+ # @return [::Google::Api::JavaSettings]
48
+ # Settings for legacy Java features, supported in the Service YAML.
49
+ # @!attribute [rw] cpp_settings
50
+ # @return [::Google::Api::CppSettings]
51
+ # Settings for C++ client libraries.
52
+ # @!attribute [rw] php_settings
53
+ # @return [::Google::Api::PhpSettings]
54
+ # Settings for PHP client libraries.
55
+ # @!attribute [rw] python_settings
56
+ # @return [::Google::Api::PythonSettings]
57
+ # Settings for Python client libraries.
58
+ # @!attribute [rw] node_settings
59
+ # @return [::Google::Api::NodeSettings]
60
+ # Settings for Node client libraries.
61
+ # @!attribute [rw] dotnet_settings
62
+ # @return [::Google::Api::DotnetSettings]
63
+ # Settings for .NET client libraries.
64
+ # @!attribute [rw] ruby_settings
65
+ # @return [::Google::Api::RubySettings]
66
+ # Settings for Ruby client libraries.
67
+ # @!attribute [rw] go_settings
68
+ # @return [::Google::Api::GoSettings]
69
+ # Settings for Go client libraries.
70
+ class ClientLibrarySettings
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # This message configures the settings for publishing [Google Cloud Client
76
+ # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
77
+ # generated from the service config.
78
+ # @!attribute [rw] method_settings
79
+ # @return [::Array<::Google::Api::MethodSettings>]
80
+ # A list of API method settings, e.g. the behavior for methods that use the
81
+ # long-running operation pattern.
82
+ # @!attribute [rw] new_issue_uri
83
+ # @return [::String]
84
+ # Link to a place that API users can report issues. Example:
85
+ # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
+ # @!attribute [rw] documentation_uri
87
+ # @return [::String]
88
+ # Link to product home page. Example:
89
+ # https://cloud.google.com/asset-inventory/docs/overview
90
+ # @!attribute [rw] api_short_name
91
+ # @return [::String]
92
+ # Used as a tracking tag when collecting data about the APIs developer
93
+ # relations artifacts like docs, packages delivered to package managers,
94
+ # etc. Example: "speech".
95
+ # @!attribute [rw] github_label
96
+ # @return [::String]
97
+ # GitHub label to apply to issues and pull requests opened for this API.
98
+ # @!attribute [rw] codeowner_github_teams
99
+ # @return [::Array<::String>]
100
+ # GitHub teams to be added to CODEOWNERS in the directory in GitHub
101
+ # containing source code for the client libraries for this API.
102
+ # @!attribute [rw] doc_tag_prefix
103
+ # @return [::String]
104
+ # A prefix used in sample code when demarking regions to be included in
105
+ # documentation.
106
+ # @!attribute [rw] organization
107
+ # @return [::Google::Api::ClientLibraryOrganization]
108
+ # For whom the client library is being published.
109
+ # @!attribute [rw] library_settings
110
+ # @return [::Array<::Google::Api::ClientLibrarySettings>]
111
+ # Client library settings. If the same version string appears multiple
112
+ # times in this list, then the last one wins. Settings from earlier
113
+ # settings with the same version string are discarded.
114
+ class Publishing
115
+ include ::Google::Protobuf::MessageExts
116
+ extend ::Google::Protobuf::MessageExts::ClassMethods
117
+ end
118
+
119
+ # Settings for Java client libraries.
120
+ # @!attribute [rw] library_package
121
+ # @return [::String]
122
+ # The package name to use in Java. Clobbers the java_package option
123
+ # set in the protobuf. This should be used **only** by APIs
124
+ # who have already set the language_settings.java.package_name" field
125
+ # in gapic.yaml. API teams should use the protobuf java_package option
126
+ # where possible.
127
+ #
128
+ # Example of a YAML configuration::
129
+ #
130
+ # publishing:
131
+ # java_settings:
132
+ # library_package: com.google.cloud.pubsub.v1
133
+ # @!attribute [rw] service_class_names
134
+ # @return [::Google::Protobuf::Map{::String => ::String}]
135
+ # Configure the Java class name to use instead of the service's for its
136
+ # corresponding generated GAPIC client. Keys are fully-qualified
137
+ # service names as they appear in the protobuf (including the full
138
+ # the language_settings.java.interface_names" field in gapic.yaml. API
139
+ # teams should otherwise use the service name as it appears in the
140
+ # protobuf.
141
+ #
142
+ # Example of a YAML configuration::
143
+ #
144
+ # publishing:
145
+ # java_settings:
146
+ # service_class_names:
147
+ # - google.pubsub.v1.Publisher: TopicAdmin
148
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
149
+ # @!attribute [rw] common
150
+ # @return [::Google::Api::CommonLanguageSettings]
151
+ # Some settings.
152
+ class JavaSettings
153
+ include ::Google::Protobuf::MessageExts
154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
155
+
156
+ # @!attribute [rw] key
157
+ # @return [::String]
158
+ # @!attribute [rw] value
159
+ # @return [::String]
160
+ class ServiceClassNamesEntry
161
+ include ::Google::Protobuf::MessageExts
162
+ extend ::Google::Protobuf::MessageExts::ClassMethods
163
+ end
164
+ end
165
+
166
+ # Settings for C++ client libraries.
167
+ # @!attribute [rw] common
168
+ # @return [::Google::Api::CommonLanguageSettings]
169
+ # Some settings.
170
+ class CppSettings
171
+ include ::Google::Protobuf::MessageExts
172
+ extend ::Google::Protobuf::MessageExts::ClassMethods
173
+ end
174
+
175
+ # Settings for Php client libraries.
176
+ # @!attribute [rw] common
177
+ # @return [::Google::Api::CommonLanguageSettings]
178
+ # Some settings.
179
+ class PhpSettings
180
+ include ::Google::Protobuf::MessageExts
181
+ extend ::Google::Protobuf::MessageExts::ClassMethods
182
+ end
183
+
184
+ # Settings for Python client libraries.
185
+ # @!attribute [rw] common
186
+ # @return [::Google::Api::CommonLanguageSettings]
187
+ # Some settings.
188
+ class PythonSettings
189
+ include ::Google::Protobuf::MessageExts
190
+ extend ::Google::Protobuf::MessageExts::ClassMethods
191
+ end
192
+
193
+ # Settings for Node client libraries.
194
+ # @!attribute [rw] common
195
+ # @return [::Google::Api::CommonLanguageSettings]
196
+ # Some settings.
197
+ class NodeSettings
198
+ include ::Google::Protobuf::MessageExts
199
+ extend ::Google::Protobuf::MessageExts::ClassMethods
200
+ end
201
+
202
+ # Settings for Dotnet client libraries.
203
+ # @!attribute [rw] common
204
+ # @return [::Google::Api::CommonLanguageSettings]
205
+ # Some settings.
206
+ class DotnetSettings
207
+ include ::Google::Protobuf::MessageExts
208
+ extend ::Google::Protobuf::MessageExts::ClassMethods
209
+ end
210
+
211
+ # Settings for Ruby client libraries.
212
+ # @!attribute [rw] common
213
+ # @return [::Google::Api::CommonLanguageSettings]
214
+ # Some settings.
215
+ class RubySettings
216
+ include ::Google::Protobuf::MessageExts
217
+ extend ::Google::Protobuf::MessageExts::ClassMethods
218
+ end
219
+
220
+ # Settings for Go client libraries.
221
+ # @!attribute [rw] common
222
+ # @return [::Google::Api::CommonLanguageSettings]
223
+ # Some settings.
224
+ class GoSettings
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
228
+
229
+ # Describes the generator configuration for a method.
230
+ # @!attribute [rw] selector
231
+ # @return [::String]
232
+ # The fully qualified name of the method, for which the options below apply.
233
+ # This is used to find the method to apply the options.
234
+ # @!attribute [rw] long_running
235
+ # @return [::Google::Api::MethodSettings::LongRunning]
236
+ # Describes settings to use for long-running operations when generating
237
+ # API methods for RPCs. Complements RPCs that use the annotations in
238
+ # google/longrunning/operations.proto.
239
+ #
240
+ # Example of a YAML configuration::
241
+ #
242
+ # publishing:
243
+ # method_behavior:
244
+ # - selector: CreateAdDomain
245
+ # long_running:
246
+ # initial_poll_delay:
247
+ # seconds: 60 # 1 minute
248
+ # poll_delay_multiplier: 1.5
249
+ # max_poll_delay:
250
+ # seconds: 360 # 6 minutes
251
+ # total_poll_timeout:
252
+ # seconds: 54000 # 90 minutes
253
+ class MethodSettings
254
+ include ::Google::Protobuf::MessageExts
255
+ extend ::Google::Protobuf::MessageExts::ClassMethods
256
+
257
+ # Describes settings to use when generating API methods that use the
258
+ # long-running operation pattern.
259
+ # All default values below are from those used in the client library
260
+ # generators (e.g.
261
+ # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
262
+ # @!attribute [rw] initial_poll_delay
263
+ # @return [::Google::Protobuf::Duration]
264
+ # Initial delay after which the first poll request will be made.
265
+ # Default value: 5 seconds.
266
+ # @!attribute [rw] poll_delay_multiplier
267
+ # @return [::Float]
268
+ # Multiplier to gradually increase delay between subsequent polls until it
269
+ # reaches max_poll_delay.
270
+ # Default value: 1.5.
271
+ # @!attribute [rw] max_poll_delay
272
+ # @return [::Google::Protobuf::Duration]
273
+ # Maximum time between two subsequent poll requests.
274
+ # Default value: 45 seconds.
275
+ # @!attribute [rw] total_poll_timeout
276
+ # @return [::Google::Protobuf::Duration]
277
+ # Total polling timeout.
278
+ # Default value: 5 minutes.
279
+ class LongRunning
280
+ include ::Google::Protobuf::MessageExts
281
+ extend ::Google::Protobuf::MessageExts::ClassMethods
282
+ end
283
+ end
284
+
285
+ # The organization for which the client libraries are being published.
286
+ # Affects the url where generated docs are published, etc.
287
+ module ClientLibraryOrganization
288
+ # Not useful.
289
+ CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
290
+
291
+ # Google Cloud Platform Org.
292
+ CLOUD = 1
293
+
294
+ # Ads (Advertising) Org.
295
+ ADS = 2
296
+
297
+ # Photos Org.
298
+ PHOTOS = 3
299
+
300
+ # Street View Org.
301
+ STREET_VIEW = 4
302
+ end
303
+
304
+ # To where should client libraries be published?
305
+ module ClientLibraryDestination
306
+ # Client libraries will neither be generated nor published to package
307
+ # managers.
308
+ CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
309
+
310
+ # Generate the client library in a repo under github.com/googleapis,
311
+ # but don't publish it to package managers.
312
+ GITHUB = 10
313
+
314
+ # Publish the library to package managers like nuget.org and npmjs.com.
315
+ PACKAGE_MANAGER = 20
316
+ end
317
+ end
318
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # The launch stage as defined by [Google Cloud Platform
23
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
24
+ module LaunchStage
25
+ # Do not use this default value.
26
+ LAUNCH_STAGE_UNSPECIFIED = 0
27
+
28
+ # The feature is not yet implemented. Users can not use it.
29
+ UNIMPLEMENTED = 6
30
+
31
+ # Prelaunch features are hidden from users and are only visible internally.
32
+ PRELAUNCH = 7
33
+
34
+ # Early Access features are limited to a closed group of testers. To use
35
+ # these features, you must sign up in advance and sign a Trusted Tester
36
+ # agreement (which includes confidentiality provisions). These features may
37
+ # be unstable, changed in backward-incompatible ways, and are not
38
+ # guaranteed to be released.
39
+ EARLY_ACCESS = 1
40
+
41
+ # Alpha is a limited availability test for releases before they are cleared
42
+ # for widespread use. By Alpha, all significant design issues are resolved
43
+ # and we are in the process of verifying functionality. Alpha customers
44
+ # need to apply for access, agree to applicable terms, and have their
45
+ # projects allowlisted. Alpha releases don't have to be feature complete,
46
+ # no SLAs are provided, and there are no technical support obligations, but
47
+ # they will be far enough along that customers can actually use them in
48
+ # test environments or for limited-use tests -- just like they would in
49
+ # normal production cases.
50
+ ALPHA = 2
51
+
52
+ # Beta is the point at which we are ready to open a release for any
53
+ # customer to use. There are no SLA or technical support obligations in a
54
+ # Beta release. Products will be complete from a feature perspective, but
55
+ # may have some open outstanding issues. Beta releases are suitable for
56
+ # limited production use cases.
57
+ BETA = 3
58
+
59
+ # GA features are open to all developers and are considered stable and
60
+ # fully qualified for production use.
61
+ GA = 4
62
+
63
+ # Deprecated features are scheduled to be shut down and removed. For more
64
+ # information, see the "Deprecation Policy" section of our [Terms of
65
+ # Service](https://cloud.google.com/terms/)
66
+ # and the [Google Cloud Platform Subject to the Deprecation
67
+ # Policy](https://cloud.google.com/terms/deprecation) documentation.
68
+ DEPRECATED = 5
69
+ end
70
+ end
71
+ end
@@ -21,6 +21,37 @@ module Google
21
21
  module Cloud
22
22
  module Notebooks
23
23
  module V1beta1
24
+ # Reservation Affinity for consuming Zonal reservation.
25
+ # @!attribute [rw] consume_reservation_type
26
+ # @return [::Google::Cloud::Notebooks::V1beta1::ReservationAffinity::Type]
27
+ # Optional. Type of reservation to consume
28
+ # @!attribute [rw] key
29
+ # @return [::String]
30
+ # Optional. Corresponds to the label key of reservation resource.
31
+ # @!attribute [rw] values
32
+ # @return [::Array<::String>]
33
+ # Optional. Corresponds to the label values of reservation resource.
34
+ class ReservationAffinity
35
+ include ::Google::Protobuf::MessageExts
36
+ extend ::Google::Protobuf::MessageExts::ClassMethods
37
+
38
+ # Indicates whether to consume capacity from an reservation or not.
39
+ module Type
40
+ # Default type.
41
+ TYPE_UNSPECIFIED = 0
42
+
43
+ # Do not consume from any allocated capacity.
44
+ NO_RESERVATION = 1
45
+
46
+ # Consume any reservation available.
47
+ ANY_RESERVATION = 2
48
+
49
+ # Must consume from a specific reservation. Must specify key value fields
50
+ # for specifying the reservations.
51
+ SPECIFIC_RESERVATION = 3
52
+ end
53
+ end
54
+
24
55
  # The definition of a notebook instance.
25
56
  # @!attribute [r] name
26
57
  # @return [::String]
@@ -36,15 +67,13 @@ module Google
36
67
  # @return [::String]
37
68
  # Path to a Bash script that automatically runs after a notebook instance
38
69
  # fully boots up. The path must be a URL or
39
- # Cloud Storage path (`gs://path-to-file/file-name`).
70
+ # Cloud Storage path (gs://path-to-file/file-name).
40
71
  # @!attribute [r] proxy_uri
41
72
  # @return [::String]
42
- # Output only. The proxy endpoint that is used to access the Jupyter
43
- # notebook.
73
+ # Output only. The proxy endpoint that is used to access the Jupyter notebook.
44
74
  # @!attribute [rw] instance_owners
45
75
  # @return [::Array<::String>]
46
- # Input only. The owner of this instance after creation. Format:
47
- # `alias@example.com`
76
+ # Input only. The owner of this instance after creation. Format: `alias@example.com`
48
77
  #
49
78
  # Currently supports one owner only. If not specified, all of the service
50
79
  # account users of your VM instance's service account can use
@@ -61,15 +90,14 @@ module Google
61
90
  # is used.
62
91
  # @!attribute [rw] machine_type
63
92
  # @return [::String]
64
- # Required. The [Compute Engine machine
65
- # type](https://cloud.google.com/compute/docs/machine-types) of this
93
+ # Required. The [Compute Engine machine type](/compute/docs/machine-types) of this
66
94
  # instance.
67
95
  # @!attribute [rw] accelerator_config
68
96
  # @return [::Google::Cloud::Notebooks::V1beta1::Instance::AcceleratorConfig]
69
97
  # The hardware accelerator used on this instance. If you use
70
98
  # accelerators, make sure that your configuration has
71
99
  # [enough vCPUs and memory to support the `machine_type` you
72
- # have selected](https://cloud.google.com/compute/docs/gpus/#gpus-list).
100
+ # have selected](/compute/docs/gpus/#gpus-list).
73
101
  # @!attribute [r] state
74
102
  # @return [::Google::Cloud::Notebooks::V1beta1::Instance::State]
75
103
  # Output only. The state of this instance.
@@ -85,39 +113,37 @@ module Google
85
113
  # If not specified, we'll automatically choose from official GPU drivers.
86
114
  # @!attribute [rw] boot_disk_type
87
115
  # @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskType]
88
- # Input only. The type of the boot disk attached to this instance, defaults
89
- # to standard persistent disk (`PD_STANDARD`).
116
+ # Input only. The type of the boot disk attached to this instance, defaults to
117
+ # standard persistent disk (`PD_STANDARD`).
90
118
  # @!attribute [rw] boot_disk_size_gb
91
119
  # @return [::Integer]
92
- # Input only. The size of the boot disk in GB attached to this instance, up
93
- # to a maximum of 64000&nbsp;GB (64&nbsp;TB). The minimum recommended value
94
- # is 100&nbsp;GB. If not specified, this defaults to 100.
120
+ # Input only. The size of the boot disk in GB attached to this instance, up to a maximum
121
+ # of 64000&nbsp;GB (64&nbsp;TB). The minimum recommended value is
122
+ # 100&nbsp;GB. If not specified, this defaults to 100.
95
123
  # @!attribute [rw] data_disk_type
96
124
  # @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskType]
97
- # Input only. The type of the data disk attached to this instance, defaults
98
- # to standard persistent disk (`PD_STANDARD`).
125
+ # Input only. The type of the data disk attached to this instance, defaults to
126
+ # standard persistent disk (`PD_STANDARD`).
99
127
  # @!attribute [rw] data_disk_size_gb
100
128
  # @return [::Integer]
101
- # Input only. The size of the data disk in GB attached to this instance, up
102
- # to a maximum of 64000&nbsp;GB (64&nbsp;TB). You can choose the size of the
103
- # data disk based on how big your notebooks and data are. If not specified,
104
- # this defaults to 100.
129
+ # Input only. The size of the data disk in GB attached to this instance, up to a maximum
130
+ # of 64000&nbsp;GB (64&nbsp;TB). You can choose the size of the data disk
131
+ # based on how big your notebooks and data are. If not specified, this
132
+ # defaults to 100.
105
133
  # @!attribute [rw] no_remove_data_disk
106
134
  # @return [::Boolean]
107
- # Input only. If true, the data disk will not be auto deleted when deleting
108
- # the instance.
135
+ # Input only. If true, the data disk will not be auto deleted when deleting the instance.
109
136
  # @!attribute [rw] disk_encryption
110
137
  # @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskEncryption]
111
- # Input only. Disk encryption method used on the boot and data disks,
112
- # defaults to GMEK.
138
+ # Input only. Disk encryption method used on the boot and data disks, defaults to GMEK.
113
139
  # @!attribute [rw] kms_key
114
140
  # @return [::String]
115
- # Input only. The KMS key used to encrypt the disks, only applicable if
116
- # disk_encryption is CMEK. Format:
141
+ # Input only. The KMS key used to encrypt the disks, only applicable if disk_encryption
142
+ # is CMEK.
143
+ # Format:
117
144
  # `projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}`
118
145
  #
119
- # Learn more about [using your own encryption keys](
120
- # https://cloud.google.com/kms/docs/quickstart).
146
+ # Learn more about [using your own encryption keys](/kms/docs/quickstart).
121
147
  # @!attribute [rw] no_public_ip
122
148
  # @return [::Boolean]
123
149
  # If true, no public IP will be assigned to this instance.
@@ -141,6 +167,20 @@ module Google
141
167
  # @!attribute [rw] metadata
142
168
  # @return [::Google::Protobuf::Map{::String => ::String}]
143
169
  # Custom metadata to apply to this instance.
170
+ # @!attribute [rw] nic_type
171
+ # @return [::Google::Cloud::Notebooks::V1beta1::Instance::NicType]
172
+ # Optional. The type of vNIC to be used on this interface. This may be gVNIC or
173
+ # VirtioNet.
174
+ # @!attribute [rw] reservation_affinity
175
+ # @return [::Google::Cloud::Notebooks::V1beta1::ReservationAffinity]
176
+ # Optional. The optional reservation affinity. Setting this field will apply
177
+ # the specified [Zonal Compute
178
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
179
+ # to this notebook instance.
180
+ # @!attribute [rw] can_ip_forward
181
+ # @return [::Boolean]
182
+ # Optional. Flag to enable ip forwarding or not, default false/off.
183
+ # https://cloud.google.com/vpc/docs/using-routes#canipforward
144
184
  # @!attribute [r] create_time
145
185
  # @return [::Google::Protobuf::Timestamp]
146
186
  # Output only. Instance creation time.
@@ -199,7 +239,7 @@ module Google
199
239
  # Accelerator type is Nvidia Tesla V100.
200
240
  NVIDIA_TESLA_V100 = 3
201
241
 
202
- # Accelerator type is Nvidia Tesla P_4.
242
+ # Accelerator type is Nvidia Tesla P4.
203
243
  NVIDIA_TESLA_P4 = 4
204
244
 
205
245
  # Accelerator type is Nvidia Tesla T4.
@@ -211,7 +251,7 @@ module Google
211
251
  # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
212
252
  NVIDIA_TESLA_P100_VWS = 9
213
253
 
214
- # Accelerator type is NVIDIA Tesla P_4 Virtual Workstations.
254
+ # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
215
255
  NVIDIA_TESLA_P4_VWS = 10
216
256
 
217
257
  # (Coming soon) Accelerator type is TPU V2.
@@ -253,6 +293,12 @@ module Google
253
293
 
254
294
  # The instance is getting registered.
255
295
  REGISTERING = 9
296
+
297
+ # The instance is suspending.
298
+ SUSPENDING = 10
299
+
300
+ # The instance is suspended.
301
+ SUSPENDED = 11
256
302
  end
257
303
 
258
304
  # Possible disk types for notebook instances.
@@ -281,6 +327,19 @@ module Google
281
327
  # Use customer managed encryption keys to encrypt the boot disk.
282
328
  CMEK = 2
283
329
  end
330
+
331
+ # The type of vNIC driver.
332
+ module NicType
333
+ # No type specified. Default should be UNSPECIFIED_NIC_TYPE.
334
+ UNSPECIFIED_NIC_TYPE = 0
335
+
336
+ # VIRTIO. Default in Notebooks DLVM.
337
+ VIRTIO_NET = 1
338
+
339
+ # GVNIC. Alternative to VIRTIO.
340
+ # https://github.com/GoogleCloudPlatform/compute-virtual-ethernet-linux
341
+ GVNIC = 2
342
+ end
284
343
  end
285
344
  end
286
345
  end
@@ -42,8 +42,7 @@ module Google
42
42
  # Identifies whether the user has requested cancellation
43
43
  # of the operation. Operations that have successfully been cancelled
44
44
  # have [Operation.error][] value with a
45
- # {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
46
- # `Code.CANCELLED`.
45
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to `Code.CANCELLED`.
47
46
  # @!attribute [rw] api_version
48
47
  # @return [::String]
49
48
  # API version used to start the operation.
@@ -142,10 +141,10 @@ module Google
142
141
  # Required. Type of this accelerator.
143
142
  # @!attribute [rw] core_count
144
143
  # @return [::Integer]
145
- # Required. Count of cores of this accelerator. Note that not all
146
- # combinations of `type` and `core_count` are valid. Check [GPUs on Compute
147
- # Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a
148
- # valid combination. TPUs are not supported.
144
+ # Required. Count of cores of this accelerator. Note that not all combinations
145
+ # of `type` and `core_count` are valid. Check [GPUs on
146
+ # Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to
147
+ # find a valid combination. TPUs are not supported.
149
148
  class SetInstanceAcceleratorRequest
150
149
  include ::Google::Protobuf::MessageExts
151
150
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -276,6 +275,11 @@ module Google
276
275
  # @!attribute [rw] upgrade_info
277
276
  # @return [::String]
278
277
  # Additional information about upgrade.
278
+ # @!attribute [rw] upgrade_image
279
+ # @return [::String]
280
+ # The new image self link this instance will be upgraded to if calling the
281
+ # upgrade endpoint. This field will only be populated if field upgradeable
282
+ # is true.
279
283
  class IsInstanceUpgradeableResponse
280
284
  include ::Google::Protobuf::MessageExts
281
285
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -353,10 +357,10 @@ module Google
353
357
  # Required. Format: `projects/{project_id}/locations/{location}`
354
358
  # @!attribute [rw] environment_id
355
359
  # @return [::String]
356
- # Required. User-defined unique ID of this environment. The `environment_id`
357
- # must be 1 to 63 characters long and contain only lowercase letters, numeric
358
- # characters, and dashes. The first character must be a lowercase letter and
359
- # the last character cannot be a dash.
360
+ # Required. User-defined unique ID of this environment. The `environment_id` must
361
+ # be 1 to 63 characters long and contain only lowercase letters,
362
+ # numeric characters, and dashes. The first character must be a lowercase
363
+ # letter and the last character cannot be a dash.
360
364
  # @!attribute [rw] environment
361
365
  # @return [::Google::Cloud::Notebooks::V1beta1::Environment]
362
366
  # Required. The environment to be created.
@@ -26,8 +26,6 @@ module Google
26
26
  # service Foo {
27
27
  # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
28
28
  # }
29
- #
30
- # The JSON representation for `Empty` is empty JSON object `{}`.
31
29
  class Empty
32
30
  include ::Google::Protobuf::MessageExts
33
31
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -0,0 +1,229 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Protobuf
22
+ # `FieldMask` represents a set of symbolic field paths, for example:
23
+ #
24
+ # paths: "f.a"
25
+ # paths: "f.b.d"
26
+ #
27
+ # Here `f` represents a field in some root message, `a` and `b`
28
+ # fields in the message found in `f`, and `d` a field found in the
29
+ # message in `f.b`.
30
+ #
31
+ # Field masks are used to specify a subset of fields that should be
32
+ # returned by a get operation or modified by an update operation.
33
+ # Field masks also have a custom JSON encoding (see below).
34
+ #
35
+ # # Field Masks in Projections
36
+ #
37
+ # When used in the context of a projection, a response message or
38
+ # sub-message is filtered by the API to only contain those fields as
39
+ # specified in the mask. For example, if the mask in the previous
40
+ # example is applied to a response message as follows:
41
+ #
42
+ # f {
43
+ # a : 22
44
+ # b {
45
+ # d : 1
46
+ # x : 2
47
+ # }
48
+ # y : 13
49
+ # }
50
+ # z: 8
51
+ #
52
+ # The result will not contain specific values for fields x,y and z
53
+ # (their value will be set to the default, and omitted in proto text
54
+ # output):
55
+ #
56
+ #
57
+ # f {
58
+ # a : 22
59
+ # b {
60
+ # d : 1
61
+ # }
62
+ # }
63
+ #
64
+ # A repeated field is not allowed except at the last position of a
65
+ # paths string.
66
+ #
67
+ # If a FieldMask object is not present in a get operation, the
68
+ # operation applies to all fields (as if a FieldMask of all fields
69
+ # had been specified).
70
+ #
71
+ # Note that a field mask does not necessarily apply to the
72
+ # top-level response message. In case of a REST get operation, the
73
+ # field mask applies directly to the response, but in case of a REST
74
+ # list operation, the mask instead applies to each individual message
75
+ # in the returned resource list. In case of a REST custom method,
76
+ # other definitions may be used. Where the mask applies will be
77
+ # clearly documented together with its declaration in the API. In
78
+ # any case, the effect on the returned resource/resources is required
79
+ # behavior for APIs.
80
+ #
81
+ # # Field Masks in Update Operations
82
+ #
83
+ # A field mask in update operations specifies which fields of the
84
+ # targeted resource are going to be updated. The API is required
85
+ # to only change the values of the fields as specified in the mask
86
+ # and leave the others untouched. If a resource is passed in to
87
+ # describe the updated values, the API ignores the values of all
88
+ # fields not covered by the mask.
89
+ #
90
+ # If a repeated field is specified for an update operation, new values will
91
+ # be appended to the existing repeated field in the target resource. Note that
92
+ # a repeated field is only allowed in the last position of a `paths` string.
93
+ #
94
+ # If a sub-message is specified in the last position of the field mask for an
95
+ # update operation, then new value will be merged into the existing sub-message
96
+ # in the target resource.
97
+ #
98
+ # For example, given the target message:
99
+ #
100
+ # f {
101
+ # b {
102
+ # d: 1
103
+ # x: 2
104
+ # }
105
+ # c: [1]
106
+ # }
107
+ #
108
+ # And an update message:
109
+ #
110
+ # f {
111
+ # b {
112
+ # d: 10
113
+ # }
114
+ # c: [2]
115
+ # }
116
+ #
117
+ # then if the field mask is:
118
+ #
119
+ # paths: ["f.b", "f.c"]
120
+ #
121
+ # then the result will be:
122
+ #
123
+ # f {
124
+ # b {
125
+ # d: 10
126
+ # x: 2
127
+ # }
128
+ # c: [1, 2]
129
+ # }
130
+ #
131
+ # An implementation may provide options to override this default behavior for
132
+ # repeated and message fields.
133
+ #
134
+ # In order to reset a field's value to the default, the field must
135
+ # be in the mask and set to the default value in the provided resource.
136
+ # Hence, in order to reset all fields of a resource, provide a default
137
+ # instance of the resource and set all fields in the mask, or do
138
+ # not provide a mask as described below.
139
+ #
140
+ # If a field mask is not present on update, the operation applies to
141
+ # all fields (as if a field mask of all fields has been specified).
142
+ # Note that in the presence of schema evolution, this may mean that
143
+ # fields the client does not know and has therefore not filled into
144
+ # the request will be reset to their default. If this is unwanted
145
+ # behavior, a specific service may require a client to always specify
146
+ # a field mask, producing an error if not.
147
+ #
148
+ # As with get operations, the location of the resource which
149
+ # describes the updated values in the request message depends on the
150
+ # operation kind. In any case, the effect of the field mask is
151
+ # required to be honored by the API.
152
+ #
153
+ # ## Considerations for HTTP REST
154
+ #
155
+ # The HTTP kind of an update operation which uses a field mask must
156
+ # be set to PATCH instead of PUT in order to satisfy HTTP semantics
157
+ # (PUT must only be used for full updates).
158
+ #
159
+ # # JSON Encoding of Field Masks
160
+ #
161
+ # In JSON, a field mask is encoded as a single string where paths are
162
+ # separated by a comma. Fields name in each path are converted
163
+ # to/from lower-camel naming conventions.
164
+ #
165
+ # As an example, consider the following message declarations:
166
+ #
167
+ # message Profile {
168
+ # User user = 1;
169
+ # Photo photo = 2;
170
+ # }
171
+ # message User {
172
+ # string display_name = 1;
173
+ # string address = 2;
174
+ # }
175
+ #
176
+ # In proto a field mask for `Profile` may look as such:
177
+ #
178
+ # mask {
179
+ # paths: "user.display_name"
180
+ # paths: "photo"
181
+ # }
182
+ #
183
+ # In JSON, the same mask is represented as below:
184
+ #
185
+ # {
186
+ # mask: "user.displayName,photo"
187
+ # }
188
+ #
189
+ # # Field Masks and Oneof Fields
190
+ #
191
+ # Field masks treat fields in oneofs just as regular fields. Consider the
192
+ # following message:
193
+ #
194
+ # message SampleMessage {
195
+ # oneof test_oneof {
196
+ # string name = 4;
197
+ # SubMessage sub_message = 9;
198
+ # }
199
+ # }
200
+ #
201
+ # The field mask can be:
202
+ #
203
+ # mask {
204
+ # paths: "name"
205
+ # }
206
+ #
207
+ # Or:
208
+ #
209
+ # mask {
210
+ # paths: "sub_message"
211
+ # }
212
+ #
213
+ # Note that oneof type names ("test_oneof" in this case) cannot be used in
214
+ # paths.
215
+ #
216
+ # ## Field Mask Verification
217
+ #
218
+ # The implementation of any API method which has a FieldMask type field in the
219
+ # request should verify the included field paths, and return an
220
+ # `INVALID_ARGUMENT` error if any path is unmappable.
221
+ # @!attribute [rw] paths
222
+ # @return [::Array<::String>]
223
+ # The set of field mask paths.
224
+ class FieldMask
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
228
+ end
229
+ end
@@ -0,0 +1,75 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Type
22
+ # Represents a textual expression in the Common Expression Language (CEL)
23
+ # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
24
+ # are documented at https://github.com/google/cel-spec.
25
+ #
26
+ # Example (Comparison):
27
+ #
28
+ # title: "Summary size limit"
29
+ # description: "Determines if a summary is less than 100 chars"
30
+ # expression: "document.summary.size() < 100"
31
+ #
32
+ # Example (Equality):
33
+ #
34
+ # title: "Requestor is owner"
35
+ # description: "Determines if requestor is the document owner"
36
+ # expression: "document.owner == request.auth.claims.email"
37
+ #
38
+ # Example (Logic):
39
+ #
40
+ # title: "Public documents"
41
+ # description: "Determine whether the document should be publicly visible"
42
+ # expression: "document.type != 'private' && document.type != 'internal'"
43
+ #
44
+ # Example (Data Manipulation):
45
+ #
46
+ # title: "Notification string"
47
+ # description: "Create a notification string with a timestamp."
48
+ # expression: "'New message received at ' + string(document.create_time)"
49
+ #
50
+ # The exact variables and functions that may be referenced within an expression
51
+ # are determined by the service that evaluates it. See the service
52
+ # documentation for additional information.
53
+ # @!attribute [rw] expression
54
+ # @return [::String]
55
+ # Textual representation of an expression in Common Expression Language
56
+ # syntax.
57
+ # @!attribute [rw] title
58
+ # @return [::String]
59
+ # Optional. Title for the expression, i.e. a short string describing
60
+ # its purpose. This can be used e.g. in UIs which allow to enter the
61
+ # expression.
62
+ # @!attribute [rw] description
63
+ # @return [::String]
64
+ # Optional. Description of the expression. This is a longer text which
65
+ # describes the expression, e.g. when hovered over it in a UI.
66
+ # @!attribute [rw] location
67
+ # @return [::String]
68
+ # Optional. String indicating the location of the expression for error
69
+ # reporting, e.g. a file name and a position in the file.
70
+ class Expr
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+ end
75
+ end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-notebooks-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.0
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-07-06 00:00:00.000000000 Z
11
+ date: 2022-11-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.10'
19
+ version: '0.12'
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.10'
29
+ version: '0.12'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -44,6 +44,46 @@ dependencies:
44
44
  - - "~>"
45
45
  - !ruby/object:Gem::Version
46
46
  version: '1.0'
47
+ - !ruby/object:Gem::Dependency
48
+ name: google-cloud-location
49
+ requirement: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - ">="
52
+ - !ruby/object:Gem::Version
53
+ version: '0.0'
54
+ - - "<"
55
+ - !ruby/object:Gem::Version
56
+ version: 2.a
57
+ type: :runtime
58
+ prerelease: false
59
+ version_requirements: !ruby/object:Gem::Requirement
60
+ requirements:
61
+ - - ">="
62
+ - !ruby/object:Gem::Version
63
+ version: '0.0'
64
+ - - "<"
65
+ - !ruby/object:Gem::Version
66
+ version: 2.a
67
+ - !ruby/object:Gem::Dependency
68
+ name: google-iam-v1
69
+ requirement: !ruby/object:Gem::Requirement
70
+ requirements:
71
+ - - ">="
72
+ - !ruby/object:Gem::Version
73
+ version: '0.0'
74
+ - - "<"
75
+ - !ruby/object:Gem::Version
76
+ version: 2.a
77
+ type: :runtime
78
+ prerelease: false
79
+ version_requirements: !ruby/object:Gem::Requirement
80
+ requirements:
81
+ - - ">="
82
+ - !ruby/object:Gem::Version
83
+ version: '0.0'
84
+ - - "<"
85
+ - !ruby/object:Gem::Version
86
+ version: 2.a
47
87
  - !ruby/object:Gem::Dependency
48
88
  name: google-style
49
89
  requirement: !ruby/object:Gem::Requirement
@@ -184,7 +224,9 @@ files:
184
224
  - lib/google/cloud/notebooks/v1beta1/service_services_pb.rb
185
225
  - lib/google/cloud/notebooks/v1beta1/version.rb
186
226
  - proto_docs/README.md
227
+ - proto_docs/google/api/client.rb
187
228
  - proto_docs/google/api/field_behavior.rb
229
+ - proto_docs/google/api/launch_stage.rb
188
230
  - proto_docs/google/api/resource.rb
189
231
  - proto_docs/google/cloud/notebooks/v1beta1/environment.rb
190
232
  - proto_docs/google/cloud/notebooks/v1beta1/instance.rb
@@ -193,8 +235,10 @@ files:
193
235
  - proto_docs/google/protobuf/any.rb
194
236
  - proto_docs/google/protobuf/duration.rb
195
237
  - proto_docs/google/protobuf/empty.rb
238
+ - proto_docs/google/protobuf/field_mask.rb
196
239
  - proto_docs/google/protobuf/timestamp.rb
197
240
  - proto_docs/google/rpc/status.rb
241
+ - proto_docs/google/type/expr.rb
198
242
  homepage: https://github.com/googleapis/google-cloud-ruby
199
243
  licenses:
200
244
  - Apache-2.0