google-cloud-hypercompute_cluster-v1beta 0.a → 0.1.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.
Files changed (37) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +122 -0
  4. data/README.md +154 -8
  5. data/lib/google/cloud/hypercompute_cluster/v1beta/bindings_override.rb +75 -0
  6. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/client.rb +968 -0
  7. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/credentials.rb +47 -0
  8. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/operations.rb +841 -0
  9. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/paths.rb +217 -0
  10. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/rest/client.rb +898 -0
  11. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/rest/operations.rb +925 -0
  12. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/rest/service_stub.rb +388 -0
  13. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster/rest.rb +54 -0
  14. data/lib/google/cloud/hypercompute_cluster/v1beta/hypercompute_cluster.rb +56 -0
  15. data/lib/google/cloud/hypercompute_cluster/v1beta/rest.rb +38 -0
  16. data/lib/google/cloud/hypercompute_cluster/v1beta/version.rb +7 -2
  17. data/lib/google/cloud/hypercompute_cluster/v1beta.rb +45 -0
  18. data/lib/google/cloud/hypercomputecluster/v1beta/hypercompute_cluster_pb.rb +101 -0
  19. data/lib/google/cloud/hypercomputecluster/v1beta/hypercompute_cluster_services_pb.rb +53 -0
  20. data/lib/google/cloud/hypercomputecluster/v1beta/operation_metadata_pb.rb +47 -0
  21. data/lib/google-cloud-hypercompute_cluster-v1beta.rb +21 -0
  22. data/proto_docs/README.md +4 -0
  23. data/proto_docs/google/api/client.rb +473 -0
  24. data/proto_docs/google/api/field_behavior.rb +85 -0
  25. data/proto_docs/google/api/field_info.rb +88 -0
  26. data/proto_docs/google/api/launch_stage.rb +71 -0
  27. data/proto_docs/google/api/resource.rb +227 -0
  28. data/proto_docs/google/cloud/hypercomputecluster/v1beta/hypercompute_cluster.rb +1007 -0
  29. data/proto_docs/google/cloud/hypercomputecluster/v1beta/operation_metadata.rb +55 -0
  30. data/proto_docs/google/longrunning/operations.rb +191 -0
  31. data/proto_docs/google/protobuf/any.rb +145 -0
  32. data/proto_docs/google/protobuf/duration.rb +98 -0
  33. data/proto_docs/google/protobuf/empty.rb +34 -0
  34. data/proto_docs/google/protobuf/field_mask.rb +229 -0
  35. data/proto_docs/google/protobuf/timestamp.rb +127 -0
  36. data/proto_docs/google/rpc/status.rb +48 -0
  37. metadata +84 -9
@@ -0,0 +1,968 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 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
+ require "google/cloud/errors"
20
+ require "google/cloud/hypercomputecluster/v1beta/hypercompute_cluster_pb"
21
+ require "google/cloud/location"
22
+
23
+ module Google
24
+ module Cloud
25
+ module HypercomputeCluster
26
+ module V1beta
27
+ module HypercomputeCluster
28
+ ##
29
+ # Client for the HypercomputeCluster service.
30
+ #
31
+ # Service describing handlers for resources
32
+ #
33
+ class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
37
+ # @private
38
+ DEFAULT_ENDPOINT_TEMPLATE = "hypercomputecluster.$UNIVERSE_DOMAIN$"
39
+
40
+ include Paths
41
+
42
+ # @private
43
+ attr_reader :hypercompute_cluster_stub
44
+
45
+ ##
46
+ # Configure the HypercomputeCluster Client class.
47
+ #
48
+ # See {::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client::Configuration}
49
+ # for a description of the configuration fields.
50
+ #
51
+ # @example
52
+ #
53
+ # # Modify the configuration for all HypercomputeCluster clients
54
+ # ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.configure do |config|
55
+ # config.timeout = 10.0
56
+ # end
57
+ #
58
+ # @yield [config] Configure the Client client.
59
+ # @yieldparam config [Client::Configuration]
60
+ #
61
+ # @return [Client::Configuration]
62
+ #
63
+ def self.configure
64
+ @configure ||= begin
65
+ namespace = ["Google", "Cloud", "HypercomputeCluster", "V1beta"]
66
+ parent_config = while namespace.any?
67
+ parent_name = namespace.join "::"
68
+ parent_const = const_get parent_name
69
+ break parent_const.configure if parent_const.respond_to? :configure
70
+ namespace.pop
71
+ end
72
+ default_config = Client::Configuration.new parent_config
73
+
74
+ default_config.rpcs.list_clusters.timeout = 60.0
75
+ default_config.rpcs.list_clusters.retry_policy = {
76
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
77
+ }
78
+
79
+ default_config.rpcs.get_cluster.timeout = 60.0
80
+ default_config.rpcs.get_cluster.retry_policy = {
81
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
82
+ }
83
+
84
+ default_config.rpcs.create_cluster.timeout = 3600.0
85
+
86
+ default_config.rpcs.update_cluster.timeout = 3600.0
87
+
88
+ default_config.rpcs.delete_cluster.timeout = 3600.0
89
+
90
+ default_config
91
+ end
92
+ yield @configure if block_given?
93
+ @configure
94
+ end
95
+
96
+ ##
97
+ # Configure the HypercomputeCluster Client instance.
98
+ #
99
+ # The configuration is set to the derived mode, meaning that values can be changed,
100
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
101
+ # should be made on {Client.configure}.
102
+ #
103
+ # See {::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client::Configuration}
104
+ # for a description of the configuration fields.
105
+ #
106
+ # @yield [config] Configure the Client client.
107
+ # @yieldparam config [Client::Configuration]
108
+ #
109
+ # @return [Client::Configuration]
110
+ #
111
+ def configure
112
+ yield @config if block_given?
113
+ @config
114
+ end
115
+
116
+ ##
117
+ # The effective universe domain
118
+ #
119
+ # @return [String]
120
+ #
121
+ def universe_domain
122
+ @hypercompute_cluster_stub.universe_domain
123
+ end
124
+
125
+ ##
126
+ # Create a new HypercomputeCluster client object.
127
+ #
128
+ # @example
129
+ #
130
+ # # Create a client using the default configuration
131
+ # client = ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
132
+ #
133
+ # # Create a client using a custom configuration
134
+ # client = ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new do |config|
135
+ # config.timeout = 10.0
136
+ # end
137
+ #
138
+ # @yield [config] Configure the HypercomputeCluster client.
139
+ # @yieldparam config [Client::Configuration]
140
+ #
141
+ def initialize
142
+ # These require statements are intentionally placed here to initialize
143
+ # the gRPC module only when it's required.
144
+ # See https://github.com/googleapis/toolkit/issues/446
145
+ require "gapic/grpc"
146
+ require "google/cloud/hypercomputecluster/v1beta/hypercompute_cluster_services_pb"
147
+
148
+ # Create the configuration object
149
+ @config = Configuration.new Client.configure
150
+
151
+ # Yield the configuration if needed
152
+ yield @config if block_given?
153
+
154
+ # Create credentials
155
+ credentials = @config.credentials
156
+ # Use self-signed JWT if the endpoint is unchanged from default,
157
+ # but only if the default endpoint does not have a region prefix.
158
+ enable_self_signed_jwt = @config.endpoint.nil? ||
159
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
160
+ !@config.endpoint.split(".").first.include?("-"))
161
+ credentials ||= Credentials.default scope: @config.scope,
162
+ enable_self_signed_jwt: enable_self_signed_jwt
163
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
164
+ credentials = Credentials.new credentials, scope: @config.scope
165
+ end
166
+ @quota_project_id = @config.quota_project
167
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
168
+
169
+ @operations_client = Operations.new do |config|
170
+ config.credentials = credentials
171
+ config.quota_project = @quota_project_id
172
+ config.endpoint = @config.endpoint
173
+ config.universe_domain = @config.universe_domain
174
+ end
175
+
176
+ @hypercompute_cluster_stub = ::Gapic::ServiceStub.new(
177
+ ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Stub,
178
+ credentials: credentials,
179
+ endpoint: @config.endpoint,
180
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
181
+ universe_domain: @config.universe_domain,
182
+ channel_args: @config.channel_args,
183
+ interceptors: @config.interceptors,
184
+ channel_pool_config: @config.channel_pool,
185
+ logger: @config.logger
186
+ )
187
+
188
+ @hypercompute_cluster_stub.stub_logger&.info do |entry|
189
+ entry.set_system_name
190
+ entry.set_service
191
+ entry.message = "Created client for #{entry.service}"
192
+ entry.set_credentials_fields credentials
193
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
194
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
195
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
196
+ end
197
+
198
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
199
+ config.credentials = credentials
200
+ config.quota_project = @quota_project_id
201
+ config.endpoint = @hypercompute_cluster_stub.endpoint
202
+ config.universe_domain = @hypercompute_cluster_stub.universe_domain
203
+ config.logger = @hypercompute_cluster_stub.logger if config.respond_to? :logger=
204
+ end
205
+ end
206
+
207
+ ##
208
+ # Get the associated client for long-running operations.
209
+ #
210
+ # @return [::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Operations]
211
+ #
212
+ attr_reader :operations_client
213
+
214
+ ##
215
+ # Get the associated client for mix-in of the Locations.
216
+ #
217
+ # @return [Google::Cloud::Location::Locations::Client]
218
+ #
219
+ attr_reader :location_client
220
+
221
+ ##
222
+ # The logger used for request/response debug logging.
223
+ #
224
+ # @return [Logger]
225
+ #
226
+ def logger
227
+ @hypercompute_cluster_stub.logger
228
+ end
229
+
230
+ # Service calls
231
+
232
+ ##
233
+ # Lists Clusters in a given project and location.
234
+ #
235
+ # @overload list_clusters(request, options = nil)
236
+ # Pass arguments to `list_clusters` via a request object, either of type
237
+ # {::Google::Cloud::HypercomputeCluster::V1beta::ListClustersRequest} or an equivalent Hash.
238
+ #
239
+ # @param request [::Google::Cloud::HypercomputeCluster::V1beta::ListClustersRequest, ::Hash]
240
+ # A request object representing the call parameters. Required. To specify no
241
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
242
+ # @param options [::Gapic::CallOptions, ::Hash]
243
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
244
+ #
245
+ # @overload list_clusters(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
246
+ # Pass arguments to `list_clusters` via keyword arguments. Note that at
247
+ # least one keyword argument is required. To specify no parameters, or to keep all
248
+ # the default parameter values, pass an empty Hash as a request object (see above).
249
+ #
250
+ # @param parent [::String]
251
+ # Required. Parent location of the clusters to list, in the format
252
+ # `projects/{project}/locations/{location}`.
253
+ # @param page_size [::Integer]
254
+ # Optional. Maximum number of clusters to return. The service may return
255
+ # fewer than this value.
256
+ # @param page_token [::String]
257
+ # Optional. A page token received from a previous `ListClusters` call.
258
+ # Provide this to retrieve the subsequent page. When paginating, all other
259
+ # parameters provided to `ListClusters` must match the call that provided the
260
+ # page token.
261
+ # @param filter [::String]
262
+ # Optional. [Filter](https://google.aip.dev/160) to apply to the returned
263
+ # results.
264
+ # @param order_by [::String]
265
+ # Optional. How to order the resulting clusters. Must be one of the following
266
+ # strings:
267
+ #
268
+ # * `name`
269
+ # * `name desc`
270
+ # * `create_time`
271
+ # * `create_time desc`
272
+ #
273
+ # If not specified, clusters will be returned in an arbitrary order.
274
+ #
275
+ # @yield [response, operation] Access the result along with the RPC operation
276
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::HypercomputeCluster::V1beta::Cluster>]
277
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
278
+ #
279
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::HypercomputeCluster::V1beta::Cluster>]
280
+ #
281
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
282
+ #
283
+ # @example Basic example
284
+ # require "google/cloud/hypercompute_cluster/v1beta"
285
+ #
286
+ # # Create a client object. The client can be reused for multiple calls.
287
+ # client = Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
288
+ #
289
+ # # Create a request. To set request fields, pass in keyword arguments.
290
+ # request = Google::Cloud::HypercomputeCluster::V1beta::ListClustersRequest.new
291
+ #
292
+ # # Call the list_clusters method.
293
+ # result = client.list_clusters request
294
+ #
295
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
296
+ # # over elements, and API calls will be issued to fetch pages as needed.
297
+ # result.each do |item|
298
+ # # Each element is of type ::Google::Cloud::HypercomputeCluster::V1beta::Cluster.
299
+ # p item
300
+ # end
301
+ #
302
+ def list_clusters request, options = nil
303
+ raise ::ArgumentError, "request must be provided" if request.nil?
304
+
305
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::HypercomputeCluster::V1beta::ListClustersRequest
306
+
307
+ # Converts hash and nil to an options object
308
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
309
+
310
+ # Customize the options with defaults
311
+ metadata = @config.rpcs.list_clusters.metadata.to_h
312
+
313
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
314
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
315
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
316
+ gapic_version: ::Google::Cloud::HypercomputeCluster::V1beta::VERSION
317
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
318
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
319
+
320
+ header_params = {}
321
+ if request.parent
322
+ header_params["parent"] = request.parent
323
+ end
324
+
325
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
326
+ metadata[:"x-goog-request-params"] ||= request_params_header
327
+
328
+ options.apply_defaults timeout: @config.rpcs.list_clusters.timeout,
329
+ metadata: metadata,
330
+ retry_policy: @config.rpcs.list_clusters.retry_policy
331
+
332
+ options.apply_defaults timeout: @config.timeout,
333
+ metadata: @config.metadata,
334
+ retry_policy: @config.retry_policy
335
+
336
+ @hypercompute_cluster_stub.call_rpc :list_clusters, request, options: options do |response, operation|
337
+ response = ::Gapic::PagedEnumerable.new @hypercompute_cluster_stub, :list_clusters, request, response, operation, options
338
+ yield response, operation if block_given?
339
+ throw :response, response
340
+ end
341
+ rescue ::GRPC::BadStatus => e
342
+ raise ::Google::Cloud::Error.from_error(e)
343
+ end
344
+
345
+ ##
346
+ # Gets details of a single Cluster.
347
+ #
348
+ # @overload get_cluster(request, options = nil)
349
+ # Pass arguments to `get_cluster` via a request object, either of type
350
+ # {::Google::Cloud::HypercomputeCluster::V1beta::GetClusterRequest} or an equivalent Hash.
351
+ #
352
+ # @param request [::Google::Cloud::HypercomputeCluster::V1beta::GetClusterRequest, ::Hash]
353
+ # A request object representing the call parameters. Required. To specify no
354
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
355
+ # @param options [::Gapic::CallOptions, ::Hash]
356
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
357
+ #
358
+ # @overload get_cluster(name: nil)
359
+ # Pass arguments to `get_cluster` via keyword arguments. Note that at
360
+ # least one keyword argument is required. To specify no parameters, or to keep all
361
+ # the default parameter values, pass an empty Hash as a request object (see above).
362
+ #
363
+ # @param name [::String]
364
+ # Required. Name of the cluster to retrieve, in the format
365
+ # `projects/{project}/locations/{location}/clusters/{cluster}`.
366
+ #
367
+ # @yield [response, operation] Access the result along with the RPC operation
368
+ # @yieldparam response [::Google::Cloud::HypercomputeCluster::V1beta::Cluster]
369
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
370
+ #
371
+ # @return [::Google::Cloud::HypercomputeCluster::V1beta::Cluster]
372
+ #
373
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
374
+ #
375
+ # @example Basic example
376
+ # require "google/cloud/hypercompute_cluster/v1beta"
377
+ #
378
+ # # Create a client object. The client can be reused for multiple calls.
379
+ # client = Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
380
+ #
381
+ # # Create a request. To set request fields, pass in keyword arguments.
382
+ # request = Google::Cloud::HypercomputeCluster::V1beta::GetClusterRequest.new
383
+ #
384
+ # # Call the get_cluster method.
385
+ # result = client.get_cluster request
386
+ #
387
+ # # The returned object is of type Google::Cloud::HypercomputeCluster::V1beta::Cluster.
388
+ # p result
389
+ #
390
+ def get_cluster request, options = nil
391
+ raise ::ArgumentError, "request must be provided" if request.nil?
392
+
393
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::HypercomputeCluster::V1beta::GetClusterRequest
394
+
395
+ # Converts hash and nil to an options object
396
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
397
+
398
+ # Customize the options with defaults
399
+ metadata = @config.rpcs.get_cluster.metadata.to_h
400
+
401
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
402
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
403
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
404
+ gapic_version: ::Google::Cloud::HypercomputeCluster::V1beta::VERSION
405
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
406
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
407
+
408
+ header_params = {}
409
+ if request.name
410
+ header_params["name"] = request.name
411
+ end
412
+
413
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
414
+ metadata[:"x-goog-request-params"] ||= request_params_header
415
+
416
+ options.apply_defaults timeout: @config.rpcs.get_cluster.timeout,
417
+ metadata: metadata,
418
+ retry_policy: @config.rpcs.get_cluster.retry_policy
419
+
420
+ options.apply_defaults timeout: @config.timeout,
421
+ metadata: @config.metadata,
422
+ retry_policy: @config.retry_policy
423
+
424
+ @hypercompute_cluster_stub.call_rpc :get_cluster, request, options: options do |response, operation|
425
+ yield response, operation if block_given?
426
+ end
427
+ rescue ::GRPC::BadStatus => e
428
+ raise ::Google::Cloud::Error.from_error(e)
429
+ end
430
+
431
+ ##
432
+ # Creates a new Cluster in a given project and location.
433
+ #
434
+ # @overload create_cluster(request, options = nil)
435
+ # Pass arguments to `create_cluster` via a request object, either of type
436
+ # {::Google::Cloud::HypercomputeCluster::V1beta::CreateClusterRequest} or an equivalent Hash.
437
+ #
438
+ # @param request [::Google::Cloud::HypercomputeCluster::V1beta::CreateClusterRequest, ::Hash]
439
+ # A request object representing the call parameters. Required. To specify no
440
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
441
+ # @param options [::Gapic::CallOptions, ::Hash]
442
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
443
+ #
444
+ # @overload create_cluster(parent: nil, cluster_id: nil, cluster: nil, request_id: nil)
445
+ # Pass arguments to `create_cluster` via keyword arguments. Note that at
446
+ # least one keyword argument is required. To specify no parameters, or to keep all
447
+ # the default parameter values, pass an empty Hash as a request object (see above).
448
+ #
449
+ # @param parent [::String]
450
+ # Required. Parent location in which the cluster should be created, in the
451
+ # format `projects/{project}/locations/{location}`.
452
+ # @param cluster_id [::String]
453
+ # Required. ID of the cluster to create. Must conform to
454
+ # [RFC-1034](https://datatracker.ietf.org/doc/html/rfc1034) (lower-case,
455
+ # alphanumeric, and at most 63 characters).
456
+ # @param cluster [::Google::Cloud::HypercomputeCluster::V1beta::Cluster, ::Hash]
457
+ # Required. Cluster to create.
458
+ # @param request_id [::String]
459
+ # Optional. A unique identifier for this request. A random UUID is
460
+ # recommended. This request is idempotent if and only if `request_id` is
461
+ # provided.
462
+ #
463
+ # @yield [response, operation] Access the result along with the RPC operation
464
+ # @yieldparam response [::Gapic::Operation]
465
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
466
+ #
467
+ # @return [::Gapic::Operation]
468
+ #
469
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
470
+ #
471
+ # @example Basic example
472
+ # require "google/cloud/hypercompute_cluster/v1beta"
473
+ #
474
+ # # Create a client object. The client can be reused for multiple calls.
475
+ # client = Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
476
+ #
477
+ # # Create a request. To set request fields, pass in keyword arguments.
478
+ # request = Google::Cloud::HypercomputeCluster::V1beta::CreateClusterRequest.new
479
+ #
480
+ # # Call the create_cluster method.
481
+ # result = client.create_cluster request
482
+ #
483
+ # # The returned object is of type Gapic::Operation. You can use it to
484
+ # # check the status of an operation, cancel it, or wait for results.
485
+ # # Here is how to wait for a response.
486
+ # result.wait_until_done! timeout: 60
487
+ # if result.response?
488
+ # p result.response
489
+ # else
490
+ # puts "No response received."
491
+ # end
492
+ #
493
+ def create_cluster request, options = nil
494
+ raise ::ArgumentError, "request must be provided" if request.nil?
495
+
496
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::HypercomputeCluster::V1beta::CreateClusterRequest
497
+
498
+ # Converts hash and nil to an options object
499
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
500
+
501
+ # Customize the options with defaults
502
+ metadata = @config.rpcs.create_cluster.metadata.to_h
503
+
504
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
505
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
506
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
507
+ gapic_version: ::Google::Cloud::HypercomputeCluster::V1beta::VERSION
508
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
509
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
510
+
511
+ header_params = {}
512
+ if request.parent
513
+ header_params["parent"] = request.parent
514
+ end
515
+
516
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
517
+ metadata[:"x-goog-request-params"] ||= request_params_header
518
+
519
+ options.apply_defaults timeout: @config.rpcs.create_cluster.timeout,
520
+ metadata: metadata,
521
+ retry_policy: @config.rpcs.create_cluster.retry_policy
522
+
523
+ options.apply_defaults timeout: @config.timeout,
524
+ metadata: @config.metadata,
525
+ retry_policy: @config.retry_policy
526
+
527
+ @hypercompute_cluster_stub.call_rpc :create_cluster, request, options: options do |response, operation|
528
+ response = ::Gapic::Operation.new response, @operations_client, options: options
529
+ yield response, operation if block_given?
530
+ throw :response, response
531
+ end
532
+ rescue ::GRPC::BadStatus => e
533
+ raise ::Google::Cloud::Error.from_error(e)
534
+ end
535
+
536
+ ##
537
+ # Updates the parameters of a single Cluster.
538
+ #
539
+ # @overload update_cluster(request, options = nil)
540
+ # Pass arguments to `update_cluster` via a request object, either of type
541
+ # {::Google::Cloud::HypercomputeCluster::V1beta::UpdateClusterRequest} or an equivalent Hash.
542
+ #
543
+ # @param request [::Google::Cloud::HypercomputeCluster::V1beta::UpdateClusterRequest, ::Hash]
544
+ # A request object representing the call parameters. Required. To specify no
545
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
546
+ # @param options [::Gapic::CallOptions, ::Hash]
547
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
548
+ #
549
+ # @overload update_cluster(cluster: nil, update_mask: nil, request_id: nil)
550
+ # Pass arguments to `update_cluster` via keyword arguments. Note that at
551
+ # least one keyword argument is required. To specify no parameters, or to keep all
552
+ # the default parameter values, pass an empty Hash as a request object (see above).
553
+ #
554
+ # @param cluster [::Google::Cloud::HypercomputeCluster::V1beta::Cluster, ::Hash]
555
+ # Required. Cluster to update.
556
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
557
+ # Optional. Mask specifying which fields in the cluster to update. All paths
558
+ # must be specified explicitly - wildcards are not supported. At least one
559
+ # path must be provided.
560
+ # @param request_id [::String]
561
+ # Optional. A unique identifier for this request. A random UUID is
562
+ # recommended. This request is idempotent if and only if `request_id` is
563
+ # provided.
564
+ #
565
+ # @yield [response, operation] Access the result along with the RPC operation
566
+ # @yieldparam response [::Gapic::Operation]
567
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
568
+ #
569
+ # @return [::Gapic::Operation]
570
+ #
571
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
572
+ #
573
+ # @example Basic example
574
+ # require "google/cloud/hypercompute_cluster/v1beta"
575
+ #
576
+ # # Create a client object. The client can be reused for multiple calls.
577
+ # client = Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
578
+ #
579
+ # # Create a request. To set request fields, pass in keyword arguments.
580
+ # request = Google::Cloud::HypercomputeCluster::V1beta::UpdateClusterRequest.new
581
+ #
582
+ # # Call the update_cluster method.
583
+ # result = client.update_cluster request
584
+ #
585
+ # # The returned object is of type Gapic::Operation. You can use it to
586
+ # # check the status of an operation, cancel it, or wait for results.
587
+ # # Here is how to wait for a response.
588
+ # result.wait_until_done! timeout: 60
589
+ # if result.response?
590
+ # p result.response
591
+ # else
592
+ # puts "No response received."
593
+ # end
594
+ #
595
+ def update_cluster request, options = nil
596
+ raise ::ArgumentError, "request must be provided" if request.nil?
597
+
598
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::HypercomputeCluster::V1beta::UpdateClusterRequest
599
+
600
+ # Converts hash and nil to an options object
601
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
602
+
603
+ # Customize the options with defaults
604
+ metadata = @config.rpcs.update_cluster.metadata.to_h
605
+
606
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
607
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
608
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
609
+ gapic_version: ::Google::Cloud::HypercomputeCluster::V1beta::VERSION
610
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
611
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
612
+
613
+ header_params = {}
614
+ if request.cluster&.name
615
+ header_params["cluster.name"] = request.cluster.name
616
+ end
617
+
618
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
619
+ metadata[:"x-goog-request-params"] ||= request_params_header
620
+
621
+ options.apply_defaults timeout: @config.rpcs.update_cluster.timeout,
622
+ metadata: metadata,
623
+ retry_policy: @config.rpcs.update_cluster.retry_policy
624
+
625
+ options.apply_defaults timeout: @config.timeout,
626
+ metadata: @config.metadata,
627
+ retry_policy: @config.retry_policy
628
+
629
+ @hypercompute_cluster_stub.call_rpc :update_cluster, request, options: options do |response, operation|
630
+ response = ::Gapic::Operation.new response, @operations_client, options: options
631
+ yield response, operation if block_given?
632
+ throw :response, response
633
+ end
634
+ rescue ::GRPC::BadStatus => e
635
+ raise ::Google::Cloud::Error.from_error(e)
636
+ end
637
+
638
+ ##
639
+ # Deletes a single Cluster.
640
+ #
641
+ # @overload delete_cluster(request, options = nil)
642
+ # Pass arguments to `delete_cluster` via a request object, either of type
643
+ # {::Google::Cloud::HypercomputeCluster::V1beta::DeleteClusterRequest} or an equivalent Hash.
644
+ #
645
+ # @param request [::Google::Cloud::HypercomputeCluster::V1beta::DeleteClusterRequest, ::Hash]
646
+ # A request object representing the call parameters. Required. To specify no
647
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
648
+ # @param options [::Gapic::CallOptions, ::Hash]
649
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
650
+ #
651
+ # @overload delete_cluster(name: nil, request_id: nil)
652
+ # Pass arguments to `delete_cluster` via keyword arguments. Note that at
653
+ # least one keyword argument is required. To specify no parameters, or to keep all
654
+ # the default parameter values, pass an empty Hash as a request object (see above).
655
+ #
656
+ # @param name [::String]
657
+ # Required. Name of the cluster to delete, in the format
658
+ # `projects/{project}/locations/{location}/clusters/{cluster}`.
659
+ # @param request_id [::String]
660
+ # Optional. A unique identifier for this request. A random UUID is
661
+ # recommended. This request is idempotent if and only if `request_id` is
662
+ # provided.
663
+ #
664
+ # @yield [response, operation] Access the result along with the RPC operation
665
+ # @yieldparam response [::Gapic::Operation]
666
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
667
+ #
668
+ # @return [::Gapic::Operation]
669
+ #
670
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
671
+ #
672
+ # @example Basic example
673
+ # require "google/cloud/hypercompute_cluster/v1beta"
674
+ #
675
+ # # Create a client object. The client can be reused for multiple calls.
676
+ # client = Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new
677
+ #
678
+ # # Create a request. To set request fields, pass in keyword arguments.
679
+ # request = Google::Cloud::HypercomputeCluster::V1beta::DeleteClusterRequest.new
680
+ #
681
+ # # Call the delete_cluster method.
682
+ # result = client.delete_cluster request
683
+ #
684
+ # # The returned object is of type Gapic::Operation. You can use it to
685
+ # # check the status of an operation, cancel it, or wait for results.
686
+ # # Here is how to wait for a response.
687
+ # result.wait_until_done! timeout: 60
688
+ # if result.response?
689
+ # p result.response
690
+ # else
691
+ # puts "No response received."
692
+ # end
693
+ #
694
+ def delete_cluster request, options = nil
695
+ raise ::ArgumentError, "request must be provided" if request.nil?
696
+
697
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::HypercomputeCluster::V1beta::DeleteClusterRequest
698
+
699
+ # Converts hash and nil to an options object
700
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
701
+
702
+ # Customize the options with defaults
703
+ metadata = @config.rpcs.delete_cluster.metadata.to_h
704
+
705
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
706
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
707
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
708
+ gapic_version: ::Google::Cloud::HypercomputeCluster::V1beta::VERSION
709
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
710
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
711
+
712
+ header_params = {}
713
+ if request.name
714
+ header_params["name"] = request.name
715
+ end
716
+
717
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
718
+ metadata[:"x-goog-request-params"] ||= request_params_header
719
+
720
+ options.apply_defaults timeout: @config.rpcs.delete_cluster.timeout,
721
+ metadata: metadata,
722
+ retry_policy: @config.rpcs.delete_cluster.retry_policy
723
+
724
+ options.apply_defaults timeout: @config.timeout,
725
+ metadata: @config.metadata,
726
+ retry_policy: @config.retry_policy
727
+
728
+ @hypercompute_cluster_stub.call_rpc :delete_cluster, request, options: options do |response, operation|
729
+ response = ::Gapic::Operation.new response, @operations_client, options: options
730
+ yield response, operation if block_given?
731
+ throw :response, response
732
+ end
733
+ rescue ::GRPC::BadStatus => e
734
+ raise ::Google::Cloud::Error.from_error(e)
735
+ end
736
+
737
+ ##
738
+ # Configuration class for the HypercomputeCluster API.
739
+ #
740
+ # This class represents the configuration for HypercomputeCluster,
741
+ # providing control over timeouts, retry behavior, logging, transport
742
+ # parameters, and other low-level controls. Certain parameters can also be
743
+ # applied individually to specific RPCs. See
744
+ # {::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client::Configuration::Rpcs}
745
+ # for a list of RPCs that can be configured independently.
746
+ #
747
+ # Configuration can be applied globally to all clients, or to a single client
748
+ # on construction.
749
+ #
750
+ # @example
751
+ #
752
+ # # Modify the global config, setting the timeout for
753
+ # # list_clusters to 20 seconds,
754
+ # # and all remaining timeouts to 10 seconds.
755
+ # ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.configure do |config|
756
+ # config.timeout = 10.0
757
+ # config.rpcs.list_clusters.timeout = 20.0
758
+ # end
759
+ #
760
+ # # Apply the above configuration only to a new client.
761
+ # client = ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new do |config|
762
+ # config.timeout = 10.0
763
+ # config.rpcs.list_clusters.timeout = 20.0
764
+ # end
765
+ #
766
+ # @!attribute [rw] endpoint
767
+ # A custom service endpoint, as a hostname or hostname:port. The default is
768
+ # nil, indicating to use the default endpoint in the current universe domain.
769
+ # @return [::String,nil]
770
+ # @!attribute [rw] credentials
771
+ # Credentials to send with calls. You may provide any of the following types:
772
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
773
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
774
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
775
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
776
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
777
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
778
+ # * (`nil`) indicating no credentials
779
+ #
780
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
781
+ # is deprecated. Providing an unvalidated credential configuration to
782
+ # Google APIs can compromise the security of your systems and data.
783
+ #
784
+ # @example
785
+ #
786
+ # # The recommended way to provide credentials is to use the `make_creds` method
787
+ # # on the appropriate credentials class for your environment.
788
+ #
789
+ # require "googleauth"
790
+ #
791
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
792
+ # json_key_io: ::File.open("/path/to/keyfile.json")
793
+ # )
794
+ #
795
+ # client = ::Google::Cloud::HypercomputeCluster::V1beta::HypercomputeCluster::Client.new do |config|
796
+ # config.credentials = credentials
797
+ # end
798
+ #
799
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
800
+ # external source for authentication to Google Cloud, you must validate it before
801
+ # providing it to a Google API client library. Providing an unvalidated credential
802
+ # configuration to Google APIs can compromise the security of your systems and data.
803
+ # For more information, refer to [Validate credential configurations from external
804
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
805
+ # @return [::Object]
806
+ # @!attribute [rw] scope
807
+ # The OAuth scopes
808
+ # @return [::Array<::String>]
809
+ # @!attribute [rw] lib_name
810
+ # The library name as recorded in instrumentation and logging
811
+ # @return [::String]
812
+ # @!attribute [rw] lib_version
813
+ # The library version as recorded in instrumentation and logging
814
+ # @return [::String]
815
+ # @!attribute [rw] channel_args
816
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
817
+ # `GRPC::Core::Channel` object is provided as the credential.
818
+ # @return [::Hash]
819
+ # @!attribute [rw] interceptors
820
+ # An array of interceptors that are run before calls are executed.
821
+ # @return [::Array<::GRPC::ClientInterceptor>]
822
+ # @!attribute [rw] timeout
823
+ # The call timeout in seconds.
824
+ # @return [::Numeric]
825
+ # @!attribute [rw] metadata
826
+ # Additional gRPC headers to be sent with the call.
827
+ # @return [::Hash{::Symbol=>::String}]
828
+ # @!attribute [rw] retry_policy
829
+ # The retry policy. The value is a hash with the following keys:
830
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
831
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
832
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
833
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
834
+ # trigger a retry.
835
+ # @return [::Hash]
836
+ # @!attribute [rw] quota_project
837
+ # A separate project against which to charge quota.
838
+ # @return [::String]
839
+ # @!attribute [rw] universe_domain
840
+ # The universe domain within which to make requests. This determines the
841
+ # default endpoint URL. The default value of nil uses the environment
842
+ # universe (usually the default "googleapis.com" universe).
843
+ # @return [::String,nil]
844
+ # @!attribute [rw] logger
845
+ # A custom logger to use for request/response debug logging, or the value
846
+ # `:default` (the default) to construct a default logger, or `nil` to
847
+ # explicitly disable logging.
848
+ # @return [::Logger,:default,nil]
849
+ #
850
+ class Configuration
851
+ extend ::Gapic::Config
852
+
853
+ # @private
854
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
855
+ DEFAULT_ENDPOINT = "hypercomputecluster.googleapis.com"
856
+
857
+ config_attr :endpoint, nil, ::String, nil
858
+ config_attr :credentials, nil do |value|
859
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
860
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
861
+ allowed.any? { |klass| klass === value }
862
+ end
863
+ config_attr :scope, nil, ::String, ::Array, nil
864
+ config_attr :lib_name, nil, ::String, nil
865
+ config_attr :lib_version, nil, ::String, nil
866
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
867
+ config_attr :interceptors, nil, ::Array, nil
868
+ config_attr :timeout, nil, ::Numeric, nil
869
+ config_attr :metadata, nil, ::Hash, nil
870
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
871
+ config_attr :quota_project, nil, ::String, nil
872
+ config_attr :universe_domain, nil, ::String, nil
873
+ config_attr :logger, :default, ::Logger, nil, :default
874
+
875
+ # @private
876
+ def initialize parent_config = nil
877
+ @parent_config = parent_config unless parent_config.nil?
878
+
879
+ yield self if block_given?
880
+ end
881
+
882
+ ##
883
+ # Configurations for individual RPCs
884
+ # @return [Rpcs]
885
+ #
886
+ def rpcs
887
+ @rpcs ||= begin
888
+ parent_rpcs = nil
889
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
890
+ Rpcs.new parent_rpcs
891
+ end
892
+ end
893
+
894
+ ##
895
+ # Configuration for the channel pool
896
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
897
+ #
898
+ def channel_pool
899
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
900
+ end
901
+
902
+ ##
903
+ # Configuration RPC class for the HypercomputeCluster API.
904
+ #
905
+ # Includes fields providing the configuration for each RPC in this service.
906
+ # Each configuration object is of type `Gapic::Config::Method` and includes
907
+ # the following configuration fields:
908
+ #
909
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
910
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
911
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
912
+ # include the following keys:
913
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
914
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
915
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
916
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
917
+ # trigger a retry.
918
+ #
919
+ class Rpcs
920
+ ##
921
+ # RPC-specific configuration for `list_clusters`
922
+ # @return [::Gapic::Config::Method]
923
+ #
924
+ attr_reader :list_clusters
925
+ ##
926
+ # RPC-specific configuration for `get_cluster`
927
+ # @return [::Gapic::Config::Method]
928
+ #
929
+ attr_reader :get_cluster
930
+ ##
931
+ # RPC-specific configuration for `create_cluster`
932
+ # @return [::Gapic::Config::Method]
933
+ #
934
+ attr_reader :create_cluster
935
+ ##
936
+ # RPC-specific configuration for `update_cluster`
937
+ # @return [::Gapic::Config::Method]
938
+ #
939
+ attr_reader :update_cluster
940
+ ##
941
+ # RPC-specific configuration for `delete_cluster`
942
+ # @return [::Gapic::Config::Method]
943
+ #
944
+ attr_reader :delete_cluster
945
+
946
+ # @private
947
+ def initialize parent_rpcs = nil
948
+ list_clusters_config = parent_rpcs.list_clusters if parent_rpcs.respond_to? :list_clusters
949
+ @list_clusters = ::Gapic::Config::Method.new list_clusters_config
950
+ get_cluster_config = parent_rpcs.get_cluster if parent_rpcs.respond_to? :get_cluster
951
+ @get_cluster = ::Gapic::Config::Method.new get_cluster_config
952
+ create_cluster_config = parent_rpcs.create_cluster if parent_rpcs.respond_to? :create_cluster
953
+ @create_cluster = ::Gapic::Config::Method.new create_cluster_config
954
+ update_cluster_config = parent_rpcs.update_cluster if parent_rpcs.respond_to? :update_cluster
955
+ @update_cluster = ::Gapic::Config::Method.new update_cluster_config
956
+ delete_cluster_config = parent_rpcs.delete_cluster if parent_rpcs.respond_to? :delete_cluster
957
+ @delete_cluster = ::Gapic::Config::Method.new delete_cluster_config
958
+
959
+ yield self if block_given?
960
+ end
961
+ end
962
+ end
963
+ end
964
+ end
965
+ end
966
+ end
967
+ end
968
+ end