google-cloud-compute-v1 2.14.0 → 2.16.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (210) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +37 -1
  3. data/lib/google/cloud/compute/v1/accelerator_types/rest/client.rb +36 -4
  4. data/lib/google/cloud/compute/v1/accelerator_types/rest/service_stub.rb +38 -20
  5. data/lib/google/cloud/compute/v1/addresses/rest/client.rb +40 -8
  6. data/lib/google/cloud/compute/v1/addresses/rest/service_stub.rb +70 -44
  7. data/lib/google/cloud/compute/v1/autoscalers/rest/client.rb +40 -8
  8. data/lib/google/cloud/compute/v1/autoscalers/rest/service_stub.rb +70 -44
  9. data/lib/google/cloud/compute/v1/backend_buckets/rest/client.rb +42 -13
  10. data/lib/google/cloud/compute/v1/backend_buckets/rest/service_stub.rb +110 -74
  11. data/lib/google/cloud/compute/v1/backend_services/rest/client.rb +45 -17
  12. data/lib/google/cloud/compute/v1/backend_services/rest/service_stub.rb +142 -98
  13. data/lib/google/cloud/compute/v1/compute_pb.rb +57 -2
  14. data/lib/google/cloud/compute/v1/disk_types/rest/client.rb +36 -4
  15. data/lib/google/cloud/compute/v1/disk_types/rest/service_stub.rb +38 -20
  16. data/lib/google/cloud/compute/v1/disks/rest/client.rb +48 -19
  17. data/lib/google/cloud/compute/v1/disks/rest/service_stub.rb +158 -110
  18. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/client.rb +38 -7
  19. data/lib/google/cloud/compute/v1/external_vpn_gateways/rest/service_stub.rb +62 -38
  20. data/lib/google/cloud/compute/v1/firewall_policies/rest/client.rb +45 -19
  21. data/lib/google/cloud/compute/v1/firewall_policies/rest/service_stub.rb +158 -110
  22. data/lib/google/cloud/compute/v1/firewalls/rest/client.rb +39 -7
  23. data/lib/google/cloud/compute/v1/firewalls/rest/service_stub.rb +62 -38
  24. data/lib/google/cloud/compute/v1/forwarding_rules/rest/client.rb +41 -9
  25. data/lib/google/cloud/compute/v1/forwarding_rules/rest/service_stub.rb +78 -50
  26. data/lib/google/cloud/compute/v1/global_addresses/rest/client.rb +39 -7
  27. data/lib/google/cloud/compute/v1/global_addresses/rest/service_stub.rb +62 -38
  28. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/client.rb +40 -8
  29. data/lib/google/cloud/compute/v1/global_forwarding_rules/rest/service_stub.rb +70 -44
  30. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/client.rb +40 -8
  31. data/lib/google/cloud/compute/v1/global_network_endpoint_groups/rest/service_stub.rb +70 -44
  32. data/lib/google/cloud/compute/v1/global_operations/rest/client.rb +36 -6
  33. data/lib/google/cloud/compute/v1/global_operations/rest/service_stub.rb +54 -32
  34. data/lib/google/cloud/compute/v1/global_organization_operations/rest/client.rb +35 -4
  35. data/lib/google/cloud/compute/v1/global_organization_operations/rest/service_stub.rb +38 -20
  36. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/client.rb +38 -6
  37. data/lib/google/cloud/compute/v1/global_public_delegated_prefixes/rest/service_stub.rb +54 -32
  38. data/lib/google/cloud/compute/v1/health_checks/rest/client.rb +40 -8
  39. data/lib/google/cloud/compute/v1/health_checks/rest/service_stub.rb +70 -44
  40. data/lib/google/cloud/compute/v1/image_family_views/rest/client.rb +34 -2
  41. data/lib/google/cloud/compute/v1/image_family_views/rest/service_stub.rb +22 -8
  42. data/lib/google/cloud/compute/v1/images/rest/client.rb +40 -12
  43. data/lib/google/cloud/compute/v1/images/rest/service_stub.rb +102 -68
  44. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/client.rb +38 -6
  45. data/lib/google/cloud/compute/v1/instance_group_manager_resize_requests/rest/service_stub.rb +54 -32
  46. data/lib/google/cloud/compute/v1/instance_group_managers/rest/client.rb +473 -21
  47. data/lib/google/cloud/compute/v1/instance_group_managers/rest/service_stub.rb +428 -120
  48. data/lib/google/cloud/compute/v1/instance_groups/rest/client.rb +42 -10
  49. data/lib/google/cloud/compute/v1/instance_groups/rest/service_stub.rb +86 -56
  50. data/lib/google/cloud/compute/v1/instance_settings_service/rest/client.rb +35 -3
  51. data/lib/google/cloud/compute/v1/instance_settings_service/rest/service_stub.rb +30 -14
  52. data/lib/google/cloud/compute/v1/instance_templates/rest/client.rb +38 -9
  53. data/lib/google/cloud/compute/v1/instance_templates/rest/service_stub.rb +78 -50
  54. data/lib/google/cloud/compute/v1/instances/rest/client.rb +73 -50
  55. data/lib/google/cloud/compute/v1/instances/rest/service_stub.rb +398 -290
  56. data/lib/google/cloud/compute/v1/instant_snapshots/rest/client.rb +39 -10
  57. data/lib/google/cloud/compute/v1/instant_snapshots/rest/service_stub.rb +86 -56
  58. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/client.rb +40 -8
  59. data/lib/google/cloud/compute/v1/interconnect_attachments/rest/service_stub.rb +70 -44
  60. data/lib/google/cloud/compute/v1/interconnect_locations/rest/client.rb +35 -3
  61. data/lib/google/cloud/compute/v1/interconnect_locations/rest/service_stub.rb +30 -14
  62. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/client.rb +35 -3
  63. data/lib/google/cloud/compute/v1/interconnect_remote_locations/rest/service_stub.rb +30 -14
  64. data/lib/google/cloud/compute/v1/interconnects/rest/client.rb +39 -9
  65. data/lib/google/cloud/compute/v1/interconnects/rest/service_stub.rb +78 -50
  66. data/lib/google/cloud/compute/v1/license_codes/rest/client.rb +34 -3
  67. data/lib/google/cloud/compute/v1/license_codes/rest/service_stub.rb +30 -14
  68. data/lib/google/cloud/compute/v1/licenses/rest/client.rb +37 -8
  69. data/lib/google/cloud/compute/v1/licenses/rest/service_stub.rb +70 -44
  70. data/lib/google/cloud/compute/v1/machine_images/rest/client.rb +37 -8
  71. data/lib/google/cloud/compute/v1/machine_images/rest/service_stub.rb +70 -44
  72. data/lib/google/cloud/compute/v1/machine_types/rest/client.rb +36 -4
  73. data/lib/google/cloud/compute/v1/machine_types/rest/service_stub.rb +38 -20
  74. data/lib/google/cloud/compute/v1/network_attachments/rest/client.rb +39 -10
  75. data/lib/google/cloud/compute/v1/network_attachments/rest/service_stub.rb +86 -56
  76. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/client.rb +38 -6
  77. data/lib/google/cloud/compute/v1/network_edge_security_services/rest/service_stub.rb +54 -32
  78. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/client.rb +41 -10
  79. data/lib/google/cloud/compute/v1/network_endpoint_groups/rest/service_stub.rb +86 -56
  80. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/client.rb +150 -17
  81. data/lib/google/cloud/compute/v1/network_firewall_policies/rest/service_stub.rb +202 -97
  82. data/lib/google/cloud/compute/v1/network_profiles/credentials.rb +53 -0
  83. data/lib/google/cloud/compute/v1/network_profiles/rest/client.rb +529 -0
  84. data/lib/google/cloud/compute/v1/network_profiles/rest/service_stub.rb +204 -0
  85. data/lib/google/cloud/compute/v1/network_profiles/rest.rb +51 -0
  86. data/lib/google/cloud/compute/v1/network_profiles.rb +47 -0
  87. data/lib/google/cloud/compute/v1/networks/rest/client.rb +43 -12
  88. data/lib/google/cloud/compute/v1/networks/rest/service_stub.rb +102 -68
  89. data/lib/google/cloud/compute/v1/node_groups/rest/client.rb +45 -16
  90. data/lib/google/cloud/compute/v1/node_groups/rest/service_stub.rb +134 -92
  91. data/lib/google/cloud/compute/v1/node_templates/rest/client.rb +38 -9
  92. data/lib/google/cloud/compute/v1/node_templates/rest/service_stub.rb +78 -50
  93. data/lib/google/cloud/compute/v1/node_types/rest/client.rb +36 -4
  94. data/lib/google/cloud/compute/v1/node_types/rest/service_stub.rb +38 -20
  95. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/client.rb +39 -8
  96. data/lib/google/cloud/compute/v1/packet_mirrorings/rest/service_stub.rb +70 -44
  97. data/lib/google/cloud/compute/v1/projects/rest/client.rb +46 -15
  98. data/lib/google/cloud/compute/v1/projects/rest/service_stub.rb +126 -86
  99. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/client.rb +40 -8
  100. data/lib/google/cloud/compute/v1/public_advertised_prefixes/rest/service_stub.rb +70 -44
  101. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/client.rb +41 -9
  102. data/lib/google/cloud/compute/v1/public_delegated_prefixes/rest/service_stub.rb +78 -50
  103. data/lib/google/cloud/compute/v1/region_autoscalers/rest/client.rb +39 -7
  104. data/lib/google/cloud/compute/v1/region_autoscalers/rest/service_stub.rb +62 -38
  105. data/lib/google/cloud/compute/v1/region_backend_services/rest/client.rb +41 -13
  106. data/lib/google/cloud/compute/v1/region_backend_services/rest/service_stub.rb +110 -74
  107. data/lib/google/cloud/compute/v1/region_commitments/rest/client.rb +38 -6
  108. data/lib/google/cloud/compute/v1/region_commitments/rest/service_stub.rb +54 -32
  109. data/lib/google/cloud/compute/v1/region_disk_types/rest/client.rb +35 -3
  110. data/lib/google/cloud/compute/v1/region_disk_types/rest/service_stub.rb +30 -14
  111. data/lib/google/cloud/compute/v1/region_disks/rest/client.rb +47 -18
  112. data/lib/google/cloud/compute/v1/region_disks/rest/service_stub.rb +150 -104
  113. data/lib/google/cloud/compute/v1/region_health_check_services/rest/client.rb +38 -6
  114. data/lib/google/cloud/compute/v1/region_health_check_services/rest/service_stub.rb +54 -32
  115. data/lib/google/cloud/compute/v1/region_health_checks/rest/client.rb +39 -7
  116. data/lib/google/cloud/compute/v1/region_health_checks/rest/service_stub.rb +62 -38
  117. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/client.rb +472 -20
  118. data/lib/google/cloud/compute/v1/region_instance_group_managers/rest/service_stub.rb +420 -114
  119. data/lib/google/cloud/compute/v1/region_instance_groups/rest/client.rb +37 -5
  120. data/lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb +46 -26
  121. data/lib/google/cloud/compute/v1/region_instance_templates/rest/client.rb +37 -5
  122. data/lib/google/cloud/compute/v1/region_instance_templates/rest/service_stub.rb +46 -26
  123. data/lib/google/cloud/compute/v1/region_instances/rest/client.rb +35 -2
  124. data/lib/google/cloud/compute/v1/region_instances/rest/service_stub.rb +22 -8
  125. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/client.rb +38 -9
  126. data/lib/google/cloud/compute/v1/region_instant_snapshots/rest/service_stub.rb +78 -50
  127. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/client.rb +40 -8
  128. data/lib/google/cloud/compute/v1/region_network_endpoint_groups/rest/service_stub.rb +70 -44
  129. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/client.rb +44 -18
  130. data/lib/google/cloud/compute/v1/region_network_firewall_policies/rest/service_stub.rb +150 -104
  131. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/client.rb +37 -5
  132. data/lib/google/cloud/compute/v1/region_notification_endpoints/rest/service_stub.rb +46 -26
  133. data/lib/google/cloud/compute/v1/region_operations/rest/client.rb +35 -5
  134. data/lib/google/cloud/compute/v1/region_operations/rest/service_stub.rb +46 -26
  135. data/lib/google/cloud/compute/v1/region_security_policies/rest/client.rb +146 -10
  136. data/lib/google/cloud/compute/v1/region_security_policies/rest/service_stub.rb +149 -55
  137. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/client.rb +37 -5
  138. data/lib/google/cloud/compute/v1/region_ssl_certificates/rest/service_stub.rb +46 -26
  139. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/client.rb +38 -7
  140. data/lib/google/cloud/compute/v1/region_ssl_policies/rest/service_stub.rb +62 -38
  141. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/client.rb +38 -6
  142. data/lib/google/cloud/compute/v1/region_target_http_proxies/rest/service_stub.rb +54 -32
  143. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/client.rb +40 -8
  144. data/lib/google/cloud/compute/v1/region_target_https_proxies/rest/service_stub.rb +70 -44
  145. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/client.rb +37 -5
  146. data/lib/google/cloud/compute/v1/region_target_tcp_proxies/rest/service_stub.rb +46 -26
  147. data/lib/google/cloud/compute/v1/region_url_maps/rest/client.rb +39 -8
  148. data/lib/google/cloud/compute/v1/region_url_maps/rest/service_stub.rb +70 -44
  149. data/lib/google/cloud/compute/v1/region_zones/rest/client.rb +35 -2
  150. data/lib/google/cloud/compute/v1/region_zones/rest/service_stub.rb +22 -8
  151. data/lib/google/cloud/compute/v1/regions/rest/client.rb +35 -3
  152. data/lib/google/cloud/compute/v1/regions/rest/service_stub.rb +30 -14
  153. data/lib/google/cloud/compute/v1/reservations/rest/client.rb +40 -11
  154. data/lib/google/cloud/compute/v1/reservations/rest/service_stub.rb +94 -62
  155. data/lib/google/cloud/compute/v1/resource_policies/rest/client.rb +39 -10
  156. data/lib/google/cloud/compute/v1/resource_policies/rest/service_stub.rb +86 -56
  157. data/lib/google/cloud/compute/v1/rest.rb +1 -0
  158. data/lib/google/cloud/compute/v1/routers/rest/client.rb +41 -12
  159. data/lib/google/cloud/compute/v1/routers/rest/service_stub.rb +102 -68
  160. data/lib/google/cloud/compute/v1/routes/rest/client.rb +37 -5
  161. data/lib/google/cloud/compute/v1/routes/rest/service_stub.rb +46 -26
  162. data/lib/google/cloud/compute/v1/security_policies/rest/client.rb +43 -13
  163. data/lib/google/cloud/compute/v1/security_policies/rest/service_stub.rb +110 -74
  164. data/lib/google/cloud/compute/v1/service_attachments/rest/client.rb +39 -10
  165. data/lib/google/cloud/compute/v1/service_attachments/rest/service_stub.rb +86 -56
  166. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/client.rb +35 -3
  167. data/lib/google/cloud/compute/v1/snapshot_settings_service/rest/service_stub.rb +30 -14
  168. data/lib/google/cloud/compute/v1/snapshots/rest/client.rb +38 -9
  169. data/lib/google/cloud/compute/v1/snapshots/rest/service_stub.rb +78 -50
  170. data/lib/google/cloud/compute/v1/ssl_certificates/rest/client.rb +38 -6
  171. data/lib/google/cloud/compute/v1/ssl_certificates/rest/service_stub.rb +54 -32
  172. data/lib/google/cloud/compute/v1/ssl_policies/rest/client.rb +39 -8
  173. data/lib/google/cloud/compute/v1/ssl_policies/rest/service_stub.rb +70 -44
  174. data/lib/google/cloud/compute/v1/storage_pool_types/rest/client.rb +36 -4
  175. data/lib/google/cloud/compute/v1/storage_pool_types/rest/service_stub.rb +38 -20
  176. data/lib/google/cloud/compute/v1/storage_pools/rest/client.rb +38 -11
  177. data/lib/google/cloud/compute/v1/storage_pools/rest/service_stub.rb +94 -62
  178. data/lib/google/cloud/compute/v1/subnetworks/rest/client.rb +42 -13
  179. data/lib/google/cloud/compute/v1/subnetworks/rest/service_stub.rb +110 -74
  180. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/client.rb +38 -6
  181. data/lib/google/cloud/compute/v1/target_grpc_proxies/rest/service_stub.rb +54 -32
  182. data/lib/google/cloud/compute/v1/target_http_proxies/rest/client.rb +40 -8
  183. data/lib/google/cloud/compute/v1/target_http_proxies/rest/service_stub.rb +70 -44
  184. data/lib/google/cloud/compute/v1/target_https_proxies/rest/client.rb +44 -12
  185. data/lib/google/cloud/compute/v1/target_https_proxies/rest/service_stub.rb +102 -68
  186. data/lib/google/cloud/compute/v1/target_instances/rest/client.rb +39 -7
  187. data/lib/google/cloud/compute/v1/target_instances/rest/service_stub.rb +62 -38
  188. data/lib/google/cloud/compute/v1/target_pools/rest/client.rb +44 -13
  189. data/lib/google/cloud/compute/v1/target_pools/rest/service_stub.rb +110 -74
  190. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/client.rb +42 -10
  191. data/lib/google/cloud/compute/v1/target_ssl_proxies/rest/service_stub.rb +86 -56
  192. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/client.rb +40 -8
  193. data/lib/google/cloud/compute/v1/target_tcp_proxies/rest/service_stub.rb +70 -44
  194. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/client.rb +39 -7
  195. data/lib/google/cloud/compute/v1/target_vpn_gateways/rest/service_stub.rb +62 -38
  196. data/lib/google/cloud/compute/v1/url_maps/rest/client.rb +41 -10
  197. data/lib/google/cloud/compute/v1/url_maps/rest/service_stub.rb +86 -56
  198. data/lib/google/cloud/compute/v1/version.rb +1 -1
  199. data/lib/google/cloud/compute/v1/vpn_gateways/rest/client.rb +39 -9
  200. data/lib/google/cloud/compute/v1/vpn_gateways/rest/service_stub.rb +78 -50
  201. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/client.rb +39 -7
  202. data/lib/google/cloud/compute/v1/vpn_tunnels/rest/service_stub.rb +62 -38
  203. data/lib/google/cloud/compute/v1/zone_operations/rest/client.rb +35 -5
  204. data/lib/google/cloud/compute/v1/zone_operations/rest/service_stub.rb +46 -26
  205. data/lib/google/cloud/compute/v1/zones/rest/client.rb +35 -3
  206. data/lib/google/cloud/compute/v1/zones/rest/service_stub.rb +30 -14
  207. data/lib/google/cloud/compute/v1.rb +1 -0
  208. data/proto_docs/google/api/client.rb +19 -0
  209. data/proto_docs/google/cloud/compute/v1/compute.rb +1010 -55
  210. metadata +11 -9
@@ -158,8 +158,28 @@ module Google
158
158
  endpoint: @config.endpoint,
159
159
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
160
160
  universe_domain: @config.universe_domain,
161
- credentials: credentials
161
+ credentials: credentials,
162
+ logger: @config.logger
162
163
  )
164
+
165
+ @region_disk_types_stub.logger(stub: true)&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+ end
175
+
176
+ ##
177
+ # The logger used for request/response debug logging.
178
+ #
179
+ # @return [Logger]
180
+ #
181
+ def logger
182
+ @region_disk_types_stub.logger
163
183
  end
164
184
 
165
185
  # Service calls
@@ -241,7 +261,6 @@ module Google
241
261
 
242
262
  @region_disk_types_stub.get request, options do |result, operation|
243
263
  yield result, operation if block_given?
244
- return result
245
264
  end
246
265
  rescue ::Gapic::Rest::Error => e
247
266
  raise ::Google::Cloud::Error.from_error(e)
@@ -333,7 +352,7 @@ module Google
333
352
  @region_disk_types_stub.list request, options do |result, operation|
334
353
  result = ::Gapic::Rest::PagedEnumerable.new @region_disk_types_stub, :list, "items", request, result, options
335
354
  yield result, operation if block_given?
336
- return result
355
+ throw :response, result
337
356
  end
338
357
  rescue ::Gapic::Rest::Error => e
339
358
  raise ::Google::Cloud::Error.from_error(e)
@@ -381,6 +400,13 @@ module Google
381
400
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
382
401
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
383
402
  # * (`nil`) indicating no credentials
403
+ #
404
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
405
+ # external source for authentication to Google Cloud, you must validate it before
406
+ # providing it to a Google API client library. Providing an unvalidated credential
407
+ # configuration to Google APIs can compromise the security of your systems and data.
408
+ # For more information, refer to [Validate credential configurations from external
409
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
384
410
  # @return [::Object]
385
411
  # @!attribute [rw] scope
386
412
  # The OAuth scopes
@@ -413,6 +439,11 @@ module Google
413
439
  # default endpoint URL. The default value of nil uses the environment
414
440
  # universe (usually the default "googleapis.com" universe).
415
441
  # @return [::String,nil]
442
+ # @!attribute [rw] logger
443
+ # A custom logger to use for request/response debug logging, or the value
444
+ # `:default` (the default) to construct a default logger, or `nil` to
445
+ # explicitly disable logging.
446
+ # @return [::Logger,:default,nil]
416
447
  #
417
448
  class Configuration
418
449
  extend ::Gapic::Config
@@ -434,6 +465,7 @@ module Google
434
465
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
435
466
  config_attr :quota_project, nil, ::String, nil
436
467
  config_attr :universe_domain, nil, ::String, nil
468
+ config_attr :logger, :default, ::Logger, nil, :default
437
469
 
438
470
  # @private
439
471
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: false,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the get REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "get",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Compute::V1::DiskType.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "list",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Compute::V1::RegionDiskTypeList.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -199,8 +199,19 @@ module Google
199
199
  endpoint: @config.endpoint,
200
200
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
201
201
  universe_domain: @config.universe_domain,
202
- credentials: credentials
202
+ credentials: credentials,
203
+ logger: @config.logger
203
204
  )
205
+
206
+ @region_disks_stub.logger(stub: true)&.info do |entry|
207
+ entry.set_system_name
208
+ entry.set_service
209
+ entry.message = "Created client for #{entry.service}"
210
+ entry.set_credentials_fields credentials
211
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
212
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
213
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
214
+ end
204
215
  end
205
216
 
206
217
  ##
@@ -210,6 +221,15 @@ module Google
210
221
  #
211
222
  attr_reader :region_operations
212
223
 
224
+ ##
225
+ # The logger used for request/response debug logging.
226
+ #
227
+ # @return [Logger]
228
+ #
229
+ def logger
230
+ @region_disks_stub.logger
231
+ end
232
+
213
233
  # Service calls
214
234
 
215
235
  ##
@@ -302,7 +322,7 @@ module Google
302
322
  options: options
303
323
  )
304
324
  yield result, response if block_given?
305
- return result
325
+ throw :response, result
306
326
  end
307
327
  rescue ::Gapic::Rest::Error => e
308
328
  raise ::Google::Cloud::Error.from_error(e)
@@ -396,7 +416,7 @@ module Google
396
416
  options: options
397
417
  )
398
418
  yield result, response if block_given?
399
- return result
419
+ throw :response, result
400
420
  end
401
421
  rescue ::Gapic::Rest::Error => e
402
422
  raise ::Google::Cloud::Error.from_error(e)
@@ -492,7 +512,7 @@ module Google
492
512
  options: options
493
513
  )
494
514
  yield result, response if block_given?
495
- return result
515
+ throw :response, result
496
516
  end
497
517
  rescue ::Gapic::Rest::Error => e
498
518
  raise ::Google::Cloud::Error.from_error(e)
@@ -586,7 +606,7 @@ module Google
586
606
  options: options
587
607
  )
588
608
  yield result, response if block_given?
589
- return result
609
+ throw :response, result
590
610
  end
591
611
  rescue ::Gapic::Rest::Error => e
592
612
  raise ::Google::Cloud::Error.from_error(e)
@@ -669,7 +689,6 @@ module Google
669
689
 
670
690
  @region_disks_stub.get request, options do |result, operation|
671
691
  yield result, operation if block_given?
672
- return result
673
692
  end
674
693
  rescue ::Gapic::Rest::Error => e
675
694
  raise ::Google::Cloud::Error.from_error(e)
@@ -754,7 +773,6 @@ module Google
754
773
 
755
774
  @region_disks_stub.get_iam_policy request, options do |result, operation|
756
775
  yield result, operation if block_given?
757
- return result
758
776
  end
759
777
  rescue ::Gapic::Rest::Error => e
760
778
  raise ::Google::Cloud::Error.from_error(e)
@@ -850,7 +868,7 @@ module Google
850
868
  options: options
851
869
  )
852
870
  yield result, response if block_given?
853
- return result
871
+ throw :response, result
854
872
  end
855
873
  rescue ::Gapic::Rest::Error => e
856
874
  raise ::Google::Cloud::Error.from_error(e)
@@ -942,7 +960,7 @@ module Google
942
960
  @region_disks_stub.list request, options do |result, operation|
943
961
  result = ::Gapic::Rest::PagedEnumerable.new @region_disks_stub, :list, "items", request, result, options
944
962
  yield result, operation if block_given?
945
- return result
963
+ throw :response, result
946
964
  end
947
965
  rescue ::Gapic::Rest::Error => e
948
966
  raise ::Google::Cloud::Error.from_error(e)
@@ -1038,7 +1056,7 @@ module Google
1038
1056
  options: options
1039
1057
  )
1040
1058
  yield result, response if block_given?
1041
- return result
1059
+ throw :response, result
1042
1060
  end
1043
1061
  rescue ::Gapic::Rest::Error => e
1044
1062
  raise ::Google::Cloud::Error.from_error(e)
@@ -1134,7 +1152,7 @@ module Google
1134
1152
  options: options
1135
1153
  )
1136
1154
  yield result, response if block_given?
1137
- return result
1155
+ throw :response, result
1138
1156
  end
1139
1157
  rescue ::Gapic::Rest::Error => e
1140
1158
  raise ::Google::Cloud::Error.from_error(e)
@@ -1219,7 +1237,6 @@ module Google
1219
1237
 
1220
1238
  @region_disks_stub.set_iam_policy request, options do |result, operation|
1221
1239
  yield result, operation if block_given?
1222
- return result
1223
1240
  end
1224
1241
  rescue ::Gapic::Rest::Error => e
1225
1242
  raise ::Google::Cloud::Error.from_error(e)
@@ -1315,7 +1332,7 @@ module Google
1315
1332
  options: options
1316
1333
  )
1317
1334
  yield result, response if block_given?
1318
- return result
1335
+ throw :response, result
1319
1336
  end
1320
1337
  rescue ::Gapic::Rest::Error => e
1321
1338
  raise ::Google::Cloud::Error.from_error(e)
@@ -1411,7 +1428,7 @@ module Google
1411
1428
  options: options
1412
1429
  )
1413
1430
  yield result, response if block_given?
1414
- return result
1431
+ throw :response, result
1415
1432
  end
1416
1433
  rescue ::Gapic::Rest::Error => e
1417
1434
  raise ::Google::Cloud::Error.from_error(e)
@@ -1505,7 +1522,7 @@ module Google
1505
1522
  options: options
1506
1523
  )
1507
1524
  yield result, response if block_given?
1508
- return result
1525
+ throw :response, result
1509
1526
  end
1510
1527
  rescue ::Gapic::Rest::Error => e
1511
1528
  raise ::Google::Cloud::Error.from_error(e)
@@ -1599,7 +1616,7 @@ module Google
1599
1616
  options: options
1600
1617
  )
1601
1618
  yield result, response if block_given?
1602
- return result
1619
+ throw :response, result
1603
1620
  end
1604
1621
  rescue ::Gapic::Rest::Error => e
1605
1622
  raise ::Google::Cloud::Error.from_error(e)
@@ -1684,7 +1701,6 @@ module Google
1684
1701
 
1685
1702
  @region_disks_stub.test_iam_permissions request, options do |result, operation|
1686
1703
  yield result, operation if block_given?
1687
- return result
1688
1704
  end
1689
1705
  rescue ::Gapic::Rest::Error => e
1690
1706
  raise ::Google::Cloud::Error.from_error(e)
@@ -1783,7 +1799,7 @@ module Google
1783
1799
  options: options
1784
1800
  )
1785
1801
  yield result, response if block_given?
1786
- return result
1802
+ throw :response, result
1787
1803
  end
1788
1804
  rescue ::Gapic::Rest::Error => e
1789
1805
  raise ::Google::Cloud::Error.from_error(e)
@@ -1831,6 +1847,13 @@ module Google
1831
1847
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1832
1848
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1833
1849
  # * (`nil`) indicating no credentials
1850
+ #
1851
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1852
+ # external source for authentication to Google Cloud, you must validate it before
1853
+ # providing it to a Google API client library. Providing an unvalidated credential
1854
+ # configuration to Google APIs can compromise the security of your systems and data.
1855
+ # For more information, refer to [Validate credential configurations from external
1856
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1834
1857
  # @return [::Object]
1835
1858
  # @!attribute [rw] scope
1836
1859
  # The OAuth scopes
@@ -1863,6 +1886,11 @@ module Google
1863
1886
  # default endpoint URL. The default value of nil uses the environment
1864
1887
  # universe (usually the default "googleapis.com" universe).
1865
1888
  # @return [::String,nil]
1889
+ # @!attribute [rw] logger
1890
+ # A custom logger to use for request/response debug logging, or the value
1891
+ # `:default` (the default) to construct a default logger, or `nil` to
1892
+ # explicitly disable logging.
1893
+ # @return [::Logger,:default,nil]
1866
1894
  #
1867
1895
  class Configuration
1868
1896
  extend ::Gapic::Config
@@ -1884,6 +1912,7 @@ module Google
1884
1912
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1885
1913
  config_attr :quota_project, nil, ::String, nil
1886
1914
  config_attr :universe_domain, nil, ::String, nil
1915
+ config_attr :logger, :default, ::Logger, nil, :default
1887
1916
 
1888
1917
  # @private
1889
1918
  def initialize parent_config = nil