google-cloud-compute-v1 2.12.0 → 2.13.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.
@@ -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