google-cloud-compute-v1 2.12.0 → 2.13.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -286,7 +286,7 @@ module Google
286
286
  # the default parameter values, pass an empty Hash as a request object (see above).
287
287
  #
288
288
  # @param operation [::String]
289
- # Name of the Operations resource to delete.
289
+ # Name of the Operations resource to delete, or its unique numeric identifier.
290
290
  # @param project [::String]
291
291
  # Project ID for this request.
292
292
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -367,7 +367,7 @@ module Google
367
367
  # the default parameter values, pass an empty Hash as a request object (see above).
368
368
  #
369
369
  # @param operation [::String]
370
- # Name of the Operations resource to return.
370
+ # Name of the Operations resource to return, or its unique numeric identifier.
371
371
  # @param project [::String]
372
372
  # Project ID for this request.
373
373
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -538,7 +538,7 @@ module Google
538
538
  # the default parameter values, pass an empty Hash as a request object (see above).
539
539
  #
540
540
  # @param operation [::String]
541
- # Name of the Operations resource to return.
541
+ # Name of the Operations resource to return, or its unique numeric identifier.
542
542
  # @param project [::String]
543
543
  # Project ID for this request.
544
544
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -185,7 +185,7 @@ module Google
185
185
  # the default parameter values, pass an empty Hash as a request object (see above).
186
186
  #
187
187
  # @param operation [::String]
188
- # Name of the Operations resource to delete.
188
+ # Name of the Operations resource to delete, or its unique numeric identifier.
189
189
  # @param parent_id [::String]
190
190
  # Parent ID for this request.
191
191
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -266,7 +266,7 @@ module Google
266
266
  # the default parameter values, pass an empty Hash as a request object (see above).
267
267
  #
268
268
  # @param operation [::String]
269
- # Name of the Operations resource to return.
269
+ # Name of the Operations resource to return, or its unique numeric identifier.
270
270
  # @param parent_id [::String]
271
271
  # Parent ID for this request.
272
272
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -830,7 +830,7 @@ module Google
830
830
  end
831
831
 
832
832
  ##
833
- # Patches the specified network with the data included in the request. Only the following fields can be modified: routingConfig.routingMode.
833
+ # Patches the specified network with the data included in the request. Only routingConfig can be modified.
834
834
  #
835
835
  # @overload patch(request, options = nil)
836
836
  # Pass arguments to `patch` via a request object, either of type
@@ -738,7 +738,7 @@ module Google
738
738
  end
739
739
 
740
740
  ##
741
- # Retrieves an aggregated list of all usable backend services in the specified project in the given region.
741
+ # Retrieves a list of all usable backend services in the specified project in the given region.
742
742
  #
743
743
  # @overload list_usable(request, options = nil)
744
744
  # Pass arguments to `list_usable` via a request object, either of type
@@ -187,7 +187,7 @@ module Google
187
187
  # the default parameter values, pass an empty Hash as a request object (see above).
188
188
  #
189
189
  # @param operation [::String]
190
- # Name of the Operations resource to delete.
190
+ # Name of the Operations resource to delete, or its unique numeric identifier.
191
191
  # @param project [::String]
192
192
  # Project ID for this request.
193
193
  # @param region [::String]
@@ -270,7 +270,7 @@ module Google
270
270
  # the default parameter values, pass an empty Hash as a request object (see above).
271
271
  #
272
272
  # @param operation [::String]
273
- # Name of the Operations resource to return.
273
+ # Name of the Operations resource to return, or its unique numeric identifier.
274
274
  # @param project [::String]
275
275
  # Project ID for this request.
276
276
  # @param region [::String]
@@ -445,7 +445,7 @@ module Google
445
445
  # the default parameter values, pass an empty Hash as a request object (see above).
446
446
  #
447
447
  # @param operation [::String]
448
- # Name of the Operations resource to return.
448
+ # Name of the Operations resource to return, or its unique numeric identifier.
449
449
  # @param project [::String]
450
450
  # Project ID for this request.
451
451
  # @param region [::String]
@@ -165,7 +165,7 @@ module Google
165
165
  # Service calls
166
166
 
167
167
  ##
168
- # Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
168
+ # Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method.
169
169
  #
170
170
  # @overload get(request, options = nil)
171
171
  # Pass arguments to `get` via a request object, either of type
@@ -246,7 +246,7 @@ module Google
246
246
  end
247
247
 
248
248
  ##
249
- # Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
249
+ # Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method.
250
250
  #
251
251
  # @overload list(request, options = nil)
252
252
  # Pass arguments to `list` via a request object, either of type
@@ -1009,7 +1009,7 @@ module Google
1009
1009
  end
1010
1010
 
1011
1011
  ##
1012
- # Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops.
1012
+ # Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.
1013
1013
  #
1014
1014
  # @overload update(request, options = nil)
1015
1015
  # Pass arguments to `update` via a request object, either of type
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Compute
23
23
  module V1
24
- VERSION = "2.12.0"
24
+ VERSION = "2.13.0"
25
25
  end
26
26
  end
27
27
  end
@@ -187,7 +187,7 @@ module Google
187
187
  # the default parameter values, pass an empty Hash as a request object (see above).
188
188
  #
189
189
  # @param operation [::String]
190
- # Name of the Operations resource to delete.
190
+ # Name of the Operations resource to delete, or its unique numeric identifier.
191
191
  # @param project [::String]
192
192
  # Project ID for this request.
193
193
  # @param zone [::String]
@@ -270,7 +270,7 @@ module Google
270
270
  # the default parameter values, pass an empty Hash as a request object (see above).
271
271
  #
272
272
  # @param operation [::String]
273
- # Name of the Operations resource to return.
273
+ # Name of the Operations resource to return, or its unique numeric identifier.
274
274
  # @param project [::String]
275
275
  # Project ID for this request.
276
276
  # @param zone [::String]
@@ -445,7 +445,7 @@ module Google
445
445
  # the default parameter values, pass an empty Hash as a request object (see above).
446
446
  #
447
447
  # @param operation [::String]
448
- # Name of the Operations resource to return.
448
+ # Name of the Operations resource to return, or its unique numeric identifier.
449
449
  # @param project [::String]
450
450
  # Project ID for this request.
451
451
  # @param zone [::String]
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,32 @@ module Google
196
199
  # @!attribute [rw] common
197
200
  # @return [::Google::Api::CommonLanguageSettings]
198
201
  # Some settings.
202
+ # @!attribute [rw] experimental_features
203
+ # @return [::Google::Api::PythonSettings::ExperimentalFeatures]
204
+ # Experimental features to be included during client library generation.
199
205
  class PythonSettings
200
206
  include ::Google::Protobuf::MessageExts
201
207
  extend ::Google::Protobuf::MessageExts::ClassMethods
208
+
209
+ # Experimental features to be included during client library generation.
210
+ # These fields will be deprecated once the feature graduates and is enabled
211
+ # by default.
212
+ # @!attribute [rw] rest_async_io_enabled
213
+ # @return [::Boolean]
214
+ # Enables generation of asynchronous REST clients if `rest` transport is
215
+ # enabled. By default, asynchronous REST clients will not be generated.
216
+ # This feature will be enabled by default 1 month after launching the
217
+ # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
224
+ class ExperimentalFeatures
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
202
228
  end
203
229
 
204
230
  # Settings for Node client libraries.
@@ -290,6 +316,13 @@ module Google
290
316
  # @return [::String]
291
317
  # The fully qualified name of the method, for which the options below apply.
292
318
  # This is used to find the method to apply the options.
319
+ #
320
+ # Example:
321
+ #
322
+ # publishing:
323
+ # method_settings:
324
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
325
+ # # method settings for CreateFolder...
293
326
  # @!attribute [rw] long_running
294
327
  # @return [::Google::Api::MethodSettings::LongRunning]
295
328
  # Describes settings to use for long-running operations when generating
@@ -298,17 +331,14 @@ module Google
298
331
  #
299
332
  # Example of a YAML configuration::
300
333
  #
301
- # publishing:
302
- # method_settings:
334
+ # publishing:
335
+ # method_settings:
303
336
  # - selector: google.cloud.speech.v2.Speech.BatchRecognize
304
337
  # long_running:
305
- # initial_poll_delay:
306
- # seconds: 60 # 1 minute
338
+ # initial_poll_delay: 60s # 1 minute
307
339
  # poll_delay_multiplier: 1.5
308
- # max_poll_delay:
309
- # seconds: 360 # 6 minutes
310
- # total_poll_timeout:
311
- # seconds: 54000 # 90 minutes
340
+ # max_poll_delay: 360s # 6 minutes
341
+ # total_poll_timeout: 54000s # 90 minutes
312
342
  # @!attribute [rw] auto_populated_fields
313
343
  # @return [::Array<::String>]
314
344
  # List of top-level fields of the request message, that should be
@@ -317,8 +347,8 @@ module Google
317
347
  #
318
348
  # Example of a YAML configuration:
319
349
  #
320
- # publishing:
321
- # method_settings:
350
+ # publishing:
351
+ # method_settings:
322
352
  # - selector: google.example.v1.ExampleService.CreateExample
323
353
  # auto_populated_fields:
324
354
  # - request_id
@@ -354,6 +384,17 @@ module Google
354
384
  end
355
385
  end
356
386
 
387
+ # This message is used to configure the generation of a subset of the RPCs in
388
+ # a service for client libraries.
389
+ # @!attribute [rw] methods
390
+ # @return [::Array<::String>]
391
+ # An allowlist of the fully qualified names of RPCs that should be included
392
+ # on public client surfaces.
393
+ class SelectiveGapicGeneration
394
+ include ::Google::Protobuf::MessageExts
395
+ extend ::Google::Protobuf::MessageExts::ClassMethods
396
+ end
397
+
357
398
  # The organization for which the client libraries are being published.
358
399
  # Affects the url where generated docs are published, etc.
359
400
  module ClientLibraryOrganization
@@ -124,8 +124,13 @@ module Google
124
124
  # @return [::String]
125
125
  # The plural name used in the resource name and permission names, such as
126
126
  # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
- # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
- # concept of the `plural` field in k8s CRD spec
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
128
+ # to this is for Nested Collections that have stuttering names, as defined
129
+ # in [AIP-122](https://google.aip.dev/122#nested-collections), where the
130
+ # collection ID in the resource name pattern does not necessarily directly
131
+ # match the `plural` value.
132
+ #
133
+ # It is the same concept of the `plural` field in k8s CRD spec
129
134
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
135
  #
131
136
  # Note: The plural form is required even for singleton resources. See