google-cloud-compute-v1 3.3.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 (182) 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 +330 -20
  4. data/lib/google/cloud/compute/v1/addresses/rest/service_stub.rb +64 -0
  5. data/lib/google/cloud/compute/v1/advice/credentials.rb +52 -0
  6. data/lib/google/cloud/compute/v1/advice/rest/client.rb +431 -0
  7. data/lib/google/cloud/compute/v1/advice/rest/service_stub.rb +144 -0
  8. data/lib/google/cloud/compute/v1/advice/rest.rb +51 -0
  9. data/lib/google/cloud/compute/v1/advice.rb +47 -0
  10. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +334 -21
  11. data/lib/google/cloud/compute/v1/autoscalers/rest/service_stub.rb +64 -0
  12. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +198 -23
  13. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +499 -40
  14. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +62 -0
  15. data/lib/google/cloud/compute/v1/compute_pb.rb +281 -25
  16. data/lib/google/cloud/compute/v1/cross_site_networks/credentials.rb +52 -0
  17. data/lib/google/cloud/compute/v1/cross_site_networks/rest/client.rb +975 -0
  18. data/lib/google/cloud/compute/v1/cross_site_networks/rest/service_stub.rb +391 -0
  19. data/lib/google/cloud/compute/v1/cross_site_networks/rest.rb +51 -0
  20. data/lib/google/cloud/compute/v1/cross_site_networks.rb +47 -0
  21. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +181 -14
  22. data/lib/google/cloud/compute/v1/disks/rest/client.rb +390 -42
  23. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +118 -11
  24. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +240 -25
  25. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +238 -13
  26. data/lib/google/cloud/compute/v1/firewalls/rest/service_stub.rb +63 -0
  27. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +258 -23
  28. data/lib/google/cloud/compute/v1/future_reservations/credentials.rb +52 -0
  29. data/lib/google/cloud/compute/v1/future_reservations/rest/client.rb +1287 -0
  30. data/lib/google/cloud/compute/v1/future_reservations/rest/service_stub.rb +520 -0
  31. data/lib/google/cloud/compute/v1/future_reservations/rest.rb +51 -0
  32. data/lib/google/cloud/compute/v1/future_reservations.rb +47 -0
  33. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +217 -10
  34. data/lib/google/cloud/compute/v1/global_addresses/rest/service_stub.rb +63 -0
  35. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +151 -15
  36. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +246 -21
  37. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +203 -18
  38. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +91 -9
  39. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +128 -10
  40. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +333 -21
  41. data/lib/google/cloud/compute/v1/health_checks/rest/service_stub.rb +63 -0
  42. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +2 -1
  43. data/lib/google/cloud/compute/v1/images/rest/client.rb +161 -18
  44. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/client.rb +159 -24
  45. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +920 -95
  46. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +473 -40
  47. data/lib/google/cloud/compute/v1/instance_groups/rest/service_stub.rb +64 -0
  48. data/lib/google/cloud/compute/v1/instance_settings_service/rest/client.rb +13 -1
  49. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +220 -20
  50. data/lib/google/cloud/compute/v1/instances/rest/client.rb +1144 -99
  51. data/lib/google/cloud/compute/v1/instances/rest/service_stub.rb +127 -0
  52. data/lib/google/cloud/compute/v1/instant_snapshots/rest/client.rb +235 -21
  53. data/lib/google/cloud/compute/v1/interconnect_attachment_groups/rest/client.rb +139 -14
  54. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +242 -21
  55. data/lib/google/cloud/compute/v1/interconnect_groups/rest/client.rb +139 -14
  56. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +87 -7
  57. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/client.rb +87 -7
  58. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +145 -14
  59. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +9 -2
  60. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +161 -16
  61. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +124 -13
  62. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +181 -14
  63. data/lib/google/cloud/compute/v1/network_attachments/rest/client.rb +232 -20
  64. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/client.rb +138 -12
  65. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +361 -37
  66. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/client.rb +354 -33
  67. data/lib/google/cloud/compute/v1/network_profiles/rest/client.rb +85 -6
  68. data/lib/google/cloud/compute/v1/networks/rest/client.rb +281 -23
  69. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +381 -32
  70. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +213 -19
  71. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +181 -14
  72. data/lib/google/cloud/compute/v1/organization_security_policies/credentials.rb +52 -0
  73. data/lib/google/cloud/compute/v1/organization_security_policies/rest/client.rb +2259 -0
  74. data/lib/google/cloud/compute/v1/organization_security_policies/rest/service_stub.rb +1054 -0
  75. data/lib/google/cloud/compute/v1/organization_security_policies/rest.rb +51 -0
  76. data/lib/google/cloud/compute/v1/organization_security_policies.rb +47 -0
  77. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +226 -19
  78. data/lib/google/cloud/compute/v1/preview_features/credentials.rb +52 -0
  79. data/lib/google/cloud/compute/v1/preview_features/rest/client.rb +739 -0
  80. data/lib/google/cloud/compute/v1/preview_features/rest/service_stub.rb +267 -0
  81. data/lib/google/cloud/compute/v1/preview_features/rest.rb +51 -0
  82. data/lib/google/cloud/compute/v1/preview_features.rb +47 -0
  83. data/lib/google/cloud/compute/v1/projects/rest/client.rb +346 -30
  84. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +154 -12
  85. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +255 -22
  86. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +238 -13
  87. data/lib/google/cloud/compute/v1/region_autoscalers/rest/service_stub.rb +64 -0
  88. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +260 -26
  89. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +212 -18
  90. data/lib/google/cloud/compute/v1/region_composite_health_checks/credentials.rb +52 -0
  91. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/client.rb +1268 -0
  92. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/service_stub.rb +521 -0
  93. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest.rb +51 -0
  94. data/lib/google/cloud/compute/v1/region_composite_health_checks.rb +47 -0
  95. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +83 -5
  96. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +269 -29
  97. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/credentials.rb +52 -0
  98. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/client.rb +1268 -0
  99. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/service_stub.rb +521 -0
  100. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest.rb +51 -0
  101. data/lib/google/cloud/compute/v1/region_health_aggregation_policies.rb +47 -0
  102. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +427 -17
  103. data/lib/google/cloud/compute/v1/region_health_check_services/rest/service_stub.rb +125 -0
  104. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +238 -13
  105. data/lib/google/cloud/compute/v1/region_health_checks/rest/service_stub.rb +64 -0
  106. data/lib/google/cloud/compute/v1/region_health_sources/credentials.rb +52 -0
  107. data/lib/google/cloud/compute/v1/region_health_sources/rest/client.rb +1268 -0
  108. data/lib/google/cloud/compute/v1/region_health_sources/rest/service_stub.rb +521 -0
  109. data/lib/google/cloud/compute/v1/region_health_sources/rest.rb +51 -0
  110. data/lib/google/cloud/compute/v1/region_health_sources.rb +47 -0
  111. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +750 -64
  112. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +280 -14
  113. data/lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb +64 -0
  114. data/lib/google/cloud/compute/v1/region_instance_templates/rest/client.rb +115 -10
  115. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +15 -2
  116. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/client.rb +139 -13
  117. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +264 -28
  118. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/client.rb +213 -20
  119. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +399 -11
  120. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/service_stub.rb +125 -0
  121. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +107 -10
  122. data/lib/google/cloud/compute/v1/region_security_policies/rest/client.rb +149 -14
  123. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +116 -10
  124. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/client.rb +220 -20
  125. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +126 -10
  126. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +158 -14
  127. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/client.rb +113 -9
  128. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +104 -14
  129. data/lib/google/cloud/compute/v1/region_zones/rest/client.rb +85 -6
  130. data/lib/google/cloud/compute/v1/regions/rest/client.rb +120 -7
  131. data/lib/google/cloud/compute/v1/reservation_blocks/rest/client.rb +396 -11
  132. data/lib/google/cloud/compute/v1/reservation_blocks/rest/service_stub.rb +194 -0
  133. data/lib/google/cloud/compute/v1/reservation_slots/credentials.rb +52 -0
  134. data/lib/google/cloud/compute/v1/reservation_slots/rest/client.rb +863 -0
  135. data/lib/google/cloud/compute/v1/reservation_slots/rest/service_stub.rb +338 -0
  136. data/lib/google/cloud/compute/v1/reservation_slots/rest.rb +51 -0
  137. data/lib/google/cloud/compute/v1/reservation_slots.rb +47 -0
  138. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/client.rb +642 -12
  139. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/service_stub.rb +327 -3
  140. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +257 -24
  141. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +224 -19
  142. data/lib/google/cloud/compute/v1/rest.rb +10 -0
  143. data/lib/google/cloud/compute/v1/routers/rest/client.rb +555 -50
  144. data/lib/google/cloud/compute/v1/routes/rest/client.rb +202 -8
  145. data/lib/google/cloud/compute/v1/routes/rest/service_stub.rb +63 -0
  146. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +316 -26
  147. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +234 -22
  148. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/client.rb +13 -1
  149. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +130 -13
  150. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +210 -17
  151. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +315 -27
  152. data/lib/google/cloud/compute/v1/storage_pool_types/rest/client.rb +181 -14
  153. data/lib/google/cloud/compute/v1/storage_pools/rest/client.rb +321 -28
  154. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +378 -34
  155. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +128 -10
  156. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +240 -20
  157. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +306 -30
  158. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +320 -20
  159. data/lib/google/cloud/compute/v1/target_instances/rest/service_stub.rb +64 -0
  160. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +387 -26
  161. data/lib/google/cloud/compute/v1/target_pools/rest/service_stub.rb +64 -0
  162. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +281 -19
  163. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/service_stub.rb +63 -0
  164. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +329 -20
  165. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/service_stub.rb +63 -0
  166. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +224 -19
  167. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +354 -24
  168. data/lib/google/cloud/compute/v1/url_maps/rest/service_stub.rb +63 -0
  169. data/lib/google/cloud/compute/v1/version.rb +1 -1
  170. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +224 -19
  171. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +224 -19
  172. data/lib/google/cloud/compute/v1/wire_groups/credentials.rb +52 -0
  173. data/lib/google/cloud/compute/v1/wire_groups/rest/client.rb +980 -0
  174. data/lib/google/cloud/compute/v1/wire_groups/rest/service_stub.rb +396 -0
  175. data/lib/google/cloud/compute/v1/wire_groups/rest.rb +51 -0
  176. data/lib/google/cloud/compute/v1/wire_groups.rb +47 -0
  177. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +106 -10
  178. data/lib/google/cloud/compute/v1/zones/rest/client.rb +83 -5
  179. data/lib/google/cloud/compute/v1.rb +10 -0
  180. data/proto_docs/google/api/client.rb +149 -29
  181. data/proto_docs/google/cloud/compute/v1/compute.rb +44226 -5514
  182. metadata +52 -2
@@ -245,7 +245,21 @@ module Google
245
245
  # Service calls
246
246
 
247
247
  ##
248
- # Flags the specified instances to be immediately 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.
248
+ # Flags the specified instances to be immediately removed from the managed
249
+ # instance group. Abandoning an instance does not delete the
250
+ # instance, but it does remove the instance from any target pools that are
251
+ # applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
252
+ # number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
253
+ # not yet been removed from the group. You must separately verify the
254
+ # status of the abandoning action with thelistmanagedinstances
255
+ # method.
256
+ #
257
+ # If the group is part of a backend
258
+ # service that has enabled
259
+ # connection draining, it can take up to 60 seconds after the connection
260
+ # draining duration has elapsed before the VM instance is removed or deleted.
261
+ #
262
+ # You can specify a maximum of 1000 instances with this method per request.
249
263
  #
250
264
  # @overload abandon_instances(request, options = nil)
251
265
  # Pass arguments to `abandon_instances` via a request object, either of type
@@ -271,7 +285,19 @@ module Google
271
285
  # @param region_instance_group_managers_abandon_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersAbandonInstancesRequest, ::Hash]
272
286
  # The body resource for this request
273
287
  # @param request_id [::String]
274
- # 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).
288
+ # An optional request ID to identify requests. Specify a unique request ID so
289
+ # that if you must retry your request, the server will know to ignore the
290
+ # request if it has already been completed.
291
+ #
292
+ # For example, consider a situation where you make an initial request and
293
+ # the request times out. If you make the request again with the same
294
+ # request ID, the server can check if original operation with the same
295
+ # request ID was received, and if so, will ignore the second request. This
296
+ # prevents clients from accidentally creating duplicate commitments.
297
+ #
298
+ # The request ID must be
299
+ # a valid UUID with the exception that zero UUID is not supported
300
+ # (00000000-0000-0000-0000-000000000000).
275
301
  # @yield [result, operation] Access the result along with the TransportOperation object
276
302
  # @yieldparam result [::Gapic::GenericLRO::Operation]
277
303
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -435,7 +461,12 @@ module Google
435
461
  end
436
462
 
437
463
  ##
438
- # Creates instances with per-instance configurations in this regional 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.
464
+ # Creates instances with per-instance configurations in this regional managed
465
+ # instance group. Instances are created using the current instance template.
466
+ # The create instances operation is marked DONE if
467
+ # the createInstances request is successful. The underlying
468
+ # actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
469
+ # method.
439
470
  #
440
471
  # @overload create_instances(request, options = nil)
441
472
  # Pass arguments to `create_instances` via a request object, either of type
@@ -453,15 +484,29 @@ module Google
453
484
  # the default parameter values, pass an empty Hash as a request object (see above).
454
485
  #
455
486
  # @param instance_group_manager [::String]
456
- # The name of the managed instance group. It should conform to RFC1035.
487
+ # The name of the managed instance group.
488
+ # It should conform to RFC1035.
457
489
  # @param project [::String]
458
490
  # Project ID for this request.
459
491
  # @param region [::String]
460
- # The name of the region where the managed instance group is located. It should conform to RFC1035.
492
+ # The name of theregion
493
+ # where the managed instance group is located.
494
+ # It should conform to RFC1035.
461
495
  # @param region_instance_group_managers_create_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersCreateInstancesRequest, ::Hash]
462
496
  # The body resource for this request
463
497
  # @param request_id [::String]
464
- # 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).
498
+ # An optional request ID to identify requests. Specify a unique request ID so
499
+ # that if you must retry your request, the server will know to ignore the
500
+ # request if it has already been completed.
501
+ #
502
+ # For example, consider a situation where you make an initial request and
503
+ # the request times out. If you make the request again with the same
504
+ # request ID, the server can check if original operation with the same
505
+ # request ID was received, and if so, will ignore the second request.
506
+ #
507
+ # The request ID must be
508
+ # a valid UUID with the exception that zero UUID is not supported
509
+ # (00000000-0000-0000-0000-000000000000).
465
510
  # @yield [result, operation] Access the result along with the TransportOperation object
466
511
  # @yieldparam result [::Gapic::GenericLRO::Operation]
467
512
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -531,7 +576,8 @@ module Google
531
576
  end
532
577
 
533
578
  ##
534
- # Deletes the specified managed instance group and all of the instances in that group.
579
+ # Deletes the specified managed instance group and all of the instances
580
+ # in that group.
535
581
  #
536
582
  # @overload delete(request, options = nil)
537
583
  # Pass arguments to `delete` via a request object, either of type
@@ -555,7 +601,19 @@ module Google
555
601
  # @param region [::String]
556
602
  # Name of the region scoping this request.
557
603
  # @param request_id [::String]
558
- # 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).
604
+ # An optional request ID to identify requests. Specify a unique request ID so
605
+ # that if you must retry your request, the server will know to ignore the
606
+ # request if it has already been completed.
607
+ #
608
+ # For example, consider a situation where you make an initial request and
609
+ # the request times out. If you make the request again with the same
610
+ # request ID, the server can check if original operation with the same
611
+ # request ID was received, and if so, will ignore the second request. This
612
+ # prevents clients from accidentally creating duplicate commitments.
613
+ #
614
+ # The request ID must be
615
+ # a valid UUID with the exception that zero UUID is not supported
616
+ # (00000000-0000-0000-0000-000000000000).
559
617
  # @yield [result, operation] Access the result along with the TransportOperation object
560
618
  # @yieldparam result [::Gapic::GenericLRO::Operation]
561
619
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -625,7 +683,21 @@ module Google
625
683
  end
626
684
 
627
685
  ##
628
- # Flags the specified instances in the managed instance group to be immediately deleted. 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. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. 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.
686
+ # Flags the specified instances in the managed instance group to be
687
+ # immediately deleted. The instances are also removed from any target
688
+ # pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
689
+ # instances that you delete.
690
+ # The deleteInstances operation is marked DONE if
691
+ # the deleteInstances request is successful. The underlying
692
+ # actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances
693
+ # method.
694
+ #
695
+ # If the group is part of a backend
696
+ # service that has enabled
697
+ # connection draining, it can take up to 60 seconds after the connection
698
+ # draining duration has elapsed before the VM instance is removed or deleted.
699
+ #
700
+ # You can specify a maximum of 1000 instances with this method per request.
629
701
  #
630
702
  # @overload delete_instances(request, options = nil)
631
703
  # Pass arguments to `delete_instances` via a request object, either of type
@@ -651,7 +723,19 @@ module Google
651
723
  # @param region_instance_group_managers_delete_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersDeleteInstancesRequest, ::Hash]
652
724
  # The body resource for this request
653
725
  # @param request_id [::String]
654
- # 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).
726
+ # An optional request ID to identify requests. Specify a unique request ID so
727
+ # that if you must retry your request, the server will know to ignore the
728
+ # request if it has already been completed.
729
+ #
730
+ # For example, consider a situation where you make an initial request and
731
+ # the request times out. If you make the request again with the same
732
+ # request ID, the server can check if original operation with the same
733
+ # request ID was received, and if so, will ignore the second request. This
734
+ # prevents clients from accidentally creating duplicate commitments.
735
+ #
736
+ # The request ID must be
737
+ # a valid UUID with the exception that zero UUID is not supported
738
+ # (00000000-0000-0000-0000-000000000000).
655
739
  # @yield [result, operation] Access the result along with the TransportOperation object
656
740
  # @yieldparam result [::Gapic::GenericLRO::Operation]
657
741
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -721,7 +805,8 @@ module Google
721
805
  end
722
806
 
723
807
  ##
724
- # Deletes selected per-instance configurations for the managed instance group.
808
+ # Deletes selected per-instance configurations for the managed instance
809
+ # group.
725
810
  #
726
811
  # @overload delete_per_instance_configs(request, options = nil)
727
812
  # Pass arguments to `delete_per_instance_configs` via a request object, either of type
@@ -897,7 +982,15 @@ module Google
897
982
  end
898
983
 
899
984
  ##
900
- # 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 regional managed instance group can contain up to 2000 instances.
985
+ # Creates a managed instance group using the information that you specify
986
+ # in the request. After the group is created, instances in the group are
987
+ # created using the specified instance template.
988
+ # This operation is marked as DONE when the group is created
989
+ # even if the instances in the group have not yet been created. You must
990
+ # separately verify the status of the individual instances with thelistmanagedinstances
991
+ # method.
992
+ #
993
+ # A regional managed instance group can contain up to 2000 instances.
901
994
  #
902
995
  # @overload insert(request, options = nil)
903
996
  # Pass arguments to `insert` via a request object, either of type
@@ -921,7 +1014,19 @@ module Google
921
1014
  # @param region [::String]
922
1015
  # Name of the region scoping this request.
923
1016
  # @param request_id [::String]
924
- # 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).
1017
+ # An optional request ID to identify requests. Specify a unique request ID so
1018
+ # that if you must retry your request, the server will know to ignore the
1019
+ # request if it has already been completed.
1020
+ #
1021
+ # For example, consider a situation where you make an initial request and
1022
+ # the request times out. If you make the request again with the same
1023
+ # request ID, the server can check if original operation with the same
1024
+ # request ID was received, and if so, will ignore the second request. This
1025
+ # prevents clients from accidentally creating duplicate commitments.
1026
+ #
1027
+ # The request ID must be
1028
+ # a valid UUID with the exception that zero UUID is not supported
1029
+ # (00000000-0000-0000-0000-000000000000).
925
1030
  # @yield [result, operation] Access the result along with the TransportOperation object
926
1031
  # @yieldparam result [::Gapic::GenericLRO::Operation]
927
1032
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -991,7 +1096,8 @@ module Google
991
1096
  end
992
1097
 
993
1098
  ##
994
- # Retrieves the list of managed instance groups that are contained within the specified region.
1099
+ # Retrieves the list of managed instance groups that are contained
1100
+ # within the specified region.
995
1101
  #
996
1102
  # @overload list(request, options = nil)
997
1103
  # Pass arguments to `list` via a request object, either of type
@@ -1009,19 +1115,97 @@ module Google
1009
1115
  # the default parameter values, pass an empty Hash as a request object (see above).
1010
1116
  #
1011
1117
  # @param filter [::String]
1012
- # 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.
1118
+ # A filter expression that filters resources listed in the response. Most
1119
+ # Compute resources support two types of filter expressions:
1120
+ # expressions that support regular expressions and expressions that follow
1121
+ # API improvement proposal AIP-160.
1122
+ # These two types of filter expressions cannot be mixed in one request.
1123
+ #
1124
+ # If you want to use AIP-160, your expression must specify the field name, an
1125
+ # operator, and the value that you want to use for filtering. The value
1126
+ # must be a string, a number, or a boolean. The operator
1127
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1128
+ #
1129
+ # For example, if you are filtering Compute Engine instances, you can
1130
+ # exclude instances named `example-instance` by specifying
1131
+ # `name != example-instance`.
1132
+ #
1133
+ # The `:*` comparison can be used to test whether a key has been defined.
1134
+ # For example, to find all objects with `owner` label use:
1135
+ # ```
1136
+ # labels.owner:*
1137
+ # ```
1138
+ #
1139
+ # You can also filter nested fields. For example, you could specify
1140
+ # `scheduling.automaticRestart = false` to include instances only
1141
+ # if they are not scheduled for automatic restarts. You can use filtering
1142
+ # on nested fields to filter based onresource labels.
1143
+ #
1144
+ # To filter on multiple expressions, provide each separate expression within
1145
+ # parentheses. For example:
1146
+ # ```
1147
+ # (scheduling.automaticRestart = true)
1148
+ # (cpuPlatform = "Intel Skylake")
1149
+ # ```
1150
+ # By default, each expression is an `AND` expression. However, you
1151
+ # can include `AND` and `OR` expressions explicitly.
1152
+ # For example:
1153
+ # ```
1154
+ # (cpuPlatform = "Intel Skylake") OR
1155
+ # (cpuPlatform = "Intel Broadwell") AND
1156
+ # (scheduling.automaticRestart = true)
1157
+ # ```
1158
+ #
1159
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1160
+ # (not equal) operator against a single un-parenthesized expression with or
1161
+ # without quotes or against multiple parenthesized expressions. Examples:
1162
+ #
1163
+ # `fieldname eq unquoted literal`
1164
+ # `fieldname eq 'single quoted literal'`
1165
+ # `fieldname eq "double quoted literal"`
1166
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1167
+ #
1168
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1169
+ # The literal value must match the entire field.
1170
+ #
1171
+ # For example, to filter for instances that do not end with name "instance",
1172
+ # you would use `name ne .*instance`.
1173
+ #
1174
+ # You cannot combine constraints on multiple fields using regular
1175
+ # expressions.
1013
1176
  # @param max_results [::Integer]
1014
- # 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`)
1177
+ # The maximum number of results per page that should be returned.
1178
+ # If the number of available results is larger than `maxResults`,
1179
+ # Compute Engine returns a `nextPageToken` that can be used to get
1180
+ # the next page of results in subsequent list requests. Acceptable values are
1181
+ # `0` to `500`, inclusive. (Default: `500`)
1015
1182
  # @param order_by [::String]
1016
- # 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.
1183
+ # Sorts list results by a certain order. By default, results
1184
+ # are returned in alphanumerical order based on the resource name.
1185
+ #
1186
+ # You can also sort results in descending order based on the creation
1187
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1188
+ # results based on the `creationTimestamp` field in
1189
+ # reverse chronological order (newest result first). Use this to sort
1190
+ # resources like operations so that the newest operation is returned first.
1191
+ #
1192
+ # Currently, only sorting by `name` or
1193
+ # `creationTimestamp desc` is supported.
1017
1194
  # @param page_token [::String]
1018
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1195
+ # Specifies a page token to use. Set `pageToken` to the
1196
+ # `nextPageToken` returned by a previous list request to get
1197
+ # the next page of results.
1019
1198
  # @param project [::String]
1020
1199
  # Project ID for this request.
1021
1200
  # @param region [::String]
1022
1201
  # Name of the region scoping this request.
1023
1202
  # @param return_partial_success [::Boolean]
1024
- # 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.
1203
+ # Opt-in for partial success behavior which provides partial results in case
1204
+ # of failure. The default value is false.
1205
+ #
1206
+ # For example, when partial success behavior is enabled, aggregatedList for a
1207
+ # single zone scope either returns all resources in the zone or no resources,
1208
+ # with an error code.
1025
1209
  # @yield [result, operation] Access the result along with the TransportOperation object
1026
1210
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::InstanceGroupManager>]
1027
1211
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1083,7 +1267,8 @@ module Google
1083
1267
  end
1084
1268
 
1085
1269
  ##
1086
- # Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported.
1270
+ # Lists all errors thrown by actions on instances for a given regional
1271
+ # managed instance group. The filter andorderBy query parameters are not supported.
1087
1272
  #
1088
1273
  # @overload list_errors(request, options = nil)
1089
1274
  # Pass arguments to `list_errors` via a request object, either of type
@@ -1101,21 +1286,103 @@ module Google
1101
1286
  # the default parameter values, pass an empty Hash as a request object (see above).
1102
1287
  #
1103
1288
  # @param filter [::String]
1104
- # 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.
1289
+ # A filter expression that filters resources listed in the response. Most
1290
+ # Compute resources support two types of filter expressions:
1291
+ # expressions that support regular expressions and expressions that follow
1292
+ # API improvement proposal AIP-160.
1293
+ # These two types of filter expressions cannot be mixed in one request.
1294
+ #
1295
+ # If you want to use AIP-160, your expression must specify the field name, an
1296
+ # operator, and the value that you want to use for filtering. The value
1297
+ # must be a string, a number, or a boolean. The operator
1298
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1299
+ #
1300
+ # For example, if you are filtering Compute Engine instances, you can
1301
+ # exclude instances named `example-instance` by specifying
1302
+ # `name != example-instance`.
1303
+ #
1304
+ # The `:*` comparison can be used to test whether a key has been defined.
1305
+ # For example, to find all objects with `owner` label use:
1306
+ # ```
1307
+ # labels.owner:*
1308
+ # ```
1309
+ #
1310
+ # You can also filter nested fields. For example, you could specify
1311
+ # `scheduling.automaticRestart = false` to include instances only
1312
+ # if they are not scheduled for automatic restarts. You can use filtering
1313
+ # on nested fields to filter based onresource labels.
1314
+ #
1315
+ # To filter on multiple expressions, provide each separate expression within
1316
+ # parentheses. For example:
1317
+ # ```
1318
+ # (scheduling.automaticRestart = true)
1319
+ # (cpuPlatform = "Intel Skylake")
1320
+ # ```
1321
+ # By default, each expression is an `AND` expression. However, you
1322
+ # can include `AND` and `OR` expressions explicitly.
1323
+ # For example:
1324
+ # ```
1325
+ # (cpuPlatform = "Intel Skylake") OR
1326
+ # (cpuPlatform = "Intel Broadwell") AND
1327
+ # (scheduling.automaticRestart = true)
1328
+ # ```
1329
+ #
1330
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1331
+ # (not equal) operator against a single un-parenthesized expression with or
1332
+ # without quotes or against multiple parenthesized expressions. Examples:
1333
+ #
1334
+ # `fieldname eq unquoted literal`
1335
+ # `fieldname eq 'single quoted literal'`
1336
+ # `fieldname eq "double quoted literal"`
1337
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1338
+ #
1339
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1340
+ # The literal value must match the entire field.
1341
+ #
1342
+ # For example, to filter for instances that do not end with name "instance",
1343
+ # you would use `name ne .*instance`.
1344
+ #
1345
+ # You cannot combine constraints on multiple fields using regular
1346
+ # expressions.
1105
1347
  # @param instance_group_manager [::String]
1106
- # 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}.
1348
+ # The name of the managed instance group.
1349
+ # It must be a string that meets the requirements in RFC1035, or an
1350
+ # unsigned long integer: must match regexp pattern:
1351
+ # (?:[a-z](?:[-a-z0-9]\\{0,61}[a-z0-9])?)|1-9\\{0,19}.
1107
1352
  # @param max_results [::Integer]
1108
- # 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`)
1353
+ # The maximum number of results per page that should be returned.
1354
+ # If the number of available results is larger than `maxResults`,
1355
+ # Compute Engine returns a `nextPageToken` that can be used to get
1356
+ # the next page of results in subsequent list requests. Acceptable values are
1357
+ # `0` to `500`, inclusive. (Default: `500`)
1109
1358
  # @param order_by [::String]
1110
- # 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.
1359
+ # Sorts list results by a certain order. By default, results
1360
+ # are returned in alphanumerical order based on the resource name.
1361
+ #
1362
+ # You can also sort results in descending order based on the creation
1363
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1364
+ # results based on the `creationTimestamp` field in
1365
+ # reverse chronological order (newest result first). Use this to sort
1366
+ # resources like operations so that the newest operation is returned first.
1367
+ #
1368
+ # Currently, only sorting by `name` or
1369
+ # `creationTimestamp desc` is supported.
1111
1370
  # @param page_token [::String]
1112
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1371
+ # Specifies a page token to use. Set `pageToken` to the
1372
+ # `nextPageToken` returned by a previous list request to get
1373
+ # the next page of results.
1113
1374
  # @param project [::String]
1114
1375
  # Project ID for this request.
1115
1376
  # @param region [::String]
1116
- # Name of the region scoping this request. This should conform to RFC1035.
1377
+ # Name of the region scoping this request.
1378
+ # This should conform to RFC1035.
1117
1379
  # @param return_partial_success [::Boolean]
1118
- # 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.
1380
+ # Opt-in for partial success behavior which provides partial results in case
1381
+ # of failure. The default value is false.
1382
+ #
1383
+ # For example, when partial success behavior is enabled, aggregatedList for a
1384
+ # single zone scope either returns all resources in the zone or no resources,
1385
+ # with an error code.
1119
1386
  # @yield [result, operation] Access the result along with the TransportOperation object
1120
1387
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::InstanceManagedByIgmError>]
1121
1388
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1177,7 +1444,12 @@ module Google
1177
1444
  end
1178
1445
 
1179
1446
  ##
1180
- # Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`.
1447
+ # Lists the instances in the managed instance group and instances that are
1448
+ # scheduled to be created. The list includes any current actions
1449
+ # that the group has scheduled for its instances. The orderBy
1450
+ # query parameter is not supported. The `pageToken` query parameter is
1451
+ # supported only if the group's `listManagedInstancesResults` field is set
1452
+ # to `PAGINATED`.
1181
1453
  #
1182
1454
  # @overload list_managed_instances(request, options = nil)
1183
1455
  # Pass arguments to `list_managed_instances` via a request object, either of type
@@ -1195,21 +1467,99 @@ module Google
1195
1467
  # the default parameter values, pass an empty Hash as a request object (see above).
1196
1468
  #
1197
1469
  # @param filter [::String]
1198
- # 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.
1470
+ # A filter expression that filters resources listed in the response. Most
1471
+ # Compute resources support two types of filter expressions:
1472
+ # expressions that support regular expressions and expressions that follow
1473
+ # API improvement proposal AIP-160.
1474
+ # These two types of filter expressions cannot be mixed in one request.
1475
+ #
1476
+ # If you want to use AIP-160, your expression must specify the field name, an
1477
+ # operator, and the value that you want to use for filtering. The value
1478
+ # must be a string, a number, or a boolean. The operator
1479
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1480
+ #
1481
+ # For example, if you are filtering Compute Engine instances, you can
1482
+ # exclude instances named `example-instance` by specifying
1483
+ # `name != example-instance`.
1484
+ #
1485
+ # The `:*` comparison can be used to test whether a key has been defined.
1486
+ # For example, to find all objects with `owner` label use:
1487
+ # ```
1488
+ # labels.owner:*
1489
+ # ```
1490
+ #
1491
+ # You can also filter nested fields. For example, you could specify
1492
+ # `scheduling.automaticRestart = false` to include instances only
1493
+ # if they are not scheduled for automatic restarts. You can use filtering
1494
+ # on nested fields to filter based onresource labels.
1495
+ #
1496
+ # To filter on multiple expressions, provide each separate expression within
1497
+ # parentheses. For example:
1498
+ # ```
1499
+ # (scheduling.automaticRestart = true)
1500
+ # (cpuPlatform = "Intel Skylake")
1501
+ # ```
1502
+ # By default, each expression is an `AND` expression. However, you
1503
+ # can include `AND` and `OR` expressions explicitly.
1504
+ # For example:
1505
+ # ```
1506
+ # (cpuPlatform = "Intel Skylake") OR
1507
+ # (cpuPlatform = "Intel Broadwell") AND
1508
+ # (scheduling.automaticRestart = true)
1509
+ # ```
1510
+ #
1511
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1512
+ # (not equal) operator against a single un-parenthesized expression with or
1513
+ # without quotes or against multiple parenthesized expressions. Examples:
1514
+ #
1515
+ # `fieldname eq unquoted literal`
1516
+ # `fieldname eq 'single quoted literal'`
1517
+ # `fieldname eq "double quoted literal"`
1518
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1519
+ #
1520
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1521
+ # The literal value must match the entire field.
1522
+ #
1523
+ # For example, to filter for instances that do not end with name "instance",
1524
+ # you would use `name ne .*instance`.
1525
+ #
1526
+ # You cannot combine constraints on multiple fields using regular
1527
+ # expressions.
1199
1528
  # @param instance_group_manager [::String]
1200
1529
  # The name of the managed instance group.
1201
1530
  # @param max_results [::Integer]
1202
- # 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`)
1531
+ # The maximum number of results per page that should be returned.
1532
+ # If the number of available results is larger than `maxResults`,
1533
+ # Compute Engine returns a `nextPageToken` that can be used to get
1534
+ # the next page of results in subsequent list requests. Acceptable values are
1535
+ # `0` to `500`, inclusive. (Default: `500`)
1203
1536
  # @param order_by [::String]
1204
- # 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.
1537
+ # Sorts list results by a certain order. By default, results
1538
+ # are returned in alphanumerical order based on the resource name.
1539
+ #
1540
+ # You can also sort results in descending order based on the creation
1541
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1542
+ # results based on the `creationTimestamp` field in
1543
+ # reverse chronological order (newest result first). Use this to sort
1544
+ # resources like operations so that the newest operation is returned first.
1545
+ #
1546
+ # Currently, only sorting by `name` or
1547
+ # `creationTimestamp desc` is supported.
1205
1548
  # @param page_token [::String]
1206
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1549
+ # Specifies a page token to use. Set `pageToken` to the
1550
+ # `nextPageToken` returned by a previous list request to get
1551
+ # the next page of results.
1207
1552
  # @param project [::String]
1208
1553
  # Project ID for this request.
1209
1554
  # @param region [::String]
1210
1555
  # Name of the region scoping this request.
1211
1556
  # @param return_partial_success [::Boolean]
1212
- # 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.
1557
+ # Opt-in for partial success behavior which provides partial results in case
1558
+ # of failure. The default value is false.
1559
+ #
1560
+ # For example, when partial success behavior is enabled, aggregatedList for a
1561
+ # single zone scope either returns all resources in the zone or no resources,
1562
+ # with an error code.
1213
1563
  # @yield [result, operation] Access the result along with the TransportOperation object
1214
1564
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::ManagedInstance>]
1215
1565
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1271,7 +1621,8 @@ module Google
1271
1621
  end
1272
1622
 
1273
1623
  ##
1274
- # Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.
1624
+ # Lists all of the per-instance configurations defined for the managed
1625
+ # instance group. The orderBy query parameter is not supported.
1275
1626
  #
1276
1627
  # @overload list_per_instance_configs(request, options = nil)
1277
1628
  # Pass arguments to `list_per_instance_configs` via a request object, either of type
@@ -1289,21 +1640,99 @@ module Google
1289
1640
  # the default parameter values, pass an empty Hash as a request object (see above).
1290
1641
  #
1291
1642
  # @param filter [::String]
1292
- # 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.
1643
+ # A filter expression that filters resources listed in the response. Most
1644
+ # Compute resources support two types of filter expressions:
1645
+ # expressions that support regular expressions and expressions that follow
1646
+ # API improvement proposal AIP-160.
1647
+ # These two types of filter expressions cannot be mixed in one request.
1648
+ #
1649
+ # If you want to use AIP-160, your expression must specify the field name, an
1650
+ # operator, and the value that you want to use for filtering. The value
1651
+ # must be a string, a number, or a boolean. The operator
1652
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
1653
+ #
1654
+ # For example, if you are filtering Compute Engine instances, you can
1655
+ # exclude instances named `example-instance` by specifying
1656
+ # `name != example-instance`.
1657
+ #
1658
+ # The `:*` comparison can be used to test whether a key has been defined.
1659
+ # For example, to find all objects with `owner` label use:
1660
+ # ```
1661
+ # labels.owner:*
1662
+ # ```
1663
+ #
1664
+ # You can also filter nested fields. For example, you could specify
1665
+ # `scheduling.automaticRestart = false` to include instances only
1666
+ # if they are not scheduled for automatic restarts. You can use filtering
1667
+ # on nested fields to filter based onresource labels.
1668
+ #
1669
+ # To filter on multiple expressions, provide each separate expression within
1670
+ # parentheses. For example:
1671
+ # ```
1672
+ # (scheduling.automaticRestart = true)
1673
+ # (cpuPlatform = "Intel Skylake")
1674
+ # ```
1675
+ # By default, each expression is an `AND` expression. However, you
1676
+ # can include `AND` and `OR` expressions explicitly.
1677
+ # For example:
1678
+ # ```
1679
+ # (cpuPlatform = "Intel Skylake") OR
1680
+ # (cpuPlatform = "Intel Broadwell") AND
1681
+ # (scheduling.automaticRestart = true)
1682
+ # ```
1683
+ #
1684
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
1685
+ # (not equal) operator against a single un-parenthesized expression with or
1686
+ # without quotes or against multiple parenthesized expressions. Examples:
1687
+ #
1688
+ # `fieldname eq unquoted literal`
1689
+ # `fieldname eq 'single quoted literal'`
1690
+ # `fieldname eq "double quoted literal"`
1691
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
1692
+ #
1693
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1694
+ # The literal value must match the entire field.
1695
+ #
1696
+ # For example, to filter for instances that do not end with name "instance",
1697
+ # you would use `name ne .*instance`.
1698
+ #
1699
+ # You cannot combine constraints on multiple fields using regular
1700
+ # expressions.
1293
1701
  # @param instance_group_manager [::String]
1294
1702
  # The name of the managed instance group. It should conform to RFC1035.
1295
1703
  # @param max_results [::Integer]
1296
- # 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`)
1704
+ # The maximum number of results per page that should be returned.
1705
+ # If the number of available results is larger than `maxResults`,
1706
+ # Compute Engine returns a `nextPageToken` that can be used to get
1707
+ # the next page of results in subsequent list requests. Acceptable values are
1708
+ # `0` to `500`, inclusive. (Default: `500`)
1297
1709
  # @param order_by [::String]
1298
- # 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.
1710
+ # Sorts list results by a certain order. By default, results
1711
+ # are returned in alphanumerical order based on the resource name.
1712
+ #
1713
+ # You can also sort results in descending order based on the creation
1714
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
1715
+ # results based on the `creationTimestamp` field in
1716
+ # reverse chronological order (newest result first). Use this to sort
1717
+ # resources like operations so that the newest operation is returned first.
1718
+ #
1719
+ # Currently, only sorting by `name` or
1720
+ # `creationTimestamp desc` is supported.
1299
1721
  # @param page_token [::String]
1300
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
1722
+ # Specifies a page token to use. Set `pageToken` to the
1723
+ # `nextPageToken` returned by a previous list request to get
1724
+ # the next page of results.
1301
1725
  # @param project [::String]
1302
1726
  # Project ID for this request.
1303
1727
  # @param region [::String]
1304
1728
  # Name of the region scoping this request, should conform to RFC1035.
1305
1729
  # @param return_partial_success [::Boolean]
1306
- # 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.
1730
+ # Opt-in for partial success behavior which provides partial results in case
1731
+ # of failure. The default value is false.
1732
+ #
1733
+ # For example, when partial success behavior is enabled, aggregatedList for a
1734
+ # single zone scope either returns all resources in the zone or no resources,
1735
+ # with an error code.
1307
1736
  # @yield [result, operation] Access the result along with the TransportOperation object
1308
1737
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::PerInstanceConfig>]
1309
1738
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1365,7 +1794,21 @@ module Google
1365
1794
  end
1366
1795
 
1367
1796
  ##
1368
- # 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.
1797
+ # Updates a managed instance group using the information that you specify
1798
+ # in the request.
1799
+ # This operation is marked as DONE when the group is patched
1800
+ # even if the instances in the group are still in the process of being
1801
+ # patched. You must separately verify the status of the individual instances
1802
+ # with the listmanagedinstances
1803
+ # method. This method supportsPATCH
1804
+ # semantics and uses theJSON merge
1805
+ # patch format and processing rules.
1806
+ #
1807
+ # If you update your group to specify a new template or instance
1808
+ # configuration, it's possible that your intended specification for each VM
1809
+ # in the group is different from the current state of that VM. To learn how
1810
+ # to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
1811
+ # a MIG.
1369
1812
  #
1370
1813
  # @overload patch(request, options = nil)
1371
1814
  # Pass arguments to `patch` via a request object, either of type
@@ -1391,7 +1834,19 @@ module Google
1391
1834
  # @param region [::String]
1392
1835
  # Name of the region scoping this request.
1393
1836
  # @param request_id [::String]
1394
- # 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).
1837
+ # An optional request ID to identify requests. Specify a unique request ID so
1838
+ # that if you must retry your request, the server will know to ignore the
1839
+ # request if it has already been completed.
1840
+ #
1841
+ # For example, consider a situation where you make an initial request and
1842
+ # the request times out. If you make the request again with the same
1843
+ # request ID, the server can check if original operation with the same
1844
+ # request ID was received, and if so, will ignore the second request. This
1845
+ # prevents clients from accidentally creating duplicate commitments.
1846
+ #
1847
+ # The request ID must be
1848
+ # a valid UUID with the exception that zero UUID is not supported
1849
+ # (00000000-0000-0000-0000-000000000000).
1395
1850
  # @yield [result, operation] Access the result along with the TransportOperation object
1396
1851
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1397
1852
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1461,7 +1916,9 @@ module Google
1461
1916
  end
1462
1917
 
1463
1918
  ##
1464
- # 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.
1919
+ # Inserts or patches per-instance configurations for the managed instance
1920
+ # group. perInstanceConfig.name serves as a key used to
1921
+ # distinguish whether to perform insert or patch.
1465
1922
  #
1466
1923
  # @overload patch_per_instance_configs(request, options = nil)
1467
1924
  # Pass arguments to `patch_per_instance_configs` via a request object, either of type
@@ -1479,7 +1936,8 @@ module Google
1479
1936
  # the default parameter values, pass an empty Hash as a request object (see above).
1480
1937
  #
1481
1938
  # @param instance_group_manager [::String]
1482
- # The name of the managed instance group. It should conform to RFC1035.
1939
+ # The name of the managed instance group.
1940
+ # It should conform to RFC1035.
1483
1941
  # @param project [::String]
1484
1942
  # Project ID for this request.
1485
1943
  # @param region [::String]
@@ -1487,7 +1945,19 @@ module Google
1487
1945
  # @param region_instance_group_manager_patch_instance_config_req_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagerPatchInstanceConfigReq, ::Hash]
1488
1946
  # The body resource for this request
1489
1947
  # @param request_id [::String]
1490
- # 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).
1948
+ # An optional request ID to identify requests. Specify a unique request ID so
1949
+ # that if you must retry your request, the server will know to ignore the
1950
+ # request if it has already been completed.
1951
+ #
1952
+ # For example, consider a situation where you make an initial request and
1953
+ # the request times out. If you make the request again with the same
1954
+ # request ID, the server can check if original operation with the same
1955
+ # request ID was received, and if so, will ignore the second request. This
1956
+ # prevents clients from accidentally creating duplicate commitments.
1957
+ #
1958
+ # The request ID must be
1959
+ # a valid UUID with the exception that zero UUID is not supported
1960
+ # (00000000-0000-0000-0000-000000000000).
1491
1961
  # @yield [result, operation] Access the result along with the TransportOperation object
1492
1962
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1493
1963
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1557,7 +2027,19 @@ module Google
1557
2027
  end
1558
2028
 
1559
2029
  ##
1560
- # 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.
2030
+ # Flags the specified VM instances in the managed instance group to be
2031
+ # immediately recreated. Each instance is recreated using the group's current
2032
+ # configuration. This operation is marked as DONE when the flag
2033
+ # is set even if the instances have not yet been recreated. You must
2034
+ # separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
2035
+ # the status of managed instances.
2036
+ #
2037
+ # If the group is part of a backend
2038
+ # service that has enabled
2039
+ # connection draining, it can take up to 60 seconds after the connection
2040
+ # draining duration has elapsed before the VM instance is removed or deleted.
2041
+ #
2042
+ # You can specify a maximum of 1000 instances with this method per request.
1561
2043
  #
1562
2044
  # @overload recreate_instances(request, options = nil)
1563
2045
  # Pass arguments to `recreate_instances` via a request object, either of type
@@ -1583,7 +2065,19 @@ module Google
1583
2065
  # @param region_instance_group_managers_recreate_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersRecreateRequest, ::Hash]
1584
2066
  # The body resource for this request
1585
2067
  # @param request_id [::String]
1586
- # 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).
2068
+ # An optional request ID to identify requests. Specify a unique request ID so
2069
+ # that if you must retry your request, the server will know to ignore the
2070
+ # request if it has already been completed.
2071
+ #
2072
+ # For example, consider a situation where you make an initial request and
2073
+ # the request times out. If you make the request again with the same
2074
+ # request ID, the server can check if original operation with the same
2075
+ # request ID was received, and if so, will ignore the second request. This
2076
+ # prevents clients from accidentally creating duplicate commitments.
2077
+ #
2078
+ # The request ID must be
2079
+ # a valid UUID with the exception that zero UUID is not supported
2080
+ # (00000000-0000-0000-0000-000000000000).
1587
2081
  # @yield [result, operation] Access the result along with the TransportOperation object
1588
2082
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1589
2083
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1653,7 +2147,19 @@ module Google
1653
2147
  end
1654
2148
 
1655
2149
  ##
1656
- # Changes the intended size of 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 one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions 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.
2150
+ # Changes the intended size of the managed instance group. If you increase
2151
+ # the size, the group creates new instances using the current instance
2152
+ # template. If you decrease the size, the group deletes one or more
2153
+ # instances.
2154
+ #
2155
+ # The resize operation is marked DONE if theresize request is successful. The underlying actions take
2156
+ # additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances
2157
+ # method.
2158
+ #
2159
+ # If the group is part of a backend
2160
+ # service that has enabled
2161
+ # connection draining, it can take up to 60 seconds after the connection
2162
+ # draining duration has elapsed before the VM instance is removed or deleted.
1657
2163
  #
1658
2164
  # @overload resize(request, options = nil)
1659
2165
  # Pass arguments to `resize` via a request object, either of type
@@ -1677,9 +2183,22 @@ module Google
1677
2183
  # @param region [::String]
1678
2184
  # Name of the region scoping this request.
1679
2185
  # @param request_id [::String]
1680
- # 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).
2186
+ # An optional request ID to identify requests. Specify a unique request ID so
2187
+ # that if you must retry your request, the server will know to ignore the
2188
+ # request if it has already been completed.
2189
+ #
2190
+ # For example, consider a situation where you make an initial request and
2191
+ # the request times out. If you make the request again with the same
2192
+ # request ID, the server can check if original operation with the same
2193
+ # request ID was received, and if so, will ignore the second request. This
2194
+ # prevents clients from accidentally creating duplicate commitments.
2195
+ #
2196
+ # The request ID must be
2197
+ # a valid UUID with the exception that zero UUID is not supported
2198
+ # (00000000-0000-0000-0000-000000000000).
1681
2199
  # @param size [::Integer]
1682
- # Number of instances that should exist in this instance group manager.
2200
+ # Number of instances that should exist in this instance group
2201
+ # manager.
1683
2202
  # @yield [result, operation] Access the result along with the TransportOperation object
1684
2203
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1685
2204
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1749,7 +2268,22 @@ module Google
1749
2268
  end
1750
2269
 
1751
2270
  ##
1752
- # 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.
2271
+ # Flags the specified instances in the managed instance group to be
2272
+ # resumed. This method increases thetargetSize and decreases the targetSuspendedSize
2273
+ # of the managed instance group by the number of instances that you resume.
2274
+ # The resumeInstances operation is marked DONE if
2275
+ # the resumeInstances request is successful. The underlying
2276
+ # actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
2277
+ # method.
2278
+ #
2279
+ # In this request, you can only specify instances that are suspended. For
2280
+ # example, if an instance was previously suspended using the suspendInstances
2281
+ # method, it can be resumed using the resumeInstances method.
2282
+ #
2283
+ # If a health check is attached to the managed instance group, the specified
2284
+ # instances will be verified as healthy after they are resumed.
2285
+ #
2286
+ # You can specify a maximum of 1000 instances with this method per request.
1753
2287
  #
1754
2288
  # @overload resume_instances(request, options = nil)
1755
2289
  # Pass arguments to `resume_instances` via a request object, either of type
@@ -1775,7 +2309,19 @@ module Google
1775
2309
  # @param region_instance_group_managers_resume_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersResumeInstancesRequest, ::Hash]
1776
2310
  # The body resource for this request
1777
2311
  # @param request_id [::String]
1778
- # 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).
2312
+ # An optional request ID to identify requests. Specify a unique request ID so
2313
+ # that if you must retry your request, the server will know to ignore the
2314
+ # request if it has already been completed.
2315
+ #
2316
+ # For example, consider a situation where you make an initial request and
2317
+ # the request times out. If you make the request again with the same
2318
+ # request ID, the server can check if original operation with the same
2319
+ # request ID was received, and if so, will ignore the second request. This
2320
+ # prevents clients from accidentally creating duplicate commitments.
2321
+ #
2322
+ # The request ID must be
2323
+ # a valid UUID with the exception that zero UUID is not supported
2324
+ # (00000000-0000-0000-0000-000000000000).
1779
2325
  # @yield [result, operation] Access the result along with the TransportOperation object
1780
2326
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1781
2327
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1845,7 +2391,8 @@ module Google
1845
2391
  end
1846
2392
 
1847
2393
  ##
1848
- # Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.
2394
+ # Sets the instance template to use when creating new instances or recreating
2395
+ # instances in this group. Existing instances are not affected.
1849
2396
  #
1850
2397
  # @overload set_instance_template(request, options = nil)
1851
2398
  # Pass arguments to `set_instance_template` via a request object, either of type
@@ -1871,7 +2418,19 @@ module Google
1871
2418
  # @param region_instance_group_managers_set_template_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersSetTemplateRequest, ::Hash]
1872
2419
  # The body resource for this request
1873
2420
  # @param request_id [::String]
1874
- # 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).
2421
+ # An optional request ID to identify requests. Specify a unique request ID so
2422
+ # that if you must retry your request, the server will know to ignore the
2423
+ # request if it has already been completed.
2424
+ #
2425
+ # For example, consider a situation where you make an initial request and
2426
+ # the request times out. If you make the request again with the same
2427
+ # request ID, the server can check if original operation with the same
2428
+ # request ID was received, and if so, will ignore the second request. This
2429
+ # prevents clients from accidentally creating duplicate commitments.
2430
+ #
2431
+ # The request ID must be
2432
+ # a valid UUID with the exception that zero UUID is not supported
2433
+ # (00000000-0000-0000-0000-000000000000).
1875
2434
  # @yield [result, operation] Access the result along with the TransportOperation object
1876
2435
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1877
2436
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1941,7 +2500,8 @@ module Google
1941
2500
  end
1942
2501
 
1943
2502
  ##
1944
- # Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.
2503
+ # Modifies the target pools to which all new instances in this group are
2504
+ # assigned. Existing instances in the group are not affected.
1945
2505
  #
1946
2506
  # @overload set_target_pools(request, options = nil)
1947
2507
  # Pass arguments to `set_target_pools` via a request object, either of type
@@ -1967,7 +2527,19 @@ module Google
1967
2527
  # @param region_instance_group_managers_set_target_pools_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersSetTargetPoolsRequest, ::Hash]
1968
2528
  # The body resource for this request
1969
2529
  # @param request_id [::String]
1970
- # 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).
2530
+ # An optional request ID to identify requests. Specify a unique request ID so
2531
+ # that if you must retry your request, the server will know to ignore the
2532
+ # request if it has already been completed.
2533
+ #
2534
+ # For example, consider a situation where you make an initial request and
2535
+ # the request times out. If you make the request again with the same
2536
+ # request ID, the server can check if original operation with the same
2537
+ # request ID was received, and if so, will ignore the second request. This
2538
+ # prevents clients from accidentally creating duplicate commitments.
2539
+ #
2540
+ # The request ID must be
2541
+ # a valid UUID with the exception that zero UUID is not supported
2542
+ # (00000000-0000-0000-0000-000000000000).
1971
2543
  # @yield [result, operation] Access the result along with the TransportOperation object
1972
2544
  # @yieldparam result [::Gapic::GenericLRO::Operation]
1973
2545
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2037,7 +2609,22 @@ module Google
2037
2609
  end
2038
2610
 
2039
2611
  ##
2040
- # 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.
2612
+ # Flags the specified instances in the managed instance group to be
2613
+ # started. This method increases thetargetSize and decreases the targetStoppedSize
2614
+ # of the managed instance group by the number of instances that you start.
2615
+ # The startInstances operation is marked DONE if
2616
+ # the startInstances request is successful. The underlying
2617
+ # actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
2618
+ # method.
2619
+ #
2620
+ # In this request, you can only specify instances that are stopped. For
2621
+ # example, if an instance was previously stopped using the stopInstances
2622
+ # method, it can be started using the startInstances method.
2623
+ #
2624
+ # If a health check is attached to the managed instance group, the specified
2625
+ # instances will be verified as healthy after they are started.
2626
+ #
2627
+ # You can specify a maximum of 1000 instances with this method per request.
2041
2628
  #
2042
2629
  # @overload start_instances(request, options = nil)
2043
2630
  # Pass arguments to `start_instances` via a request object, either of type
@@ -2063,7 +2650,19 @@ module Google
2063
2650
  # @param region_instance_group_managers_start_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersStartInstancesRequest, ::Hash]
2064
2651
  # The body resource for this request
2065
2652
  # @param request_id [::String]
2066
- # 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).
2653
+ # An optional request ID to identify requests. Specify a unique request ID so
2654
+ # that if you must retry your request, the server will know to ignore the
2655
+ # request if it has already been completed.
2656
+ #
2657
+ # For example, consider a situation where you make an initial request and
2658
+ # the request times out. If you make the request again with the same
2659
+ # request ID, the server can check if original operation with the same
2660
+ # request ID was received, and if so, will ignore the second request. This
2661
+ # prevents clients from accidentally creating duplicate commitments.
2662
+ #
2663
+ # The request ID must be
2664
+ # a valid UUID with the exception that zero UUID is not supported
2665
+ # (00000000-0000-0000-0000-000000000000).
2067
2666
  # @yield [result, operation] Access the result along with the TransportOperation object
2068
2667
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2069
2668
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2133,7 +2732,31 @@ module Google
2133
2732
  end
2134
2733
 
2135
2734
  ##
2136
- # 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.
2735
+ # Flags the specified instances in the managed instance group to be
2736
+ # immediately stopped. You can only specify instances that are running in
2737
+ # this request. This method reduces thetargetSize and increases the targetStoppedSize
2738
+ # of the managed instance group by the number of instances that you stop.
2739
+ # The stopInstances operation is marked DONE if
2740
+ # the stopInstances request is successful. The underlying
2741
+ # actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
2742
+ # method.
2743
+ #
2744
+ # If the standbyPolicy.initialDelaySec field is set, the group
2745
+ # delays stopping the instances until initialDelaySec have
2746
+ # passed from instance.creationTimestamp (that is, when the
2747
+ # instance was created). This delay gives your application time to
2748
+ # set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
2749
+ # will be zero delay.
2750
+ #
2751
+ # If the group is part of a backend
2752
+ # service that has enabled
2753
+ # connection draining, it can take up to 60 seconds after the connection
2754
+ # draining duration has elapsed before the VM instance is stopped.
2755
+ #
2756
+ # Stopped instances can be started using the startInstances
2757
+ # method.
2758
+ #
2759
+ # You can specify a maximum of 1000 instances with this method per request.
2137
2760
  #
2138
2761
  # @overload stop_instances(request, options = nil)
2139
2762
  # Pass arguments to `stop_instances` via a request object, either of type
@@ -2159,7 +2782,19 @@ module Google
2159
2782
  # @param region_instance_group_managers_stop_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersStopInstancesRequest, ::Hash]
2160
2783
  # The body resource for this request
2161
2784
  # @param request_id [::String]
2162
- # 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).
2785
+ # An optional request ID to identify requests. Specify a unique request ID so
2786
+ # that if you must retry your request, the server will know to ignore the
2787
+ # request if it has already been completed.
2788
+ #
2789
+ # For example, consider a situation where you make an initial request and
2790
+ # the request times out. If you make the request again with the same
2791
+ # request ID, the server can check if original operation with the same
2792
+ # request ID was received, and if so, will ignore the second request. This
2793
+ # prevents clients from accidentally creating duplicate commitments.
2794
+ #
2795
+ # The request ID must be
2796
+ # a valid UUID with the exception that zero UUID is not supported
2797
+ # (00000000-0000-0000-0000-000000000000).
2163
2798
  # @yield [result, operation] Access the result along with the TransportOperation object
2164
2799
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2165
2800
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2229,7 +2864,31 @@ module Google
2229
2864
  end
2230
2865
 
2231
2866
  ##
2232
- # 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.
2867
+ # Flags the specified instances in the managed instance group to be
2868
+ # immediately suspended. You can only specify instances that are running in
2869
+ # this request. This method reduces thetargetSize and increases the targetSuspendedSize
2870
+ # of the managed instance group by the number of instances that you suspend.
2871
+ # The suspendInstances operation is marked DONE if
2872
+ # the suspendInstances request is successful. The underlying
2873
+ # actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
2874
+ # method.
2875
+ #
2876
+ # If the standbyPolicy.initialDelaySec field is set, the group
2877
+ # delays suspension of the instances until initialDelaySec have
2878
+ # passed from instance.creationTimestamp (that is, when the
2879
+ # instance was created). This delay gives your application time to
2880
+ # set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
2881
+ # will be zero delay.
2882
+ #
2883
+ # If the group is part of a backend
2884
+ # service that has enabled
2885
+ # connection draining, it can take up to 60 seconds after the connection
2886
+ # draining duration has elapsed before the VM instance is suspended.
2887
+ #
2888
+ # Suspended instances can be resumed using the resumeInstances
2889
+ # method.
2890
+ #
2891
+ # You can specify a maximum of 1000 instances with this method per request.
2233
2892
  #
2234
2893
  # @overload suspend_instances(request, options = nil)
2235
2894
  # Pass arguments to `suspend_instances` via a request object, either of type
@@ -2255,7 +2914,19 @@ module Google
2255
2914
  # @param region_instance_group_managers_suspend_instances_request_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagersSuspendInstancesRequest, ::Hash]
2256
2915
  # The body resource for this request
2257
2916
  # @param request_id [::String]
2258
- # 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).
2917
+ # An optional request ID to identify requests. Specify a unique request ID so
2918
+ # that if you must retry your request, the server will know to ignore the
2919
+ # request if it has already been completed.
2920
+ #
2921
+ # For example, consider a situation where you make an initial request and
2922
+ # the request times out. If you make the request again with the same
2923
+ # request ID, the server can check if original operation with the same
2924
+ # request ID was received, and if so, will ignore the second request. This
2925
+ # prevents clients from accidentally creating duplicate commitments.
2926
+ #
2927
+ # The request ID must be
2928
+ # a valid UUID with the exception that zero UUID is not supported
2929
+ # (00000000-0000-0000-0000-000000000000).
2259
2930
  # @yield [result, operation] Access the result along with the TransportOperation object
2260
2931
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2261
2932
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2325,7 +2996,9 @@ module Google
2325
2996
  end
2326
2997
 
2327
2998
  ##
2328
- # 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.
2999
+ # Inserts or updates per-instance configurations for the managed instance
3000
+ # group. perInstanceConfig.name serves as a key used to
3001
+ # distinguish whether to perform insert or patch.
2329
3002
  #
2330
3003
  # @overload update_per_instance_configs(request, options = nil)
2331
3004
  # Pass arguments to `update_per_instance_configs` via a request object, either of type
@@ -2343,7 +3016,8 @@ module Google
2343
3016
  # the default parameter values, pass an empty Hash as a request object (see above).
2344
3017
  #
2345
3018
  # @param instance_group_manager [::String]
2346
- # The name of the managed instance group. It should conform to RFC1035.
3019
+ # The name of the managed instance group.
3020
+ # It should conform to RFC1035.
2347
3021
  # @param project [::String]
2348
3022
  # Project ID for this request.
2349
3023
  # @param region [::String]
@@ -2351,7 +3025,19 @@ module Google
2351
3025
  # @param region_instance_group_manager_update_instance_config_req_resource [::Google::Cloud::Compute::V1::RegionInstanceGroupManagerUpdateInstanceConfigReq, ::Hash]
2352
3026
  # The body resource for this request
2353
3027
  # @param request_id [::String]
2354
- # 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).
3028
+ # An optional request ID to identify requests. Specify a unique request ID so
3029
+ # that if you must retry your request, the server will know to ignore the
3030
+ # request if it has already been completed.
3031
+ #
3032
+ # For example, consider a situation where you make an initial request and
3033
+ # the request times out. If you make the request again with the same
3034
+ # request ID, the server can check if original operation with the same
3035
+ # request ID was received, and if so, will ignore the second request. This
3036
+ # prevents clients from accidentally creating duplicate commitments.
3037
+ #
3038
+ # The request ID must be
3039
+ # a valid UUID with the exception that zero UUID is not supported
3040
+ # (00000000-0000-0000-0000-000000000000).
2355
3041
  # @yield [result, operation] Access the result along with the TransportOperation object
2356
3042
  # @yieldparam result [::Gapic::GenericLRO::Operation]
2357
3043
  # @yieldparam operation [::Gapic::Rest::TransportOperation]