google-cloud-apigee_registry-v1 0.8.0 → 0.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +30 -20
- data/lib/google/cloud/apigee_registry/v1/provisioning/client.rb +40 -7
- data/lib/google/cloud/apigee_registry/v1/provisioning/operations.rb +25 -20
- data/lib/google/cloud/apigee_registry/v1/provisioning/rest/client.rb +40 -7
- data/lib/google/cloud/apigee_registry/v1/provisioning/rest/operations.rb +54 -42
- data/lib/google/cloud/apigee_registry/v1/provisioning/rest/service_stub.rb +38 -20
- data/lib/google/cloud/apigee_registry/v1/registry/client.rb +109 -71
- data/lib/google/cloud/apigee_registry/v1/registry/rest/client.rb +109 -71
- data/lib/google/cloud/apigee_registry/v1/registry/rest/service_stub.rb +294 -212
- data/lib/google/cloud/apigee_registry/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +74 -10
- data/proto_docs/google/api/resource.rb +7 -2
- data/proto_docs/google/longrunning/operations.rb +19 -14
- metadata +5 -5
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d015880b5c33c1ad57def4e04e44f18b0fb6888a397decd50ed0ac2716818323
|
|
4
|
+
data.tar.gz: aa4fd26610d20cc9d67aa3f5df63c1bd8fa718e0798692ee324599590873e4de
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 3e7764e61d51c1119d0e757279cfe7714d2a5038d27af7354df4a9ea59dee9ffa4b92f0dca84c822d0e90cda285e3f316b5354e33df56f47d721f83abe7f03d0
|
|
7
|
+
data.tar.gz: 0a468f708d5344c0a4384218a3e5eaf770c036a36a795da5fec33a35cc001f960ea1f68d114cb4735a2f6e87ee82acfb63dd12577cdc3299477d55f90082f816
|
data/README.md
CHANGED
|
@@ -43,33 +43,43 @@ for class and method documentation.
|
|
|
43
43
|
See also the [Product Documentation](https://cloud.google.com/apigee/docs/api-hub/get-started-registry-api/)
|
|
44
44
|
for general usage information.
|
|
45
45
|
|
|
46
|
-
##
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
46
|
+
## Debug Logging
|
|
47
|
+
|
|
48
|
+
This library comes with opt-in Debug Logging that can help you troubleshoot
|
|
49
|
+
your application's integration with the API. When logging is activated, key
|
|
50
|
+
events such as requests and responses, along with data payloads and metadata
|
|
51
|
+
such as headers and client configuration, are logged to the standard error
|
|
52
|
+
stream.
|
|
53
|
+
|
|
54
|
+
**WARNING:** Client Library Debug Logging includes your data payloads in
|
|
55
|
+
plaintext, which could include sensitive data such as PII for yourself or your
|
|
56
|
+
customers, private keys, or other security data that could be compromising if
|
|
57
|
+
leaked. Always practice good data hygiene with your application logs, and follow
|
|
58
|
+
the principle of least access. Google also recommends that Client Library Debug
|
|
59
|
+
Logging be enabled only temporarily during active debugging, and not used
|
|
60
|
+
permanently in production.
|
|
61
|
+
|
|
62
|
+
To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
|
|
63
|
+
to the value `all`. Alternatively, you can set the value to a comma-delimited
|
|
64
|
+
list of client library gem names. This will select the default logging behavior,
|
|
65
|
+
which writes logs to the standard error stream. On a local workstation, this may
|
|
66
|
+
result in logs appearing on the console. When running on a Google Cloud hosting
|
|
67
|
+
service such as [Google Cloud Run](https://cloud.google.com/run), this generally
|
|
68
|
+
results in logs appearing alongside your application logs in the
|
|
69
|
+
[Google Cloud Logging](https://cloud.google.com/logging/) service.
|
|
70
|
+
|
|
71
|
+
You can customize logging by modifying the `logger` configuration when
|
|
72
|
+
constructing a client object. For example:
|
|
55
73
|
|
|
56
74
|
```ruby
|
|
75
|
+
require "google/cloud/apigee_registry/v1"
|
|
57
76
|
require "logger"
|
|
58
77
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
def logger
|
|
62
|
-
LOGGER
|
|
63
|
-
end
|
|
64
|
-
end
|
|
65
|
-
|
|
66
|
-
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
|
67
|
-
module GRPC
|
|
68
|
-
extend MyLogger
|
|
78
|
+
client = ::Google::Cloud::ApigeeRegistry::V1::Provisioning::Client.new do |config|
|
|
79
|
+
config.logger = Logger.new "my-app.log"
|
|
69
80
|
end
|
|
70
81
|
```
|
|
71
82
|
|
|
72
|
-
|
|
73
83
|
## Google Cloud Samples
|
|
74
84
|
|
|
75
85
|
To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
|
|
@@ -33,6 +33,9 @@ module Google
|
|
|
33
33
|
# Registry.
|
|
34
34
|
#
|
|
35
35
|
class Client
|
|
36
|
+
# @private
|
|
37
|
+
API_VERSION = ""
|
|
38
|
+
|
|
36
39
|
# @private
|
|
37
40
|
DEFAULT_ENDPOINT_TEMPLATE = "apigeeregistry.$UNIVERSE_DOMAIN$"
|
|
38
41
|
|
|
@@ -164,14 +167,26 @@ module Google
|
|
|
164
167
|
universe_domain: @config.universe_domain,
|
|
165
168
|
channel_args: @config.channel_args,
|
|
166
169
|
interceptors: @config.interceptors,
|
|
167
|
-
channel_pool_config: @config.channel_pool
|
|
170
|
+
channel_pool_config: @config.channel_pool,
|
|
171
|
+
logger: @config.logger
|
|
168
172
|
)
|
|
169
173
|
|
|
174
|
+
@provisioning_stub.stub_logger&.info do |entry|
|
|
175
|
+
entry.set_system_name
|
|
176
|
+
entry.set_service
|
|
177
|
+
entry.message = "Created client for #{entry.service}"
|
|
178
|
+
entry.set_credentials_fields credentials
|
|
179
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
|
180
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
|
181
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
|
182
|
+
end
|
|
183
|
+
|
|
170
184
|
@location_client = Google::Cloud::Location::Locations::Client.new do |config|
|
|
171
185
|
config.credentials = credentials
|
|
172
186
|
config.quota_project = @quota_project_id
|
|
173
187
|
config.endpoint = @provisioning_stub.endpoint
|
|
174
188
|
config.universe_domain = @provisioning_stub.universe_domain
|
|
189
|
+
config.logger = @provisioning_stub.logger if config.respond_to? :logger=
|
|
175
190
|
end
|
|
176
191
|
|
|
177
192
|
@iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
|
|
@@ -179,6 +194,7 @@ module Google
|
|
|
179
194
|
config.quota_project = @quota_project_id
|
|
180
195
|
config.endpoint = @provisioning_stub.endpoint
|
|
181
196
|
config.universe_domain = @provisioning_stub.universe_domain
|
|
197
|
+
config.logger = @provisioning_stub.logger if config.respond_to? :logger=
|
|
182
198
|
end
|
|
183
199
|
end
|
|
184
200
|
|
|
@@ -203,6 +219,15 @@ module Google
|
|
|
203
219
|
#
|
|
204
220
|
attr_reader :iam_policy_client
|
|
205
221
|
|
|
222
|
+
##
|
|
223
|
+
# The logger used for request/response debug logging.
|
|
224
|
+
#
|
|
225
|
+
# @return [Logger]
|
|
226
|
+
#
|
|
227
|
+
def logger
|
|
228
|
+
@provisioning_stub.logger
|
|
229
|
+
end
|
|
230
|
+
|
|
206
231
|
# Service calls
|
|
207
232
|
|
|
208
233
|
##
|
|
@@ -272,10 +297,11 @@ module Google
|
|
|
272
297
|
# Customize the options with defaults
|
|
273
298
|
metadata = @config.rpcs.create_instance.metadata.to_h
|
|
274
299
|
|
|
275
|
-
# Set x-goog-api-client
|
|
300
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
276
301
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
277
302
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
278
303
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
304
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
279
305
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
280
306
|
|
|
281
307
|
header_params = {}
|
|
@@ -297,7 +323,7 @@ module Google
|
|
|
297
323
|
@provisioning_stub.call_rpc :create_instance, request, options: options do |response, operation|
|
|
298
324
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
|
299
325
|
yield response, operation if block_given?
|
|
300
|
-
|
|
326
|
+
throw :response, response
|
|
301
327
|
end
|
|
302
328
|
rescue ::GRPC::BadStatus => e
|
|
303
329
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -366,10 +392,11 @@ module Google
|
|
|
366
392
|
# Customize the options with defaults
|
|
367
393
|
metadata = @config.rpcs.delete_instance.metadata.to_h
|
|
368
394
|
|
|
369
|
-
# Set x-goog-api-client
|
|
395
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
370
396
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
371
397
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
372
398
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
399
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
373
400
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
374
401
|
|
|
375
402
|
header_params = {}
|
|
@@ -391,7 +418,7 @@ module Google
|
|
|
391
418
|
@provisioning_stub.call_rpc :delete_instance, request, options: options do |response, operation|
|
|
392
419
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
|
393
420
|
yield response, operation if block_given?
|
|
394
|
-
|
|
421
|
+
throw :response, response
|
|
395
422
|
end
|
|
396
423
|
rescue ::GRPC::BadStatus => e
|
|
397
424
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -453,10 +480,11 @@ module Google
|
|
|
453
480
|
# Customize the options with defaults
|
|
454
481
|
metadata = @config.rpcs.get_instance.metadata.to_h
|
|
455
482
|
|
|
456
|
-
# Set x-goog-api-client
|
|
483
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
457
484
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
458
485
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
459
486
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
487
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
460
488
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
461
489
|
|
|
462
490
|
header_params = {}
|
|
@@ -477,7 +505,6 @@ module Google
|
|
|
477
505
|
|
|
478
506
|
@provisioning_stub.call_rpc :get_instance, request, options: options do |response, operation|
|
|
479
507
|
yield response, operation if block_given?
|
|
480
|
-
return response
|
|
481
508
|
end
|
|
482
509
|
rescue ::GRPC::BadStatus => e
|
|
483
510
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -566,6 +593,11 @@ module Google
|
|
|
566
593
|
# default endpoint URL. The default value of nil uses the environment
|
|
567
594
|
# universe (usually the default "googleapis.com" universe).
|
|
568
595
|
# @return [::String,nil]
|
|
596
|
+
# @!attribute [rw] logger
|
|
597
|
+
# A custom logger to use for request/response debug logging, or the value
|
|
598
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
|
599
|
+
# explicitly disable logging.
|
|
600
|
+
# @return [::Logger,:default,nil]
|
|
569
601
|
#
|
|
570
602
|
class Configuration
|
|
571
603
|
extend ::Gapic::Config
|
|
@@ -590,6 +622,7 @@ module Google
|
|
|
590
622
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
591
623
|
config_attr :quota_project, nil, ::String, nil
|
|
592
624
|
config_attr :universe_domain, nil, ::String, nil
|
|
625
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
|
593
626
|
|
|
594
627
|
# @private
|
|
595
628
|
def initialize parent_config = nil
|
|
@@ -26,6 +26,9 @@ module Google
|
|
|
26
26
|
module Provisioning
|
|
27
27
|
# Service that implements Longrunning Operations API.
|
|
28
28
|
class Operations
|
|
29
|
+
# @private
|
|
30
|
+
API_VERSION = ""
|
|
31
|
+
|
|
29
32
|
# @private
|
|
30
33
|
DEFAULT_ENDPOINT_TEMPLATE = "apigeeregistry.$UNIVERSE_DOMAIN$"
|
|
31
34
|
|
|
@@ -121,14 +124,6 @@ module Google
|
|
|
121
124
|
# Lists operations that match the specified filter in the request. If the
|
|
122
125
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
|
123
126
|
#
|
|
124
|
-
# NOTE: the `name` binding allows API services to override the binding
|
|
125
|
-
# to use different resource name schemes, such as `users/*/operations`. To
|
|
126
|
-
# override the binding, API services can add a binding such as
|
|
127
|
-
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
|
128
|
-
# For backwards compatibility, the default name includes the operations
|
|
129
|
-
# collection id, however overriding users must ensure the name binding
|
|
130
|
-
# is the parent resource, without the operations collection id.
|
|
131
|
-
#
|
|
132
127
|
# @overload list_operations(request, options = nil)
|
|
133
128
|
# Pass arguments to `list_operations` via a request object, either of type
|
|
134
129
|
# {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
|
@@ -191,10 +186,11 @@ module Google
|
|
|
191
186
|
# Customize the options with defaults
|
|
192
187
|
metadata = @config.rpcs.list_operations.metadata.to_h
|
|
193
188
|
|
|
194
|
-
# Set x-goog-api-client
|
|
189
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
195
190
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
196
191
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
197
192
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
193
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
198
194
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
199
195
|
|
|
200
196
|
header_params = {}
|
|
@@ -217,7 +213,7 @@ module Google
|
|
|
217
213
|
wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
|
|
218
214
|
response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
|
|
219
215
|
yield response, operation if block_given?
|
|
220
|
-
|
|
216
|
+
throw :response, response
|
|
221
217
|
end
|
|
222
218
|
rescue ::GRPC::BadStatus => e
|
|
223
219
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -287,10 +283,11 @@ module Google
|
|
|
287
283
|
# Customize the options with defaults
|
|
288
284
|
metadata = @config.rpcs.get_operation.metadata.to_h
|
|
289
285
|
|
|
290
|
-
# Set x-goog-api-client
|
|
286
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
291
287
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
292
288
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
293
289
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
290
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
294
291
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
295
292
|
|
|
296
293
|
header_params = {}
|
|
@@ -312,7 +309,7 @@ module Google
|
|
|
312
309
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
|
313
310
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
|
314
311
|
yield response, operation if block_given?
|
|
315
|
-
|
|
312
|
+
throw :response, response
|
|
316
313
|
end
|
|
317
314
|
rescue ::GRPC::BadStatus => e
|
|
318
315
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -376,10 +373,11 @@ module Google
|
|
|
376
373
|
# Customize the options with defaults
|
|
377
374
|
metadata = @config.rpcs.delete_operation.metadata.to_h
|
|
378
375
|
|
|
379
|
-
# Set x-goog-api-client
|
|
376
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
380
377
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
381
378
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
382
379
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
380
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
383
381
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
384
382
|
|
|
385
383
|
header_params = {}
|
|
@@ -400,7 +398,6 @@ module Google
|
|
|
400
398
|
|
|
401
399
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
|
402
400
|
yield response, operation if block_given?
|
|
403
|
-
return response
|
|
404
401
|
end
|
|
405
402
|
rescue ::GRPC::BadStatus => e
|
|
406
403
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -415,8 +412,9 @@ module Google
|
|
|
415
412
|
# other methods to check whether the cancellation succeeded or whether the
|
|
416
413
|
# operation completed despite cancellation. On successful cancellation,
|
|
417
414
|
# the operation is not deleted; instead, it becomes an operation with
|
|
418
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
|
419
|
-
# corresponding to
|
|
415
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
|
416
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
|
417
|
+
# `Code.CANCELLED`.
|
|
420
418
|
#
|
|
421
419
|
# @overload cancel_operation(request, options = nil)
|
|
422
420
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
|
@@ -470,10 +468,11 @@ module Google
|
|
|
470
468
|
# Customize the options with defaults
|
|
471
469
|
metadata = @config.rpcs.cancel_operation.metadata.to_h
|
|
472
470
|
|
|
473
|
-
# Set x-goog-api-client
|
|
471
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
474
472
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
475
473
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
476
474
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
475
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
477
476
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
478
477
|
|
|
479
478
|
header_params = {}
|
|
@@ -494,7 +493,6 @@ module Google
|
|
|
494
493
|
|
|
495
494
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
|
496
495
|
yield response, operation if block_given?
|
|
497
|
-
return response
|
|
498
496
|
end
|
|
499
497
|
rescue ::GRPC::BadStatus => e
|
|
500
498
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -574,10 +572,11 @@ module Google
|
|
|
574
572
|
# Customize the options with defaults
|
|
575
573
|
metadata = @config.rpcs.wait_operation.metadata.to_h
|
|
576
574
|
|
|
577
|
-
# Set x-goog-api-client
|
|
575
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
578
576
|
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
579
577
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
580
578
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION
|
|
579
|
+
metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
581
580
|
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
582
581
|
|
|
583
582
|
options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
|
|
@@ -591,7 +590,7 @@ module Google
|
|
|
591
590
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
|
592
591
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
|
593
592
|
yield response, operation if block_given?
|
|
594
|
-
|
|
593
|
+
throw :response, response
|
|
595
594
|
end
|
|
596
595
|
rescue ::GRPC::BadStatus => e
|
|
597
596
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -680,6 +679,11 @@ module Google
|
|
|
680
679
|
# default endpoint URL. The default value of nil uses the environment
|
|
681
680
|
# universe (usually the default "googleapis.com" universe).
|
|
682
681
|
# @return [::String,nil]
|
|
682
|
+
# @!attribute [rw] logger
|
|
683
|
+
# A custom logger to use for request/response debug logging, or the value
|
|
684
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
|
685
|
+
# explicitly disable logging.
|
|
686
|
+
# @return [::Logger,:default,nil]
|
|
683
687
|
#
|
|
684
688
|
class Configuration
|
|
685
689
|
extend ::Gapic::Config
|
|
@@ -704,6 +708,7 @@ module Google
|
|
|
704
708
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
|
705
709
|
config_attr :quota_project, nil, ::String, nil
|
|
706
710
|
config_attr :universe_domain, nil, ::String, nil
|
|
711
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
|
707
712
|
|
|
708
713
|
# @private
|
|
709
714
|
def initialize parent_config = nil
|
|
@@ -35,6 +35,9 @@ module Google
|
|
|
35
35
|
# Registry.
|
|
36
36
|
#
|
|
37
37
|
class Client
|
|
38
|
+
# @private
|
|
39
|
+
API_VERSION = ""
|
|
40
|
+
|
|
38
41
|
# @private
|
|
39
42
|
DEFAULT_ENDPOINT_TEMPLATE = "apigeeregistry.$UNIVERSE_DOMAIN$"
|
|
40
43
|
|
|
@@ -157,15 +160,27 @@ module Google
|
|
|
157
160
|
endpoint: @config.endpoint,
|
|
158
161
|
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
|
159
162
|
universe_domain: @config.universe_domain,
|
|
160
|
-
credentials: credentials
|
|
163
|
+
credentials: credentials,
|
|
164
|
+
logger: @config.logger
|
|
161
165
|
)
|
|
162
166
|
|
|
167
|
+
@provisioning_stub.logger(stub: true)&.info do |entry|
|
|
168
|
+
entry.set_system_name
|
|
169
|
+
entry.set_service
|
|
170
|
+
entry.message = "Created client for #{entry.service}"
|
|
171
|
+
entry.set_credentials_fields credentials
|
|
172
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
|
173
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
|
174
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
|
175
|
+
end
|
|
176
|
+
|
|
163
177
|
@location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
|
|
164
178
|
config.credentials = credentials
|
|
165
179
|
config.quota_project = @quota_project_id
|
|
166
180
|
config.endpoint = @provisioning_stub.endpoint
|
|
167
181
|
config.universe_domain = @provisioning_stub.universe_domain
|
|
168
182
|
config.bindings_override = @config.bindings_override
|
|
183
|
+
config.logger = @provisioning_stub.logger if config.respond_to? :logger=
|
|
169
184
|
end
|
|
170
185
|
|
|
171
186
|
@iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
|
|
@@ -174,6 +189,7 @@ module Google
|
|
|
174
189
|
config.endpoint = @provisioning_stub.endpoint
|
|
175
190
|
config.universe_domain = @provisioning_stub.universe_domain
|
|
176
191
|
config.bindings_override = @config.bindings_override
|
|
192
|
+
config.logger = @provisioning_stub.logger if config.respond_to? :logger=
|
|
177
193
|
end
|
|
178
194
|
end
|
|
179
195
|
|
|
@@ -198,6 +214,15 @@ module Google
|
|
|
198
214
|
#
|
|
199
215
|
attr_reader :iam_policy_client
|
|
200
216
|
|
|
217
|
+
##
|
|
218
|
+
# The logger used for request/response debug logging.
|
|
219
|
+
#
|
|
220
|
+
# @return [Logger]
|
|
221
|
+
#
|
|
222
|
+
def logger
|
|
223
|
+
@provisioning_stub.logger
|
|
224
|
+
end
|
|
225
|
+
|
|
201
226
|
# Service calls
|
|
202
227
|
|
|
203
228
|
##
|
|
@@ -266,12 +291,13 @@ module Google
|
|
|
266
291
|
# Customize the options with defaults
|
|
267
292
|
call_metadata = @config.rpcs.create_instance.metadata.to_h
|
|
268
293
|
|
|
269
|
-
# Set x-goog-api-client
|
|
294
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
270
295
|
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
271
296
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
272
297
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION,
|
|
273
298
|
transports_version_send: [:rest]
|
|
274
299
|
|
|
300
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
275
301
|
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
276
302
|
|
|
277
303
|
options.apply_defaults timeout: @config.rpcs.create_instance.timeout,
|
|
@@ -285,7 +311,7 @@ module Google
|
|
|
285
311
|
@provisioning_stub.create_instance request, options do |result, operation|
|
|
286
312
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
|
287
313
|
yield result, operation if block_given?
|
|
288
|
-
|
|
314
|
+
throw :response, result
|
|
289
315
|
end
|
|
290
316
|
rescue ::Gapic::Rest::Error => e
|
|
291
317
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -353,12 +379,13 @@ module Google
|
|
|
353
379
|
# Customize the options with defaults
|
|
354
380
|
call_metadata = @config.rpcs.delete_instance.metadata.to_h
|
|
355
381
|
|
|
356
|
-
# Set x-goog-api-client
|
|
382
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
357
383
|
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
358
384
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
359
385
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION,
|
|
360
386
|
transports_version_send: [:rest]
|
|
361
387
|
|
|
388
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
362
389
|
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
363
390
|
|
|
364
391
|
options.apply_defaults timeout: @config.rpcs.delete_instance.timeout,
|
|
@@ -372,7 +399,7 @@ module Google
|
|
|
372
399
|
@provisioning_stub.delete_instance request, options do |result, operation|
|
|
373
400
|
result = ::Gapic::Operation.new result, @operations_client, options: options
|
|
374
401
|
yield result, operation if block_given?
|
|
375
|
-
|
|
402
|
+
throw :response, result
|
|
376
403
|
end
|
|
377
404
|
rescue ::Gapic::Rest::Error => e
|
|
378
405
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -433,12 +460,13 @@ module Google
|
|
|
433
460
|
# Customize the options with defaults
|
|
434
461
|
call_metadata = @config.rpcs.get_instance.metadata.to_h
|
|
435
462
|
|
|
436
|
-
# Set x-goog-api-client
|
|
463
|
+
# Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
|
|
437
464
|
call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
|
438
465
|
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
|
439
466
|
gapic_version: ::Google::Cloud::ApigeeRegistry::V1::VERSION,
|
|
440
467
|
transports_version_send: [:rest]
|
|
441
468
|
|
|
469
|
+
call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
|
|
442
470
|
call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
|
443
471
|
|
|
444
472
|
options.apply_defaults timeout: @config.rpcs.get_instance.timeout,
|
|
@@ -451,7 +479,6 @@ module Google
|
|
|
451
479
|
|
|
452
480
|
@provisioning_stub.get_instance request, options do |result, operation|
|
|
453
481
|
yield result, operation if block_given?
|
|
454
|
-
return result
|
|
455
482
|
end
|
|
456
483
|
rescue ::Gapic::Rest::Error => e
|
|
457
484
|
raise ::Google::Cloud::Error.from_error(e)
|
|
@@ -531,6 +558,11 @@ module Google
|
|
|
531
558
|
# default endpoint URL. The default value of nil uses the environment
|
|
532
559
|
# universe (usually the default "googleapis.com" universe).
|
|
533
560
|
# @return [::String,nil]
|
|
561
|
+
# @!attribute [rw] logger
|
|
562
|
+
# A custom logger to use for request/response debug logging, or the value
|
|
563
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
|
564
|
+
# explicitly disable logging.
|
|
565
|
+
# @return [::Logger,:default,nil]
|
|
534
566
|
#
|
|
535
567
|
class Configuration
|
|
536
568
|
extend ::Gapic::Config
|
|
@@ -559,6 +591,7 @@ module Google
|
|
|
559
591
|
# by the host service.
|
|
560
592
|
# @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
|
|
561
593
|
config_attr :bindings_override, {}, ::Hash, nil
|
|
594
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
|
562
595
|
|
|
563
596
|
# @private
|
|
564
597
|
def initialize parent_config = nil
|