google-cloud-dataplex-v1 0.17.0 → 0.18.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 (28) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +72 -99
  3. data/lib/google/cloud/dataplex/v1/content_service/client.rb +33 -8
  4. data/lib/google/cloud/dataplex/v1/content_service/rest/client.rb +35 -7
  5. data/lib/google/cloud/dataplex/v1/content_service/rest/service_stub.rb +14 -2
  6. data/lib/google/cloud/dataplex/v1/data_scan_service/client.rb +34 -8
  7. data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb +28 -6
  8. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb +36 -7
  9. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb +33 -8
  10. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/service_stub.rb +14 -2
  11. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/client.rb +34 -8
  12. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/operations.rb +28 -6
  13. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/client.rb +36 -7
  14. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/operations.rb +33 -8
  15. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/service_stub.rb +14 -2
  16. data/lib/google/cloud/dataplex/v1/dataplex_service/client.rb +34 -8
  17. data/lib/google/cloud/dataplex/v1/dataplex_service/operations.rb +28 -6
  18. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/client.rb +36 -7
  19. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/operations.rb +33 -8
  20. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/service_stub.rb +14 -2
  21. data/lib/google/cloud/dataplex/v1/metadata_service/client.rb +33 -8
  22. data/lib/google/cloud/dataplex/v1/metadata_service/rest/client.rb +35 -7
  23. data/lib/google/cloud/dataplex/v1/metadata_service/rest/service_stub.rb +14 -2
  24. data/lib/google/cloud/dataplex/v1/version.rb +1 -1
  25. data/proto_docs/google/api/client.rb +1 -0
  26. data/proto_docs/google/cloud/dataplex/v1/data_quality.rb +6 -1
  27. data/proto_docs/google/cloud/dataplex/v1/metadata.rb +2 -0
  28. metadata +8 -8
data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb CHANGED
@@ -26,6 +26,9 @@ module Google
26
26
  module DataScanService
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -90,8 +102,10 @@ module Google
90
102
 
91
103
  @operations_stub = ::Gapic::ServiceStub.new(
92
104
  ::Google::Longrunning::Operations::Stub,
93
- credentials: credentials,
94
- endpoint: @config.endpoint,
105
+ credentials: credentials,
106
+ endpoint: @config.endpoint,
107
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
108
+ universe_domain: @config.universe_domain,
95
109
  channel_args: @config.channel_args,
96
110
  interceptors: @config.interceptors,
97
111
  channel_pool_config: @config.channel_pool
@@ -613,9 +627,9 @@ module Google
613
627
  # end
614
628
  #
615
629
  # @!attribute [rw] endpoint
616
- # The hostname or hostname:port of the service endpoint.
617
- # Defaults to `"dataplex.googleapis.com"`.
618
- # @return [::String]
630
+ # A custom service endpoint, as a hostname or hostname:port. The default is
631
+ # nil, indicating to use the default endpoint in the current universe domain.
632
+ # @return [::String,nil]
619
633
  # @!attribute [rw] credentials
620
634
  # Credentials to send with calls. You may provide any of the following types:
621
635
  # * (`String`) The path to a service account key file in JSON format
@@ -661,13 +675,20 @@ module Google
661
675
  # @!attribute [rw] quota_project
662
676
  # A separate project against which to charge quota.
663
677
  # @return [::String]
678
+ # @!attribute [rw] universe_domain
679
+ # The universe domain within which to make requests. This determines the
680
+ # default endpoint URL. The default value of nil uses the environment
681
+ # universe (usually the default "googleapis.com" universe).
682
+ # @return [::String,nil]
664
683
  #
665
684
  class Configuration
666
685
  extend ::Gapic::Config
667
686
 
687
+ # @private
688
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
668
689
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
669
690
 
670
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
691
+ config_attr :endpoint, nil, ::String, nil
671
692
  config_attr :credentials, nil do |value|
672
693
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
673
694
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -682,6 +703,7 @@ module Google
682
703
  config_attr :metadata, nil, ::Hash, nil
683
704
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
684
705
  config_attr :quota_project, nil, ::String, nil
706
+ config_attr :universe_domain, nil, ::String, nil
685
707
 
686
708
  # @private
687
709
  def initialize parent_config = nil
data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb CHANGED
@@ -36,6 +36,9 @@ module Google
36
36
  # Data Profile, Data Quality) for the data source.
37
37
  #
38
38
  class Client
39
+ # @private
40
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
41
+
39
42
  include Paths
40
43
 
41
44
  # @private
@@ -96,6 +99,15 @@ module Google
96
99
  @config
97
100
  end
98
101
 
102
+ ##
103
+ # The effective universe domain
104
+ #
105
+ # @return [String]
106
+ #
107
+ def universe_domain
108
+ @data_scan_service_stub.universe_domain
109
+ end
110
+
99
111
  ##
100
112
  # Create a new DataScanService REST client object.
101
113
  #
@@ -123,8 +135,9 @@ module Google
123
135
  credentials = @config.credentials
124
136
  # Use self-signed JWT if the endpoint is unchanged from default,
125
137
  # but only if the default endpoint does not have a region prefix.
126
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
127
- !@config.endpoint.split(".").first.include?("-")
138
+ enable_self_signed_jwt = @config.endpoint.nil? ||
139
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
140
+ !@config.endpoint.split(".").first.include?("-"))
128
141
  credentials ||= Credentials.default scope: @config.scope,
129
142
  enable_self_signed_jwt: enable_self_signed_jwt
130
143
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -138,12 +151,14 @@ module Google
138
151
  config.credentials = credentials
139
152
  config.quota_project = @quota_project_id
140
153
  config.endpoint = @config.endpoint
154
+ config.universe_domain = @config.universe_domain
141
155
  end
142
156
 
143
157
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
144
158
  config.credentials = credentials
145
159
  config.quota_project = @quota_project_id
146
160
  config.endpoint = @config.endpoint
161
+ config.universe_domain = @config.universe_domain
147
162
  config.bindings_override = @config.bindings_override
148
163
  end
149
164
 
@@ -151,10 +166,16 @@ module Google
151
166
  config.credentials = credentials
152
167
  config.quota_project = @quota_project_id
153
168
  config.endpoint = @config.endpoint
169
+ config.universe_domain = @config.universe_domain
154
170
  config.bindings_override = @config.bindings_override
155
171
  end
156
172
 
157
- @data_scan_service_stub = ::Google::Cloud::Dataplex::V1::DataScanService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
173
+ @data_scan_service_stub = ::Google::Cloud::Dataplex::V1::DataScanService::Rest::ServiceStub.new(
174
+ endpoint: @config.endpoint,
175
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
176
+ universe_domain: @config.universe_domain,
177
+ credentials: credentials
178
+ )
158
179
  end
159
180
 
160
181
  ##
@@ -956,9 +977,9 @@ module Google
956
977
  # end
957
978
  #
958
979
  # @!attribute [rw] endpoint
959
- # The hostname or hostname:port of the service endpoint.
960
- # Defaults to `"dataplex.googleapis.com"`.
961
- # @return [::String]
980
+ # A custom service endpoint, as a hostname or hostname:port. The default is
981
+ # nil, indicating to use the default endpoint in the current universe domain.
982
+ # @return [::String,nil]
962
983
  # @!attribute [rw] credentials
963
984
  # Credentials to send with calls. You may provide any of the following types:
964
985
  # * (`String`) The path to a service account key file in JSON format
@@ -995,13 +1016,20 @@ module Google
995
1016
  # @!attribute [rw] quota_project
996
1017
  # A separate project against which to charge quota.
997
1018
  # @return [::String]
1019
+ # @!attribute [rw] universe_domain
1020
+ # The universe domain within which to make requests. This determines the
1021
+ # default endpoint URL. The default value of nil uses the environment
1022
+ # universe (usually the default "googleapis.com" universe).
1023
+ # @return [::String,nil]
998
1024
  #
999
1025
  class Configuration
1000
1026
  extend ::Gapic::Config
1001
1027
 
1028
+ # @private
1029
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1002
1030
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
1003
1031
 
1004
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1032
+ config_attr :endpoint, nil, ::String, nil
1005
1033
  config_attr :credentials, nil do |value|
1006
1034
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1007
1035
  allowed.any? { |klass| klass === value }
@@ -1013,6 +1041,7 @@ module Google
1013
1041
  config_attr :metadata, nil, ::Hash, nil
1014
1042
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1015
1043
  config_attr :quota_project, nil, ::String, nil
1044
+ config_attr :universe_domain, nil, ::String, nil
1016
1045
 
1017
1046
  # @private
1018
1047
  # Overrides for http bindings for the RPCs of this service
data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb CHANGED
@@ -26,6 +26,9 @@ module Google
26
26
  module Rest
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -84,8 +96,10 @@ module Google
84
96
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
85
97
 
86
98
  @operations_stub = OperationsServiceStub.new(
87
- endpoint: @config.endpoint,
88
- credentials: credentials
99
+ endpoint: @config.endpoint,
100
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
101
+ universe_domain: @config.universe_domain,
102
+ credentials: credentials
89
103
  )
90
104
 
91
105
  # Used by an LRO wrapper for some methods of this service
@@ -478,9 +492,9 @@ module Google
478
492
  # end
479
493
  #
480
494
  # @!attribute [rw] endpoint
481
- # The hostname or hostname:port of the service endpoint.
482
- # Defaults to `"dataplex.googleapis.com"`.
483
- # @return [::String]
495
+ # A custom service endpoint, as a hostname or hostname:port. The default is
496
+ # nil, indicating to use the default endpoint in the current universe domain.
497
+ # @return [::String,nil]
484
498
  # @!attribute [rw] credentials
485
499
  # Credentials to send with calls. You may provide any of the following types:
486
500
  # * (`String`) The path to a service account key file in JSON format
@@ -517,13 +531,20 @@ module Google
517
531
  # @!attribute [rw] quota_project
518
532
  # A separate project against which to charge quota.
519
533
  # @return [::String]
534
+ # @!attribute [rw] universe_domain
535
+ # The universe domain within which to make requests. This determines the
536
+ # default endpoint URL. The default value of nil uses the environment
537
+ # universe (usually the default "googleapis.com" universe).
538
+ # @return [::String,nil]
520
539
  #
521
540
  class Configuration
522
541
  extend ::Gapic::Config
523
542
 
543
+ # @private
544
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
524
545
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
525
546
 
526
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
547
+ config_attr :endpoint, nil, ::String, nil
527
548
  config_attr :credentials, nil do |value|
528
549
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
529
550
  allowed.any? { |klass| klass === value }
@@ -535,6 +556,7 @@ module Google
535
556
  config_attr :metadata, nil, ::Hash, nil
536
557
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
537
558
  config_attr :quota_project, nil, ::String, nil
559
+ config_attr :universe_domain, nil, ::String, nil
538
560
 
539
561
  # @private
540
562
  def initialize parent_config = nil
@@ -617,12 +639,15 @@ module Google
617
639
  # Service stub contains baseline method implementations
618
640
  # including transcoding, making the REST call, and deserialing the response.
619
641
  class OperationsServiceStub
620
- def initialize endpoint:, credentials:
642
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
621
643
  # These require statements are intentionally placed here to initialize
622
644
  # the REST modules only when it's required.
623
645
  require "gapic/rest"
624
646
 
625
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials
647
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
648
+ endpoint_template: endpoint_template,
649
+ universe_domain: universe_domain,
650
+ credentials: credentials
626
651
  end
627
652
 
628
653
  ##
data/lib/google/cloud/dataplex/v1/data_scan_service/rest/service_stub.rb CHANGED
@@ -30,16 +30,28 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, credentials:
33
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
34
  # These require statements are intentionally placed here to initialize
35
35
  # the REST modules only when it's required.
36
36
  require "gapic/rest"
37
37
 
38
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
39
+ endpoint_template: endpoint_template,
40
+ universe_domain: universe_domain,
41
+ credentials: credentials,
39
42
  numeric_enums: true,
40
43
  raise_faraday_errors: false
41
44
  end
42
45
 
46
+ ##
47
+ # The effective universe domain
48
+ #
49
+ # @return [String]
50
+ #
51
+ def universe_domain
52
+ @client_stub.universe_domain
53
+ end
54
+
43
55
  ##
44
56
  # Baseline implementation for the create_data_scan REST call
45
57
  #
data/lib/google/cloud/dataplex/v1/data_taxonomy_service/client.rb CHANGED
@@ -33,6 +33,9 @@ module Google
33
33
  # currently offered include DataTaxonomy and DataAttribute.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
38
+
36
39
  include Paths
37
40
 
38
41
  # @private
@@ -93,6 +96,15 @@ module Google
93
96
  @config
94
97
  end
95
98
 
99
+ ##
100
+ # The effective universe domain
101
+ #
102
+ # @return [String]
103
+ #
104
+ def universe_domain
105
+ @data_taxonomy_service_stub.universe_domain
106
+ end
107
+
96
108
  ##
97
109
  # Create a new DataTaxonomyService client object.
98
110
  #
@@ -126,8 +138,9 @@ module Google
126
138
  credentials = @config.credentials
127
139
  # Use self-signed JWT if the endpoint is unchanged from default,
128
140
  # but only if the default endpoint does not have a region prefix.
129
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
130
- !@config.endpoint.split(".").first.include?("-")
141
+ enable_self_signed_jwt = @config.endpoint.nil? ||
142
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
143
+ !@config.endpoint.split(".").first.include?("-"))
131
144
  credentials ||= Credentials.default scope: @config.scope,
132
145
  enable_self_signed_jwt: enable_self_signed_jwt
133
146
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -140,24 +153,29 @@ module Google
140
153
  config.credentials = credentials
141
154
  config.quota_project = @quota_project_id
142
155
  config.endpoint = @config.endpoint
156
+ config.universe_domain = @config.universe_domain
143
157
  end
144
158
 
145
159
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
146
160
  config.credentials = credentials
147
161
  config.quota_project = @quota_project_id
148
162
  config.endpoint = @config.endpoint
163
+ config.universe_domain = @config.universe_domain
149
164
  end
150
165
 
151
166
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
152
167
  config.credentials = credentials
153
168
  config.quota_project = @quota_project_id
154
169
  config.endpoint = @config.endpoint
170
+ config.universe_domain = @config.universe_domain
155
171
  end
156
172
 
157
173
  @data_taxonomy_service_stub = ::Gapic::ServiceStub.new(
158
174
  ::Google::Cloud::Dataplex::V1::DataTaxonomyService::Stub,
159
- credentials: credentials,
160
- endpoint: @config.endpoint,
175
+ credentials: credentials,
176
+ endpoint: @config.endpoint,
177
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
178
+ universe_domain: @config.universe_domain,
161
179
  channel_args: @config.channel_args,
162
180
  interceptors: @config.interceptors,
163
181
  channel_pool_config: @config.channel_pool
@@ -1704,9 +1722,9 @@ module Google
1704
1722
  # end
1705
1723
  #
1706
1724
  # @!attribute [rw] endpoint
1707
- # The hostname or hostname:port of the service endpoint.
1708
- # Defaults to `"dataplex.googleapis.com"`.
1709
- # @return [::String]
1725
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1726
+ # nil, indicating to use the default endpoint in the current universe domain.
1727
+ # @return [::String,nil]
1710
1728
  # @!attribute [rw] credentials
1711
1729
  # Credentials to send with calls. You may provide any of the following types:
1712
1730
  # * (`String`) The path to a service account key file in JSON format
@@ -1752,13 +1770,20 @@ module Google
1752
1770
  # @!attribute [rw] quota_project
1753
1771
  # A separate project against which to charge quota.
1754
1772
  # @return [::String]
1773
+ # @!attribute [rw] universe_domain
1774
+ # The universe domain within which to make requests. This determines the
1775
+ # default endpoint URL. The default value of nil uses the environment
1776
+ # universe (usually the default "googleapis.com" universe).
1777
+ # @return [::String,nil]
1755
1778
  #
1756
1779
  class Configuration
1757
1780
  extend ::Gapic::Config
1758
1781
 
1782
+ # @private
1783
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1759
1784
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
1760
1785
 
1761
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1786
+ config_attr :endpoint, nil, ::String, nil
1762
1787
  config_attr :credentials, nil do |value|
1763
1788
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1764
1789
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1773,6 +1798,7 @@ module Google
1773
1798
  config_attr :metadata, nil, ::Hash, nil
1774
1799
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1775
1800
  config_attr :quota_project, nil, ::String, nil
1801
+ config_attr :universe_domain, nil, ::String, nil
1776
1802
 
1777
1803
  # @private
1778
1804
  def initialize parent_config = nil
data/lib/google/cloud/dataplex/v1/data_taxonomy_service/operations.rb CHANGED
@@ -26,6 +26,9 @@ module Google
26
26
  module DataTaxonomyService
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -90,8 +102,10 @@ module Google
90
102
 
91
103
  @operations_stub = ::Gapic::ServiceStub.new(
92
104
  ::Google::Longrunning::Operations::Stub,
93
- credentials: credentials,
94
- endpoint: @config.endpoint,
105
+ credentials: credentials,
106
+ endpoint: @config.endpoint,
107
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
108
+ universe_domain: @config.universe_domain,
95
109
  channel_args: @config.channel_args,
96
110
  interceptors: @config.interceptors,
97
111
  channel_pool_config: @config.channel_pool
@@ -613,9 +627,9 @@ module Google
613
627
  # end
614
628
  #
615
629
  # @!attribute [rw] endpoint
616
- # The hostname or hostname:port of the service endpoint.
617
- # Defaults to `"dataplex.googleapis.com"`.
618
- # @return [::String]
630
+ # A custom service endpoint, as a hostname or hostname:port. The default is
631
+ # nil, indicating to use the default endpoint in the current universe domain.
632
+ # @return [::String,nil]
619
633
  # @!attribute [rw] credentials
620
634
  # Credentials to send with calls. You may provide any of the following types:
621
635
  # * (`String`) The path to a service account key file in JSON format
@@ -661,13 +675,20 @@ module Google
661
675
  # @!attribute [rw] quota_project
662
676
  # A separate project against which to charge quota.
663
677
  # @return [::String]
678
+ # @!attribute [rw] universe_domain
679
+ # The universe domain within which to make requests. This determines the
680
+ # default endpoint URL. The default value of nil uses the environment
681
+ # universe (usually the default "googleapis.com" universe).
682
+ # @return [::String,nil]
664
683
  #
665
684
  class Configuration
666
685
  extend ::Gapic::Config
667
686
 
687
+ # @private
688
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
668
689
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
669
690
 
670
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
691
+ config_attr :endpoint, nil, ::String, nil
671
692
  config_attr :credentials, nil do |value|
672
693
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
673
694
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -682,6 +703,7 @@ module Google
682
703
  config_attr :metadata, nil, ::Hash, nil
683
704
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
684
705
  config_attr :quota_project, nil, ::String, nil
706
+ config_attr :universe_domain, nil, ::String, nil
685
707
 
686
708
  # @private
687
709
  def initialize parent_config = nil
data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/client.rb CHANGED
@@ -35,6 +35,9 @@ module Google
35
35
  # currently offered include DataTaxonomy and DataAttribute.
36
36
  #
37
37
  class Client
38
+ # @private
39
+ DEFAULT_ENDPOINT_TEMPLATE = "dataplex.$UNIVERSE_DOMAIN$"
40
+
38
41
  include Paths
39
42
 
40
43
  # @private
@@ -95,6 +98,15 @@ module Google
95
98
  @config
96
99
  end
97
100
 
101
+ ##
102
+ # The effective universe domain
103
+ #
104
+ # @return [String]
105
+ #
106
+ def universe_domain
107
+ @data_taxonomy_service_stub.universe_domain
108
+ end
109
+
98
110
  ##
99
111
  # Create a new DataTaxonomyService REST client object.
100
112
  #
@@ -122,8 +134,9 @@ module Google
122
134
  credentials = @config.credentials
123
135
  # Use self-signed JWT if the endpoint is unchanged from default,
124
136
  # but only if the default endpoint does not have a region prefix.
125
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
126
- !@config.endpoint.split(".").first.include?("-")
137
+ enable_self_signed_jwt = @config.endpoint.nil? ||
138
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
139
+ !@config.endpoint.split(".").first.include?("-"))
127
140
  credentials ||= Credentials.default scope: @config.scope,
128
141
  enable_self_signed_jwt: enable_self_signed_jwt
129
142
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -137,12 +150,14 @@ module Google
137
150
  config.credentials = credentials
138
151
  config.quota_project = @quota_project_id
139
152
  config.endpoint = @config.endpoint
153
+ config.universe_domain = @config.universe_domain
140
154
  end
141
155
 
142
156
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
143
157
  config.credentials = credentials
144
158
  config.quota_project = @quota_project_id
145
159
  config.endpoint = @config.endpoint
160
+ config.universe_domain = @config.universe_domain
146
161
  config.bindings_override = @config.bindings_override
147
162
  end
148
163
 
@@ -150,10 +165,16 @@ module Google
150
165
  config.credentials = credentials
151
166
  config.quota_project = @quota_project_id
152
167
  config.endpoint = @config.endpoint
168
+ config.universe_domain = @config.universe_domain
153
169
  config.bindings_override = @config.bindings_override
154
170
  end
155
171
 
156
- @data_taxonomy_service_stub = ::Google::Cloud::Dataplex::V1::DataTaxonomyService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
172
+ @data_taxonomy_service_stub = ::Google::Cloud::Dataplex::V1::DataTaxonomyService::Rest::ServiceStub.new(
173
+ endpoint: @config.endpoint,
174
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
175
+ universe_domain: @config.universe_domain,
176
+ credentials: credentials
177
+ )
157
178
  end
158
179
 
159
180
  ##
@@ -1588,9 +1609,9 @@ module Google
1588
1609
  # end
1589
1610
  #
1590
1611
  # @!attribute [rw] endpoint
1591
- # The hostname or hostname:port of the service endpoint.
1592
- # Defaults to `"dataplex.googleapis.com"`.
1593
- # @return [::String]
1612
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1613
+ # nil, indicating to use the default endpoint in the current universe domain.
1614
+ # @return [::String,nil]
1594
1615
  # @!attribute [rw] credentials
1595
1616
  # Credentials to send with calls. You may provide any of the following types:
1596
1617
  # * (`String`) The path to a service account key file in JSON format
@@ -1627,13 +1648,20 @@ module Google
1627
1648
  # @!attribute [rw] quota_project
1628
1649
  # A separate project against which to charge quota.
1629
1650
  # @return [::String]
1651
+ # @!attribute [rw] universe_domain
1652
+ # The universe domain within which to make requests. This determines the
1653
+ # default endpoint URL. The default value of nil uses the environment
1654
+ # universe (usually the default "googleapis.com" universe).
1655
+ # @return [::String,nil]
1630
1656
  #
1631
1657
  class Configuration
1632
1658
  extend ::Gapic::Config
1633
1659
 
1660
+ # @private
1661
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1634
1662
  DEFAULT_ENDPOINT = "dataplex.googleapis.com"
1635
1663
 
1636
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1664
+ config_attr :endpoint, nil, ::String, nil
1637
1665
  config_attr :credentials, nil do |value|
1638
1666
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1639
1667
  allowed.any? { |klass| klass === value }
@@ -1645,6 +1673,7 @@ module Google
1645
1673
  config_attr :metadata, nil, ::Hash, nil
1646
1674
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1647
1675
  config_attr :quota_project, nil, ::String, nil
1676
+ config_attr :universe_domain, nil, ::String, nil
1648
1677
 
1649
1678
  # @private
1650
1679
  # Overrides for http bindings for the RPCs of this service