google-cloud-compute-v1 3.3.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/compute/v1/accelerator_types/rest/client.rb +181 -14
  3. data/lib/google/cloud/compute/v1/addresses/rest/client.rb +330 -20
  4. data/lib/google/cloud/compute/v1/addresses/rest/service_stub.rb +64 -0
  5. data/lib/google/cloud/compute/v1/advice/credentials.rb +52 -0
  6. data/lib/google/cloud/compute/v1/advice/rest/client.rb +431 -0
  7. data/lib/google/cloud/compute/v1/advice/rest/service_stub.rb +144 -0
  8. data/lib/google/cloud/compute/v1/advice/rest.rb +51 -0
  9. data/lib/google/cloud/compute/v1/advice.rb +47 -0
  10. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +334 -21
  11. data/lib/google/cloud/compute/v1/autoscalers/rest/service_stub.rb +64 -0
  12. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +198 -23
  13. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +499 -40
  14. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +62 -0
  15. data/lib/google/cloud/compute/v1/compute_pb.rb +281 -25
  16. data/lib/google/cloud/compute/v1/cross_site_networks/credentials.rb +52 -0
  17. data/lib/google/cloud/compute/v1/cross_site_networks/rest/client.rb +975 -0
  18. data/lib/google/cloud/compute/v1/cross_site_networks/rest/service_stub.rb +391 -0
  19. data/lib/google/cloud/compute/v1/cross_site_networks/rest.rb +51 -0
  20. data/lib/google/cloud/compute/v1/cross_site_networks.rb +47 -0
  21. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +181 -14
  22. data/lib/google/cloud/compute/v1/disks/rest/client.rb +390 -42
  23. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +118 -11
  24. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +240 -25
  25. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +238 -13
  26. data/lib/google/cloud/compute/v1/firewalls/rest/service_stub.rb +63 -0
  27. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +258 -23
  28. data/lib/google/cloud/compute/v1/future_reservations/credentials.rb +52 -0
  29. data/lib/google/cloud/compute/v1/future_reservations/rest/client.rb +1287 -0
  30. data/lib/google/cloud/compute/v1/future_reservations/rest/service_stub.rb +520 -0
  31. data/lib/google/cloud/compute/v1/future_reservations/rest.rb +51 -0
  32. data/lib/google/cloud/compute/v1/future_reservations.rb +47 -0
  33. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +217 -10
  34. data/lib/google/cloud/compute/v1/global_addresses/rest/service_stub.rb +63 -0
  35. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +151 -15
  36. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +246 -21
  37. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +203 -18
  38. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +91 -9
  39. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +128 -10
  40. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +333 -21
  41. data/lib/google/cloud/compute/v1/health_checks/rest/service_stub.rb +63 -0
  42. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +2 -1
  43. data/lib/google/cloud/compute/v1/images/rest/client.rb +161 -18
  44. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/client.rb +159 -24
  45. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +920 -95
  46. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +473 -40
  47. data/lib/google/cloud/compute/v1/instance_groups/rest/service_stub.rb +64 -0
  48. data/lib/google/cloud/compute/v1/instance_settings_service/rest/client.rb +13 -1
  49. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +220 -20
  50. data/lib/google/cloud/compute/v1/instances/rest/client.rb +1144 -99
  51. data/lib/google/cloud/compute/v1/instances/rest/service_stub.rb +127 -0
  52. data/lib/google/cloud/compute/v1/instant_snapshots/rest/client.rb +235 -21
  53. data/lib/google/cloud/compute/v1/interconnect_attachment_groups/rest/client.rb +139 -14
  54. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +242 -21
  55. data/lib/google/cloud/compute/v1/interconnect_groups/rest/client.rb +139 -14
  56. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +87 -7
  57. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/client.rb +87 -7
  58. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +145 -14
  59. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +9 -2
  60. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +161 -16
  61. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +124 -13
  62. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +181 -14
  63. data/lib/google/cloud/compute/v1/network_attachments/rest/client.rb +232 -20
  64. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/client.rb +138 -12
  65. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +361 -37
  66. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/client.rb +354 -33
  67. data/lib/google/cloud/compute/v1/network_profiles/rest/client.rb +85 -6
  68. data/lib/google/cloud/compute/v1/networks/rest/client.rb +281 -23
  69. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +381 -32
  70. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +213 -19
  71. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +181 -14
  72. data/lib/google/cloud/compute/v1/organization_security_policies/credentials.rb +52 -0
  73. data/lib/google/cloud/compute/v1/organization_security_policies/rest/client.rb +2259 -0
  74. data/lib/google/cloud/compute/v1/organization_security_policies/rest/service_stub.rb +1054 -0
  75. data/lib/google/cloud/compute/v1/organization_security_policies/rest.rb +51 -0
  76. data/lib/google/cloud/compute/v1/organization_security_policies.rb +47 -0
  77. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +226 -19
  78. data/lib/google/cloud/compute/v1/preview_features/credentials.rb +52 -0
  79. data/lib/google/cloud/compute/v1/preview_features/rest/client.rb +739 -0
  80. data/lib/google/cloud/compute/v1/preview_features/rest/service_stub.rb +267 -0
  81. data/lib/google/cloud/compute/v1/preview_features/rest.rb +51 -0
  82. data/lib/google/cloud/compute/v1/preview_features.rb +47 -0
  83. data/lib/google/cloud/compute/v1/projects/rest/client.rb +346 -30
  84. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +154 -12
  85. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +255 -22
  86. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +238 -13
  87. data/lib/google/cloud/compute/v1/region_autoscalers/rest/service_stub.rb +64 -0
  88. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +260 -26
  89. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +212 -18
  90. data/lib/google/cloud/compute/v1/region_composite_health_checks/credentials.rb +52 -0
  91. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/client.rb +1268 -0
  92. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest/service_stub.rb +521 -0
  93. data/lib/google/cloud/compute/v1/region_composite_health_checks/rest.rb +51 -0
  94. data/lib/google/cloud/compute/v1/region_composite_health_checks.rb +47 -0
  95. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +83 -5
  96. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +269 -29
  97. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/credentials.rb +52 -0
  98. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/client.rb +1268 -0
  99. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest/service_stub.rb +521 -0
  100. data/lib/google/cloud/compute/v1/region_health_aggregation_policies/rest.rb +51 -0
  101. data/lib/google/cloud/compute/v1/region_health_aggregation_policies.rb +47 -0
  102. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +427 -17
  103. data/lib/google/cloud/compute/v1/region_health_check_services/rest/service_stub.rb +125 -0
  104. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +238 -13
  105. data/lib/google/cloud/compute/v1/region_health_checks/rest/service_stub.rb +64 -0
  106. data/lib/google/cloud/compute/v1/region_health_sources/credentials.rb +52 -0
  107. data/lib/google/cloud/compute/v1/region_health_sources/rest/client.rb +1268 -0
  108. data/lib/google/cloud/compute/v1/region_health_sources/rest/service_stub.rb +521 -0
  109. data/lib/google/cloud/compute/v1/region_health_sources/rest.rb +51 -0
  110. data/lib/google/cloud/compute/v1/region_health_sources.rb +47 -0
  111. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +750 -64
  112. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +280 -14
  113. data/lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb +64 -0
  114. data/lib/google/cloud/compute/v1/region_instance_templates/rest/client.rb +115 -10
  115. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +15 -2
  116. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/client.rb +139 -13
  117. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +264 -28
  118. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/client.rb +213 -20
  119. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +399 -11
  120. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/service_stub.rb +125 -0
  121. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +107 -10
  122. data/lib/google/cloud/compute/v1/region_security_policies/rest/client.rb +149 -14
  123. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +116 -10
  124. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/client.rb +220 -20
  125. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +126 -10
  126. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +158 -14
  127. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/client.rb +113 -9
  128. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +104 -14
  129. data/lib/google/cloud/compute/v1/region_zones/rest/client.rb +85 -6
  130. data/lib/google/cloud/compute/v1/regions/rest/client.rb +120 -7
  131. data/lib/google/cloud/compute/v1/reservation_blocks/rest/client.rb +396 -11
  132. data/lib/google/cloud/compute/v1/reservation_blocks/rest/service_stub.rb +194 -0
  133. data/lib/google/cloud/compute/v1/reservation_slots/credentials.rb +52 -0
  134. data/lib/google/cloud/compute/v1/reservation_slots/rest/client.rb +863 -0
  135. data/lib/google/cloud/compute/v1/reservation_slots/rest/service_stub.rb +338 -0
  136. data/lib/google/cloud/compute/v1/reservation_slots/rest.rb +51 -0
  137. data/lib/google/cloud/compute/v1/reservation_slots.rb +47 -0
  138. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/client.rb +642 -12
  139. data/lib/google/cloud/compute/v1/reservation_sub_blocks/rest/service_stub.rb +327 -3
  140. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +257 -24
  141. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +224 -19
  142. data/lib/google/cloud/compute/v1/rest.rb +10 -0
  143. data/lib/google/cloud/compute/v1/routers/rest/client.rb +555 -50
  144. data/lib/google/cloud/compute/v1/routes/rest/client.rb +202 -8
  145. data/lib/google/cloud/compute/v1/routes/rest/service_stub.rb +63 -0
  146. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +316 -26
  147. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +234 -22
  148. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/client.rb +13 -1
  149. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +130 -13
  150. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +210 -17
  151. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +315 -27
  152. data/lib/google/cloud/compute/v1/storage_pool_types/rest/client.rb +181 -14
  153. data/lib/google/cloud/compute/v1/storage_pools/rest/client.rb +321 -28
  154. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +378 -34
  155. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +128 -10
  156. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +240 -20
  157. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +306 -30
  158. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +320 -20
  159. data/lib/google/cloud/compute/v1/target_instances/rest/service_stub.rb +64 -0
  160. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +387 -26
  161. data/lib/google/cloud/compute/v1/target_pools/rest/service_stub.rb +64 -0
  162. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +281 -19
  163. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/service_stub.rb +63 -0
  164. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +329 -20
  165. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/service_stub.rb +63 -0
  166. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +224 -19
  167. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +354 -24
  168. data/lib/google/cloud/compute/v1/url_maps/rest/service_stub.rb +63 -0
  169. data/lib/google/cloud/compute/v1/version.rb +1 -1
  170. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +224 -19
  171. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +224 -19
  172. data/lib/google/cloud/compute/v1/wire_groups/credentials.rb +52 -0
  173. data/lib/google/cloud/compute/v1/wire_groups/rest/client.rb +980 -0
  174. data/lib/google/cloud/compute/v1/wire_groups/rest/service_stub.rb +396 -0
  175. data/lib/google/cloud/compute/v1/wire_groups/rest.rb +51 -0
  176. data/lib/google/cloud/compute/v1/wire_groups.rb +47 -0
  177. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +106 -10
  178. data/lib/google/cloud/compute/v1/zones/rest/client.rb +83 -5
  179. data/lib/google/cloud/compute/v1.rb +10 -0
  180. data/proto_docs/google/api/client.rb +149 -29
  181. data/proto_docs/google/cloud/compute/v1/compute.rb +44226 -5514
  182. metadata +52 -2
@@ -240,7 +240,19 @@ module Google
240
240
  # @param project [::String]
241
241
  # Project ID for this request.
242
242
  # @param request_id [::String]
243
- # 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).
243
+ # An optional request ID to identify requests. Specify a unique request ID so
244
+ # that if you must retry your request, the server will know to ignore the
245
+ # request if it has already been completed.
246
+ #
247
+ # For example, consider a situation where you make an initial request and
248
+ # the request times out. If you make the request again with the same
249
+ # request ID, the server can check if original operation with the same
250
+ # request ID was received, and if so, will ignore the second request. This
251
+ # prevents clients from accidentally creating duplicate commitments.
252
+ #
253
+ # The request ID must be
254
+ # a valid UUID with the exception that zero UUID is not supported
255
+ # (00000000-0000-0000-0000-000000000000).
244
256
  # @yield [result, operation] Access the result along with the TransportOperation object
245
257
  # @yieldparam result [::Gapic::GenericLRO::Operation]
246
258
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -309,7 +321,8 @@ module Google
309
321
  end
310
322
 
311
323
  ##
312
- # Returns the specified Interconnect. Get a list of available Interconnects by making a list() request.
324
+ # Returns the specified Interconnect. Get a list of available Interconnects
325
+ # by making a list() request.
313
326
  #
314
327
  # @overload get(request, options = nil)
315
328
  # Pass arguments to `get` via a request object, either of type
@@ -389,7 +402,16 @@ module Google
389
402
  end
390
403
 
391
404
  ##
392
- # Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly.
405
+ # Returns the interconnectDiagnostics for the specified
406
+ # Interconnect.
407
+ #
408
+ # In the event of a
409
+ # global outage, do not use this API to make decisions about where to
410
+ # redirect your network traffic.
411
+ #
412
+ # Unlike a VLAN attachment, which is regional, a Cloud Interconnect
413
+ # connection is a global resource. A global outage can prevent this
414
+ # API from functioning properly.
393
415
  #
394
416
  # @overload get_diagnostics(request, options = nil)
395
417
  # Pass arguments to `get_diagnostics` via a request object, either of type
@@ -469,7 +491,8 @@ module Google
469
491
  end
470
492
 
471
493
  ##
472
- # Returns the interconnectMacsecConfig for the specified Interconnect.
494
+ # Returns the interconnectMacsecConfig for the specified
495
+ # Interconnect.
473
496
  #
474
497
  # @overload get_macsec_config(request, options = nil)
475
498
  # Pass arguments to `get_macsec_config` via a request object, either of type
@@ -549,7 +572,8 @@ module Google
549
572
  end
550
573
 
551
574
  ##
552
- # Creates an Interconnect in the specified project using the data included in the request.
575
+ # Creates an Interconnect in the specified project using
576
+ # the data included in the request.
553
577
  #
554
578
  # @overload insert(request, options = nil)
555
579
  # Pass arguments to `insert` via a request object, either of type
@@ -571,7 +595,19 @@ module Google
571
595
  # @param project [::String]
572
596
  # Project ID for this request.
573
597
  # @param request_id [::String]
574
- # 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).
598
+ # An optional request ID to identify requests. Specify a unique request ID so
599
+ # that if you must retry your request, the server will know to ignore the
600
+ # request if it has already been completed.
601
+ #
602
+ # For example, consider a situation where you make an initial request and
603
+ # the request times out. If you make the request again with the same
604
+ # request ID, the server can check if original operation with the same
605
+ # request ID was received, and if so, will ignore the second request. This
606
+ # prevents clients from accidentally creating duplicate commitments.
607
+ #
608
+ # The request ID must be
609
+ # a valid UUID with the exception that zero UUID is not supported
610
+ # (00000000-0000-0000-0000-000000000000).
575
611
  # @yield [result, operation] Access the result along with the TransportOperation object
576
612
  # @yieldparam result [::Gapic::GenericLRO::Operation]
577
613
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -658,17 +694,95 @@ module Google
658
694
  # the default parameter values, pass an empty Hash as a request object (see above).
659
695
  #
660
696
  # @param filter [::String]
661
- # 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.
697
+ # A filter expression that filters resources listed in the response. Most
698
+ # Compute resources support two types of filter expressions:
699
+ # expressions that support regular expressions and expressions that follow
700
+ # API improvement proposal AIP-160.
701
+ # These two types of filter expressions cannot be mixed in one request.
702
+ #
703
+ # If you want to use AIP-160, your expression must specify the field name, an
704
+ # operator, and the value that you want to use for filtering. The value
705
+ # must be a string, a number, or a boolean. The operator
706
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
707
+ #
708
+ # For example, if you are filtering Compute Engine instances, you can
709
+ # exclude instances named `example-instance` by specifying
710
+ # `name != example-instance`.
711
+ #
712
+ # The `:*` comparison can be used to test whether a key has been defined.
713
+ # For example, to find all objects with `owner` label use:
714
+ # ```
715
+ # labels.owner:*
716
+ # ```
717
+ #
718
+ # You can also filter nested fields. For example, you could specify
719
+ # `scheduling.automaticRestart = false` to include instances only
720
+ # if they are not scheduled for automatic restarts. You can use filtering
721
+ # on nested fields to filter based onresource labels.
722
+ #
723
+ # To filter on multiple expressions, provide each separate expression within
724
+ # parentheses. For example:
725
+ # ```
726
+ # (scheduling.automaticRestart = true)
727
+ # (cpuPlatform = "Intel Skylake")
728
+ # ```
729
+ # By default, each expression is an `AND` expression. However, you
730
+ # can include `AND` and `OR` expressions explicitly.
731
+ # For example:
732
+ # ```
733
+ # (cpuPlatform = "Intel Skylake") OR
734
+ # (cpuPlatform = "Intel Broadwell") AND
735
+ # (scheduling.automaticRestart = true)
736
+ # ```
737
+ #
738
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
739
+ # (not equal) operator against a single un-parenthesized expression with or
740
+ # without quotes or against multiple parenthesized expressions. Examples:
741
+ #
742
+ # `fieldname eq unquoted literal`
743
+ # `fieldname eq 'single quoted literal'`
744
+ # `fieldname eq "double quoted literal"`
745
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
746
+ #
747
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
748
+ # The literal value must match the entire field.
749
+ #
750
+ # For example, to filter for instances that do not end with name "instance",
751
+ # you would use `name ne .*instance`.
752
+ #
753
+ # You cannot combine constraints on multiple fields using regular
754
+ # expressions.
662
755
  # @param max_results [::Integer]
663
- # 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`)
756
+ # The maximum number of results per page that should be returned.
757
+ # If the number of available results is larger than `maxResults`,
758
+ # Compute Engine returns a `nextPageToken` that can be used to get
759
+ # the next page of results in subsequent list requests. Acceptable values are
760
+ # `0` to `500`, inclusive. (Default: `500`)
664
761
  # @param order_by [::String]
665
- # 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.
762
+ # Sorts list results by a certain order. By default, results
763
+ # are returned in alphanumerical order based on the resource name.
764
+ #
765
+ # You can also sort results in descending order based on the creation
766
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
767
+ # results based on the `creationTimestamp` field in
768
+ # reverse chronological order (newest result first). Use this to sort
769
+ # resources like operations so that the newest operation is returned first.
770
+ #
771
+ # Currently, only sorting by `name` or
772
+ # `creationTimestamp desc` is supported.
666
773
  # @param page_token [::String]
667
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
774
+ # Specifies a page token to use. Set `pageToken` to the
775
+ # `nextPageToken` returned by a previous list request to get
776
+ # the next page of results.
668
777
  # @param project [::String]
669
778
  # Project ID for this request.
670
779
  # @param return_partial_success [::Boolean]
671
- # 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.
780
+ # Opt-in for partial success behavior which provides partial results in case
781
+ # of failure. The default value is false.
782
+ #
783
+ # For example, when partial success behavior is enabled, aggregatedList for a
784
+ # single zone scope either returns all resources in the zone or no resources,
785
+ # with an error code.
672
786
  # @yield [result, operation] Access the result along with the TransportOperation object
673
787
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::Interconnect>]
674
788
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -730,7 +844,10 @@ module Google
730
844
  end
731
845
 
732
846
  ##
733
- # Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
847
+ # Updates the specified Interconnect with the data included in the request.
848
+ # This method supportsPATCH
849
+ # semantics and uses theJSON merge
850
+ # patch format and processing rules.
734
851
  #
735
852
  # @overload patch(request, options = nil)
736
853
  # Pass arguments to `patch` via a request object, either of type
@@ -754,7 +871,19 @@ module Google
754
871
  # @param project [::String]
755
872
  # Project ID for this request.
756
873
  # @param request_id [::String]
757
- # 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).
874
+ # An optional request ID to identify requests. Specify a unique request ID so
875
+ # that if you must retry your request, the server will know to ignore the
876
+ # request if it has already been completed.
877
+ #
878
+ # For example, consider a situation where you make an initial request and
879
+ # the request times out. If you make the request again with the same
880
+ # request ID, the server can check if original operation with the same
881
+ # request ID was received, and if so, will ignore the second request. This
882
+ # prevents clients from accidentally creating duplicate commitments.
883
+ #
884
+ # The request ID must be
885
+ # a valid UUID with the exception that zero UUID is not supported
886
+ # (00000000-0000-0000-0000-000000000000).
758
887
  # @yield [result, operation] Access the result along with the TransportOperation object
759
888
  # @yieldparam result [::Gapic::GenericLRO::Operation]
760
889
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -823,7 +952,9 @@ module Google
823
952
  end
824
953
 
825
954
  ##
826
- # Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation.
955
+ # Sets the labels on an Interconnect. To learn more about labels,
956
+ # read the Labeling
957
+ # Resources documentation.
827
958
  #
828
959
  # @overload set_labels(request, options = nil)
829
960
  # Pass arguments to `set_labels` via a request object, either of type
@@ -182,7 +182,11 @@ module Google
182
182
  # Service calls
183
183
 
184
184
  ##
185
- # Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
185
+ # Return a specified license code. License codes are mirrored across
186
+ # all projects that have permissions to read the License Code.
187
+ # *Caution* This resource is intended
188
+ # for use only by third-party partners who are creatingCloud Marketplace
189
+ # images.
186
190
  #
187
191
  # @overload get(request, options = nil)
188
192
  # Pass arguments to `get` via a request object, either of type
@@ -262,7 +266,10 @@ module Google
262
266
  end
263
267
 
264
268
  ##
265
- # Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
269
+ # Returns permissions that a caller has on the specified resource.
270
+ # *Caution* This resource is intended
271
+ # for use only by third-party partners who are creatingCloud Marketplace
272
+ # images.
266
273
  #
267
274
  # @overload test_iam_permissions(request, options = nil)
268
275
  # Pass arguments to `test_iam_permissions` via a request object, either of type
@@ -215,7 +215,10 @@ module Google
215
215
  # Service calls
216
216
 
217
217
  ##
218
- # Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
218
+ # Deletes the specified license.
219
+ # *Caution* This resource is intended
220
+ # for use only by third-party partners who are creatingCloud Marketplace
221
+ # images.
219
222
  #
220
223
  # @overload delete(request, options = nil)
221
224
  # Pass arguments to `delete` via a request object, either of type
@@ -237,7 +240,19 @@ module Google
237
240
  # @param project [::String]
238
241
  # Project ID for this request.
239
242
  # @param request_id [::String]
240
- # 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).
243
+ # An optional request ID to identify requests. Specify a unique request ID so
244
+ # that if you must retry your request, the server will know to ignore the
245
+ # request if it has already been completed.
246
+ #
247
+ # For example, consider a situation where you make an initial request and
248
+ # the request times out. If you make the request again with the same
249
+ # request ID, the server can check if original operation with the same
250
+ # request ID was received, and if so, will ignore the second request. This
251
+ # prevents clients from accidentally creating duplicate commitments.
252
+ #
253
+ # The request ID must be
254
+ # a valid UUID with the exception that zero UUID is not supported
255
+ # (00000000-0000-0000-0000-000000000000).
241
256
  # @yield [result, operation] Access the result along with the TransportOperation object
242
257
  # @yieldparam result [::Gapic::GenericLRO::Operation]
243
258
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -306,7 +321,10 @@ module Google
306
321
  end
307
322
 
308
323
  ##
309
- # Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
324
+ # Returns the specified License resource.
325
+ # *Caution* This resource is intended
326
+ # for use only by third-party partners who are creatingCloud Marketplace
327
+ # images.
310
328
  #
311
329
  # @overload get(request, options = nil)
312
330
  # Pass arguments to `get` via a request object, either of type
@@ -386,7 +404,11 @@ module Google
386
404
  end
387
405
 
388
406
  ##
389
- # Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
407
+ # Gets the access control policy for a resource. May be empty if no such
408
+ # policy or resource exists.
409
+ # *Caution* This resource is intended
410
+ # for use only by third-party partners who are creatingCloud Marketplace
411
+ # images.
390
412
  #
391
413
  # @overload get_iam_policy(request, options = nil)
392
414
  # Pass arguments to `get_iam_policy` via a request object, either of type
@@ -468,7 +490,10 @@ module Google
468
490
  end
469
491
 
470
492
  ##
471
- # Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
493
+ # Create a License resource in the specified project.
494
+ # *Caution* This resource is intended
495
+ # for use only by third-party partners who are creatingCloud Marketplace
496
+ # images.
472
497
  #
473
498
  # @overload insert(request, options = nil)
474
499
  # Pass arguments to `insert` via a request object, either of type
@@ -490,7 +515,19 @@ module Google
490
515
  # @param project [::String]
491
516
  # Project ID for this request.
492
517
  # @param request_id [::String]
493
- # 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).
518
+ # An optional request ID to identify requests. Specify a unique request ID so
519
+ # that if you must retry your request, the server will know to ignore the
520
+ # request if it has already been completed.
521
+ #
522
+ # For example, consider a situation where you make an initial request and
523
+ # the request times out. If you make the request again with the same
524
+ # request ID, the server can check if original operation with the same
525
+ # request ID was received, and if so, will ignore the second request. This
526
+ # prevents clients from accidentally creating duplicate commitments.
527
+ #
528
+ # The request ID must be
529
+ # a valid UUID with the exception that zero UUID is not supported
530
+ # (00000000-0000-0000-0000-000000000000).
494
531
  # @yield [result, operation] Access the result along with the TransportOperation object
495
532
  # @yieldparam result [::Gapic::GenericLRO::Operation]
496
533
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -559,7 +596,15 @@ module Google
559
596
  end
560
597
 
561
598
  ##
562
- # Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
599
+ # Retrieves the list of licenses
600
+ # available in the specified project. This method does not
601
+ # get any licenses that belong to other projects, including licenses attached
602
+ # to publicly-available images, like Debian 9. If you want to get a list of
603
+ # publicly-available licenses, use this method to make a request to the
604
+ # respective image project, such as debian-cloud orwindows-cloud.
605
+ # *Caution* This resource is intended
606
+ # for use only by third-party partners who are creatingCloud Marketplace
607
+ # images.
563
608
  #
564
609
  # @overload list(request, options = nil)
565
610
  # Pass arguments to `list` via a request object, either of type
@@ -577,17 +622,95 @@ module Google
577
622
  # the default parameter values, pass an empty Hash as a request object (see above).
578
623
  #
579
624
  # @param filter [::String]
580
- # 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.
625
+ # A filter expression that filters resources listed in the response. Most
626
+ # Compute resources support two types of filter expressions:
627
+ # expressions that support regular expressions and expressions that follow
628
+ # API improvement proposal AIP-160.
629
+ # These two types of filter expressions cannot be mixed in one request.
630
+ #
631
+ # If you want to use AIP-160, your expression must specify the field name, an
632
+ # operator, and the value that you want to use for filtering. The value
633
+ # must be a string, a number, or a boolean. The operator
634
+ # must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.
635
+ #
636
+ # For example, if you are filtering Compute Engine instances, you can
637
+ # exclude instances named `example-instance` by specifying
638
+ # `name != example-instance`.
639
+ #
640
+ # The `:*` comparison can be used to test whether a key has been defined.
641
+ # For example, to find all objects with `owner` label use:
642
+ # ```
643
+ # labels.owner:*
644
+ # ```
645
+ #
646
+ # You can also filter nested fields. For example, you could specify
647
+ # `scheduling.automaticRestart = false` to include instances only
648
+ # if they are not scheduled for automatic restarts. You can use filtering
649
+ # on nested fields to filter based onresource labels.
650
+ #
651
+ # To filter on multiple expressions, provide each separate expression within
652
+ # parentheses. For example:
653
+ # ```
654
+ # (scheduling.automaticRestart = true)
655
+ # (cpuPlatform = "Intel Skylake")
656
+ # ```
657
+ # By default, each expression is an `AND` expression. However, you
658
+ # can include `AND` and `OR` expressions explicitly.
659
+ # For example:
660
+ # ```
661
+ # (cpuPlatform = "Intel Skylake") OR
662
+ # (cpuPlatform = "Intel Broadwell") AND
663
+ # (scheduling.automaticRestart = true)
664
+ # ```
665
+ #
666
+ # If you want to use a regular expression, use the `eq` (equal) or `ne`
667
+ # (not equal) operator against a single un-parenthesized expression with or
668
+ # without quotes or against multiple parenthesized expressions. Examples:
669
+ #
670
+ # `fieldname eq unquoted literal`
671
+ # `fieldname eq 'single quoted literal'`
672
+ # `fieldname eq "double quoted literal"`
673
+ # `(fieldname1 eq literal) (fieldname2 ne "literal")`
674
+ #
675
+ # The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
676
+ # The literal value must match the entire field.
677
+ #
678
+ # For example, to filter for instances that do not end with name "instance",
679
+ # you would use `name ne .*instance`.
680
+ #
681
+ # You cannot combine constraints on multiple fields using regular
682
+ # expressions.
581
683
  # @param max_results [::Integer]
582
- # 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`)
684
+ # The maximum number of results per page that should be returned.
685
+ # If the number of available results is larger than `maxResults`,
686
+ # Compute Engine returns a `nextPageToken` that can be used to get
687
+ # the next page of results in subsequent list requests. Acceptable values are
688
+ # `0` to `500`, inclusive. (Default: `500`)
583
689
  # @param order_by [::String]
584
- # 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.
690
+ # Sorts list results by a certain order. By default, results
691
+ # are returned in alphanumerical order based on the resource name.
692
+ #
693
+ # You can also sort results in descending order based on the creation
694
+ # timestamp using `orderBy="creationTimestamp desc"`. This sorts
695
+ # results based on the `creationTimestamp` field in
696
+ # reverse chronological order (newest result first). Use this to sort
697
+ # resources like operations so that the newest operation is returned first.
698
+ #
699
+ # Currently, only sorting by `name` or
700
+ # `creationTimestamp desc` is supported.
585
701
  # @param page_token [::String]
586
- # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
702
+ # Specifies a page token to use. Set `pageToken` to the
703
+ # `nextPageToken` returned by a previous list request to get
704
+ # the next page of results.
587
705
  # @param project [::String]
588
706
  # Project ID for this request.
589
707
  # @param return_partial_success [::Boolean]
590
- # 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.
708
+ # Opt-in for partial success behavior which provides partial results in case
709
+ # of failure. The default value is false.
710
+ #
711
+ # For example, when partial success behavior is enabled, aggregatedList for a
712
+ # single zone scope either returns all resources in the zone or no resources,
713
+ # with an error code.
591
714
  # @yield [result, operation] Access the result along with the TransportOperation object
592
715
  # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Compute::V1::License>]
593
716
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -649,7 +772,11 @@ module Google
649
772
  end
650
773
 
651
774
  ##
652
- # Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
775
+ # Sets the access control policy on the specified resource.
776
+ # Replaces any existing policy.
777
+ # *Caution* This resource is intended
778
+ # for use only by third-party partners who are creatingCloud Marketplace
779
+ # images.
653
780
  #
654
781
  # @overload set_iam_policy(request, options = nil)
655
782
  # Pass arguments to `set_iam_policy` via a request object, either of type
@@ -731,7 +858,10 @@ module Google
731
858
  end
732
859
 
733
860
  ##
734
- # Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
861
+ # Returns permissions that a caller has on the specified resource.
862
+ # *Caution* This resource is intended
863
+ # for use only by third-party partners who are creatingCloud Marketplace
864
+ # images.
735
865
  #
736
866
  # @overload test_iam_permissions(request, options = nil)
737
867
  # Pass arguments to `test_iam_permissions` via a request object, either of type
@@ -813,7 +943,10 @@ module Google
813
943
  end
814
944
 
815
945
  ##
816
- # Updates a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images.
946
+ # Updates a License resource in the specified project.
947
+ # *Caution* This resource is intended
948
+ # for use only by third-party partners who are creatingCloud Marketplace
949
+ # images.
817
950
  #
818
951
  # @overload update(request, options = nil)
819
952
  # Pass arguments to `update` via a request object, either of type
@@ -837,7 +970,19 @@ module Google
837
970
  # @param project [::String]
838
971
  # Project ID for this request.
839
972
  # @param request_id [::String]
840
- # 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).
973
+ # An optional request ID to identify requests. Specify a unique request ID so
974
+ # that if you must retry your request, the server will know to ignore the
975
+ # request if it has already been completed.
976
+ #
977
+ # For example, consider a situation where you make an initial request and
978
+ # the request times out. If you make the request again with the same
979
+ # request ID, the server can check if original operation with the same
980
+ # request ID was received, and if so, will ignore the second request. This
981
+ # prevents clients from accidentally creating duplicate commitments.
982
+ #
983
+ # The request ID must be
984
+ # a valid UUID with the exception that zero UUID is not supported
985
+ # (00000000-0000-0000-0000-000000000000).
841
986
  # @param update_mask [::String]
842
987
  # update_mask indicates fields to be updated as part of this request.
843
988
  # @yield [result, operation] Access the result along with the TransportOperation object