google-cloud-notebooks-v1beta1 0.5.0 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
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