google-cloud-compute-v1 3.4.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/compute/v1/accelerator_types/rest/client.rb +181 -14
  3. data/lib/google/cloud/compute/v1/addresses/rest/client.rb +237 -20
  4. data/lib/google/cloud/compute/v1/advice/credentials.rb +52 -0
  5. data/lib/google/cloud/compute/v1/advice/rest/client.rb +431 -0
  6. data/lib/google/cloud/compute/v1/advice/rest/service_stub.rb +144 -0
  7. data/lib/google/cloud/compute/v1/advice/rest.rb +51 -0
  8. data/lib/google/cloud/compute/v1/advice.rb +47 -0
  9. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +334 -21
  10. data/lib/google/cloud/compute/v1/autoscalers/rest/service_stub.rb +64 -0
  11. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +198 -23
  12. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +499 -40
  13. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +62 -0
  14. data/lib/google/cloud/compute/v1/compute_pb.rb +264 -25
  15. data/lib/google/cloud/compute/v1/cross_site_networks/credentials.rb +52 -0
  16. data/lib/google/cloud/compute/v1/cross_site_networks/rest/client.rb +975 -0
  17. data/lib/google/cloud/compute/v1/cross_site_networks/rest/service_stub.rb +391 -0
  18. data/lib/google/cloud/compute/v1/cross_site_networks/rest.rb +51 -0
  19. data/lib/google/cloud/compute/v1/cross_site_networks.rb +47 -0
  20. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +181 -14
  21. data/lib/google/cloud/compute/v1/disks/rest/client.rb +390 -42
  22. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +118 -11
  23. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +240 -25
  24. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +238 -13
  25. data/lib/google/cloud/compute/v1/firewalls/rest/service_stub.rb +63 -0
  26. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +258 -23
  27. data/lib/google/cloud/compute/v1/future_reservations/credentials.rb +52 -0
  28. data/lib/google/cloud/compute/v1/future_reservations/rest/client.rb +1287 -0
  29. data/lib/google/cloud/compute/v1/future_reservations/rest/service_stub.rb +520 -0
  30. data/lib/google/cloud/compute/v1/future_reservations/rest.rb +51 -0
  31. data/lib/google/cloud/compute/v1/future_reservations.rb +47 -0
  32. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +126 -10
  33. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +151 -15
  34. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +246 -21
  35. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +203 -18
  36. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +91 -9
  37. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +128 -10
  38. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +333 -21
  39. data/lib/google/cloud/compute/v1/health_checks/rest/service_stub.rb +63 -0
  40. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +2 -1
  41. data/lib/google/cloud/compute/v1/images/rest/client.rb +161 -18
  42. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/client.rb +159 -24
  43. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +920 -95
  44. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +380 -40
  45. data/lib/google/cloud/compute/v1/instance_settings_service/rest/client.rb +13 -1
  46. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +220 -20
  47. data/lib/google/cloud/compute/v1/instances/rest/client.rb +939 -104
  48. data/lib/google/cloud/compute/v1/instant_snapshots/rest/client.rb +235 -21
  49. data/lib/google/cloud/compute/v1/interconnect_attachment_groups/rest/client.rb +139 -14
  50. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +242 -21
  51. data/lib/google/cloud/compute/v1/interconnect_groups/rest/client.rb +139 -14
  52. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +87 -7
  53. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/client.rb +87 -7
  54. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +145 -14
  55. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +9 -2
  56. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +161 -16
  57. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +124 -13
  58. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +181 -14
  59. data/lib/google/cloud/compute/v1/network_attachments/rest/client.rb +232 -20
  60. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/client.rb +138 -12
  61. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +361 -37
  62. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/client.rb +354 -33
  63. data/lib/google/cloud/compute/v1/network_profiles/rest/client.rb +85 -6
  64. data/lib/google/cloud/compute/v1/networks/rest/client.rb +281 -23
  65. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +381 -32
  66. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +213 -19
  67. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +181 -14
  68. data/lib/google/cloud/compute/v1/organization_security_policies/credentials.rb +52 -0
  69. data/lib/google/cloud/compute/v1/organization_security_policies/rest/client.rb +2259 -0
  70. data/lib/google/cloud/compute/v1/organization_security_policies/rest/service_stub.rb +1054 -0
  71. data/lib/google/cloud/compute/v1/organization_security_policies/rest.rb +51 -0
  72. data/lib/google/cloud/compute/v1/organization_security_policies.rb +47 -0
  73. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +226 -19
  74. data/lib/google/cloud/compute/v1/preview_features/credentials.rb +52 -0
  75. data/lib/google/cloud/compute/v1/preview_features/rest/client.rb +739 -0
  76. data/lib/google/cloud/compute/v1/preview_features/rest/service_stub.rb +267 -0
  77. data/lib/google/cloud/compute/v1/preview_features/rest.rb +51 -0
  78. data/lib/google/cloud/compute/v1/preview_features.rb +47 -0
  79. data/lib/google/cloud/compute/v1/projects/rest/client.rb +346 -30
  80. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +154 -12
  81. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +255 -22
  82. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +238 -13
  83. data/lib/google/cloud/compute/v1/region_autoscalers/rest/service_stub.rb +64 -0
  84. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +260 -26
  85. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +212 -18
  86. data/lib/google/cloud/compute/v1/region_composite_health_checks/credentials.rb +52 -0
  87. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/client.rb +1268 -0
  88. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/service_stub.rb +521 -0
  89. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest.rb +51 -0
  90. data/lib/google/cloud/compute/v1/region_composite_health_checks.rb +47 -0
  91. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +83 -5
  92. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +269 -29
  93. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/credentials.rb +52 -0
  94. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/client.rb +1268 -0
  95. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/service_stub.rb +521 -0
  96. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest.rb +51 -0
  97. data/lib/google/cloud/compute/v1/region_health_aggregation_policies.rb +47 -0
  98. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +427 -17
  99. data/lib/google/cloud/compute/v1/region_health_check_services/rest/service_stub.rb +125 -0
  100. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +238 -13
  101. data/lib/google/cloud/compute/v1/region_health_checks/rest/service_stub.rb +64 -0
  102. data/lib/google/cloud/compute/v1/region_health_sources/credentials.rb +52 -0
  103. data/lib/google/cloud/compute/v1/region_health_sources/rest/client.rb +1268 -0
  104. data/lib/google/cloud/compute/v1/region_health_sources/rest/service_stub.rb +521 -0
  105. data/lib/google/cloud/compute/v1/region_health_sources/rest.rb +51 -0
  106. data/lib/google/cloud/compute/v1/region_health_sources.rb +47 -0
  107. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +750 -64
  108. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +187 -14
  109. data/lib/google/cloud/compute/v1/region_instance_templates/rest/client.rb +115 -10
  110. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +15 -2
  111. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/client.rb +139 -13
  112. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +264 -28
  113. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/client.rb +213 -20
  114. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +399 -11
  115. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/service_stub.rb +125 -0
  116. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +107 -10
  117. data/lib/google/cloud/compute/v1/region_security_policies/rest/client.rb +149 -14
  118. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +116 -10
  119. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/client.rb +220 -20
  120. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +126 -10
  121. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +158 -14
  122. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/client.rb +113 -9
  123. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +104 -14
  124. data/lib/google/cloud/compute/v1/region_zones/rest/client.rb +85 -6
  125. data/lib/google/cloud/compute/v1/regions/rest/client.rb +120 -7
  126. data/lib/google/cloud/compute/v1/reservation_blocks/rest/client.rb +396 -11
  127. data/lib/google/cloud/compute/v1/reservation_blocks/rest/service_stub.rb +194 -0
  128. data/lib/google/cloud/compute/v1/reservation_slots/credentials.rb +52 -0
  129. data/lib/google/cloud/compute/v1/reservation_slots/rest/client.rb +863 -0
  130. data/lib/google/cloud/compute/v1/reservation_slots/rest/service_stub.rb +338 -0
  131. data/lib/google/cloud/compute/v1/reservation_slots/rest.rb +51 -0
  132. data/lib/google/cloud/compute/v1/reservation_slots.rb +47 -0
  133. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/client.rb +642 -12
  134. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/service_stub.rb +327 -3
  135. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +257 -24
  136. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +224 -19
  137. data/lib/google/cloud/compute/v1/rest.rb +10 -0
  138. data/lib/google/cloud/compute/v1/routers/rest/client.rb +555 -50
  139. data/lib/google/cloud/compute/v1/routes/rest/client.rb +202 -8
  140. data/lib/google/cloud/compute/v1/routes/rest/service_stub.rb +63 -0
  141. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +316 -26
  142. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +231 -21
  143. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/client.rb +13 -1
  144. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +130 -13
  145. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +210 -17
  146. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +315 -27
  147. data/lib/google/cloud/compute/v1/storage_pool_types/rest/client.rb +181 -14
  148. data/lib/google/cloud/compute/v1/storage_pools/rest/client.rb +321 -28
  149. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +378 -34
  150. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +128 -10
  151. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +240 -20
  152. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +306 -30
  153. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +227 -20
  154. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +294 -26
  155. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +281 -19
  156. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/service_stub.rb +63 -0
  157. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +329 -20
  158. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/service_stub.rb +63 -0
  159. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +224 -19
  160. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +354 -24
  161. data/lib/google/cloud/compute/v1/url_maps/rest/service_stub.rb +63 -0
  162. data/lib/google/cloud/compute/v1/version.rb +1 -1
  163. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +224 -19
  164. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +224 -19
  165. data/lib/google/cloud/compute/v1/wire_groups/credentials.rb +52 -0
  166. data/lib/google/cloud/compute/v1/wire_groups/rest/client.rb +980 -0
  167. data/lib/google/cloud/compute/v1/wire_groups/rest/service_stub.rb +396 -0
  168. data/lib/google/cloud/compute/v1/wire_groups/rest.rb +51 -0
  169. data/lib/google/cloud/compute/v1/wire_groups.rb +47 -0
  170. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +106 -10
  171. data/lib/google/cloud/compute/v1/zones/rest/client.rb +83 -5
  172. data/lib/google/cloud/compute/v1.rb +10 -0
  173. data/proto_docs/google/api/client.rb +149 -29
  174. data/proto_docs/google/cloud/compute/v1/compute.rb +43929 -5522
  175. metadata +52 -2
@@ -348,7 +348,19 @@ module Google
348
348
  # @param project [::String]
349
349
  # Project ID for this request.
350
350
  # @param request_id [::String]
351
- # 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).
351
+ # An optional request ID to identify requests. Specify a unique request ID so
352
+ # that if you must retry your request, the server will know to ignore the
353
+ # request if it has already been completed.
354
+ #
355
+ # For example, consider a situation where you make an initial request and
356
+ # the request times out. If you make the request again with the same
357
+ # request ID, the server can check if original operation with the same
358
+ # request ID was received, and if so, will ignore the second request. This
359
+ # prevents clients from accidentally creating duplicate commitments.
360
+ #
361
+ # The request ID must be
362
+ # a valid UUID with the exception that zero UUID is not supported
363
+ # (00000000-0000-0000-0000-000000000000).
352
364
  # @param zone [::String]
353
365
  # The name of the zone for this request.
354
366
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -438,13 +450,26 @@ module Google
438
450
  # the default parameter values, pass an empty Hash as a request object (see above).
439
451
  #
440
452
  # @param instance [::String]
441
- # The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer.
453
+ # The instance name for this request stored as resource_id.
454
+ # Name should conform to RFC1035 or be an unsigned long integer.
442
455
  # @param network_interface_resource [::Google::Cloud::Compute::V1::NetworkInterface, ::Hash]
443
456
  # The body resource for this request
444
457
  # @param project [::String]
445
458
  # Project ID for this request.
446
459
  # @param request_id [::String]
447
- # 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).
460
+ # An optional request ID to identify requests. Specify a unique request ID so
461
+ # that if you must retry your request, the server will know to ignore the
462
+ # request if it has already been completed.
463
+ #
464
+ # For example, consider a situation where you make an initial request and
465
+ # the request times out. If you make the request again with the same
466
+ # request ID, the server can check if original operation with the same
467
+ # request ID was received, and if so, will ignore the second request. This
468
+ # prevents clients from accidentally creating duplicate commitments.
469
+ #
470
+ # The request ID must be
471
+ # a valid UUID with the exception that zero UUID is not supported
472
+ # (00000000-0000-0000-0000-000000000000).
448
473
  # @param zone [::String]
449
474
  # The name of the zone for this request.
450
475
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -516,7 +541,9 @@ module Google
516
541
  end
517
542
 
518
543
  ##
519
- # Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations.
544
+ # Adds existing resource policies to an instance. You can only add one
545
+ # policy right now which will be applied to this instance for scheduling live
546
+ # migrations.
520
547
  #
521
548
  # @overload add_resource_policies(request, options = nil)
522
549
  # Pass arguments to `add_resource_policies` via a request object, either of type
@@ -540,7 +567,19 @@ module Google
540
567
  # @param project [::String]
541
568
  # Project ID for this request.
542
569
  # @param request_id [::String]
543
- # 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).
570
+ # An optional request ID to identify requests. Specify a unique request ID so
571
+ # that if you must retry your request, the server will know to ignore the
572
+ # request if it has already been completed.
573
+ #
574
+ # For example, consider a situation where you make an initial request and
575
+ # the request times out. If you make the request again with the same
576
+ # request ID, the server can check if original operation with the same
577
+ # request ID was received, and if so, will ignore the second request. This
578
+ # prevents clients from accidentally creating duplicate commitments.
579
+ #
580
+ # The request ID must be
581
+ # a valid UUID with the exception that zero UUID is not supported
582
+ # (00000000-0000-0000-0000-000000000000).
544
583
  # @param zone [::String]
545
584
  # The name of the zone for this request.
546
585
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -612,7 +651,14 @@ module Google
612
651
  end
613
652
 
614
653
  ##
615
- # Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.
654
+ # Retrieves an aggregated list of all of the instances in your project
655
+ # across all regions and zones.
656
+ #
657
+ # The performance of this method degrades when a filter is specified on a
658
+ # project that has a very large number of instances.
659
+ #
660
+ # To prevent failure, Google recommends that you set the
661
+ # `returnPartialSuccess` parameter to `true`.
616
662
  #
617
663
  # @overload aggregated_list(request, options = nil)
618
664
  # Pass arguments to `aggregated_list` via a request object, either of type
@@ -630,21 +676,106 @@ module Google
630
676
  # the default parameter values, pass an empty Hash as a request object (see above).
631
677
  #
632
678
  # @param filter [::String]
633
- # 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.
679
+ # A filter expression that filters resources listed in the response. Most
680
+ # Compute resources support two types of filter expressions:
681
+ # expressions that support regular expressions and expressions that follow
682
+ # API improvement proposal AIP-160.
683
+ # These two types of filter expressions cannot be mixed in one request.
684
+ #
685
+ # If you want to use AIP-160, your expression must specify the field name, an
686
+ # operator, and the value that you want to use for filtering. The value
687
+ # must be a string, a number, or a boolean. The operator
688
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
689
+ #
690
+ # For example, if you are filtering Compute Engine instances, you can
691
+ # exclude instances named `example-instance` by specifying
692
+ # `name != example-instance`.
693
+ #
694
+ # The `:*` comparison can be used to test whether a key has been defined.
695
+ # For example, to find all objects with `owner` label use:
696
+ # ```
697
+ # labels.owner:*
698
+ # ```
699
+ #
700
+ # You can also filter nested fields. For example, you could specify
701
+ # `scheduling.automaticRestart = false` to include instances only
702
+ # if they are not scheduled for automatic restarts. You can use filtering
703
+ # on nested fields to filter based onresource labels.
704
+ #
705
+ # To filter on multiple expressions, provide each separate expression within
706
+ # parentheses. For example:
707
+ # ```
708
+ # (scheduling.automaticRestart = true)
709
+ # (cpuPlatform = "Intel Skylake")
710
+ # ```
711
+ # By default, each expression is an `AND` expression. However, you
712
+ # can include `AND` and `OR` expressions explicitly.
713
+ # For example:
714
+ # ```
715
+ # (cpuPlatform = "Intel Skylake") OR
716
+ # (cpuPlatform = "Intel Broadwell") AND
717
+ # (scheduling.automaticRestart = true)
718
+ # ```
719
+ #
720
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
721
+ # (not equal) operator against a single un-parenthesized expression with or
722
+ # without quotes or against multiple parenthesized expressions. Examples:
723
+ #
724
+ # `fieldname eq unquoted literal`
725
+ # `fieldname eq 'single quoted literal'`
726
+ # `fieldname eq "double quoted literal"`
727
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
728
+ #
729
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
730
+ # The literal value must match the entire field.
731
+ #
732
+ # For example, to filter for instances that do not end with name "instance",
733
+ # you would use `name ne .*instance`.
734
+ #
735
+ # You cannot combine constraints on multiple fields using regular
736
+ # expressions.
634
737
  # @param include_all_scopes [::Boolean]
635
- # Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.
738
+ # Indicates whether every visible scope for each scope type (zone, region,
739
+ # global) should be included in the response. For new resource types added
740
+ # after this field, the flag has no effect as new resource types will always
741
+ # include every visible scope for each scope type in response. For resource
742
+ # types which predate this field, if this flag is omitted or false, only
743
+ # scopes of the scope types where the resource type is expected to be found
744
+ # will be included.
636
745
  # @param max_results [::Integer]
637
- # 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`)
746
+ # The maximum number of results per page that should be returned.
747
+ # If the number of available results is larger than `maxResults`,
748
+ # Compute Engine returns a `nextPageToken` that can be used to get
749
+ # the next page of results in subsequent list requests. Acceptable values are
750
+ # `0` to `500`, inclusive. (Default: `500`)
638
751
  # @param order_by [::String]
639
- # 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.
752
+ # Sorts list results by a certain order. By default, results
753
+ # are returned in alphanumerical order based on the resource name.
754
+ #
755
+ # You can also sort results in descending order based on the creation
756
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
757
+ # results based on the `creationTimestamp` field in
758
+ # reverse chronological order (newest result first). Use this to sort
759
+ # resources like operations so that the newest operation is returned first.
760
+ #
761
+ # Currently, only sorting by `name` or
762
+ # `creationTimestamp desc` is supported.
640
763
  # @param page_token [::String]
641
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
764
+ # Specifies a page token to use. Set `pageToken` to the
765
+ # `nextPageToken` returned by a previous list request to get
766
+ # the next page of results.
642
767
  # @param project [::String]
643
768
  # Project ID for this request.
644
769
  # @param return_partial_success [::Boolean]
645
- # 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.
770
+ # Opt-in for partial success behavior which provides partial results in case
771
+ # of failure. The default value is false.
772
+ #
773
+ # For example, when partial success behavior is enabled, aggregatedList for a
774
+ # single zone scope either returns all resources in the zone or no resources,
775
+ # with an error code.
646
776
  # @param service_project_number [::Integer]
647
- # The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.
777
+ # The Shared VPC service project id or service project number for which
778
+ # aggregated list request is invoked for subnetworks list-usable api.
648
779
  # @yield [result, operation] Access the result along with the TransportOperation object
649
780
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::String, ::Google::Cloud::Compute::V1::InstancesScopedList>]
650
781
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -706,7 +837,10 @@ module Google
706
837
  end
707
838
 
708
839
  ##
709
- # Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance.
840
+ # Attaches an existing Disk resource to an instance. You must first
841
+ # create the disk before you can attach it. It is not possible to create
842
+ # and attach a disk at the same time. For more information, readAdding a
843
+ # persistent disk to your instance.
710
844
  #
711
845
  # @overload attach_disk(request, options = nil)
712
846
  # Pass arguments to `attach_disk` via a request object, either of type
@@ -726,13 +860,27 @@ module Google
726
860
  # @param attached_disk_resource [::Google::Cloud::Compute::V1::AttachedDisk, ::Hash]
727
861
  # The body resource for this request
728
862
  # @param force_attach [::Boolean]
729
- # Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.
863
+ # Whether to force attach the regional disk even if it's currently attached
864
+ # to another instance. If you try to force attach a zonal disk to an
865
+ # instance, you will receive an error.
730
866
  # @param instance [::String]
731
867
  # The instance name for this request.
732
868
  # @param project [::String]
733
869
  # Project ID for this request.
734
870
  # @param request_id [::String]
735
- # 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).
871
+ # An optional request ID to identify requests. Specify a unique request ID so
872
+ # that if you must retry your request, the server will know to ignore the
873
+ # request if it has already been completed.
874
+ #
875
+ # For example, consider a situation where you make an initial request and
876
+ # the request times out. If you make the request again with the same
877
+ # request ID, the server can check if original operation with the same
878
+ # request ID was received, and if so, will ignore the second request. This
879
+ # prevents clients from accidentally creating duplicate commitments.
880
+ #
881
+ # The request ID must be
882
+ # a valid UUID with the exception that zero UUID is not supported
883
+ # (00000000-0000-0000-0000-000000000000).
736
884
  # @param zone [::String]
737
885
  # The name of the zone for this request.
738
886
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -804,7 +952,9 @@ module Google
804
952
  end
805
953
 
806
954
  ##
807
- # Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs.
955
+ # Creates multiple instances. Count specifies the number of instances to
956
+ # create. For more information, seeAbout bulk
957
+ # creation of VMs.
808
958
  #
809
959
  # @overload bulk_insert(request, options = nil)
810
960
  # Pass arguments to `bulk_insert` via a request object, either of type
@@ -826,7 +976,19 @@ module Google
826
976
  # @param project [::String]
827
977
  # Project ID for this request.
828
978
  # @param request_id [::String]
829
- # 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).
979
+ # An optional request ID to identify requests. Specify a unique request ID so
980
+ # that if you must retry your request, the server will know to ignore the
981
+ # request if it has already been completed.
982
+ #
983
+ # For example, consider a situation where you make an initial request and
984
+ # the request times out. If you make the request again with the same
985
+ # request ID, the server can check if original operation with the same
986
+ # request ID was received, and if so, will ignore the second request. This
987
+ # prevents clients from accidentally creating duplicate commitments.
988
+ #
989
+ # The request ID must be
990
+ # a valid UUID with the exception that zero UUID is not supported
991
+ # (00000000-0000-0000-0000-000000000000).
830
992
  # @param zone [::String]
831
993
  # The name of the zone for this request.
832
994
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -898,7 +1060,8 @@ module Google
898
1060
  end
899
1061
 
900
1062
  ##
901
- # Deletes the specified Instance resource. For more information, see Deleting an instance.
1063
+ # Deletes the specified Instance resource. For more information, seeDeleting
1064
+ # an instance.
902
1065
  #
903
1066
  # @overload delete(request, options = nil)
904
1067
  # Pass arguments to `delete` via a request object, either of type
@@ -920,7 +1083,19 @@ module Google
920
1083
  # @param project [::String]
921
1084
  # Project ID for this request.
922
1085
  # @param request_id [::String]
923
- # 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).
1086
+ # An optional request ID to identify requests. Specify a unique request ID so
1087
+ # that if you must retry your request, the server will know to ignore the
1088
+ # request if it has already been completed.
1089
+ #
1090
+ # For example, consider a situation where you make an initial request and
1091
+ # the request times out. If you make the request again with the same
1092
+ # request ID, the server can check if original operation with the same
1093
+ # request ID was received, and if so, will ignore the second request. This
1094
+ # prevents clients from accidentally creating duplicate commitments.
1095
+ #
1096
+ # The request ID must be
1097
+ # a valid UUID with the exception that zero UUID is not supported
1098
+ # (00000000-0000-0000-0000-000000000000).
924
1099
  # @param zone [::String]
925
1100
  # The name of the zone for this request.
926
1101
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1018,7 +1193,19 @@ module Google
1018
1193
  # @param project [::String]
1019
1194
  # Project ID for this request.
1020
1195
  # @param request_id [::String]
1021
- # An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
1196
+ # An optional request ID to identify requests. Specify a unique request ID so
1197
+ # that if you must retry your request, the server will know to ignore the
1198
+ # request if it has already been completed.
1199
+ #
1200
+ # For example, consider a situation where you make an initial request and
1201
+ # the request times out. If you make the request again with the same
1202
+ # request ID, the server can check if original operation with the same
1203
+ # request ID was received, and if so, will ignore the second request. This
1204
+ # prevents clients from accidentally creating duplicate commitments.
1205
+ #
1206
+ # The request ID must be
1207
+ # a valid UUID with the exception that zero UUID is not supported
1208
+ # (00000000-0000-0000-0000-000000000000).
1022
1209
  # @param zone [::String]
1023
1210
  # The name of the zone for this request.
1024
1211
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1090,7 +1277,11 @@ module Google
1090
1277
  end
1091
1278
 
1092
1279
  ##
1093
- # Deletes one dynamic network interface from an active instance. InstancesDeleteNetworkInterfaceRequest indicates: - instance from which to delete, using project+zone+resource_id fields; - dynamic network interface to be deleted, using network_interface_name field;
1280
+ # Deletes one dynamic network interface from an active instance.
1281
+ # InstancesDeleteNetworkInterfaceRequest indicates:
1282
+ # - instance from which to delete, using project+zone+resource_id fields;
1283
+ # - dynamic network interface to be deleted, using network_interface_name
1284
+ # field;
1094
1285
  #
1095
1286
  # @overload delete_network_interface(request, options = nil)
1096
1287
  # Pass arguments to `delete_network_interface` via a request object, either of type
@@ -1108,13 +1299,26 @@ module Google
1108
1299
  # the default parameter values, pass an empty Hash as a request object (see above).
1109
1300
  #
1110
1301
  # @param instance [::String]
1111
- # The instance name for this request stored as resource_id. Name should conform to RFC1035 or be an unsigned long integer.
1302
+ # The instance name for this request stored as resource_id.
1303
+ # Name should conform to RFC1035 or be an unsigned long integer.
1112
1304
  # @param network_interface_name [::String]
1113
1305
  # The name of the dynamic network interface to be deleted from the instance.
1114
1306
  # @param project [::String]
1115
1307
  # Project ID for this request.
1116
1308
  # @param request_id [::String]
1117
- # 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).
1309
+ # An optional request ID to identify requests. Specify a unique request ID so
1310
+ # that if you must retry your request, the server will know to ignore the
1311
+ # request if it has already been completed.
1312
+ #
1313
+ # For example, consider a situation where you make an initial request and
1314
+ # the request times out. If you make the request again with the same
1315
+ # request ID, the server can check if original operation with the same
1316
+ # request ID was received, and if so, will ignore the second request. This
1317
+ # prevents clients from accidentally creating duplicate commitments.
1318
+ #
1319
+ # The request ID must be
1320
+ # a valid UUID with the exception that zero UUID is not supported
1321
+ # (00000000-0000-0000-0000-000000000000).
1118
1322
  # @param zone [::String]
1119
1323
  # The name of the zone for this request.
1120
1324
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1204,13 +1408,26 @@ module Google
1204
1408
  # the default parameter values, pass an empty Hash as a request object (see above).
1205
1409
  #
1206
1410
  # @param device_name [::String]
1207
- # The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names.
1411
+ # The device name of the disk to detach. Make a get() request on
1412
+ # the instance to view currently attached disks and device names.
1208
1413
  # @param instance [::String]
1209
1414
  # Instance name for this request.
1210
1415
  # @param project [::String]
1211
1416
  # Project ID for this request.
1212
1417
  # @param request_id [::String]
1213
- # 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).
1418
+ # An optional request ID to identify requests. Specify a unique request ID so
1419
+ # that if you must retry your request, the server will know to ignore the
1420
+ # request if it has already been completed.
1421
+ #
1422
+ # For example, consider a situation where you make an initial request and
1423
+ # the request times out. If you make the request again with the same
1424
+ # request ID, the server can check if original operation with the same
1425
+ # request ID was received, and if so, will ignore the second request. This
1426
+ # prevents clients from accidentally creating duplicate commitments.
1427
+ #
1428
+ # The request ID must be
1429
+ # a valid UUID with the exception that zero UUID is not supported
1430
+ # (00000000-0000-0000-0000-000000000000).
1214
1431
  # @param zone [::String]
1215
1432
  # The name of the zone for this request.
1216
1433
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1534,7 +1751,8 @@ module Google
1534
1751
  end
1535
1752
 
1536
1753
  ##
1537
- # Gets the access control policy for a resource. May be empty if no such policy or resource exists.
1754
+ # Gets the access control policy for a resource. May be empty if no such
1755
+ # policy or resource exists.
1538
1756
  #
1539
1757
  # @overload get_iam_policy(request, options = nil)
1540
1758
  # Pass arguments to `get_iam_policy` via a request object, either of type
@@ -1724,7 +1942,23 @@ module Google
1724
1942
  # @param project [::String]
1725
1943
  # Project ID for this request.
1726
1944
  # @param start [::Integer]
1727
- # Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console. Note that the negative start is bounded by the retained buffer size, and the returned serial console output will not exceed the max buffer size.
1945
+ # Specifies the starting byte position of the output to return. To start with
1946
+ # the first byte of output to the specified port, omit this field or set it
1947
+ # to `0`.
1948
+ #
1949
+ # If the output for that byte position is available, this field matches the
1950
+ # `start` parameter sent with the request. If the amount of serial console
1951
+ # output exceeds the size of the buffer (1 MB), the oldest output is
1952
+ # discarded and is no longer available. If the requested start position
1953
+ # refers to discarded output, the start position is adjusted to the oldest
1954
+ # output still available, and the adjusted start position is returned as the
1955
+ # `start` property value.
1956
+ #
1957
+ # You can also provide a negative start position, which translates to the
1958
+ # most recent number of bytes written to the serial port. For example, -3 is
1959
+ # interpreted as the most recent 3 bytes written to the serial console. Note
1960
+ # that the negative start is bounded by the retained buffer size, and the
1961
+ # returned serial console output will not exceed the max buffer size.
1728
1962
  # @param zone [::String]
1729
1963
  # The name of the zone for this request.
1730
1964
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1868,7 +2102,8 @@ module Google
1868
2102
  end
1869
2103
 
1870
2104
  ##
1871
- # Creates an instance resource in the specified project using the data included in the request.
2105
+ # Creates an instance resource in the specified project using the data
2106
+ # included in the request.
1872
2107
  #
1873
2108
  # @overload insert(request, options = nil)
1874
2109
  # Pass arguments to `insert` via a request object, either of type
@@ -1890,11 +2125,39 @@ module Google
1890
2125
  # @param project [::String]
1891
2126
  # Project ID for this request.
1892
2127
  # @param request_id [::String]
1893
- # 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).
2128
+ # An optional request ID to identify requests. Specify a unique request ID so
2129
+ # that if you must retry your request, the server will know to ignore the
2130
+ # request if it has already been completed.
2131
+ #
2132
+ # For example, consider a situation where you make an initial request and
2133
+ # the request times out. If you make the request again with the same
2134
+ # request ID, the server can check if original operation with the same
2135
+ # request ID was received, and if so, will ignore the second request. This
2136
+ # prevents clients from accidentally creating duplicate commitments.
2137
+ #
2138
+ # The request ID must be
2139
+ # a valid UUID with the exception that zero UUID is not supported
2140
+ # (00000000-0000-0000-0000-000000000000).
1894
2141
  # @param source_instance_template [::String]
1895
- # Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate
2142
+ # Specifies instance template to create the instance.
2143
+ #
2144
+ # This field is optional. It can be a full or partial URL. For example, the
2145
+ # following are all valid URLs to an instance template:
2146
+ #
2147
+ #
2148
+ # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
2149
+ # - projects/project/global/instanceTemplates/instanceTemplate
2150
+ # - global/instanceTemplates/instanceTemplate
1896
2151
  # @param source_machine_image [::String]
1897
- # Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage
2152
+ # Specifies the machine image to use to create the instance.
2153
+ #
2154
+ # This field is optional. It can be a full or partial URL. For example, the
2155
+ # following are all valid URLs to a machine image:
2156
+ #
2157
+ #
2158
+ # - https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage
2159
+ # - projects/project/global/global/machineImages/machineImage
2160
+ # - global/machineImages/machineImage
1898
2161
  # @param zone [::String]
1899
2162
  # The name of the zone for this request.
1900
2163
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1966,7 +2229,8 @@ module Google
1966
2229
  end
1967
2230
 
1968
2231
  ##
1969
- # Retrieves the list of instances contained within the specified zone.
2232
+ # Retrieves the list of instances contained within
2233
+ # the specified zone.
1970
2234
  #
1971
2235
  # @overload list(request, options = nil)
1972
2236
  # Pass arguments to `list` via a request object, either of type
@@ -1984,17 +2248,95 @@ module Google
1984
2248
  # the default parameter values, pass an empty Hash as a request object (see above).
1985
2249
  #
1986
2250
  # @param filter [::String]
1987
- # 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.
2251
+ # A filter expression that filters resources listed in the response. Most
2252
+ # Compute resources support two types of filter expressions:
2253
+ # expressions that support regular expressions and expressions that follow
2254
+ # API improvement proposal AIP-160.
2255
+ # These two types of filter expressions cannot be mixed in one request.
2256
+ #
2257
+ # If you want to use AIP-160, your expression must specify the field name, an
2258
+ # operator, and the value that you want to use for filtering. The value
2259
+ # must be a string, a number, or a boolean. The operator
2260
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
2261
+ #
2262
+ # For example, if you are filtering Compute Engine instances, you can
2263
+ # exclude instances named `example-instance` by specifying
2264
+ # `name != example-instance`.
2265
+ #
2266
+ # The `:*` comparison can be used to test whether a key has been defined.
2267
+ # For example, to find all objects with `owner` label use:
2268
+ # ```
2269
+ # labels.owner:*
2270
+ # ```
2271
+ #
2272
+ # You can also filter nested fields. For example, you could specify
2273
+ # `scheduling.automaticRestart = false` to include instances only
2274
+ # if they are not scheduled for automatic restarts. You can use filtering
2275
+ # on nested fields to filter based onresource labels.
2276
+ #
2277
+ # To filter on multiple expressions, provide each separate expression within
2278
+ # parentheses. For example:
2279
+ # ```
2280
+ # (scheduling.automaticRestart = true)
2281
+ # (cpuPlatform = "Intel Skylake")
2282
+ # ```
2283
+ # By default, each expression is an `AND` expression. However, you
2284
+ # can include `AND` and `OR` expressions explicitly.
2285
+ # For example:
2286
+ # ```
2287
+ # (cpuPlatform = "Intel Skylake") OR
2288
+ # (cpuPlatform = "Intel Broadwell") AND
2289
+ # (scheduling.automaticRestart = true)
2290
+ # ```
2291
+ #
2292
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
2293
+ # (not equal) operator against a single un-parenthesized expression with or
2294
+ # without quotes or against multiple parenthesized expressions. Examples:
2295
+ #
2296
+ # `fieldname eq unquoted literal`
2297
+ # `fieldname eq 'single quoted literal'`
2298
+ # `fieldname eq "double quoted literal"`
2299
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
2300
+ #
2301
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
2302
+ # The literal value must match the entire field.
2303
+ #
2304
+ # For example, to filter for instances that do not end with name "instance",
2305
+ # you would use `name ne .*instance`.
2306
+ #
2307
+ # You cannot combine constraints on multiple fields using regular
2308
+ # expressions.
1988
2309
  # @param max_results [::Integer]
1989
- # 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`)
2310
+ # The maximum number of results per page that should be returned.
2311
+ # If the number of available results is larger than `maxResults`,
2312
+ # Compute Engine returns a `nextPageToken` that can be used to get
2313
+ # the next page of results in subsequent list requests. Acceptable values are
2314
+ # `0` to `500`, inclusive. (Default: `500`)
1990
2315
  # @param order_by [::String]
1991
- # 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.
2316
+ # Sorts list results by a certain order. By default, results
2317
+ # are returned in alphanumerical order based on the resource name.
2318
+ #
2319
+ # You can also sort results in descending order based on the creation
2320
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
2321
+ # results based on the `creationTimestamp` field in
2322
+ # reverse chronological order (newest result first). Use this to sort
2323
+ # resources like operations so that the newest operation is returned first.
2324
+ #
2325
+ # Currently, only sorting by `name` or
2326
+ # `creationTimestamp desc` is supported.
1992
2327
  # @param page_token [::String]
1993
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
2328
+ # Specifies a page token to use. Set `pageToken` to the
2329
+ # `nextPageToken` returned by a previous list request to get
2330
+ # the next page of results.
1994
2331
  # @param project [::String]
1995
2332
  # Project ID for this request.
1996
2333
  # @param return_partial_success [::Boolean]
1997
- # 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.
2334
+ # Opt-in for partial success behavior which provides partial results in case
2335
+ # of failure. The default value is false.
2336
+ #
2337
+ # For example, when partial success behavior is enabled, aggregatedList for a
2338
+ # single zone scope either returns all resources in the zone or no resources,
2339
+ # with an error code.
1998
2340
  # @param zone [::String]
1999
2341
  # The name of the zone for this request.
2000
2342
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2058,7 +2400,11 @@ module Google
2058
2400
  end
2059
2401
 
2060
2402
  ##
2061
- # Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances.
2403
+ # Retrieves a list of resources that refer to the VM instance specified in
2404
+ # the request. For example, if the VM instance is part of a managed or
2405
+ # unmanaged instance group, the referrers list includes the instance group.
2406
+ # For more information, readViewing
2407
+ # referrers to VM instances.
2062
2408
  #
2063
2409
  # @overload list_referrers(request, options = nil)
2064
2410
  # Pass arguments to `list_referrers` via a request object, either of type
@@ -2076,19 +2422,98 @@ module Google
2076
2422
  # the default parameter values, pass an empty Hash as a request object (see above).
2077
2423
  #
2078
2424
  # @param filter [::String]
2079
- # 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.
2425
+ # A filter expression that filters resources listed in the response. Most
2426
+ # Compute resources support two types of filter expressions:
2427
+ # expressions that support regular expressions and expressions that follow
2428
+ # API improvement proposal AIP-160.
2429
+ # These two types of filter expressions cannot be mixed in one request.
2430
+ #
2431
+ # If you want to use AIP-160, your expression must specify the field name, an
2432
+ # operator, and the value that you want to use for filtering. The value
2433
+ # must be a string, a number, or a boolean. The operator
2434
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
2435
+ #
2436
+ # For example, if you are filtering Compute Engine instances, you can
2437
+ # exclude instances named `example-instance` by specifying
2438
+ # `name != example-instance`.
2439
+ #
2440
+ # The `:*` comparison can be used to test whether a key has been defined.
2441
+ # For example, to find all objects with `owner` label use:
2442
+ # ```
2443
+ # labels.owner:*
2444
+ # ```
2445
+ #
2446
+ # You can also filter nested fields. For example, you could specify
2447
+ # `scheduling.automaticRestart = false` to include instances only
2448
+ # if they are not scheduled for automatic restarts. You can use filtering
2449
+ # on nested fields to filter based onresource labels.
2450
+ #
2451
+ # To filter on multiple expressions, provide each separate expression within
2452
+ # parentheses. For example:
2453
+ # ```
2454
+ # (scheduling.automaticRestart = true)
2455
+ # (cpuPlatform = "Intel Skylake")
2456
+ # ```
2457
+ # By default, each expression is an `AND` expression. However, you
2458
+ # can include `AND` and `OR` expressions explicitly.
2459
+ # For example:
2460
+ # ```
2461
+ # (cpuPlatform = "Intel Skylake") OR
2462
+ # (cpuPlatform = "Intel Broadwell") AND
2463
+ # (scheduling.automaticRestart = true)
2464
+ # ```
2465
+ #
2466
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
2467
+ # (not equal) operator against a single un-parenthesized expression with or
2468
+ # without quotes or against multiple parenthesized expressions. Examples:
2469
+ #
2470
+ # `fieldname eq unquoted literal`
2471
+ # `fieldname eq 'single quoted literal'`
2472
+ # `fieldname eq "double quoted literal"`
2473
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
2474
+ #
2475
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
2476
+ # The literal value must match the entire field.
2477
+ #
2478
+ # For example, to filter for instances that do not end with name "instance",
2479
+ # you would use `name ne .*instance`.
2480
+ #
2481
+ # You cannot combine constraints on multiple fields using regular
2482
+ # expressions.
2080
2483
  # @param instance [::String]
2081
- # Name of the target instance scoping this request, or '-' if the request should span over all instances in the container.
2484
+ # Name of the target instance scoping this request, or '-' if the
2485
+ # request should span over all instances in the container.
2082
2486
  # @param max_results [::Integer]
2083
- # 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`)
2487
+ # The maximum number of results per page that should be returned.
2488
+ # If the number of available results is larger than `maxResults`,
2489
+ # Compute Engine returns a `nextPageToken` that can be used to get
2490
+ # the next page of results in subsequent list requests. Acceptable values are
2491
+ # `0` to `500`, inclusive. (Default: `500`)
2084
2492
  # @param order_by [::String]
2085
- # 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.
2493
+ # Sorts list results by a certain order. By default, results
2494
+ # are returned in alphanumerical order based on the resource name.
2495
+ #
2496
+ # You can also sort results in descending order based on the creation
2497
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
2498
+ # results based on the `creationTimestamp` field in
2499
+ # reverse chronological order (newest result first). Use this to sort
2500
+ # resources like operations so that the newest operation is returned first.
2501
+ #
2502
+ # Currently, only sorting by `name` or
2503
+ # `creationTimestamp desc` is supported.
2086
2504
  # @param page_token [::String]
2087
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
2505
+ # Specifies a page token to use. Set `pageToken` to the
2506
+ # `nextPageToken` returned by a previous list request to get
2507
+ # the next page of results.
2088
2508
  # @param project [::String]
2089
2509
  # Project ID for this request.
2090
2510
  # @param return_partial_success [::Boolean]
2091
- # 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.
2511
+ # Opt-in for partial success behavior which provides partial results in case
2512
+ # of failure. The default value is false.
2513
+ #
2514
+ # For example, when partial success behavior is enabled, aggregatedList for a
2515
+ # single zone scope either returns all resources in the zone or no resources,
2516
+ # with an error code.
2092
2517
  # @param zone [::String]
2093
2518
  # The name of the zone for this request.
2094
2519
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2174,7 +2599,19 @@ module Google
2174
2599
  # @param project [::String]
2175
2600
  # Project ID for this request.
2176
2601
  # @param request_id [::String]
2177
- # 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).
2602
+ # An optional request ID to identify requests. Specify a unique request ID so
2603
+ # that if you must retry your request, the server will know to ignore the
2604
+ # request if it has already been completed.
2605
+ #
2606
+ # For example, consider a situation where you make an initial request and
2607
+ # the request times out. If you make the request again with the same
2608
+ # request ID, the server can check if original operation with the same
2609
+ # request ID was received, and if so, will ignore the second request. This
2610
+ # prevents clients from accidentally creating duplicate commitments.
2611
+ #
2612
+ # The request ID must be
2613
+ # a valid UUID with the exception that zero UUID is not supported
2614
+ # (00000000-0000-0000-0000-000000000000).
2178
2615
  # @param zone [::String]
2179
2616
  # The name of the zone for this request.
2180
2617
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2270,7 +2707,19 @@ module Google
2270
2707
  # @param project [::String]
2271
2708
  # Project ID for this request.
2272
2709
  # @param request_id [::String]
2273
- # 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).
2710
+ # An optional request ID to identify requests. Specify a unique request ID so
2711
+ # that if you must retry your request, the server will know to ignore the
2712
+ # request if it has already been completed.
2713
+ #
2714
+ # For example, consider a situation where you make an initial request and
2715
+ # the request times out. If you make the request again with the same
2716
+ # request ID, the server can check if original operation with the same
2717
+ # request ID was received, and if so, will ignore the second request. This
2718
+ # prevents clients from accidentally creating duplicate commitments.
2719
+ #
2720
+ # The request ID must be
2721
+ # a valid UUID with the exception that zero UUID is not supported
2722
+ # (00000000-0000-0000-0000-000000000000).
2274
2723
  # @param zone [::String]
2275
2724
  # The name of the zone for this request.
2276
2725
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2366,7 +2815,19 @@ module Google
2366
2815
  # @param project [::String]
2367
2816
  # Project ID for this request.
2368
2817
  # @param request_id [::String]
2369
- # 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).
2818
+ # An optional request ID to identify requests. Specify a unique request ID so
2819
+ # that if you must retry your request, the server will know to ignore the
2820
+ # request if it has already been completed.
2821
+ #
2822
+ # For example, consider a situation where you make an initial request and
2823
+ # the request times out. If you make the request again with the same
2824
+ # request ID, the server can check if original operation with the same
2825
+ # request ID was received, and if so, will ignore the second request. This
2826
+ # prevents clients from accidentally creating duplicate commitments.
2827
+ #
2828
+ # The request ID must be
2829
+ # a valid UUID with the exception that zero UUID is not supported
2830
+ # (00000000-0000-0000-0000-000000000000).
2370
2831
  # @param zone [::String]
2371
2832
  # The name of the zone for this request.
2372
2833
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2438,7 +2899,9 @@ module Google
2438
2899
  end
2439
2900
 
2440
2901
  ##
2441
- # Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance.
2902
+ # Performs a reset on the instance. This is a hard reset. The VM
2903
+ # does not do a graceful shutdown. For more information, seeResetting
2904
+ # an instance.
2442
2905
  #
2443
2906
  # @overload reset(request, options = nil)
2444
2907
  # Pass arguments to `reset` via a request object, either of type
@@ -2460,7 +2923,19 @@ module Google
2460
2923
  # @param project [::String]
2461
2924
  # Project ID for this request.
2462
2925
  # @param request_id [::String]
2463
- # 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).
2926
+ # An optional request ID to identify requests. Specify a unique request ID so
2927
+ # that if you must retry your request, the server will know to ignore the
2928
+ # request if it has already been completed.
2929
+ #
2930
+ # For example, consider a situation where you make an initial request and
2931
+ # the request times out. If you make the request again with the same
2932
+ # request ID, the server can check if original operation with the same
2933
+ # request ID was received, and if so, will ignore the second request. This
2934
+ # prevents clients from accidentally creating duplicate commitments.
2935
+ #
2936
+ # The request ID must be
2937
+ # a valid UUID with the exception that zero UUID is not supported
2938
+ # (00000000-0000-0000-0000-000000000000).
2464
2939
  # @param zone [::String]
2465
2940
  # The name of the zone for this request.
2466
2941
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2532,7 +3007,8 @@ module Google
2532
3007
  end
2533
3008
 
2534
3009
  ##
2535
- # Resumes an instance that was suspended using the instances().suspend method.
3010
+ # Resumes an instance that was suspended using theinstances().suspend
3011
+ # method.
2536
3012
  #
2537
3013
  # @overload resume(request, options = nil)
2538
3014
  # Pass arguments to `resume` via a request object, either of type
@@ -2554,7 +3030,19 @@ module Google
2554
3030
  # @param project [::String]
2555
3031
  # Project ID for this request.
2556
3032
  # @param request_id [::String]
2557
- # 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).
3033
+ # An optional request ID to identify requests. Specify a unique request ID so
3034
+ # that if you must retry your request, the server will know to ignore the
3035
+ # request if it has already been completed.
3036
+ #
3037
+ # For example, consider a situation where you make an initial request and
3038
+ # the request times out. If you make the request again with the same
3039
+ # request ID, the server can check if original operation with the same
3040
+ # request ID was received, and if so, will ignore the second request. This
3041
+ # prevents clients from accidentally creating duplicate commitments.
3042
+ #
3043
+ # The request ID must be
3044
+ # a valid UUID with the exception that zero UUID is not supported
3045
+ # (00000000-0000-0000-0000-000000000000).
2558
3046
  # @param zone [::String]
2559
3047
  # The name of the zone for this request.
2560
3048
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2730,7 +3218,19 @@ module Google
2730
3218
  # @param project [::String]
2731
3219
  # Project ID for this request.
2732
3220
  # @param request_id [::String]
2733
- # 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).
3221
+ # An optional request ID to identify requests. Specify a unique request ID so
3222
+ # that if you must retry your request, the server will know to ignore the
3223
+ # request if it has already been completed.
3224
+ #
3225
+ # For example, consider a situation where you make an initial request and
3226
+ # the request times out. If you make the request again with the same
3227
+ # request ID, the server can check if original operation with the same
3228
+ # request ID was received, and if so, will ignore the second request. This
3229
+ # prevents clients from accidentally creating duplicate commitments.
3230
+ #
3231
+ # The request ID must be
3232
+ # a valid UUID with the exception that zero UUID is not supported
3233
+ # (00000000-0000-0000-0000-000000000000).
2734
3234
  # @param resource [::String]
2735
3235
  # Name or id of the resource for this request.
2736
3236
  # @param zone [::String]
@@ -2824,13 +3324,26 @@ module Google
2824
3324
  # @param auto_delete [::Boolean]
2825
3325
  # Whether to auto-delete the disk when the instance is deleted.
2826
3326
  # @param device_name [::String]
2827
- # The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names.
3327
+ # The device name of the disk to modify. Make a get() request
3328
+ # on the instance to view currently attached disks and device names.
2828
3329
  # @param instance [::String]
2829
3330
  # The instance name for this request.
2830
3331
  # @param project [::String]
2831
3332
  # Project ID for this request.
2832
3333
  # @param request_id [::String]
2833
- # 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).
3334
+ # An optional request ID to identify requests. Specify a unique request ID so
3335
+ # that if you must retry your request, the server will know to ignore the
3336
+ # request if it has already been completed.
3337
+ #
3338
+ # For example, consider a situation where you make an initial request and
3339
+ # the request times out. If you make the request again with the same
3340
+ # request ID, the server can check if original operation with the same
3341
+ # request ID was received, and if so, will ignore the second request. This
3342
+ # prevents clients from accidentally creating duplicate commitments.
3343
+ #
3344
+ # The request ID must be
3345
+ # a valid UUID with the exception that zero UUID is not supported
3346
+ # (00000000-0000-0000-0000-000000000000).
2834
3347
  # @param zone [::String]
2835
3348
  # The name of the zone for this request.
2836
3349
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2902,7 +3415,8 @@ module Google
2902
3415
  end
2903
3416
 
2904
3417
  ##
2905
- # Sets the access control policy on the specified resource. Replaces any existing policy.
3418
+ # Sets the access control policy on the specified resource.
3419
+ # Replaces any existing policy.
2906
3420
  #
2907
3421
  # @overload set_iam_policy(request, options = nil)
2908
3422
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -2986,7 +3500,8 @@ module Google
2986
3500
  end
2987
3501
 
2988
3502
  ##
2989
- # Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation.
3503
+ # Sets labels on an instance. To learn more about labels, read theLabeling
3504
+ # Resources documentation.
2990
3505
  #
2991
3506
  # @overload set_labels(request, options = nil)
2992
3507
  # Pass arguments to `set_labels` via a request object, either of type
@@ -3010,7 +3525,19 @@ module Google
3010
3525
  # @param project [::String]
3011
3526
  # Project ID for this request.
3012
3527
  # @param request_id [::String]
3013
- # 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).
3528
+ # An optional request ID to identify requests. Specify a unique request ID so
3529
+ # that if you must retry your request, the server will know to ignore the
3530
+ # request if it has already been completed.
3531
+ #
3532
+ # For example, consider a situation where you make an initial request and
3533
+ # the request times out. If you make the request again with the same
3534
+ # request ID, the server can check if original operation with the same
3535
+ # request ID was received, and if so, will ignore the second request. This
3536
+ # prevents clients from accidentally creating duplicate commitments.
3537
+ #
3538
+ # The request ID must be
3539
+ # a valid UUID with the exception that zero UUID is not supported
3540
+ # (00000000-0000-0000-0000-000000000000).
3014
3541
  # @param zone [::String]
3015
3542
  # The name of the zone for this request.
3016
3543
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3082,7 +3609,8 @@ module Google
3082
3609
  end
3083
3610
 
3084
3611
  ##
3085
- # Changes the number and/or type of accelerator for a stopped instance to the values specified in the request.
3612
+ # Changes the number and/or type of accelerator for a stopped instance to the
3613
+ # values specified in the request.
3086
3614
  #
3087
3615
  # @overload set_machine_resources(request, options = nil)
3088
3616
  # Pass arguments to `set_machine_resources` via a request object, either of type
@@ -3106,7 +3634,19 @@ module Google
3106
3634
  # @param project [::String]
3107
3635
  # Project ID for this request.
3108
3636
  # @param request_id [::String]
3109
- # 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).
3637
+ # An optional request ID to identify requests. Specify a unique request ID so
3638
+ # that if you must retry your request, the server will know to ignore the
3639
+ # request if it has already been completed.
3640
+ #
3641
+ # For example, consider a situation where you make an initial request and
3642
+ # the request times out. If you make the request again with the same
3643
+ # request ID, the server can check if original operation with the same
3644
+ # request ID was received, and if so, will ignore the second request. This
3645
+ # prevents clients from accidentally creating duplicate commitments.
3646
+ #
3647
+ # The request ID must be
3648
+ # a valid UUID with the exception that zero UUID is not supported
3649
+ # (00000000-0000-0000-0000-000000000000).
3110
3650
  # @param zone [::String]
3111
3651
  # The name of the zone for this request.
3112
3652
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3178,7 +3718,8 @@ module Google
3178
3718
  end
3179
3719
 
3180
3720
  ##
3181
- # Changes the machine type for a stopped instance to the machine type specified in the request.
3721
+ # Changes the machine type for a stopped instance to the machine
3722
+ # type specified in the request.
3182
3723
  #
3183
3724
  # @overload set_machine_type(request, options = nil)
3184
3725
  # Pass arguments to `set_machine_type` via a request object, either of type
@@ -3202,7 +3743,19 @@ module Google
3202
3743
  # @param project [::String]
3203
3744
  # Project ID for this request.
3204
3745
  # @param request_id [::String]
3205
- # 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).
3746
+ # An optional request ID to identify requests. Specify a unique request ID so
3747
+ # that if you must retry your request, the server will know to ignore the
3748
+ # request if it has already been completed.
3749
+ #
3750
+ # For example, consider a situation where you make an initial request and
3751
+ # the request times out. If you make the request again with the same
3752
+ # request ID, the server can check if original operation with the same
3753
+ # request ID was received, and if so, will ignore the second request. This
3754
+ # prevents clients from accidentally creating duplicate commitments.
3755
+ #
3756
+ # The request ID must be
3757
+ # a valid UUID with the exception that zero UUID is not supported
3758
+ # (00000000-0000-0000-0000-000000000000).
3206
3759
  # @param zone [::String]
3207
3760
  # The name of the zone for this request.
3208
3761
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3274,7 +3827,8 @@ module Google
3274
3827
  end
3275
3828
 
3276
3829
  ##
3277
- # Sets metadata for the specified instance to the data included in the request.
3830
+ # Sets metadata for the specified instance to the data included
3831
+ # in the request.
3278
3832
  #
3279
3833
  # @overload set_metadata(request, options = nil)
3280
3834
  # Pass arguments to `set_metadata` via a request object, either of type
@@ -3298,7 +3852,19 @@ module Google
3298
3852
  # @param project [::String]
3299
3853
  # Project ID for this request.
3300
3854
  # @param request_id [::String]
3301
- # 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).
3855
+ # An optional request ID to identify requests. Specify a unique request ID so
3856
+ # that if you must retry your request, the server will know to ignore the
3857
+ # request if it has already been completed.
3858
+ #
3859
+ # For example, consider a situation where you make an initial request and
3860
+ # the request times out. If you make the request again with the same
3861
+ # request ID, the server can check if original operation with the same
3862
+ # request ID was received, and if so, will ignore the second request. This
3863
+ # prevents clients from accidentally creating duplicate commitments.
3864
+ #
3865
+ # The request ID must be
3866
+ # a valid UUID with the exception that zero UUID is not supported
3867
+ # (00000000-0000-0000-0000-000000000000).
3302
3868
  # @param zone [::String]
3303
3869
  # The name of the zone for this request.
3304
3870
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3370,7 +3936,10 @@ module Google
3370
3936
  end
3371
3937
 
3372
3938
  ##
3373
- # Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform.
3939
+ # Changes the minimum CPU platform that this instance should use.
3940
+ # This method can only
3941
+ # be called on a stopped instance. For more information, readSpecifying a
3942
+ # Minimum CPU Platform.
3374
3943
  #
3375
3944
  # @overload set_min_cpu_platform(request, options = nil)
3376
3945
  # Pass arguments to `set_min_cpu_platform` via a request object, either of type
@@ -3394,7 +3963,19 @@ module Google
3394
3963
  # @param project [::String]
3395
3964
  # Project ID for this request.
3396
3965
  # @param request_id [::String]
3397
- # 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).
3966
+ # An optional request ID to identify requests. Specify a unique request ID so
3967
+ # that if you must retry your request, the server will know to ignore the
3968
+ # request if it has already been completed.
3969
+ #
3970
+ # For example, consider a situation where you make an initial request and
3971
+ # the request times out. If you make the request again with the same
3972
+ # request ID, the server can check if original operation with the same
3973
+ # request ID was received, and if so, will ignore the second request. This
3974
+ # prevents clients from accidentally creating duplicate commitments.
3975
+ #
3976
+ # The request ID must be
3977
+ # a valid UUID with the exception that zero UUID is not supported
3978
+ # (00000000-0000-0000-0000-000000000000).
3398
3979
  # @param zone [::String]
3399
3980
  # The name of the zone for this request.
3400
3981
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3490,7 +4071,19 @@ module Google
3490
4071
  # @param project [::String]
3491
4072
  # Project ID for this request.
3492
4073
  # @param request_id [::String]
3493
- # 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).
4074
+ # An optional request ID to identify requests. Specify a unique request ID so
4075
+ # that if you must retry your request, the server will know to ignore the
4076
+ # request if it has already been completed.
4077
+ #
4078
+ # For example, consider a situation where you make an initial request and
4079
+ # the request times out. If you make the request again with the same
4080
+ # request ID, the server can check if original operation with the same
4081
+ # request ID was received, and if so, will ignore the second request. This
4082
+ # prevents clients from accidentally creating duplicate commitments.
4083
+ #
4084
+ # The request ID must be
4085
+ # a valid UUID with the exception that zero UUID is not supported
4086
+ # (00000000-0000-0000-0000-000000000000).
3494
4087
  # @param zone [::String]
3495
4088
  # The name of the zone for this request.
3496
4089
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3562,7 +4155,11 @@ module Google
3562
4155
  end
3563
4156
 
3564
4157
  ##
3565
- # Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy.
4158
+ # Sets an instance's scheduling options. You can only call this method on astopped instance,
4159
+ # that is, a VM instance that is in a `TERMINATED` state. SeeInstance Life
4160
+ # Cycle for more information on the possible instance states.
4161
+ # For more information about setting scheduling options for a VM, seeSet
4162
+ # VM host maintenance policy.
3566
4163
  #
3567
4164
  # @overload set_scheduling(request, options = nil)
3568
4165
  # Pass arguments to `set_scheduling` via a request object, either of type
@@ -3584,7 +4181,19 @@ module Google
3584
4181
  # @param project [::String]
3585
4182
  # Project ID for this request.
3586
4183
  # @param request_id [::String]
3587
- # 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).
4184
+ # An optional request ID to identify requests. Specify a unique request ID so
4185
+ # that if you must retry your request, the server will know to ignore the
4186
+ # request if it has already been completed.
4187
+ #
4188
+ # For example, consider a situation where you make an initial request and
4189
+ # the request times out. If you make the request again with the same
4190
+ # request ID, the server can check if original operation with the same
4191
+ # request ID was received, and if so, will ignore the second request. This
4192
+ # prevents clients from accidentally creating duplicate commitments.
4193
+ #
4194
+ # The request ID must be
4195
+ # a valid UUID with the exception that zero UUID is not supported
4196
+ # (00000000-0000-0000-0000-000000000000).
3588
4197
  # @param scheduling_resource [::Google::Cloud::Compute::V1::Scheduling, ::Hash]
3589
4198
  # The body resource for this request
3590
4199
  # @param zone [::String]
@@ -3658,7 +4267,9 @@ module Google
3658
4267
  end
3659
4268
 
3660
4269
  ##
3661
- # Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview
4270
+ # Sets the Google Cloud Armor security policy for the specified instance.
4271
+ # For more information, seeGoogle
4272
+ # Cloud Armor Overview
3662
4273
  #
3663
4274
  # @overload set_security_policy(request, options = nil)
3664
4275
  # Pass arguments to `set_security_policy` via a request object, either of type
@@ -3676,13 +4287,26 @@ module Google
3676
4287
  # the default parameter values, pass an empty Hash as a request object (see above).
3677
4288
  #
3678
4289
  # @param instance [::String]
3679
- # Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035.
4290
+ # Name of the Instance resource to which the security policy should be
4291
+ # set. The name should conform to RFC1035.
3680
4292
  # @param instances_set_security_policy_request_resource [::Google::Cloud::Compute::V1::InstancesSetSecurityPolicyRequest, ::Hash]
3681
4293
  # The body resource for this request
3682
4294
  # @param project [::String]
3683
4295
  # Project ID for this request.
3684
4296
  # @param request_id [::String]
3685
- # 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).
4297
+ # An optional request ID to identify requests. Specify a unique request ID so
4298
+ # that if you must retry your request, the server will know to ignore the
4299
+ # request if it has already been completed.
4300
+ #
4301
+ # For example, consider a situation where you make an initial request and
4302
+ # the request times out. If you make the request again with the same
4303
+ # request ID, the server can check if original operation with the same
4304
+ # request ID was received, and if so, will ignore the second request. This
4305
+ # prevents clients from accidentally creating duplicate commitments.
4306
+ #
4307
+ # The request ID must be
4308
+ # a valid UUID with the exception that zero UUID is not supported
4309
+ # (00000000-0000-0000-0000-000000000000).
3686
4310
  # @param zone [::String]
3687
4311
  # Name of the zone scoping this request.
3688
4312
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3754,7 +4378,9 @@ module Google
3754
4378
  end
3755
4379
 
3756
4380
  ##
3757
- # Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance.
4381
+ # Sets the service account on the instance. For more information,
4382
+ # readChanging
4383
+ # the service account and access scopes for an instance.
3758
4384
  #
3759
4385
  # @overload set_service_account(request, options = nil)
3760
4386
  # Pass arguments to `set_service_account` via a request object, either of type
@@ -3778,7 +4404,19 @@ module Google
3778
4404
  # @param project [::String]
3779
4405
  # Project ID for this request.
3780
4406
  # @param request_id [::String]
3781
- # 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).
4407
+ # An optional request ID to identify requests. Specify a unique request ID so
4408
+ # that if you must retry your request, the server will know to ignore the
4409
+ # request if it has already been completed.
4410
+ #
4411
+ # For example, consider a situation where you make an initial request and
4412
+ # the request times out. If you make the request again with the same
4413
+ # request ID, the server can check if original operation with the same
4414
+ # request ID was received, and if so, will ignore the second request. This
4415
+ # prevents clients from accidentally creating duplicate commitments.
4416
+ #
4417
+ # The request ID must be
4418
+ # a valid UUID with the exception that zero UUID is not supported
4419
+ # (00000000-0000-0000-0000-000000000000).
3782
4420
  # @param zone [::String]
3783
4421
  # The name of the zone for this request.
3784
4422
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -3850,7 +4488,10 @@ module Google
3850
4488
  end
3851
4489
 
3852
4490
  ##
3853
- # Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
4491
+ # Sets the Shielded Instance integrity policy for an instance. You can
4492
+ # only use this method on a running instance. This method
4493
+ # supports PATCH semantics and uses the JSON merge
4494
+ # patch format and processing rules.
3854
4495
  #
3855
4496
  # @overload set_shielded_instance_integrity_policy(request, options = nil)
3856
4497
  # Pass arguments to `set_shielded_instance_integrity_policy` via a request object, either of type
@@ -3872,7 +4513,19 @@ module Google
3872
4513
  # @param project [::String]
3873
4514
  # Project ID for this request.
3874
4515
  # @param request_id [::String]
3875
- # 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).
4516
+ # An optional request ID to identify requests. Specify a unique request ID so
4517
+ # that if you must retry your request, the server will know to ignore the
4518
+ # request if it has already been completed.
4519
+ #
4520
+ # For example, consider a situation where you make an initial request and
4521
+ # the request times out. If you make the request again with the same
4522
+ # request ID, the server can check if original operation with the same
4523
+ # request ID was received, and if so, will ignore the second request. This
4524
+ # prevents clients from accidentally creating duplicate commitments.
4525
+ #
4526
+ # The request ID must be
4527
+ # a valid UUID with the exception that zero UUID is not supported
4528
+ # (00000000-0000-0000-0000-000000000000).
3876
4529
  # @param shielded_instance_integrity_policy_resource [::Google::Cloud::Compute::V1::ShieldedInstanceIntegrityPolicy, ::Hash]
3877
4530
  # The body resource for this request
3878
4531
  # @param zone [::String]
@@ -3946,7 +4599,8 @@ module Google
3946
4599
  end
3947
4600
 
3948
4601
  ##
3949
- # Sets network tags for the specified instance to the data included in the request.
4602
+ # Sets network tags
4603
+ # for the specified instance to the data included in the request.
3950
4604
  #
3951
4605
  # @overload set_tags(request, options = nil)
3952
4606
  # Pass arguments to `set_tags` via a request object, either of type
@@ -3968,7 +4622,19 @@ module Google
3968
4622
  # @param project [::String]
3969
4623
  # Project ID for this request.
3970
4624
  # @param request_id [::String]
3971
- # 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).
4625
+ # An optional request ID to identify requests. Specify a unique request ID so
4626
+ # that if you must retry your request, the server will know to ignore the
4627
+ # request if it has already been completed.
4628
+ #
4629
+ # For example, consider a situation where you make an initial request and
4630
+ # the request times out. If you make the request again with the same
4631
+ # request ID, the server can check if original operation with the same
4632
+ # request ID was received, and if so, will ignore the second request. This
4633
+ # prevents clients from accidentally creating duplicate commitments.
4634
+ #
4635
+ # The request ID must be
4636
+ # a valid UUID with the exception that zero UUID is not supported
4637
+ # (00000000-0000-0000-0000-000000000000).
3972
4638
  # @param tags_resource [::Google::Cloud::Compute::V1::Tags, ::Hash]
3973
4639
  # The body resource for this request
3974
4640
  # @param zone [::String]
@@ -4042,7 +4708,8 @@ module Google
4042
4708
  end
4043
4709
 
4044
4710
  ##
4045
- # Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event.
4711
+ # Simulates a host maintenance event on a VM. For more information, see
4712
+ # Simulate a host maintenance event.
4046
4713
  #
4047
4714
  # @overload simulate_maintenance_event(request, options = nil)
4048
4715
  # Pass arguments to `simulate_maintenance_event` via a request object, either of type
@@ -4064,9 +4731,22 @@ module Google
4064
4731
  # @param project [::String]
4065
4732
  # Project ID for this request.
4066
4733
  # @param request_id [::String]
4067
- # 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).
4734
+ # An optional request ID to identify requests. Specify a unique request ID so
4735
+ # that if you must retry your request, the server will know to ignore the
4736
+ # request if it has already been completed.
4737
+ #
4738
+ # For example, consider a situation where you make an initial request and
4739
+ # the request times out. If you make the request again with the same
4740
+ # request ID, the server can check if original operation with the same
4741
+ # request ID was received, and if so, will ignore the second request. This
4742
+ # prevents clients from accidentally creating duplicate commitments.
4743
+ #
4744
+ # The request ID must be
4745
+ # a valid UUID with the exception that zero UUID is not supported
4746
+ # (00000000-0000-0000-0000-000000000000).
4068
4747
  # @param with_extended_notifications [::Boolean]
4069
- # Determines whether the customers receive notifications before migration. Only applicable to SF vms.
4748
+ # Determines whether the customers receive notifications before migration.
4749
+ # Only applicable to SF vms.
4070
4750
  # @param zone [::String]
4071
4751
  # The name of the zone for this request.
4072
4752
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4138,7 +4818,9 @@ module Google
4138
4818
  end
4139
4819
 
4140
4820
  ##
4141
- # Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance.
4821
+ # Starts an instance that was stopped using theinstances().stop
4822
+ # method. For more information, seeRestart an
4823
+ # instance.
4142
4824
  #
4143
4825
  # @overload start(request, options = nil)
4144
4826
  # Pass arguments to `start` via a request object, either of type
@@ -4160,7 +4842,19 @@ module Google
4160
4842
  # @param project [::String]
4161
4843
  # Project ID for this request.
4162
4844
  # @param request_id [::String]
4163
- # 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).
4845
+ # An optional request ID to identify requests. Specify a unique request ID so
4846
+ # that if you must retry your request, the server will know to ignore the
4847
+ # request if it has already been completed.
4848
+ #
4849
+ # For example, consider a situation where you make an initial request and
4850
+ # the request times out. If you make the request again with the same
4851
+ # request ID, the server can check if original operation with the same
4852
+ # request ID was received, and if so, will ignore the second request. This
4853
+ # prevents clients from accidentally creating duplicate commitments.
4854
+ #
4855
+ # The request ID must be
4856
+ # a valid UUID with the exception that zero UUID is not supported
4857
+ # (00000000-0000-0000-0000-000000000000).
4164
4858
  # @param zone [::String]
4165
4859
  # The name of the zone for this request.
4166
4860
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4232,7 +4926,9 @@ module Google
4232
4926
  end
4233
4927
 
4234
4928
  ##
4235
- # Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance.
4929
+ # Starts an instance that was stopped using theinstances().stop
4930
+ # method. For more information, seeRestart an
4931
+ # instance.
4236
4932
  #
4237
4933
  # @overload start_with_encryption_key(request, options = nil)
4238
4934
  # Pass arguments to `start_with_encryption_key` via a request object, either of type
@@ -4256,7 +4952,19 @@ module Google
4256
4952
  # @param project [::String]
4257
4953
  # Project ID for this request.
4258
4954
  # @param request_id [::String]
4259
- # 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).
4955
+ # An optional request ID to identify requests. Specify a unique request ID so
4956
+ # that if you must retry your request, the server will know to ignore the
4957
+ # request if it has already been completed.
4958
+ #
4959
+ # For example, consider a situation where you make an initial request and
4960
+ # the request times out. If you make the request again with the same
4961
+ # request ID, the server can check if original operation with the same
4962
+ # request ID was received, and if so, will ignore the second request. This
4963
+ # prevents clients from accidentally creating duplicate commitments.
4964
+ #
4965
+ # The request ID must be
4966
+ # a valid UUID with the exception that zero UUID is not supported
4967
+ # (00000000-0000-0000-0000-000000000000).
4260
4968
  # @param zone [::String]
4261
4969
  # The name of the zone for this request.
4262
4970
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4328,7 +5036,12 @@ module Google
4328
5036
  end
4329
5037
 
4330
5038
  ##
4331
- # Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance.
5039
+ # Stops a running instance, shutting it down cleanly, and allows
5040
+ # you to restart the instance at a later time. Stopped instances do not incur
5041
+ # VM usage charges while they are stopped. However, resources that the VM is
5042
+ # using, such as persistent disks and static IP addresses, will continue to
5043
+ # be charged until they are deleted. For more information, seeStopping
5044
+ # an instance.
4332
5045
  #
4333
5046
  # @overload stop(request, options = nil)
4334
5047
  # Pass arguments to `stop` via a request object, either of type
@@ -4346,13 +5059,27 @@ module Google
4346
5059
  # the default parameter values, pass an empty Hash as a request object (see above).
4347
5060
  #
4348
5061
  # @param discard_local_ssd [::Boolean]
4349
- # This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.
5062
+ # This property is required if the instance has any attached Local SSD disks.
5063
+ # If false, Local SSD data will be preserved when the instance is suspended.
5064
+ # If true, the contents of any attached Local SSD disks will be discarded.
4350
5065
  # @param instance [::String]
4351
5066
  # Name of the instance resource to stop.
4352
5067
  # @param project [::String]
4353
5068
  # Project ID for this request.
4354
5069
  # @param request_id [::String]
4355
- # 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).
5070
+ # An optional request ID to identify requests. Specify a unique request ID so
5071
+ # that if you must retry your request, the server will know to ignore the
5072
+ # request if it has already been completed.
5073
+ #
5074
+ # For example, consider a situation where you make an initial request and
5075
+ # the request times out. If you make the request again with the same
5076
+ # request ID, the server can check if original operation with the same
5077
+ # request ID was received, and if so, will ignore the second request. This
5078
+ # prevents clients from accidentally creating duplicate commitments.
5079
+ #
5080
+ # The request ID must be
5081
+ # a valid UUID with the exception that zero UUID is not supported
5082
+ # (00000000-0000-0000-0000-000000000000).
4356
5083
  # @param zone [::String]
4357
5084
  # The name of the zone for this request.
4358
5085
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4424,7 +5151,14 @@ module Google
4424
5151
  end
4425
5152
 
4426
5153
  ##
4427
- # This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance.
5154
+ # This method suspends a running instance, saving its state to persistent
5155
+ # storage, and allows you to resume the instance at a later time. Suspended
5156
+ # instances have no compute costs (cores or RAM), and incur only storage
5157
+ # charges for the saved VM memory and localSSD data. Any charged resources
5158
+ # the virtual machine was using, such as persistent disks and static IP
5159
+ # addresses, will continue to be charged while the instance is suspended.
5160
+ # For more information, see
5161
+ # Suspending and resuming an instance.
4428
5162
  #
4429
5163
  # @overload suspend(request, options = nil)
4430
5164
  # Pass arguments to `suspend` via a request object, either of type
@@ -4442,13 +5176,27 @@ module Google
4442
5176
  # the default parameter values, pass an empty Hash as a request object (see above).
4443
5177
  #
4444
5178
  # @param discard_local_ssd [::Boolean]
4445
- # This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.
5179
+ # This property is required if the instance has any attached Local SSD disks.
5180
+ # If false, Local SSD data will be preserved when the instance is suspended.
5181
+ # If true, the contents of any attached Local SSD disks will be discarded.
4446
5182
  # @param instance [::String]
4447
5183
  # Name of the instance resource to suspend.
4448
5184
  # @param project [::String]
4449
5185
  # Project ID for this request.
4450
5186
  # @param request_id [::String]
4451
- # 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).
5187
+ # An optional request ID to identify requests. Specify a unique request ID so
5188
+ # that if you must retry your request, the server will know to ignore the
5189
+ # request if it has already been completed.
5190
+ #
5191
+ # For example, consider a situation where you make an initial request and
5192
+ # the request times out. If you make the request again with the same
5193
+ # request ID, the server can check if original operation with the same
5194
+ # request ID was received, and if so, will ignore the second request. This
5195
+ # prevents clients from accidentally creating duplicate commitments.
5196
+ #
5197
+ # The request ID must be
5198
+ # a valid UUID with the exception that zero UUID is not supported
5199
+ # (00000000-0000-0000-0000-000000000000).
4452
5200
  # @param zone [::String]
4453
5201
  # The name of the zone for this request.
4454
5202
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4604,7 +5352,10 @@ module Google
4604
5352
  end
4605
5353
 
4606
5354
  ##
4607
- # Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties.
5355
+ # Updates an instance only if the necessary resources are available. This
5356
+ # method can update only a specific set of instance properties. See
5357
+ # Updating a running instance for a list of updatable instance
5358
+ # properties.
4608
5359
  #
4609
5360
  # @overload update(request, options = nil)
4610
5361
  # Pass arguments to `update` via a request object, either of type
@@ -4616,25 +5367,47 @@ module Google
4616
5367
  # @param options [::Gapic::CallOptions, ::Hash]
4617
5368
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
4618
5369
  #
4619
- # @overload update(instance: nil, instance_resource: nil, minimal_action: nil, most_disruptive_allowed_action: nil, project: nil, request_id: nil, zone: nil)
5370
+ # @overload update(discard_local_ssd: nil, instance: nil, instance_resource: nil, minimal_action: nil, most_disruptive_allowed_action: nil, project: nil, request_id: nil, zone: nil)
4620
5371
  # Pass arguments to `update` via keyword arguments. Note that at
4621
5372
  # least one keyword argument is required. To specify no parameters, or to keep all
4622
5373
  # the default parameter values, pass an empty Hash as a request object (see above).
4623
5374
  #
5375
+ # @param discard_local_ssd [::Boolean]
5376
+ # Whether to discard local SSDs from the instance during restart
5377
+ # default value is false.
4624
5378
  # @param instance [::String]
4625
5379
  # Name of the instance resource to update.
4626
5380
  # @param instance_resource [::Google::Cloud::Compute::V1::Instance, ::Hash]
4627
5381
  # The body resource for this request
4628
5382
  # @param minimal_action [::String]
4629
- # Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require.
5383
+ # Specifies the action to take when updating an instance even if the
5384
+ # updated properties do not require it. If not specified, then
5385
+ # Compute Engine acts based on the minimum action that the updated
5386
+ # properties require.
4630
5387
  # Check the MinimalAction enum for the list of possible values.
4631
5388
  # @param most_disruptive_allowed_action [::String]
4632
- # Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART.
5389
+ # Specifies the most disruptive action that can be taken on the instance
5390
+ # as part of the update. Compute Engine returns an error if the
5391
+ # instance properties require a more disruptive action as part of the
5392
+ # instance update. Valid options from lowest to highest are
5393
+ # NO_EFFECT, REFRESH, and RESTART.
4633
5394
  # Check the MostDisruptiveAllowedAction enum for the list of possible values.
4634
5395
  # @param project [::String]
4635
5396
  # Project ID for this request.
4636
5397
  # @param request_id [::String]
4637
- # 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).
5398
+ # An optional request ID to identify requests. Specify a unique request ID so
5399
+ # that if you must retry your request, the server will know to ignore the
5400
+ # request if it has already been completed.
5401
+ #
5402
+ # For example, consider a situation where you make an initial request and
5403
+ # the request times out. If you make the request again with the same
5404
+ # request ID, the server can check if original operation with the same
5405
+ # request ID was received, and if so, will ignore the second request. This
5406
+ # prevents clients from accidentally creating duplicate commitments.
5407
+ #
5408
+ # The request ID must be
5409
+ # a valid UUID with the exception that zero UUID is not supported
5410
+ # (00000000-0000-0000-0000-000000000000).
4638
5411
  # @param zone [::String]
4639
5412
  # The name of the zone for this request.
4640
5413
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4706,7 +5479,10 @@ module Google
4706
5479
  end
4707
5480
 
4708
5481
  ##
4709
- # Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
5482
+ # Updates the specified access config from an instance's network interface
5483
+ # with the data included in the request. This method supportsPATCH
5484
+ # semantics and uses theJSON merge
5485
+ # patch format and processing rules.
4710
5486
  #
4711
5487
  # @overload update_access_config(request, options = nil)
4712
5488
  # Pass arguments to `update_access_config` via a request object, either of type
@@ -4732,7 +5508,19 @@ module Google
4732
5508
  # @param project [::String]
4733
5509
  # Project ID for this request.
4734
5510
  # @param request_id [::String]
4735
- # 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).
5511
+ # An optional request ID to identify requests. Specify a unique request ID so
5512
+ # that if you must retry your request, the server will know to ignore the
5513
+ # request if it has already been completed.
5514
+ #
5515
+ # For example, consider a situation where you make an initial request and
5516
+ # the request times out. If you make the request again with the same
5517
+ # request ID, the server can check if original operation with the same
5518
+ # request ID was received, and if so, will ignore the second request. This
5519
+ # prevents clients from accidentally creating duplicate commitments.
5520
+ #
5521
+ # The request ID must be
5522
+ # a valid UUID with the exception that zero UUID is not supported
5523
+ # (00000000-0000-0000-0000-000000000000).
4736
5524
  # @param zone [::String]
4737
5525
  # The name of the zone for this request.
4738
5526
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4804,7 +5592,10 @@ module Google
4804
5592
  end
4805
5593
 
4806
5594
  ##
4807
- # Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
5595
+ # Updates the Display config for a VM instance. You can
5596
+ # only use this method on a stopped VM instance. This method supportsPATCH
5597
+ # semantics and uses theJSON merge
5598
+ # patch format and processing rules.
4808
5599
  #
4809
5600
  # @overload update_display_device(request, options = nil)
4810
5601
  # Pass arguments to `update_display_device` via a request object, either of type
@@ -4828,7 +5619,19 @@ module Google
4828
5619
  # @param project [::String]
4829
5620
  # Project ID for this request.
4830
5621
  # @param request_id [::String]
4831
- # 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).
5622
+ # An optional request ID to identify requests. Specify a unique request ID so
5623
+ # that if you must retry your request, the server will know to ignore the
5624
+ # request if it has already been completed.
5625
+ #
5626
+ # For example, consider a situation where you make an initial request and
5627
+ # the request times out. If you make the request again with the same
5628
+ # request ID, the server can check if original operation with the same
5629
+ # request ID was received, and if so, will ignore the second request. This
5630
+ # prevents clients from accidentally creating duplicate commitments.
5631
+ #
5632
+ # The request ID must be
5633
+ # a valid UUID with the exception that zero UUID is not supported
5634
+ # (00000000-0000-0000-0000-000000000000).
4832
5635
  # @param zone [::String]
4833
5636
  # The name of the zone for this request.
4834
5637
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4900,7 +5703,12 @@ module Google
4900
5703
  end
4901
5704
 
4902
5705
  ##
4903
- # Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics.
5706
+ # Updates an instance's network interface. This method can only update an
5707
+ # interface's alias IP range and attached network. See Modifying
5708
+ # alias IP ranges for an existing instance for instructions on
5709
+ # changing alias IP ranges. See Migrating
5710
+ # a VM between networks for instructions on migrating an interface.
5711
+ # This method follows PATCH semantics.
4904
5712
  #
4905
5713
  # @overload update_network_interface(request, options = nil)
4906
5714
  # Pass arguments to `update_network_interface` via a request object, either of type
@@ -4926,7 +5734,19 @@ module Google
4926
5734
  # @param project [::String]
4927
5735
  # Project ID for this request.
4928
5736
  # @param request_id [::String]
4929
- # 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).
5737
+ # An optional request ID to identify requests. Specify a unique request ID so
5738
+ # that if you must retry your request, the server will know to ignore the
5739
+ # request if it has already been completed.
5740
+ #
5741
+ # For example, consider a situation where you make an initial request and
5742
+ # the request times out. If you make the request again with the same
5743
+ # request ID, the server can check if original operation with the same
5744
+ # request ID was received, and if so, will ignore the second request. This
5745
+ # prevents clients from accidentally creating duplicate commitments.
5746
+ #
5747
+ # The request ID must be
5748
+ # a valid UUID with the exception that zero UUID is not supported
5749
+ # (00000000-0000-0000-0000-000000000000).
4930
5750
  # @param zone [::String]
4931
5751
  # The name of the zone for this request.
4932
5752
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -4998,7 +5818,10 @@ module Google
4998
5818
  end
4999
5819
 
5000
5820
  ##
5001
- # Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
5821
+ # Updates the Shielded Instance config for an instance. You can
5822
+ # only use this method on a stopped instance. This method supportsPATCH
5823
+ # semantics and uses theJSON merge
5824
+ # patch format and processing rules.
5002
5825
  #
5003
5826
  # @overload update_shielded_instance_config(request, options = nil)
5004
5827
  # Pass arguments to `update_shielded_instance_config` via a request object, either of type
@@ -5020,7 +5843,19 @@ module Google
5020
5843
  # @param project [::String]
5021
5844
  # Project ID for this request.
5022
5845
  # @param request_id [::String]
5023
- # 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).
5846
+ # An optional request ID to identify requests. Specify a unique request ID so
5847
+ # that if you must retry your request, the server will know to ignore the
5848
+ # request if it has already been completed.
5849
+ #
5850
+ # For example, consider a situation where you make an initial request and
5851
+ # the request times out. If you make the request again with the same
5852
+ # request ID, the server can check if original operation with the same
5853
+ # request ID was received, and if so, will ignore the second request. This
5854
+ # prevents clients from accidentally creating duplicate commitments.
5855
+ #
5856
+ # The request ID must be
5857
+ # a valid UUID with the exception that zero UUID is not supported
5858
+ # (00000000-0000-0000-0000-000000000000).
5024
5859
  # @param shielded_instance_config_resource [::Google::Cloud::Compute::V1::ShieldedInstanceConfig, ::Hash]
5025
5860
  # The body resource for this request
5026
5861
  # @param zone [::String]