google-cloud-compute-v1 0.3.0 → 1.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (112) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/AUTHENTICATION.md +7 -25
  4. data/README.md +4 -4
  5. data/lib/google/cloud/compute/v1/accelerator_types/rest/client.rb +4 -24
  6. data/lib/google/cloud/compute/v1/addresses/rest/client.rb +6 -34
  7. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +8 -44
  8. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +85 -42
  9. data/lib/google/cloud/compute/v1/backend_buckets/rest/service_stub.rb +46 -0
  10. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +91 -66
  11. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +46 -0
  12. data/lib/google/cloud/compute/v1/compute_pb.rb +8335 -7443
  13. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +4 -24
  14. data/lib/google/cloud/compute/v1/disks/rest/client.rb +12 -60
  15. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +4 -22
  16. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +13 -63
  17. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +6 -32
  18. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +9 -49
  19. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +4 -22
  20. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +7 -33
  21. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +8 -44
  22. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +6 -30
  23. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +2 -12
  24. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +5 -27
  25. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +8 -44
  26. data/lib/google/cloud/compute/v1/image_family_views/credentials.rb +53 -0
  27. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +318 -0
  28. data/lib/google/cloud/compute/v1/image_family_views/rest/service_stub.rb +89 -0
  29. data/lib/google/cloud/compute/v1/image_family_views/rest.rb +33 -0
  30. data/lib/google/cloud/compute/v1/image_family_views.rb +44 -0
  31. data/lib/google/cloud/compute/v1/images/rest/client.rb +7 -35
  32. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +30 -150
  33. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +16 -72
  34. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +4 -22
  35. data/lib/google/cloud/compute/v1/instances/rest/client.rb +272 -197
  36. data/lib/google/cloud/compute/v1/instances/rest/service_stub.rb +134 -0
  37. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +7 -39
  38. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +2 -12
  39. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +5 -27
  40. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +2 -2
  41. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +11 -29
  42. data/lib/google/cloud/compute/v1/machine_images/credentials.rb +52 -0
  43. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +777 -0
  44. data/lib/google/cloud/compute/v1/machine_images/rest/service_stub.rb +363 -0
  45. data/lib/google/cloud/compute/v1/machine_images/rest.rb +33 -0
  46. data/lib/google/cloud/compute/v1/machine_images.rb +44 -0
  47. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +4 -24
  48. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +10 -56
  49. data/lib/google/cloud/compute/v1/networks/rest/client.rb +14 -61
  50. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +12 -66
  51. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +6 -34
  52. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +4 -24
  53. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +7 -39
  54. data/lib/google/cloud/compute/v1/projects/rest/client.rb +15 -71
  55. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +5 -27
  56. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +7 -39
  57. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +6 -32
  58. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +9 -35
  59. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +88 -30
  60. data/lib/google/cloud/compute/v1/region_commitments/rest/service_stub.rb +48 -0
  61. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +2 -12
  62. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +10 -48
  63. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +5 -27
  64. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +6 -32
  65. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +27 -133
  66. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +5 -29
  67. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +1 -5
  68. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +4 -22
  69. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +4 -22
  70. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +3 -17
  71. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +4 -22
  72. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +5 -27
  73. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +6 -32
  74. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +2 -12
  75. data/lib/google/cloud/compute/v1/regions/rest/client.rb +4 -14
  76. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +89 -39
  77. data/lib/google/cloud/compute/v1/reservations/rest/service_stub.rb +48 -0
  78. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +6 -34
  79. data/lib/google/cloud/compute/v1/routers/rest/client.rb +10 -56
  80. data/lib/google/cloud/compute/v1/routes/rest/client.rb +4 -22
  81. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +7 -39
  82. data/lib/google/cloud/compute/v1/service_attachments/credentials.rb +52 -0
  83. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +954 -0
  84. data/lib/google/cloud/compute/v1/service_attachments/rest/service_stub.rb +458 -0
  85. data/lib/google/cloud/compute/v1/service_attachments/rest.rb +33 -0
  86. data/lib/google/cloud/compute/v1/service_attachments.rb +44 -0
  87. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +79 -20
  88. data/lib/google/cloud/compute/v1/snapshots/rest/service_stub.rb +46 -0
  89. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +6 -34
  90. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +7 -39
  91. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +11 -61
  92. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +5 -27
  93. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +9 -45
  94. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +12 -60
  95. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +6 -34
  96. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +11 -59
  97. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +8 -42
  98. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +6 -32
  99. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +6 -34
  100. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +10 -52
  101. data/lib/google/cloud/compute/v1/version.rb +1 -1
  102. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +7 -39
  103. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +6 -34
  104. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +3 -17
  105. data/lib/google/cloud/compute/v1/zones/rest/client.rb +2 -12
  106. data/lib/google/cloud/compute/v1.rb +3 -0
  107. data/proto_docs/README.md +1 -1
  108. data/proto_docs/google/api/field_behavior.rb +6 -0
  109. data/proto_docs/google/api/resource.rb +10 -71
  110. data/proto_docs/google/cloud/compute/v1/compute.rb +20013 -21099
  111. data/proto_docs/google/cloud/extended_operations.rb +51 -0
  112. metadata +34 -4
@@ -170,11 +170,7 @@ module Google
170
170
  # @param region [::String]
171
171
  # Name of the region scoping this request.
172
172
  # @param request_id [::String]
173
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
174
- #
175
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
176
- #
177
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
173
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
178
174
  # @yield [result, response] Access the result along with the Faraday response object
179
175
  # @yieldparam result [::Gapic::Rest::BaseOperation]
180
176
  # @yieldparam response [::Faraday::Response]
@@ -307,11 +303,7 @@ module Google
307
303
  # @param region [::String]
308
304
  # Name of the region scoping this request.
309
305
  # @param request_id [::String]
310
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
311
- #
312
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
313
- #
314
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
306
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
315
307
  # @yield [result, response] Access the result along with the Faraday response object
316
308
  # @yieldparam result [::Gapic::Rest::BaseOperation]
317
309
  # @yieldparam response [::Faraday::Response]
@@ -373,21 +365,11 @@ module Google
373
365
  # the default parameter values, pass an empty Hash as a request object (see above).
374
366
  #
375
367
  # @param filter [::String]
376
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
377
- #
378
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
379
- #
380
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
381
- #
382
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
368
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
383
369
  # @param max_results [::Integer]
384
370
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
385
371
  # @param order_by [::String]
386
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
387
- #
388
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
389
- #
390
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
372
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
391
373
  # @param page_token [::String]
392
374
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
393
375
  # @param project [::String]
@@ -465,11 +447,7 @@ module Google
465
447
  # @param region [::String]
466
448
  # Name of the region scoping this request.
467
449
  # @param request_id [::String]
468
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
469
- #
470
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
471
- #
472
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
450
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
473
451
  # @yield [result, response] Access the result along with the Faraday response object
474
452
  # @yieldparam result [::Gapic::Rest::BaseOperation]
475
453
  # @yieldparam response [::Faraday::Response]
@@ -539,11 +517,7 @@ module Google
539
517
  # @param region [::String]
540
518
  # Name of the region scoping this request.
541
519
  # @param request_id [::String]
542
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
543
- #
544
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
545
- #
546
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
520
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
547
521
  # @yield [result, response] Access the result along with the Faraday response object
548
522
  # @yieldparam result [::Gapic::Rest::BaseOperation]
549
523
  # @yieldparam response [::Faraday::Response]
@@ -172,11 +172,7 @@ module Google
172
172
  # @param region [::String]
173
173
  # Name of the region scoping this request.
174
174
  # @param request_id [::String]
175
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
176
- #
177
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
178
- #
179
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
175
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
180
176
  # @yield [result, response] Access the result along with the Faraday response object
181
177
  # @yieldparam result [::Gapic::Rest::BaseOperation]
182
178
  # @yieldparam response [::Faraday::Response]
@@ -349,7 +345,7 @@ module Google
349
345
  end
350
346
 
351
347
  ##
352
- # Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview.
348
+ # Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview.
353
349
  #
354
350
  # @overload insert(request, options = nil)
355
351
  # Pass arguments to `insert` via a request object, either of type
@@ -375,11 +371,7 @@ module Google
375
371
  # @param region [::String]
376
372
  # Name of the region scoping this request.
377
373
  # @param request_id [::String]
378
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
379
- #
380
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
381
- #
382
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
374
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
383
375
  # @yield [result, response] Access the result along with the Faraday response object
384
376
  # @yieldparam result [::Gapic::Rest::BaseOperation]
385
377
  # @yieldparam response [::Faraday::Response]
@@ -441,21 +433,11 @@ module Google
441
433
  # the default parameter values, pass an empty Hash as a request object (see above).
442
434
  #
443
435
  # @param filter [::String]
444
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
445
- #
446
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
447
- #
448
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
449
- #
450
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
436
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
451
437
  # @param max_results [::Integer]
452
438
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
453
439
  # @param order_by [::String]
454
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
455
- #
456
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
457
- #
458
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
440
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
459
441
  # @param page_token [::String]
460
442
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
461
443
  # @param project [::String]
@@ -505,7 +487,7 @@ module Google
505
487
  end
506
488
 
507
489
  ##
508
- # Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
490
+ # Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
509
491
  #
510
492
  # @overload patch(request, options = nil)
511
493
  # Pass arguments to `patch` via a request object, either of type
@@ -533,11 +515,7 @@ module Google
533
515
  # @param region [::String]
534
516
  # Name of the region scoping this request.
535
517
  # @param request_id [::String]
536
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
537
- #
538
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
539
- #
540
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
518
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
541
519
  # @yield [result, response] Access the result along with the Faraday response object
542
520
  # @yieldparam result [::Gapic::Rest::BaseOperation]
543
521
  # @yieldparam response [::Faraday::Response]
@@ -579,7 +557,7 @@ module Google
579
557
  end
580
558
 
581
559
  ##
582
- # Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview.
560
+ # Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview .
583
561
  #
584
562
  # @overload update(request, options = nil)
585
563
  # Pass arguments to `update` via a request object, either of type
@@ -607,11 +585,7 @@ module Google
607
585
  # @param region [::String]
608
586
  # Name of the region scoping this request.
609
587
  # @param request_id [::String]
610
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
611
- #
612
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
613
- #
614
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
588
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
615
589
  # @yield [result, response] Access the result along with the Faraday response object
616
590
  # @yieldparam result [::Gapic::Rest::BaseOperation]
617
591
  # @yieldparam response [::Faraday::Response]
@@ -81,6 +81,8 @@ module Google
81
81
  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
82
82
  }
83
83
 
84
+ default_config.rpcs.update.timeout = 600.0
85
+
84
86
  default_config
85
87
  end
86
88
  yield @configure if block_given?
@@ -143,7 +145,7 @@ module Google
143
145
  # Service calls
144
146
 
145
147
  ##
146
- # Retrieves an aggregated list of commitments.
148
+ # Retrieves an aggregated list of commitments by region.
147
149
  #
148
150
  # @overload aggregated_list(request, options = nil)
149
151
  # Pass arguments to `aggregated_list` via a request object, either of type
@@ -163,23 +165,13 @@ module Google
163
165
  # the default parameter values, pass an empty Hash as a request object (see above).
164
166
  #
165
167
  # @param filter [::String]
166
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
167
- #
168
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
169
- #
170
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
171
- #
172
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
168
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
173
169
  # @param include_all_scopes [::Boolean]
174
170
  # Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.
175
171
  # @param max_results [::Integer]
176
172
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
177
173
  # @param order_by [::String]
178
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
179
- #
180
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
181
- #
182
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
174
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
183
175
  # @param page_token [::String]
184
176
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
185
177
  # @param project [::String]
@@ -318,11 +310,7 @@ module Google
318
310
  # @param region [::String]
319
311
  # Name of the region for this request.
320
312
  # @param request_id [::String]
321
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
322
- #
323
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
324
- #
325
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
313
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
326
314
  # @yield [result, response] Access the result along with the Faraday response object
327
315
  # @yieldparam result [::Gapic::Rest::BaseOperation]
328
316
  # @yieldparam response [::Faraday::Response]
@@ -384,21 +372,11 @@ module Google
384
372
  # the default parameter values, pass an empty Hash as a request object (see above).
385
373
  #
386
374
  # @param filter [::String]
387
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
388
- #
389
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
390
- #
391
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
392
- #
393
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
375
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
394
376
  # @param max_results [::Integer]
395
377
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
396
378
  # @param order_by [::String]
397
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
398
- #
399
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
400
- #
401
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
379
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
402
380
  # @param page_token [::String]
403
381
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
404
382
  # @param project [::String]
@@ -447,6 +425,79 @@ module Google
447
425
  raise ::Google::Cloud::Error.from_error(gapic_error)
448
426
  end
449
427
 
428
+ ##
429
+ # Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: auto_renew.
430
+ #
431
+ # @overload update(request, options = nil)
432
+ # Pass arguments to `update` via a request object, either of type
433
+ # {::Google::Cloud::Compute::V1::UpdateRegionCommitmentRequest} or an equivalent Hash.
434
+ #
435
+ # @param request [::Google::Cloud::Compute::V1::UpdateRegionCommitmentRequest, ::Hash]
436
+ # A request object representing the call parameters. Required. To specify no
437
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
438
+ # @param options [::Gapic::CallOptions, ::Hash]
439
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
440
+ # Note: currently retry functionality is not implemented. While it is possible
441
+ # to set it using ::Gapic::CallOptions, it will not be applied
442
+ #
443
+ # @overload update(commitment: nil, commitment_resource: nil, paths: nil, project: nil, region: nil, request_id: nil, update_mask: nil)
444
+ # Pass arguments to `update` via keyword arguments. Note that at
445
+ # least one keyword argument is required. To specify no parameters, or to keep all
446
+ # the default parameter values, pass an empty Hash as a request object (see above).
447
+ #
448
+ # @param commitment [::String]
449
+ # Name of the commitment for which auto renew is being updated.
450
+ # @param commitment_resource [::Google::Cloud::Compute::V1::Commitment, ::Hash]
451
+ # The body resource for this request
452
+ # @param paths [::String]
453
+ # @param project [::String]
454
+ # Project ID for this request.
455
+ # @param region [::String]
456
+ # Name of the region for this request.
457
+ # @param request_id [::String]
458
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
459
+ # @param update_mask [::String]
460
+ # update_mask indicates fields to be updated as part of this request.
461
+ # @yield [result, response] Access the result along with the Faraday response object
462
+ # @yieldparam result [::Gapic::Rest::BaseOperation]
463
+ # @yieldparam response [::Faraday::Response]
464
+ #
465
+ # @return [::Gapic::Rest::BaseOperation]
466
+ #
467
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
468
+ def update request, options = nil
469
+ raise ::ArgumentError, "request must be provided" if request.nil?
470
+
471
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Compute::V1::UpdateRegionCommitmentRequest
472
+
473
+ # Converts hash and nil to an options object
474
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
475
+
476
+ # Customize the options with defaults
477
+ call_metadata = @config.rpcs.update.metadata.to_h
478
+
479
+ # Set x-goog-api-client header
480
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
481
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
482
+ gapic_version: ::Google::Cloud::Compute::V1::VERSION,
483
+ transports_version_send: [:rest]
484
+
485
+ options.apply_defaults timeout: @config.rpcs.update.timeout,
486
+ metadata: call_metadata
487
+
488
+ options.apply_defaults timeout: @config.timeout,
489
+ metadata: @config.metadata
490
+
491
+ @region_commitments_stub.update request, options do |result, response|
492
+ result = ::Gapic::Rest::BaseOperation.new result
493
+ yield result, response if block_given?
494
+ return result
495
+ end
496
+ rescue ::Faraday::Error => e
497
+ gapic_error = ::Gapic::Rest::Error.wrap_faraday_error e
498
+ raise ::Google::Cloud::Error.from_error(gapic_error)
499
+ end
500
+
450
501
  ##
451
502
  # Configuration class for the RegionCommitments REST API.
452
503
  #
@@ -566,6 +617,11 @@ module Google
566
617
  # @return [::Gapic::Config::Method]
567
618
  #
568
619
  attr_reader :list
620
+ ##
621
+ # RPC-specific configuration for `update`
622
+ # @return [::Gapic::Config::Method]
623
+ #
624
+ attr_reader :update
569
625
 
570
626
  # @private
571
627
  def initialize parent_rpcs = nil
@@ -577,6 +633,8 @@ module Google
577
633
  @insert = ::Gapic::Config::Method.new insert_config
578
634
  list_config = parent_rpcs.list if parent_rpcs.respond_to? :list
579
635
  @list = ::Gapic::Config::Method.new list_config
636
+ update_config = parent_rpcs.update if parent_rpcs.respond_to? :update
637
+ @update = ::Gapic::Config::Method.new update_config
580
638
 
581
639
  yield self if block_given?
582
640
  end
@@ -225,6 +225,54 @@ module Google
225
225
 
226
226
  [uri, body, query_string_params]
227
227
  end
228
+
229
+ ##
230
+ # Baseline implementation for the update REST call
231
+ #
232
+ # @param request_pb [::Google::Cloud::Compute::V1::UpdateRegionCommitmentRequest]
233
+ # A request object representing the call parameters. Required.
234
+ # @param options [::Gapic::CallOptions]
235
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
236
+ #
237
+ # @yield [result, response] Access the result along with the Faraday response object
238
+ # @yieldparam result [::Google::Cloud::Compute::V1::Operation]
239
+ # @yieldparam response [::Faraday::Response]
240
+ #
241
+ # @return [::Google::Cloud::Compute::V1::Operation]
242
+ # A result object deserialized from the server's reply
243
+ def update request_pb, options = nil
244
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
245
+
246
+ uri, body, query_string_params = transcode_update_request request_pb
247
+ response = @client_stub.make_patch_request(
248
+ uri: uri,
249
+ body: body,
250
+ params: query_string_params,
251
+ options: options
252
+ )
253
+ result = ::Google::Cloud::Compute::V1::Operation.decode_json response.body, ignore_unknown_fields: true
254
+
255
+ yield result, response if block_given?
256
+ result
257
+ end
258
+
259
+ ##
260
+ # GRPC transcoding helper method for the update REST call
261
+ #
262
+ # @param request_pb [::Google::Cloud::Compute::V1::UpdateRegionCommitmentRequest]
263
+ # A request object representing the call parameters. Required.
264
+ # @return [Array(String, [String, nil], Hash{String => String})]
265
+ # Uri, Body, Query string parameters
266
+ def transcode_update_request request_pb
267
+ uri = "/compute/v1/projects/#{request_pb.project}/regions/#{request_pb.region}/commitments/#{request_pb.commitment}"
268
+ body = request_pb.commitment_resource.to_json
269
+ query_string_params = {}
270
+ query_string_params["paths"] = request_pb.paths.to_s if request_pb.has_paths?
271
+ query_string_params["requestId"] = request_pb.request_id.to_s if request_pb.has_request_id?
272
+ query_string_params["updateMask"] = request_pb.update_mask.to_s if request_pb.has_update_mask?
273
+
274
+ [uri, body, query_string_params]
275
+ end
228
276
  end
229
277
  end
230
278
  end
@@ -221,21 +221,11 @@ module Google
221
221
  # the default parameter values, pass an empty Hash as a request object (see above).
222
222
  #
223
223
  # @param filter [::String]
224
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
225
- #
226
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
227
- #
228
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
229
- #
230
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
224
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
231
225
  # @param max_results [::Integer]
232
226
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
233
227
  # @param order_by [::String]
234
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
235
- #
236
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
237
- #
238
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
228
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
239
229
  # @param page_token [::String]
240
230
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
241
231
  # @param project [::String]
@@ -187,11 +187,7 @@ module Google
187
187
  # @param region_disks_add_resource_policies_request_resource [::Google::Cloud::Compute::V1::RegionDisksAddResourcePoliciesRequest, ::Hash]
188
188
  # The body resource for this request
189
189
  # @param request_id [::String]
190
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
191
- #
192
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
193
- #
194
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
190
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
195
191
  # @yield [result, response] Access the result along with the Faraday response object
196
192
  # @yieldparam result [::Gapic::Rest::BaseOperation]
197
193
  # @yieldparam response [::Faraday::Response]
@@ -233,7 +229,7 @@ module Google
233
229
  end
234
230
 
235
231
  ##
236
- # Creates a snapshot of this regional disk.
232
+ # Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project.
237
233
  #
238
234
  # @overload create_snapshot(request, options = nil)
239
235
  # Pass arguments to `create_snapshot` via a request object, either of type
@@ -259,11 +255,7 @@ module Google
259
255
  # @param region [::String]
260
256
  # Name of the region for this request.
261
257
  # @param request_id [::String]
262
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
263
- #
264
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
265
- #
266
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
258
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
267
259
  # @param snapshot_resource [::Google::Cloud::Compute::V1::Snapshot, ::Hash]
268
260
  # The body resource for this request
269
261
  # @yield [result, response] Access the result along with the Faraday response object
@@ -333,11 +325,7 @@ module Google
333
325
  # @param region [::String]
334
326
  # Name of the region for this request.
335
327
  # @param request_id [::String]
336
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
337
- #
338
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
339
- #
340
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
328
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
341
329
  # @yield [result, response] Access the result along with the Faraday response object
342
330
  # @yieldparam result [::Gapic::Rest::BaseOperation]
343
331
  # @yieldparam response [::Faraday::Response]
@@ -537,11 +525,7 @@ module Google
537
525
  # @param region [::String]
538
526
  # Name of the region for this request.
539
527
  # @param request_id [::String]
540
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
541
- #
542
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
543
- #
544
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
528
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
545
529
  # @param source_image [::String]
546
530
  # Source image to restore onto a disk. This field is optional.
547
531
  # @yield [result, response] Access the result along with the Faraday response object
@@ -605,21 +589,11 @@ module Google
605
589
  # the default parameter values, pass an empty Hash as a request object (see above).
606
590
  #
607
591
  # @param filter [::String]
608
- # A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
609
- #
610
- # For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
611
- #
612
- # You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
613
- #
614
- # To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
592
+ # A filter expression that filters resources listed in the response. The expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:` operator can be used with string fields to match substrings. For non-string fields it is equivalent to the `=` operator. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
615
593
  # @param max_results [::Integer]
616
594
  # The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
617
595
  # @param order_by [::String]
618
- # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
619
- #
620
- # You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first.
621
- #
622
- # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
596
+ # Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
623
597
  # @param page_token [::String]
624
598
  # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
625
599
  # @param project [::String]
@@ -697,11 +671,7 @@ module Google
697
671
  # @param region_disks_remove_resource_policies_request_resource [::Google::Cloud::Compute::V1::RegionDisksRemoveResourcePoliciesRequest, ::Hash]
698
672
  # The body resource for this request
699
673
  # @param request_id [::String]
700
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
701
- #
702
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
703
- #
704
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
674
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
705
675
  # @yield [result, response] Access the result along with the Faraday response object
706
676
  # @yieldparam result [::Gapic::Rest::BaseOperation]
707
677
  # @yieldparam response [::Faraday::Response]
@@ -771,11 +741,7 @@ module Google
771
741
  # @param region_disks_resize_request_resource [::Google::Cloud::Compute::V1::RegionDisksResizeRequest, ::Hash]
772
742
  # The body resource for this request
773
743
  # @param request_id [::String]
774
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
775
- #
776
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
777
- #
778
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
744
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
779
745
  # @yield [result, response] Access the result along with the Faraday response object
780
746
  # @yieldparam result [::Gapic::Rest::BaseOperation]
781
747
  # @yieldparam response [::Faraday::Response]
@@ -910,11 +876,7 @@ module Google
910
876
  # @param region_set_labels_request_resource [::Google::Cloud::Compute::V1::RegionSetLabelsRequest, ::Hash]
911
877
  # The body resource for this request
912
878
  # @param request_id [::String]
913
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
914
- #
915
- # For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
916
- #
917
- # The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
879
+ # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
918
880
  # @param resource [::String]
919
881
  # Name or id of the resource for this request.
920
882
  # @yield [result, response] Access the result along with the Faraday response object