google-cloud-compute-v1 3.4.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/compute/v1/accelerator_types/rest/client.rb +181 -14
  3. data/lib/google/cloud/compute/v1/addresses/rest/client.rb +237 -20
  4. data/lib/google/cloud/compute/v1/advice/credentials.rb +52 -0
  5. data/lib/google/cloud/compute/v1/advice/rest/client.rb +431 -0
  6. data/lib/google/cloud/compute/v1/advice/rest/service_stub.rb +144 -0
  7. data/lib/google/cloud/compute/v1/advice/rest.rb +51 -0
  8. data/lib/google/cloud/compute/v1/advice.rb +47 -0
  9. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +334 -21
  10. data/lib/google/cloud/compute/v1/autoscalers/rest/service_stub.rb +64 -0
  11. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +198 -23
  12. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +499 -40
  13. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +62 -0
  14. data/lib/google/cloud/compute/v1/compute_pb.rb +264 -25
  15. data/lib/google/cloud/compute/v1/cross_site_networks/credentials.rb +52 -0
  16. data/lib/google/cloud/compute/v1/cross_site_networks/rest/client.rb +975 -0
  17. data/lib/google/cloud/compute/v1/cross_site_networks/rest/service_stub.rb +391 -0
  18. data/lib/google/cloud/compute/v1/cross_site_networks/rest.rb +51 -0
  19. data/lib/google/cloud/compute/v1/cross_site_networks.rb +47 -0
  20. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +181 -14
  21. data/lib/google/cloud/compute/v1/disks/rest/client.rb +390 -42
  22. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +118 -11
  23. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +240 -25
  24. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +238 -13
  25. data/lib/google/cloud/compute/v1/firewalls/rest/service_stub.rb +63 -0
  26. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +258 -23
  27. data/lib/google/cloud/compute/v1/future_reservations/credentials.rb +52 -0
  28. data/lib/google/cloud/compute/v1/future_reservations/rest/client.rb +1287 -0
  29. data/lib/google/cloud/compute/v1/future_reservations/rest/service_stub.rb +520 -0
  30. data/lib/google/cloud/compute/v1/future_reservations/rest.rb +51 -0
  31. data/lib/google/cloud/compute/v1/future_reservations.rb +47 -0
  32. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +126 -10
  33. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +151 -15
  34. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +246 -21
  35. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +203 -18
  36. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +91 -9
  37. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +128 -10
  38. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +333 -21
  39. data/lib/google/cloud/compute/v1/health_checks/rest/service_stub.rb +63 -0
  40. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +2 -1
  41. data/lib/google/cloud/compute/v1/images/rest/client.rb +161 -18
  42. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/client.rb +159 -24
  43. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +920 -95
  44. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +380 -40
  45. data/lib/google/cloud/compute/v1/instance_settings_service/rest/client.rb +13 -1
  46. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +220 -20
  47. data/lib/google/cloud/compute/v1/instances/rest/client.rb +939 -104
  48. data/lib/google/cloud/compute/v1/instant_snapshots/rest/client.rb +235 -21
  49. data/lib/google/cloud/compute/v1/interconnect_attachment_groups/rest/client.rb +139 -14
  50. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +242 -21
  51. data/lib/google/cloud/compute/v1/interconnect_groups/rest/client.rb +139 -14
  52. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +87 -7
  53. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/client.rb +87 -7
  54. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +145 -14
  55. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +9 -2
  56. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +161 -16
  57. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +124 -13
  58. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +181 -14
  59. data/lib/google/cloud/compute/v1/network_attachments/rest/client.rb +232 -20
  60. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/client.rb +138 -12
  61. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +361 -37
  62. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/client.rb +354 -33
  63. data/lib/google/cloud/compute/v1/network_profiles/rest/client.rb +85 -6
  64. data/lib/google/cloud/compute/v1/networks/rest/client.rb +281 -23
  65. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +381 -32
  66. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +213 -19
  67. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +181 -14
  68. data/lib/google/cloud/compute/v1/organization_security_policies/credentials.rb +52 -0
  69. data/lib/google/cloud/compute/v1/organization_security_policies/rest/client.rb +2259 -0
  70. data/lib/google/cloud/compute/v1/organization_security_policies/rest/service_stub.rb +1054 -0
  71. data/lib/google/cloud/compute/v1/organization_security_policies/rest.rb +51 -0
  72. data/lib/google/cloud/compute/v1/organization_security_policies.rb +47 -0
  73. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +226 -19
  74. data/lib/google/cloud/compute/v1/preview_features/credentials.rb +52 -0
  75. data/lib/google/cloud/compute/v1/preview_features/rest/client.rb +739 -0
  76. data/lib/google/cloud/compute/v1/preview_features/rest/service_stub.rb +267 -0
  77. data/lib/google/cloud/compute/v1/preview_features/rest.rb +51 -0
  78. data/lib/google/cloud/compute/v1/preview_features.rb +47 -0
  79. data/lib/google/cloud/compute/v1/projects/rest/client.rb +346 -30
  80. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +154 -12
  81. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +255 -22
  82. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +238 -13
  83. data/lib/google/cloud/compute/v1/region_autoscalers/rest/service_stub.rb +64 -0
  84. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +260 -26
  85. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +212 -18
  86. data/lib/google/cloud/compute/v1/region_composite_health_checks/credentials.rb +52 -0
  87. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/client.rb +1268 -0
  88. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/service_stub.rb +521 -0
  89. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest.rb +51 -0
  90. data/lib/google/cloud/compute/v1/region_composite_health_checks.rb +47 -0
  91. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +83 -5
  92. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +269 -29
  93. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/credentials.rb +52 -0
  94. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/client.rb +1268 -0
  95. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/service_stub.rb +521 -0
  96. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest.rb +51 -0
  97. data/lib/google/cloud/compute/v1/region_health_aggregation_policies.rb +47 -0
  98. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +427 -17
  99. data/lib/google/cloud/compute/v1/region_health_check_services/rest/service_stub.rb +125 -0
  100. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +238 -13
  101. data/lib/google/cloud/compute/v1/region_health_checks/rest/service_stub.rb +64 -0
  102. data/lib/google/cloud/compute/v1/region_health_sources/credentials.rb +52 -0
  103. data/lib/google/cloud/compute/v1/region_health_sources/rest/client.rb +1268 -0
  104. data/lib/google/cloud/compute/v1/region_health_sources/rest/service_stub.rb +521 -0
  105. data/lib/google/cloud/compute/v1/region_health_sources/rest.rb +51 -0
  106. data/lib/google/cloud/compute/v1/region_health_sources.rb +47 -0
  107. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +750 -64
  108. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +187 -14
  109. data/lib/google/cloud/compute/v1/region_instance_templates/rest/client.rb +115 -10
  110. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +15 -2
  111. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/client.rb +139 -13
  112. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +264 -28
  113. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/client.rb +213 -20
  114. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +399 -11
  115. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/service_stub.rb +125 -0
  116. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +107 -10
  117. data/lib/google/cloud/compute/v1/region_security_policies/rest/client.rb +149 -14
  118. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +116 -10
  119. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/client.rb +220 -20
  120. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +126 -10
  121. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +158 -14
  122. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/client.rb +113 -9
  123. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +104 -14
  124. data/lib/google/cloud/compute/v1/region_zones/rest/client.rb +85 -6
  125. data/lib/google/cloud/compute/v1/regions/rest/client.rb +120 -7
  126. data/lib/google/cloud/compute/v1/reservation_blocks/rest/client.rb +396 -11
  127. data/lib/google/cloud/compute/v1/reservation_blocks/rest/service_stub.rb +194 -0
  128. data/lib/google/cloud/compute/v1/reservation_slots/credentials.rb +52 -0
  129. data/lib/google/cloud/compute/v1/reservation_slots/rest/client.rb +863 -0
  130. data/lib/google/cloud/compute/v1/reservation_slots/rest/service_stub.rb +338 -0
  131. data/lib/google/cloud/compute/v1/reservation_slots/rest.rb +51 -0
  132. data/lib/google/cloud/compute/v1/reservation_slots.rb +47 -0
  133. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/client.rb +642 -12
  134. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/service_stub.rb +327 -3
  135. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +257 -24
  136. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +224 -19
  137. data/lib/google/cloud/compute/v1/rest.rb +10 -0
  138. data/lib/google/cloud/compute/v1/routers/rest/client.rb +555 -50
  139. data/lib/google/cloud/compute/v1/routes/rest/client.rb +202 -8
  140. data/lib/google/cloud/compute/v1/routes/rest/service_stub.rb +63 -0
  141. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +316 -26
  142. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +231 -21
  143. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/client.rb +13 -1
  144. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +130 -13
  145. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +210 -17
  146. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +315 -27
  147. data/lib/google/cloud/compute/v1/storage_pool_types/rest/client.rb +181 -14
  148. data/lib/google/cloud/compute/v1/storage_pools/rest/client.rb +321 -28
  149. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +378 -34
  150. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +128 -10
  151. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +240 -20
  152. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +306 -30
  153. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +227 -20
  154. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +294 -26
  155. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +281 -19
  156. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/service_stub.rb +63 -0
  157. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +329 -20
  158. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/service_stub.rb +63 -0
  159. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +224 -19
  160. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +354 -24
  161. data/lib/google/cloud/compute/v1/url_maps/rest/service_stub.rb +63 -0
  162. data/lib/google/cloud/compute/v1/version.rb +1 -1
  163. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +224 -19
  164. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +224 -19
  165. data/lib/google/cloud/compute/v1/wire_groups/credentials.rb +52 -0
  166. data/lib/google/cloud/compute/v1/wire_groups/rest/client.rb +980 -0
  167. data/lib/google/cloud/compute/v1/wire_groups/rest/service_stub.rb +396 -0
  168. data/lib/google/cloud/compute/v1/wire_groups/rest.rb +51 -0
  169. data/lib/google/cloud/compute/v1/wire_groups.rb +47 -0
  170. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +106 -10
  171. data/lib/google/cloud/compute/v1/zones/rest/client.rb +83 -5
  172. data/lib/google/cloud/compute/v1.rb +10 -0
  173. data/proto_docs/google/api/client.rb +149 -29
  174. data/proto_docs/google/cloud/compute/v1/compute.rb +43929 -5522
  175. metadata +52 -2
@@ -250,7 +250,21 @@ module Google
250
250
  # Service calls
251
251
 
252
252
  ##
253
- # Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
253
+ # Flags the specified instances to be removed from the
254
+ # managed instance group. Abandoning an instance does not delete the
255
+ # instance, but it does remove the instance from any target pools that are
256
+ # applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
257
+ # number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
258
+ # not yet been removed from the group. You must separately verify the
259
+ # status of the abandoning action with thelistmanagedinstances
260
+ # method.
261
+ #
262
+ # If the group is part of a backend
263
+ # service that has enabled
264
+ # connection draining, it can take up to 60 seconds after the connection
265
+ # draining duration has elapsed before the VM instance is removed or deleted.
266
+ #
267
+ # You can specify a maximum of 1000 instances with this method per request.
254
268
  #
255
269
  # @overload abandon_instances(request, options = nil)
256
270
  # Pass arguments to `abandon_instances` via a request object, either of type
@@ -274,9 +288,22 @@ module Google
274
288
  # @param project [::String]
275
289
  # Project ID for this request.
276
290
  # @param request_id [::String]
277
- # 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).
291
+ # An optional request ID to identify requests. Specify a unique request ID so
292
+ # that if you must retry your request, the server will know to ignore the
293
+ # request if it has already been completed.
294
+ #
295
+ # For example, consider a situation where you make an initial request and
296
+ # the request times out. If you make the request again with the same
297
+ # request ID, the server can check if original operation with the same
298
+ # request ID was received, and if so, will ignore the second request. This
299
+ # prevents clients from accidentally creating duplicate commitments.
300
+ #
301
+ # The request ID must be
302
+ # a valid UUID with the exception that zero UUID is not supported
303
+ # (00000000-0000-0000-0000-000000000000).
278
304
  # @param zone [::String]
279
- # The name of the zone where the managed instance group is located.
305
+ # The name of thezone where the managed
306
+ # instance group is located.
280
307
  # @yield [result, operation] Access the result along with the TransportOperation object
281
308
  # @yieldparam result [::Gapic::GenericLRO::Operation]
282
309
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -346,7 +373,10 @@ module Google
346
373
  end
347
374
 
348
375
  ##
349
- # Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.
376
+ # Retrieves the list of managed instance groups and groups them by zone.
377
+ #
378
+ # To prevent failure, Google recommends that you set the
379
+ # `returnPartialSuccess` parameter to `true`.
350
380
  #
351
381
  # @overload aggregated_list(request, options = nil)
352
382
  # Pass arguments to `aggregated_list` via a request object, either of type
@@ -364,21 +394,106 @@ module Google
364
394
  # the default parameter values, pass an empty Hash as a request object (see above).
365
395
  #
366
396
  # @param filter [::String]
367
- # A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your 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 `:*` 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) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
397
+ # A filter expression that filters resources listed in the response. Most
398
+ # Compute resources support two types of filter expressions:
399
+ # expressions that support regular expressions and expressions that follow
400
+ # API improvement proposal AIP-160.
401
+ # These two types of filter expressions cannot be mixed in one request.
402
+ #
403
+ # If you want to use AIP-160, your expression must specify the field name, an
404
+ # operator, and the value that you want to use for filtering. The value
405
+ # must be a string, a number, or a boolean. The operator
406
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
407
+ #
408
+ # For example, if you are filtering Compute Engine instances, you can
409
+ # exclude instances named `example-instance` by specifying
410
+ # `name != example-instance`.
411
+ #
412
+ # The `:*` comparison can be used to test whether a key has been defined.
413
+ # For example, to find all objects with `owner` label use:
414
+ # ```
415
+ # labels.owner:*
416
+ # ```
417
+ #
418
+ # You can also filter nested fields. For example, you could specify
419
+ # `scheduling.automaticRestart = false` to include instances only
420
+ # if they are not scheduled for automatic restarts. You can use filtering
421
+ # on nested fields to filter based onresource labels.
422
+ #
423
+ # To filter on multiple expressions, provide each separate expression within
424
+ # parentheses. For example:
425
+ # ```
426
+ # (scheduling.automaticRestart = true)
427
+ # (cpuPlatform = "Intel Skylake")
428
+ # ```
429
+ # By default, each expression is an `AND` expression. However, you
430
+ # can include `AND` and `OR` expressions explicitly.
431
+ # For example:
432
+ # ```
433
+ # (cpuPlatform = "Intel Skylake") OR
434
+ # (cpuPlatform = "Intel Broadwell") AND
435
+ # (scheduling.automaticRestart = true)
436
+ # ```
437
+ #
438
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
439
+ # (not equal) operator against a single un-parenthesized expression with or
440
+ # without quotes or against multiple parenthesized expressions. Examples:
441
+ #
442
+ # `fieldname eq unquoted literal`
443
+ # `fieldname eq 'single quoted literal'`
444
+ # `fieldname eq "double quoted literal"`
445
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
446
+ #
447
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
448
+ # The literal value must match the entire field.
449
+ #
450
+ # For example, to filter for instances that do not end with name "instance",
451
+ # you would use `name ne .*instance`.
452
+ #
453
+ # You cannot combine constraints on multiple fields using regular
454
+ # expressions.
368
455
  # @param include_all_scopes [::Boolean]
369
- # 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.
456
+ # Indicates whether every visible scope for each scope type (zone, region,
457
+ # global) should be included in the response. For new resource types added
458
+ # after this field, the flag has no effect as new resource types will always
459
+ # include every visible scope for each scope type in response. For resource
460
+ # types which predate this field, if this flag is omitted or false, only
461
+ # scopes of the scope types where the resource type is expected to be found
462
+ # will be included.
370
463
  # @param max_results [::Integer]
371
- # 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`)
464
+ # The maximum number of results per page that should be returned.
465
+ # If the number of available results is larger than `maxResults`,
466
+ # Compute Engine returns a `nextPageToken` that can be used to get
467
+ # the next page of results in subsequent list requests. Acceptable values are
468
+ # `0` to `500`, inclusive. (Default: `500`)
372
469
  # @param order_by [::String]
373
- # 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.
470
+ # Sorts list results by a certain order. By default, results
471
+ # are returned in alphanumerical order based on the resource name.
472
+ #
473
+ # You can also sort results in descending order based on the creation
474
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
475
+ # results based on the `creationTimestamp` field in
476
+ # reverse chronological order (newest result first). Use this to sort
477
+ # resources like operations so that the newest operation is returned first.
478
+ #
479
+ # Currently, only sorting by `name` or
480
+ # `creationTimestamp desc` is supported.
374
481
  # @param page_token [::String]
375
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
482
+ # Specifies a page token to use. Set `pageToken` to the
483
+ # `nextPageToken` returned by a previous list request to get
484
+ # the next page of results.
376
485
  # @param project [::String]
377
486
  # Project ID for this request.
378
487
  # @param return_partial_success [::Boolean]
379
- # Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
488
+ # Opt-in for partial success behavior which provides partial results in case
489
+ # of failure. The default value is false.
490
+ #
491
+ # For example, when partial success behavior is enabled, aggregatedList for a
492
+ # single zone scope either returns all resources in the zone or no resources,
493
+ # with an error code.
380
494
  # @param service_project_number [::Integer]
381
- # The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.
495
+ # The Shared VPC service project id or service project number for which
496
+ # aggregated list request is invoked for subnetworks list-usable api.
382
497
  # @yield [result, operation] Access the result along with the TransportOperation object
383
498
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::String, ::Google::Cloud::Compute::V1::InstanceGroupManagersScopedList>]
384
499
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -440,7 +555,8 @@ module Google
440
555
  end
441
556
 
442
557
  ##
443
- # Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions.
558
+ # Applies changes to selected instances on the managed instance group.
559
+ # This method can be used to apply new overrides and/or new versions.
444
560
  #
445
561
  # @overload apply_updates_to_instances(request, options = nil)
446
562
  # Pass arguments to `apply_updates_to_instances` via a request object, either of type
@@ -464,7 +580,8 @@ module Google
464
580
  # @param project [::String]
465
581
  # Project ID for this request.
466
582
  # @param zone [::String]
467
- # The name of the zone where the managed instance group is located. Should conform to RFC1035.
583
+ # The name of thezone
584
+ # where the managed instance group is located. Should conform to RFC1035.
468
585
  # @yield [result, operation] Access the result along with the TransportOperation object
469
586
  # @yieldparam result [::Gapic::GenericLRO::Operation]
470
587
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -534,7 +651,10 @@ module Google
534
651
  end
535
652
 
536
653
  ##
537
- # Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.
654
+ # Creates instances with per-instance configurations in this managed instance
655
+ # group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions
656
+ # take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
657
+ # method.
538
658
  #
539
659
  # @overload create_instances(request, options = nil)
540
660
  # Pass arguments to `create_instances` via a request object, either of type
@@ -552,15 +672,29 @@ module Google
552
672
  # the default parameter values, pass an empty Hash as a request object (see above).
553
673
  #
554
674
  # @param instance_group_manager [::String]
555
- # The name of the managed instance group. It should conform to RFC1035.
675
+ # The name of the managed instance group.
676
+ # It should conform to RFC1035.
556
677
  # @param instance_group_managers_create_instances_request_resource [::Google::Cloud::Compute::V1::InstanceGroupManagersCreateInstancesRequest, ::Hash]
557
678
  # The body resource for this request
558
679
  # @param project [::String]
559
680
  # Project ID for this request.
560
681
  # @param request_id [::String]
561
- # 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. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
682
+ # An optional request ID to identify requests. Specify a unique request ID so
683
+ # that if you must retry your request, the server will know to ignore the
684
+ # request if it has already been completed.
685
+ #
686
+ # For example, consider a situation where you make an initial request and
687
+ # the request times out. If you make the request again with the same
688
+ # request ID, the server can check if original operation with the same
689
+ # request ID was received, and if so, will ignore the second request.
690
+ #
691
+ # The request ID must be
692
+ # a valid UUID with the exception that zero UUID is not supported
693
+ # (00000000-0000-0000-0000-000000000000).
562
694
  # @param zone [::String]
563
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
695
+ # The name of thezone
696
+ # where the managed instance group is located.
697
+ # It should conform to RFC1035.
564
698
  # @yield [result, operation] Access the result along with the TransportOperation object
565
699
  # @yieldparam result [::Gapic::GenericLRO::Operation]
566
700
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -630,7 +764,10 @@ module Google
630
764
  end
631
765
 
632
766
  ##
633
- # Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information.
767
+ # Deletes the specified managed instance group and all of the instances
768
+ # in that group. Note that the instance group must not belong to a
769
+ # backend service. Read
770
+ # Deleting an instance group for more information.
634
771
  #
635
772
  # @overload delete(request, options = nil)
636
773
  # Pass arguments to `delete` via a request object, either of type
@@ -652,9 +789,22 @@ module Google
652
789
  # @param project [::String]
653
790
  # Project ID for this request.
654
791
  # @param request_id [::String]
655
- # 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).
792
+ # An optional request ID to identify requests. Specify a unique request ID so
793
+ # that if you must retry your request, the server will know to ignore the
794
+ # request if it has already been completed.
795
+ #
796
+ # For example, consider a situation where you make an initial request and
797
+ # the request times out. If you make the request again with the same
798
+ # request ID, the server can check if original operation with the same
799
+ # request ID was received, and if so, will ignore the second request. This
800
+ # prevents clients from accidentally creating duplicate commitments.
801
+ #
802
+ # The request ID must be
803
+ # a valid UUID with the exception that zero UUID is not supported
804
+ # (00000000-0000-0000-0000-000000000000).
656
805
  # @param zone [::String]
657
- # The name of the zone where the managed instance group is located.
806
+ # The name of thezone where the managed
807
+ # instance group is located.
658
808
  # @yield [result, operation] Access the result along with the TransportOperation object
659
809
  # @yieldparam result [::Gapic::GenericLRO::Operation]
660
810
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -724,7 +874,21 @@ module Google
724
874
  end
725
875
 
726
876
  ##
727
- # Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
877
+ # Flags the specified instances in the managed instance group for immediate
878
+ # deletion. The instances are also removed from any target
879
+ # pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
880
+ # instances that you delete. This operation is marked as DONE
881
+ # when the action is scheduled even if the instances are still being deleted.
882
+ # You must separately verify the status of the deleting action
883
+ # with thelistmanagedinstances
884
+ # method.
885
+ #
886
+ # If the group is part of a backend
887
+ # service that has enabled
888
+ # connection draining, it can take up to 60 seconds after the connection
889
+ # draining duration has elapsed before the VM instance is removed or deleted.
890
+ #
891
+ # You can specify a maximum of 1000 instances with this method per request.
728
892
  #
729
893
  # @overload delete_instances(request, options = nil)
730
894
  # Pass arguments to `delete_instances` via a request object, either of type
@@ -748,9 +912,22 @@ module Google
748
912
  # @param project [::String]
749
913
  # Project ID for this request.
750
914
  # @param request_id [::String]
751
- # 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).
915
+ # An optional request ID to identify requests. Specify a unique request ID so
916
+ # that if you must retry your request, the server will know to ignore the
917
+ # request if it has already been completed.
918
+ #
919
+ # For example, consider a situation where you make an initial request and
920
+ # the request times out. If you make the request again with the same
921
+ # request ID, the server can check if original operation with the same
922
+ # request ID was received, and if so, will ignore the second request. This
923
+ # prevents clients from accidentally creating duplicate commitments.
924
+ #
925
+ # The request ID must be
926
+ # a valid UUID with the exception that zero UUID is not supported
927
+ # (00000000-0000-0000-0000-000000000000).
752
928
  # @param zone [::String]
753
- # The name of the zone where the managed instance group is located.
929
+ # The name of thezone where the managed
930
+ # instance group is located.
754
931
  # @yield [result, operation] Access the result along with the TransportOperation object
755
932
  # @yieldparam result [::Gapic::GenericLRO::Operation]
756
933
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -820,7 +997,8 @@ module Google
820
997
  end
821
998
 
822
999
  ##
823
- # Deletes selected per-instance configurations for the managed instance group.
1000
+ # Deletes selected per-instance configurations for the managed instance
1001
+ # group.
824
1002
  #
825
1003
  # @overload delete_per_instance_configs(request, options = nil)
826
1004
  # Pass arguments to `delete_per_instance_configs` via a request object, either of type
@@ -838,13 +1016,17 @@ module Google
838
1016
  # the default parameter values, pass an empty Hash as a request object (see above).
839
1017
  #
840
1018
  # @param instance_group_manager [::String]
841
- # The name of the managed instance group. It should conform to RFC1035.
1019
+ # The name of the managed instance group.
1020
+ # It should conform to RFC1035.
842
1021
  # @param instance_group_managers_delete_per_instance_configs_req_resource [::Google::Cloud::Compute::V1::InstanceGroupManagersDeletePerInstanceConfigsReq, ::Hash]
843
1022
  # The body resource for this request
844
1023
  # @param project [::String]
845
1024
  # Project ID for this request.
846
1025
  # @param zone [::String]
847
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
1026
+ # The name of thezone
1027
+ # where the managed instance
1028
+ # group is located.
1029
+ # It should conform to RFC1035.
848
1030
  # @yield [result, operation] Access the result along with the TransportOperation object
849
1031
  # @yieldparam result [::Gapic::GenericLRO::Operation]
850
1032
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -936,7 +1118,8 @@ module Google
936
1118
  # @param project [::String]
937
1119
  # Project ID for this request.
938
1120
  # @param zone [::String]
939
- # The name of the zone where the managed instance group is located.
1121
+ # The name of thezone where the managed
1122
+ # instance group is located.
940
1123
  # @yield [result, operation] Access the result along with the TransportOperation object
941
1124
  # @yieldparam result [::Google::Cloud::Compute::V1::InstanceGroupManager]
942
1125
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -996,7 +1179,17 @@ module Google
996
1179
  end
997
1180
 
998
1181
  ##
999
- # Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
1182
+ # Creates a managed instance group using the information that you specify
1183
+ # in the request. After the group is created, instances in the group are
1184
+ # created using the specified instance template.
1185
+ # This operation is marked as DONE when the group is created
1186
+ # even if the instances in the group have not yet been created. You
1187
+ # must separately verify the status of the individual instances with thelistmanagedinstances
1188
+ # method.
1189
+ #
1190
+ # A managed instance group can have up to 1000 VM instances per group. Please
1191
+ # contact Cloud Support if you need an increase in
1192
+ # this limit.
1000
1193
  #
1001
1194
  # @overload insert(request, options = nil)
1002
1195
  # Pass arguments to `insert` via a request object, either of type
@@ -1018,9 +1211,22 @@ module Google
1018
1211
  # @param project [::String]
1019
1212
  # Project ID for this request.
1020
1213
  # @param request_id [::String]
1021
- # 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).
1214
+ # An optional request ID to identify requests. Specify a unique request ID so
1215
+ # that if you must retry your request, the server will know to ignore the
1216
+ # request if it has already been completed.
1217
+ #
1218
+ # For example, consider a situation where you make an initial request and
1219
+ # the request times out. If you make the request again with the same
1220
+ # request ID, the server can check if original operation with the same
1221
+ # request ID was received, and if so, will ignore the second request. This
1222
+ # prevents clients from accidentally creating duplicate commitments.
1223
+ #
1224
+ # The request ID must be
1225
+ # a valid UUID with the exception that zero UUID is not supported
1226
+ # (00000000-0000-0000-0000-000000000000).
1022
1227
  # @param zone [::String]
1023
- # The name of the zone where you want to create the managed instance group.
1228
+ # The name of the zone
1229
+ # where you want to create the managed instance group.
1024
1230
  # @yield [result, operation] Access the result along with the TransportOperation object
1025
1231
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1026
1232
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1090,7 +1296,8 @@ module Google
1090
1296
  end
1091
1297
 
1092
1298
  ##
1093
- # Retrieves a list of managed instance groups that are contained within the specified project and zone.
1299
+ # Retrieves a list of managed instance groups that are contained within the
1300
+ # specified project and zone.
1094
1301
  #
1095
1302
  # @overload list(request, options = nil)
1096
1303
  # Pass arguments to `list` via a request object, either of type
@@ -1108,19 +1315,98 @@ module Google
1108
1315
  # the default parameter values, pass an empty Hash as a request object (see above).
1109
1316
  #
1110
1317
  # @param filter [::String]
1111
- # A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your 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 `:*` 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) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
1318
+ # A filter expression that filters resources listed in the response. Most
1319
+ # Compute resources support two types of filter expressions:
1320
+ # expressions that support regular expressions and expressions that follow
1321
+ # API improvement proposal AIP-160.
1322
+ # These two types of filter expressions cannot be mixed in one request.
1323
+ #
1324
+ # If you want to use AIP-160, your expression must specify the field name, an
1325
+ # operator, and the value that you want to use for filtering. The value
1326
+ # must be a string, a number, or a boolean. The operator
1327
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1328
+ #
1329
+ # For example, if you are filtering Compute Engine instances, you can
1330
+ # exclude instances named `example-instance` by specifying
1331
+ # `name != example-instance`.
1332
+ #
1333
+ # The `:*` comparison can be used to test whether a key has been defined.
1334
+ # For example, to find all objects with `owner` label use:
1335
+ # ```
1336
+ # labels.owner:*
1337
+ # ```
1338
+ #
1339
+ # You can also filter nested fields. For example, you could specify
1340
+ # `scheduling.automaticRestart = false` to include instances only
1341
+ # if they are not scheduled for automatic restarts. You can use filtering
1342
+ # on nested fields to filter based onresource labels.
1343
+ #
1344
+ # To filter on multiple expressions, provide each separate expression within
1345
+ # parentheses. For example:
1346
+ # ```
1347
+ # (scheduling.automaticRestart = true)
1348
+ # (cpuPlatform = "Intel Skylake")
1349
+ # ```
1350
+ # By default, each expression is an `AND` expression. However, you
1351
+ # can include `AND` and `OR` expressions explicitly.
1352
+ # For example:
1353
+ # ```
1354
+ # (cpuPlatform = "Intel Skylake") OR
1355
+ # (cpuPlatform = "Intel Broadwell") AND
1356
+ # (scheduling.automaticRestart = true)
1357
+ # ```
1358
+ #
1359
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1360
+ # (not equal) operator against a single un-parenthesized expression with or
1361
+ # without quotes or against multiple parenthesized expressions. Examples:
1362
+ #
1363
+ # `fieldname eq unquoted literal`
1364
+ # `fieldname eq 'single quoted literal'`
1365
+ # `fieldname eq "double quoted literal"`
1366
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1367
+ #
1368
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1369
+ # The literal value must match the entire field.
1370
+ #
1371
+ # For example, to filter for instances that do not end with name "instance",
1372
+ # you would use `name ne .*instance`.
1373
+ #
1374
+ # You cannot combine constraints on multiple fields using regular
1375
+ # expressions.
1112
1376
  # @param max_results [::Integer]
1113
- # 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`)
1377
+ # The maximum number of results per page that should be returned.
1378
+ # If the number of available results is larger than `maxResults`,
1379
+ # Compute Engine returns a `nextPageToken` that can be used to get
1380
+ # the next page of results in subsequent list requests. Acceptable values are
1381
+ # `0` to `500`, inclusive. (Default: `500`)
1114
1382
  # @param order_by [::String]
1115
- # 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.
1383
+ # Sorts list results by a certain order. By default, results
1384
+ # are returned in alphanumerical order based on the resource name.
1385
+ #
1386
+ # You can also sort results in descending order based on the creation
1387
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1388
+ # results based on the `creationTimestamp` field in
1389
+ # reverse chronological order (newest result first). Use this to sort
1390
+ # resources like operations so that the newest operation is returned first.
1391
+ #
1392
+ # Currently, only sorting by `name` or
1393
+ # `creationTimestamp desc` is supported.
1116
1394
  # @param page_token [::String]
1117
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1395
+ # Specifies a page token to use. Set `pageToken` to the
1396
+ # `nextPageToken` returned by a previous list request to get
1397
+ # the next page of results.
1118
1398
  # @param project [::String]
1119
1399
  # Project ID for this request.
1120
1400
  # @param return_partial_success [::Boolean]
1121
- # Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
1401
+ # Opt-in for partial success behavior which provides partial results in case
1402
+ # of failure. The default value is false.
1403
+ #
1404
+ # For example, when partial success behavior is enabled, aggregatedList for a
1405
+ # single zone scope either returns all resources in the zone or no resources,
1406
+ # with an error code.
1122
1407
  # @param zone [::String]
1123
- # The name of the zone where the managed instance group is located.
1408
+ # The name of thezone where the managed
1409
+ # instance group is located.
1124
1410
  # @yield [result, operation] Access the result along with the TransportOperation object
1125
1411
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::InstanceGroupManager>]
1126
1412
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1182,7 +1468,9 @@ module Google
1182
1468
  end
1183
1469
 
1184
1470
  ##
1185
- # Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported.
1471
+ # Lists all errors thrown by actions on instances for a given managed
1472
+ # instance group. The filter and orderBy query
1473
+ # parameters are not supported.
1186
1474
  #
1187
1475
  # @overload list_errors(request, options = nil)
1188
1476
  # Pass arguments to `list_errors` via a request object, either of type
@@ -1200,21 +1488,104 @@ module Google
1200
1488
  # the default parameter values, pass an empty Hash as a request object (see above).
1201
1489
  #
1202
1490
  # @param filter [::String]
1203
- # A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your 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 `:*` 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) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
1491
+ # A filter expression that filters resources listed in the response. Most
1492
+ # Compute resources support two types of filter expressions:
1493
+ # expressions that support regular expressions and expressions that follow
1494
+ # API improvement proposal AIP-160.
1495
+ # These two types of filter expressions cannot be mixed in one request.
1496
+ #
1497
+ # If you want to use AIP-160, your expression must specify the field name, an
1498
+ # operator, and the value that you want to use for filtering. The value
1499
+ # must be a string, a number, or a boolean. The operator
1500
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1501
+ #
1502
+ # For example, if you are filtering Compute Engine instances, you can
1503
+ # exclude instances named `example-instance` by specifying
1504
+ # `name != example-instance`.
1505
+ #
1506
+ # The `:*` comparison can be used to test whether a key has been defined.
1507
+ # For example, to find all objects with `owner` label use:
1508
+ # ```
1509
+ # labels.owner:*
1510
+ # ```
1511
+ #
1512
+ # You can also filter nested fields. For example, you could specify
1513
+ # `scheduling.automaticRestart = false` to include instances only
1514
+ # if they are not scheduled for automatic restarts. You can use filtering
1515
+ # on nested fields to filter based onresource labels.
1516
+ #
1517
+ # To filter on multiple expressions, provide each separate expression within
1518
+ # parentheses. For example:
1519
+ # ```
1520
+ # (scheduling.automaticRestart = true)
1521
+ # (cpuPlatform = "Intel Skylake")
1522
+ # ```
1523
+ # By default, each expression is an `AND` expression. However, you
1524
+ # can include `AND` and `OR` expressions explicitly.
1525
+ # For example:
1526
+ # ```
1527
+ # (cpuPlatform = "Intel Skylake") OR
1528
+ # (cpuPlatform = "Intel Broadwell") AND
1529
+ # (scheduling.automaticRestart = true)
1530
+ # ```
1531
+ #
1532
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1533
+ # (not equal) operator against a single un-parenthesized expression with or
1534
+ # without quotes or against multiple parenthesized expressions. Examples:
1535
+ #
1536
+ # `fieldname eq unquoted literal`
1537
+ # `fieldname eq 'single quoted literal'`
1538
+ # `fieldname eq "double quoted literal"`
1539
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1540
+ #
1541
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1542
+ # The literal value must match the entire field.
1543
+ #
1544
+ # For example, to filter for instances that do not end with name "instance",
1545
+ # you would use `name ne .*instance`.
1546
+ #
1547
+ # You cannot combine constraints on multiple fields using regular
1548
+ # expressions.
1204
1549
  # @param instance_group_manager [::String]
1205
- # The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]\\{0,61}[a-z0-9])?)|1-9\\{0,19}.
1550
+ # The name of the managed instance group.
1551
+ # It must be a string that meets the requirements in RFC1035, or an
1552
+ # unsigned long integer: must match regexp pattern:
1553
+ # (?:[a-z](?:[-a-z0-9]\\{0,61}[a-z0-9])?)|1-9\\{0,19}.
1206
1554
  # @param max_results [::Integer]
1207
- # 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`)
1555
+ # The maximum number of results per page that should be returned.
1556
+ # If the number of available results is larger than `maxResults`,
1557
+ # Compute Engine returns a `nextPageToken` that can be used to get
1558
+ # the next page of results in subsequent list requests. Acceptable values are
1559
+ # `0` to `500`, inclusive. (Default: `500`)
1208
1560
  # @param order_by [::String]
1209
- # 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.
1561
+ # Sorts list results by a certain order. By default, results
1562
+ # are returned in alphanumerical order based on the resource name.
1563
+ #
1564
+ # You can also sort results in descending order based on the creation
1565
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1566
+ # results based on the `creationTimestamp` field in
1567
+ # reverse chronological order (newest result first). Use this to sort
1568
+ # resources like operations so that the newest operation is returned first.
1569
+ #
1570
+ # Currently, only sorting by `name` or
1571
+ # `creationTimestamp desc` is supported.
1210
1572
  # @param page_token [::String]
1211
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1573
+ # Specifies a page token to use. Set `pageToken` to the
1574
+ # `nextPageToken` returned by a previous list request to get
1575
+ # the next page of results.
1212
1576
  # @param project [::String]
1213
1577
  # Project ID for this request.
1214
1578
  # @param return_partial_success [::Boolean]
1215
- # Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
1579
+ # Opt-in for partial success behavior which provides partial results in case
1580
+ # of failure. The default value is false.
1581
+ #
1582
+ # For example, when partial success behavior is enabled, aggregatedList for a
1583
+ # single zone scope either returns all resources in the zone or no resources,
1584
+ # with an error code.
1216
1585
  # @param zone [::String]
1217
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
1586
+ # The name of thezone where the managed
1587
+ # instance group is located.
1588
+ # It should conform to RFC1035.
1218
1589
  # @yield [result, operation] Access the result along with the TransportOperation object
1219
1590
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::InstanceManagedByIgmError>]
1220
1591
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1276,7 +1647,15 @@ module Google
1276
1647
  end
1277
1648
 
1278
1649
  ##
1279
- # Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
1650
+ # Lists all of the instances in the managed instance group. Each instance
1651
+ # in the list has a currentAction, which indicates the action
1652
+ # that the managed instance group is performing on the instance. For example,
1653
+ # if the group is still creating an instance, the currentAction
1654
+ # is CREATING. If a previous action failed, the
1655
+ # list displays the errors for that failed action. The orderBy
1656
+ # query parameter is not supported. The `pageToken` query parameter is
1657
+ # supported only if the group's `listManagedInstancesResults` field is set
1658
+ # to `PAGINATED`.
1280
1659
  #
1281
1660
  # @overload list_managed_instances(request, options = nil)
1282
1661
  # Pass arguments to `list_managed_instances` via a request object, either of type
@@ -1294,21 +1673,100 @@ module Google
1294
1673
  # the default parameter values, pass an empty Hash as a request object (see above).
1295
1674
  #
1296
1675
  # @param filter [::String]
1297
- # A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your 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 `:*` 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) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
1676
+ # A filter expression that filters resources listed in the response. Most
1677
+ # Compute resources support two types of filter expressions:
1678
+ # expressions that support regular expressions and expressions that follow
1679
+ # API improvement proposal AIP-160.
1680
+ # These two types of filter expressions cannot be mixed in one request.
1681
+ #
1682
+ # If you want to use AIP-160, your expression must specify the field name, an
1683
+ # operator, and the value that you want to use for filtering. The value
1684
+ # must be a string, a number, or a boolean. The operator
1685
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1686
+ #
1687
+ # For example, if you are filtering Compute Engine instances, you can
1688
+ # exclude instances named `example-instance` by specifying
1689
+ # `name != example-instance`.
1690
+ #
1691
+ # The `:*` comparison can be used to test whether a key has been defined.
1692
+ # For example, to find all objects with `owner` label use:
1693
+ # ```
1694
+ # labels.owner:*
1695
+ # ```
1696
+ #
1697
+ # You can also filter nested fields. For example, you could specify
1698
+ # `scheduling.automaticRestart = false` to include instances only
1699
+ # if they are not scheduled for automatic restarts. You can use filtering
1700
+ # on nested fields to filter based onresource labels.
1701
+ #
1702
+ # To filter on multiple expressions, provide each separate expression within
1703
+ # parentheses. For example:
1704
+ # ```
1705
+ # (scheduling.automaticRestart = true)
1706
+ # (cpuPlatform = "Intel Skylake")
1707
+ # ```
1708
+ # By default, each expression is an `AND` expression. However, you
1709
+ # can include `AND` and `OR` expressions explicitly.
1710
+ # For example:
1711
+ # ```
1712
+ # (cpuPlatform = "Intel Skylake") OR
1713
+ # (cpuPlatform = "Intel Broadwell") AND
1714
+ # (scheduling.automaticRestart = true)
1715
+ # ```
1716
+ #
1717
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1718
+ # (not equal) operator against a single un-parenthesized expression with or
1719
+ # without quotes or against multiple parenthesized expressions. Examples:
1720
+ #
1721
+ # `fieldname eq unquoted literal`
1722
+ # `fieldname eq 'single quoted literal'`
1723
+ # `fieldname eq "double quoted literal"`
1724
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1725
+ #
1726
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1727
+ # The literal value must match the entire field.
1728
+ #
1729
+ # For example, to filter for instances that do not end with name "instance",
1730
+ # you would use `name ne .*instance`.
1731
+ #
1732
+ # You cannot combine constraints on multiple fields using regular
1733
+ # expressions.
1298
1734
  # @param instance_group_manager [::String]
1299
1735
  # The name of the managed instance group.
1300
1736
  # @param max_results [::Integer]
1301
- # 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`)
1737
+ # The maximum number of results per page that should be returned.
1738
+ # If the number of available results is larger than `maxResults`,
1739
+ # Compute Engine returns a `nextPageToken` that can be used to get
1740
+ # the next page of results in subsequent list requests. Acceptable values are
1741
+ # `0` to `500`, inclusive. (Default: `500`)
1302
1742
  # @param order_by [::String]
1303
- # 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.
1743
+ # Sorts list results by a certain order. By default, results
1744
+ # are returned in alphanumerical order based on the resource name.
1745
+ #
1746
+ # You can also sort results in descending order based on the creation
1747
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1748
+ # results based on the `creationTimestamp` field in
1749
+ # reverse chronological order (newest result first). Use this to sort
1750
+ # resources like operations so that the newest operation is returned first.
1751
+ #
1752
+ # Currently, only sorting by `name` or
1753
+ # `creationTimestamp desc` is supported.
1304
1754
  # @param page_token [::String]
1305
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1755
+ # Specifies a page token to use. Set `pageToken` to the
1756
+ # `nextPageToken` returned by a previous list request to get
1757
+ # the next page of results.
1306
1758
  # @param project [::String]
1307
1759
  # Project ID for this request.
1308
1760
  # @param return_partial_success [::Boolean]
1309
- # Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
1761
+ # Opt-in for partial success behavior which provides partial results in case
1762
+ # of failure. The default value is false.
1763
+ #
1764
+ # For example, when partial success behavior is enabled, aggregatedList for a
1765
+ # single zone scope either returns all resources in the zone or no resources,
1766
+ # with an error code.
1310
1767
  # @param zone [::String]
1311
- # The name of the zone where the managed instance group is located.
1768
+ # The name of thezone where the managed
1769
+ # instance group is located.
1312
1770
  # @yield [result, operation] Access the result along with the TransportOperation object
1313
1771
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::ManagedInstance>]
1314
1772
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1370,7 +1828,8 @@ module Google
1370
1828
  end
1371
1829
 
1372
1830
  ##
1373
- # Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.
1831
+ # Lists all of the per-instance configurations defined for the managed
1832
+ # instance group. The orderBy query parameter is not supported.
1374
1833
  #
1375
1834
  # @overload list_per_instance_configs(request, options = nil)
1376
1835
  # Pass arguments to `list_per_instance_configs` via a request object, either of type
@@ -1388,21 +1847,101 @@ module Google
1388
1847
  # the default parameter values, pass an empty Hash as a request object (see above).
1389
1848
  #
1390
1849
  # @param filter [::String]
1391
- # A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your 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 `:*` 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) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
1850
+ # A filter expression that filters resources listed in the response. Most
1851
+ # Compute resources support two types of filter expressions:
1852
+ # expressions that support regular expressions and expressions that follow
1853
+ # API improvement proposal AIP-160.
1854
+ # These two types of filter expressions cannot be mixed in one request.
1855
+ #
1856
+ # If you want to use AIP-160, your expression must specify the field name, an
1857
+ # operator, and the value that you want to use for filtering. The value
1858
+ # must be a string, a number, or a boolean. The operator
1859
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1860
+ #
1861
+ # For example, if you are filtering Compute Engine instances, you can
1862
+ # exclude instances named `example-instance` by specifying
1863
+ # `name != example-instance`.
1864
+ #
1865
+ # The `:*` comparison can be used to test whether a key has been defined.
1866
+ # For example, to find all objects with `owner` label use:
1867
+ # ```
1868
+ # labels.owner:*
1869
+ # ```
1870
+ #
1871
+ # You can also filter nested fields. For example, you could specify
1872
+ # `scheduling.automaticRestart = false` to include instances only
1873
+ # if they are not scheduled for automatic restarts. You can use filtering
1874
+ # on nested fields to filter based onresource labels.
1875
+ #
1876
+ # To filter on multiple expressions, provide each separate expression within
1877
+ # parentheses. For example:
1878
+ # ```
1879
+ # (scheduling.automaticRestart = true)
1880
+ # (cpuPlatform = "Intel Skylake")
1881
+ # ```
1882
+ # By default, each expression is an `AND` expression. However, you
1883
+ # can include `AND` and `OR` expressions explicitly.
1884
+ # For example:
1885
+ # ```
1886
+ # (cpuPlatform = "Intel Skylake") OR
1887
+ # (cpuPlatform = "Intel Broadwell") AND
1888
+ # (scheduling.automaticRestart = true)
1889
+ # ```
1890
+ #
1891
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1892
+ # (not equal) operator against a single un-parenthesized expression with or
1893
+ # without quotes or against multiple parenthesized expressions. Examples:
1894
+ #
1895
+ # `fieldname eq unquoted literal`
1896
+ # `fieldname eq 'single quoted literal'`
1897
+ # `fieldname eq "double quoted literal"`
1898
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1899
+ #
1900
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1901
+ # The literal value must match the entire field.
1902
+ #
1903
+ # For example, to filter for instances that do not end with name "instance",
1904
+ # you would use `name ne .*instance`.
1905
+ #
1906
+ # You cannot combine constraints on multiple fields using regular
1907
+ # expressions.
1392
1908
  # @param instance_group_manager [::String]
1393
1909
  # The name of the managed instance group. It should conform to RFC1035.
1394
1910
  # @param max_results [::Integer]
1395
- # 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`)
1911
+ # The maximum number of results per page that should be returned.
1912
+ # If the number of available results is larger than `maxResults`,
1913
+ # Compute Engine returns a `nextPageToken` that can be used to get
1914
+ # the next page of results in subsequent list requests. Acceptable values are
1915
+ # `0` to `500`, inclusive. (Default: `500`)
1396
1916
  # @param order_by [::String]
1397
- # 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.
1917
+ # Sorts list results by a certain order. By default, results
1918
+ # are returned in alphanumerical order based on the resource name.
1919
+ #
1920
+ # You can also sort results in descending order based on the creation
1921
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1922
+ # results based on the `creationTimestamp` field in
1923
+ # reverse chronological order (newest result first). Use this to sort
1924
+ # resources like operations so that the newest operation is returned first.
1925
+ #
1926
+ # Currently, only sorting by `name` or
1927
+ # `creationTimestamp desc` is supported.
1398
1928
  # @param page_token [::String]
1399
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1929
+ # Specifies a page token to use. Set `pageToken` to the
1930
+ # `nextPageToken` returned by a previous list request to get
1931
+ # the next page of results.
1400
1932
  # @param project [::String]
1401
1933
  # Project ID for this request.
1402
1934
  # @param return_partial_success [::Boolean]
1403
- # Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
1935
+ # Opt-in for partial success behavior which provides partial results in case
1936
+ # of failure. The default value is false.
1937
+ #
1938
+ # For example, when partial success behavior is enabled, aggregatedList for a
1939
+ # single zone scope either returns all resources in the zone or no resources,
1940
+ # with an error code.
1404
1941
  # @param zone [::String]
1405
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
1942
+ # The name of thezone
1943
+ # where the managed instance group is located.
1944
+ # It should conform to RFC1035.
1406
1945
  # @yield [result, operation] Access the result along with the TransportOperation object
1407
1946
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::PerInstanceConfig>]
1408
1947
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1464,7 +2003,21 @@ module Google
1464
2003
  end
1465
2004
 
1466
2005
  ##
1467
- # Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG.
2006
+ # Updates a managed instance group using the information that you specify
2007
+ # in the request.
2008
+ # This operation is marked as DONE when the group is patched
2009
+ # even if the instances in the group are still in the process of being
2010
+ # patched. You must separately verify the status of the individual instances
2011
+ # with thelistManagedInstances
2012
+ # method. This method supportsPATCH
2013
+ # semantics and uses theJSON merge
2014
+ # patch format and processing rules.
2015
+ #
2016
+ # If you update your group to specify a new template or instance
2017
+ # configuration, it's possible that your intended specification for each VM
2018
+ # in the group is different from the current state of that VM. To learn how
2019
+ # to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
2020
+ # a MIG.
1468
2021
  #
1469
2022
  # @overload patch(request, options = nil)
1470
2023
  # Pass arguments to `patch` via a request object, either of type
@@ -1488,9 +2041,22 @@ module Google
1488
2041
  # @param project [::String]
1489
2042
  # Project ID for this request.
1490
2043
  # @param request_id [::String]
1491
- # 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).
2044
+ # An optional request ID to identify requests. Specify a unique request ID so
2045
+ # that if you must retry your request, the server will know to ignore the
2046
+ # request if it has already been completed.
2047
+ #
2048
+ # For example, consider a situation where you make an initial request and
2049
+ # the request times out. If you make the request again with the same
2050
+ # request ID, the server can check if original operation with the same
2051
+ # request ID was received, and if so, will ignore the second request. This
2052
+ # prevents clients from accidentally creating duplicate commitments.
2053
+ #
2054
+ # The request ID must be
2055
+ # a valid UUID with the exception that zero UUID is not supported
2056
+ # (00000000-0000-0000-0000-000000000000).
1492
2057
  # @param zone [::String]
1493
- # The name of the zone where you want to create the managed instance group.
2058
+ # The name of the zone where
2059
+ # you want to create the managed instance group.
1494
2060
  # @yield [result, operation] Access the result along with the TransportOperation object
1495
2061
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1496
2062
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1560,7 +2126,9 @@ module Google
1560
2126
  end
1561
2127
 
1562
2128
  ##
1563
- # Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
2129
+ # Inserts or patches per-instance configurations for the managed instance
2130
+ # group. perInstanceConfig.name serves as a key used to
2131
+ # distinguish whether to perform insert or patch.
1564
2132
  #
1565
2133
  # @overload patch_per_instance_configs(request, options = nil)
1566
2134
  # Pass arguments to `patch_per_instance_configs` via a request object, either of type
@@ -1578,15 +2146,30 @@ module Google
1578
2146
  # the default parameter values, pass an empty Hash as a request object (see above).
1579
2147
  #
1580
2148
  # @param instance_group_manager [::String]
1581
- # The name of the managed instance group. It should conform to RFC1035.
2149
+ # The name of the managed instance group.
2150
+ # It should conform to RFC1035.
1582
2151
  # @param instance_group_managers_patch_per_instance_configs_req_resource [::Google::Cloud::Compute::V1::InstanceGroupManagersPatchPerInstanceConfigsReq, ::Hash]
1583
2152
  # The body resource for this request
1584
2153
  # @param project [::String]
1585
2154
  # Project ID for this request.
1586
2155
  # @param request_id [::String]
1587
- # 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).
2156
+ # An optional request ID to identify requests. Specify a unique request ID so
2157
+ # that if you must retry your request, the server will know to ignore the
2158
+ # request if it has already been completed.
2159
+ #
2160
+ # For example, consider a situation where you make an initial request and
2161
+ # the request times out. If you make the request again with the same
2162
+ # request ID, the server can check if original operation with the same
2163
+ # request ID was received, and if so, will ignore the second request. This
2164
+ # prevents clients from accidentally creating duplicate commitments.
2165
+ #
2166
+ # The request ID must be
2167
+ # a valid UUID with the exception that zero UUID is not supported
2168
+ # (00000000-0000-0000-0000-000000000000).
1588
2169
  # @param zone [::String]
1589
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
2170
+ # The name of thezone
2171
+ # where the managed instance group is located.
2172
+ # It should conform to RFC1035.
1590
2173
  # @yield [result, operation] Access the result along with the TransportOperation object
1591
2174
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1592
2175
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1656,7 +2239,19 @@ module Google
1656
2239
  end
1657
2240
 
1658
2241
  ##
1659
- # Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request.
2242
+ # Flags the specified VM instances in the managed instance group to be
2243
+ # immediately recreated. Each instance is recreated using the group's current
2244
+ # configuration. This operation is marked as DONE when the flag
2245
+ # is set even if the instances have not yet been recreated. You must
2246
+ # separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
2247
+ # the status of managed instances.
2248
+ #
2249
+ # If the group is part of a backend
2250
+ # service that has enabled
2251
+ # connection draining, it can take up to 60 seconds after the connection
2252
+ # draining duration has elapsed before the VM instance is removed or deleted.
2253
+ #
2254
+ # You can specify a maximum of 1000 instances with this method per request.
1660
2255
  #
1661
2256
  # @overload recreate_instances(request, options = nil)
1662
2257
  # Pass arguments to `recreate_instances` via a request object, either of type
@@ -1680,9 +2275,22 @@ module Google
1680
2275
  # @param project [::String]
1681
2276
  # Project ID for this request.
1682
2277
  # @param request_id [::String]
1683
- # 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).
2278
+ # An optional request ID to identify requests. Specify a unique request ID so
2279
+ # that if you must retry your request, the server will know to ignore the
2280
+ # request if it has already been completed.
2281
+ #
2282
+ # For example, consider a situation where you make an initial request and
2283
+ # the request times out. If you make the request again with the same
2284
+ # request ID, the server can check if original operation with the same
2285
+ # request ID was received, and if so, will ignore the second request. This
2286
+ # prevents clients from accidentally creating duplicate commitments.
2287
+ #
2288
+ # The request ID must be
2289
+ # a valid UUID with the exception that zero UUID is not supported
2290
+ # (00000000-0000-0000-0000-000000000000).
1684
2291
  # @param zone [::String]
1685
- # The name of the zone where the managed instance group is located.
2292
+ # The name of thezone where the managed
2293
+ # instance group is located.
1686
2294
  # @yield [result, operation] Access the result along with the TransportOperation object
1687
2295
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1688
2296
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1752,7 +2360,29 @@ module Google
1752
2360
  end
1753
2361
 
1754
2362
  ##
1755
- # Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
2363
+ # Resizes the managed instance group. If you increase the size, the group
2364
+ # creates new instances using the current instance template. If you decrease
2365
+ # the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
2366
+ # has not yet added or deleted any instances. You must separately
2367
+ # verify the status of the creating or deleting
2368
+ # actions with thelistmanagedinstances
2369
+ # method.
2370
+ #
2371
+ # When resizing down, the instance group arbitrarily chooses the order in
2372
+ # which VMs are deleted. The group takes into account some VM attributes when
2373
+ # making the selection including:
2374
+ #
2375
+ # + The status of the VM instance.
2376
+ # + The health of the VM instance.
2377
+ # + The instance template version the VM is based on.
2378
+ # + For regional managed instance groups, the location of the VM instance.
2379
+ #
2380
+ # This list is subject to change.
2381
+ #
2382
+ # If the group is part of a backend
2383
+ # service that has enabled
2384
+ # connection draining, it can take up to 60 seconds after the connection
2385
+ # draining duration has elapsed before the VM instance is removed or deleted.
1756
2386
  #
1757
2387
  # @overload resize(request, options = nil)
1758
2388
  # Pass arguments to `resize` via a request object, either of type
@@ -1774,11 +2404,26 @@ module Google
1774
2404
  # @param project [::String]
1775
2405
  # Project ID for this request.
1776
2406
  # @param request_id [::String]
1777
- # 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).
2407
+ # An optional request ID to identify requests. Specify a unique request ID so
2408
+ # that if you must retry your request, the server will know to ignore the
2409
+ # request if it has already been completed.
2410
+ #
2411
+ # For example, consider a situation where you make an initial request and
2412
+ # the request times out. If you make the request again with the same
2413
+ # request ID, the server can check if original operation with the same
2414
+ # request ID was received, and if so, will ignore the second request. This
2415
+ # prevents clients from accidentally creating duplicate commitments.
2416
+ #
2417
+ # The request ID must be
2418
+ # a valid UUID with the exception that zero UUID is not supported
2419
+ # (00000000-0000-0000-0000-000000000000).
1778
2420
  # @param size [::Integer]
1779
- # The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter.
2421
+ # The number of running instances that the managed instance group should
2422
+ # maintain at any given time. The group automatically adds or removes
2423
+ # instances to maintain the number of instances specified by this parameter.
1780
2424
  # @param zone [::String]
1781
- # The name of the zone where the managed instance group is located.
2425
+ # The name of thezone where the managed
2426
+ # instance group is located.
1782
2427
  # @yield [result, operation] Access the result along with the TransportOperation object
1783
2428
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1784
2429
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1848,7 +2493,22 @@ module Google
1848
2493
  end
1849
2494
 
1850
2495
  ##
1851
- # Flags the specified instances in the managed instance group to be resumed. This method increases the targetSize and decreases the targetSuspendedSize of the managed instance group by the number of instances that you resume. The resumeInstances operation is marked DONE if the resumeInstances request is successful. The underlying actions take additional time. You must separately verify the status of the RESUMING action with the listmanagedinstances method. In this request, you can only specify instances that are suspended. For example, if an instance was previously suspended using the suspendInstances method, it can be resumed using the resumeInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are resumed. You can specify a maximum of 1000 instances with this method per request.
2496
+ # Flags the specified instances in the managed instance group to be
2497
+ # resumed. This method increases thetargetSize and decreases the targetSuspendedSize
2498
+ # of the managed instance group by the number of instances that you resume.
2499
+ # The resumeInstances operation is marked DONE if
2500
+ # the resumeInstances request is successful. The underlying
2501
+ # actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
2502
+ # method.
2503
+ #
2504
+ # In this request, you can only specify instances that are suspended. For
2505
+ # example, if an instance was previously suspended using the suspendInstances
2506
+ # method, it can be resumed using the resumeInstances method.
2507
+ #
2508
+ # If a health check is attached to the managed instance group, the specified
2509
+ # instances will be verified as healthy after they are resumed.
2510
+ #
2511
+ # You can specify a maximum of 1000 instances with this method per request.
1852
2512
  #
1853
2513
  # @overload resume_instances(request, options = nil)
1854
2514
  # Pass arguments to `resume_instances` via a request object, either of type
@@ -1872,9 +2532,22 @@ module Google
1872
2532
  # @param project [::String]
1873
2533
  # Project ID for this request.
1874
2534
  # @param request_id [::String]
1875
- # 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).
2535
+ # An optional request ID to identify requests. Specify a unique request ID so
2536
+ # that if you must retry your request, the server will know to ignore the
2537
+ # request if it has already been completed.
2538
+ #
2539
+ # For example, consider a situation where you make an initial request and
2540
+ # the request times out. If you make the request again with the same
2541
+ # request ID, the server can check if original operation with the same
2542
+ # request ID was received, and if so, will ignore the second request. This
2543
+ # prevents clients from accidentally creating duplicate commitments.
2544
+ #
2545
+ # The request ID must be
2546
+ # a valid UUID with the exception that zero UUID is not supported
2547
+ # (00000000-0000-0000-0000-000000000000).
1876
2548
  # @param zone [::String]
1877
- # The name of the zone where the managed instance group is located.
2549
+ # The name of thezone where the managed
2550
+ # instance group is located.
1878
2551
  # @yield [result, operation] Access the result along with the TransportOperation object
1879
2552
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1880
2553
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1944,7 +2617,9 @@ module Google
1944
2617
  end
1945
2618
 
1946
2619
  ##
1947
- # Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
2620
+ # Specifies the instance template to use when creating new instances in this
2621
+ # group. The templates for existing instances in the group do not change
2622
+ # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group'supdatePolicy.type to PROACTIVE.
1948
2623
  #
1949
2624
  # @overload set_instance_template(request, options = nil)
1950
2625
  # Pass arguments to `set_instance_template` via a request object, either of type
@@ -1968,9 +2643,22 @@ module Google
1968
2643
  # @param project [::String]
1969
2644
  # Project ID for this request.
1970
2645
  # @param request_id [::String]
1971
- # 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).
2646
+ # An optional request ID to identify requests. Specify a unique request ID so
2647
+ # that if you must retry your request, the server will know to ignore the
2648
+ # request if it has already been completed.
2649
+ #
2650
+ # For example, consider a situation where you make an initial request and
2651
+ # the request times out. If you make the request again with the same
2652
+ # request ID, the server can check if original operation with the same
2653
+ # request ID was received, and if so, will ignore the second request. This
2654
+ # prevents clients from accidentally creating duplicate commitments.
2655
+ #
2656
+ # The request ID must be
2657
+ # a valid UUID with the exception that zero UUID is not supported
2658
+ # (00000000-0000-0000-0000-000000000000).
1972
2659
  # @param zone [::String]
1973
- # The name of the zone where the managed instance group is located.
2660
+ # The name of thezone where the managed
2661
+ # instance group is located.
1974
2662
  # @yield [result, operation] Access the result along with the TransportOperation object
1975
2663
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1976
2664
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2040,7 +2728,12 @@ module Google
2040
2728
  end
2041
2729
 
2042
2730
  ##
2043
- # Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group.
2731
+ # Modifies the target pools to which all instances in this managed instance
2732
+ # group are assigned. The target pools automatically apply to all of the
2733
+ # instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not
2734
+ # yet been added to their target pools. The change might take some time to
2735
+ # apply to all of the instances in the group depending on the size of the
2736
+ # group.
2044
2737
  #
2045
2738
  # @overload set_target_pools(request, options = nil)
2046
2739
  # Pass arguments to `set_target_pools` via a request object, either of type
@@ -2064,9 +2757,22 @@ module Google
2064
2757
  # @param project [::String]
2065
2758
  # Project ID for this request.
2066
2759
  # @param request_id [::String]
2067
- # 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).
2760
+ # An optional request ID to identify requests. Specify a unique request ID so
2761
+ # that if you must retry your request, the server will know to ignore the
2762
+ # request if it has already been completed.
2763
+ #
2764
+ # For example, consider a situation where you make an initial request and
2765
+ # the request times out. If you make the request again with the same
2766
+ # request ID, the server can check if original operation with the same
2767
+ # request ID was received, and if so, will ignore the second request. This
2768
+ # prevents clients from accidentally creating duplicate commitments.
2769
+ #
2770
+ # The request ID must be
2771
+ # a valid UUID with the exception that zero UUID is not supported
2772
+ # (00000000-0000-0000-0000-000000000000).
2068
2773
  # @param zone [::String]
2069
- # The name of the zone where the managed instance group is located.
2774
+ # The name of thezone where the managed
2775
+ # instance group is located.
2070
2776
  # @yield [result, operation] Access the result along with the TransportOperation object
2071
2777
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2072
2778
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2136,7 +2842,22 @@ module Google
2136
2842
  end
2137
2843
 
2138
2844
  ##
2139
- # Flags the specified instances in the managed instance group to be started. This method increases the targetSize and decreases the targetStoppedSize of the managed instance group by the number of instances that you start. The startInstances operation is marked DONE if the startInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STARTING action with the listmanagedinstances method. In this request, you can only specify instances that are stopped. For example, if an instance was previously stopped using the stopInstances method, it can be started using the startInstances method. If a health check is attached to the managed instance group, the specified instances will be verified as healthy after they are started. You can specify a maximum of 1000 instances with this method per request.
2845
+ # Flags the specified instances in the managed instance group to be
2846
+ # started. This method increases thetargetSize and decreases the targetStoppedSize
2847
+ # of the managed instance group by the number of instances that you start.
2848
+ # The startInstances operation is marked DONE if
2849
+ # the startInstances request is successful. The underlying
2850
+ # actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
2851
+ # method.
2852
+ #
2853
+ # In this request, you can only specify instances that are stopped. For
2854
+ # example, if an instance was previously stopped using the stopInstances
2855
+ # method, it can be started using the startInstances method.
2856
+ #
2857
+ # If a health check is attached to the managed instance group, the specified
2858
+ # instances will be verified as healthy after they are started.
2859
+ #
2860
+ # You can specify a maximum of 1000 instances with this method per request.
2140
2861
  #
2141
2862
  # @overload start_instances(request, options = nil)
2142
2863
  # Pass arguments to `start_instances` via a request object, either of type
@@ -2160,9 +2881,22 @@ module Google
2160
2881
  # @param project [::String]
2161
2882
  # Project ID for this request.
2162
2883
  # @param request_id [::String]
2163
- # 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).
2884
+ # An optional request ID to identify requests. Specify a unique request ID so
2885
+ # that if you must retry your request, the server will know to ignore the
2886
+ # request if it has already been completed.
2887
+ #
2888
+ # For example, consider a situation where you make an initial request and
2889
+ # the request times out. If you make the request again with the same
2890
+ # request ID, the server can check if original operation with the same
2891
+ # request ID was received, and if so, will ignore the second request. This
2892
+ # prevents clients from accidentally creating duplicate commitments.
2893
+ #
2894
+ # The request ID must be
2895
+ # a valid UUID with the exception that zero UUID is not supported
2896
+ # (00000000-0000-0000-0000-000000000000).
2164
2897
  # @param zone [::String]
2165
- # The name of the zone where the managed instance group is located.
2898
+ # The name of thezone where the managed
2899
+ # instance group is located.
2166
2900
  # @yield [result, operation] Access the result along with the TransportOperation object
2167
2901
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2168
2902
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2232,7 +2966,31 @@ module Google
2232
2966
  end
2233
2967
 
2234
2968
  ##
2235
- # Flags the specified instances in the managed instance group to be immediately stopped. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetStoppedSize of the managed instance group by the number of instances that you stop. The stopInstances operation is marked DONE if the stopInstances request is successful. The underlying actions take additional time. You must separately verify the status of the STOPPING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays stopping the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is stopped. Stopped instances can be started using the startInstances method. You can specify a maximum of 1000 instances with this method per request.
2969
+ # Flags the specified instances in the managed instance group to be
2970
+ # immediately stopped. You can only specify instances that are running in
2971
+ # this request. This method reduces thetargetSize and increases the targetStoppedSize
2972
+ # of the managed instance group by the number of instances that you stop.
2973
+ # The stopInstances operation is marked DONE if
2974
+ # the stopInstances request is successful. The underlying
2975
+ # actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
2976
+ # method.
2977
+ #
2978
+ # If the standbyPolicy.initialDelaySec field is set, the group
2979
+ # delays stopping the instances until initialDelaySec have
2980
+ # passed from instance.creationTimestamp (that is, when the
2981
+ # instance was created). This delay gives your application time to
2982
+ # set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
2983
+ # will be zero delay.
2984
+ #
2985
+ # If the group is part of a backend
2986
+ # service that has enabled
2987
+ # connection draining, it can take up to 60 seconds after the connection
2988
+ # draining duration has elapsed before the VM instance is stopped.
2989
+ #
2990
+ # Stopped instances can be started using the startInstances
2991
+ # method.
2992
+ #
2993
+ # You can specify a maximum of 1000 instances with this method per request.
2236
2994
  #
2237
2995
  # @overload stop_instances(request, options = nil)
2238
2996
  # Pass arguments to `stop_instances` via a request object, either of type
@@ -2256,9 +3014,22 @@ module Google
2256
3014
  # @param project [::String]
2257
3015
  # Project ID for this request.
2258
3016
  # @param request_id [::String]
2259
- # 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).
3017
+ # An optional request ID to identify requests. Specify a unique request ID so
3018
+ # that if you must retry your request, the server will know to ignore the
3019
+ # request if it has already been completed.
3020
+ #
3021
+ # For example, consider a situation where you make an initial request and
3022
+ # the request times out. If you make the request again with the same
3023
+ # request ID, the server can check if original operation with the same
3024
+ # request ID was received, and if so, will ignore the second request. This
3025
+ # prevents clients from accidentally creating duplicate commitments.
3026
+ #
3027
+ # The request ID must be
3028
+ # a valid UUID with the exception that zero UUID is not supported
3029
+ # (00000000-0000-0000-0000-000000000000).
2260
3030
  # @param zone [::String]
2261
- # The name of the zone where the managed instance group is located.
3031
+ # The name of thezone where the managed
3032
+ # instance group is located.
2262
3033
  # @yield [result, operation] Access the result along with the TransportOperation object
2263
3034
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2264
3035
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2328,7 +3099,31 @@ module Google
2328
3099
  end
2329
3100
 
2330
3101
  ##
2331
- # Flags the specified instances in the managed instance group to be immediately suspended. You can only specify instances that are running in this request. This method reduces the targetSize and increases the targetSuspendedSize of the managed instance group by the number of instances that you suspend. The suspendInstances operation is marked DONE if the suspendInstances request is successful. The underlying actions take additional time. You must separately verify the status of the SUSPENDING action with the listmanagedinstances method. If the standbyPolicy.initialDelaySec field is set, the group delays suspension of the instances until initialDelaySec have passed from instance.creationTimestamp (that is, when the instance was created). This delay gives your application time to set itself up and initialize on the instance. If more than initialDelaySec seconds have passed since instance.creationTimestamp when this method is called, there will be zero delay. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is suspended. Suspended instances can be resumed using the resumeInstances method. You can specify a maximum of 1000 instances with this method per request.
3102
+ # Flags the specified instances in the managed instance group to be
3103
+ # immediately suspended. You can only specify instances that are running in
3104
+ # this request. This method reduces thetargetSize and increases the targetSuspendedSize
3105
+ # of the managed instance group by the number of instances that you suspend.
3106
+ # The suspendInstances operation is marked DONE if
3107
+ # the suspendInstances request is successful. The underlying
3108
+ # actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
3109
+ # method.
3110
+ #
3111
+ # If the standbyPolicy.initialDelaySec field is set, the group
3112
+ # delays suspension of the instances until initialDelaySec have
3113
+ # passed from instance.creationTimestamp (that is, when the
3114
+ # instance was created). This delay gives your application time to
3115
+ # set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
3116
+ # will be zero delay.
3117
+ #
3118
+ # If the group is part of a backend
3119
+ # service that has enabled
3120
+ # connection draining, it can take up to 60 seconds after the connection
3121
+ # draining duration has elapsed before the VM instance is suspended.
3122
+ #
3123
+ # Suspended instances can be resumed using the resumeInstances
3124
+ # method.
3125
+ #
3126
+ # You can specify a maximum of 1000 instances with this method per request.
2332
3127
  #
2333
3128
  # @overload suspend_instances(request, options = nil)
2334
3129
  # Pass arguments to `suspend_instances` via a request object, either of type
@@ -2352,9 +3147,22 @@ module Google
2352
3147
  # @param project [::String]
2353
3148
  # Project ID for this request.
2354
3149
  # @param request_id [::String]
2355
- # 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).
3150
+ # An optional request ID to identify requests. Specify a unique request ID so
3151
+ # that if you must retry your request, the server will know to ignore the
3152
+ # request if it has already been completed.
3153
+ #
3154
+ # For example, consider a situation where you make an initial request and
3155
+ # the request times out. If you make the request again with the same
3156
+ # request ID, the server can check if original operation with the same
3157
+ # request ID was received, and if so, will ignore the second request. This
3158
+ # prevents clients from accidentally creating duplicate commitments.
3159
+ #
3160
+ # The request ID must be
3161
+ # a valid UUID with the exception that zero UUID is not supported
3162
+ # (00000000-0000-0000-0000-000000000000).
2356
3163
  # @param zone [::String]
2357
- # The name of the zone where the managed instance group is located.
3164
+ # The name of thezone where the managed
3165
+ # instance group is located.
2358
3166
  # @yield [result, operation] Access the result along with the TransportOperation object
2359
3167
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2360
3168
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2424,7 +3232,9 @@ module Google
2424
3232
  end
2425
3233
 
2426
3234
  ##
2427
- # Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.
3235
+ # Inserts or updates per-instance configurations for the managed instance
3236
+ # group. perInstanceConfig.name serves as a key used to
3237
+ # distinguish whether to perform insert or patch.
2428
3238
  #
2429
3239
  # @overload update_per_instance_configs(request, options = nil)
2430
3240
  # Pass arguments to `update_per_instance_configs` via a request object, either of type
@@ -2442,15 +3252,30 @@ module Google
2442
3252
  # the default parameter values, pass an empty Hash as a request object (see above).
2443
3253
  #
2444
3254
  # @param instance_group_manager [::String]
2445
- # The name of the managed instance group. It should conform to RFC1035.
3255
+ # The name of the managed instance group.
3256
+ # It should conform to RFC1035.
2446
3257
  # @param instance_group_managers_update_per_instance_configs_req_resource [::Google::Cloud::Compute::V1::InstanceGroupManagersUpdatePerInstanceConfigsReq, ::Hash]
2447
3258
  # The body resource for this request
2448
3259
  # @param project [::String]
2449
3260
  # Project ID for this request.
2450
3261
  # @param request_id [::String]
2451
- # 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).
3262
+ # An optional request ID to identify requests. Specify a unique request ID so
3263
+ # that if you must retry your request, the server will know to ignore the
3264
+ # request if it has already been completed.
3265
+ #
3266
+ # For example, consider a situation where you make an initial request and
3267
+ # the request times out. If you make the request again with the same
3268
+ # request ID, the server can check if original operation with the same
3269
+ # request ID was received, and if so, will ignore the second request. This
3270
+ # prevents clients from accidentally creating duplicate commitments.
3271
+ #
3272
+ # The request ID must be
3273
+ # a valid UUID with the exception that zero UUID is not supported
3274
+ # (00000000-0000-0000-0000-000000000000).
2452
3275
  # @param zone [::String]
2453
- # The name of the zone where the managed instance group is located. It should conform to RFC1035.
3276
+ # The name of thezone
3277
+ # where the managed instance group is located.
3278
+ # It should conform to RFC1035.
2454
3279
  # @yield [result, operation] Access the result along with the TransportOperation object
2455
3280
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2456
3281
  # @yieldparam operation [::Gapic::Rest::TransportOperation]