google-cloud-os_config-v1 0.13.0 → 0.15.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.
@@ -35,6 +35,9 @@ module Google
35
35
  # manage package installations and patch jobs for virtual machine instances.
36
36
  #
37
37
  class Client
38
+ # @private
39
+ DEFAULT_ENDPOINT_TEMPLATE = "osconfig.$UNIVERSE_DOMAIN$"
40
+
38
41
  include Paths
39
42
 
40
43
  # @private
@@ -100,6 +103,15 @@ module Google
100
103
  @config
101
104
  end
102
105
 
106
+ ##
107
+ # The effective universe domain
108
+ #
109
+ # @return [String]
110
+ #
111
+ def universe_domain
112
+ @os_config_service_stub.universe_domain
113
+ end
114
+
103
115
  ##
104
116
  # Create a new OsConfigService REST client object.
105
117
  #
@@ -127,8 +139,9 @@ module Google
127
139
  credentials = @config.credentials
128
140
  # Use self-signed JWT if the endpoint is unchanged from default,
129
141
  # but only if the default endpoint does not have a region prefix.
130
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
131
- !@config.endpoint.split(".").first.include?("-")
142
+ enable_self_signed_jwt = @config.endpoint.nil? ||
143
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
144
+ !@config.endpoint.split(".").first.include?("-"))
132
145
  credentials ||= Credentials.default scope: @config.scope,
133
146
  enable_self_signed_jwt: enable_self_signed_jwt
134
147
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -138,7 +151,12 @@ module Google
138
151
  @quota_project_id = @config.quota_project
139
152
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
140
153
 
141
- @os_config_service_stub = ::Google::Cloud::OsConfig::V1::OsConfigService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
154
+ @os_config_service_stub = ::Google::Cloud::OsConfig::V1::OsConfigService::Rest::ServiceStub.new(
155
+ endpoint: @config.endpoint,
156
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
157
+ universe_domain: @config.universe_domain,
158
+ credentials: credentials
159
+ )
142
160
  end
143
161
 
144
162
  # Service calls
@@ -189,6 +207,22 @@ module Google
189
207
  # @return [::Google::Cloud::OsConfig::V1::PatchJob]
190
208
  #
191
209
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
210
+ #
211
+ # @example Basic example
212
+ # require "google/cloud/os_config/v1"
213
+ #
214
+ # # Create a client object. The client can be reused for multiple calls.
215
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
216
+ #
217
+ # # Create a request. To set request fields, pass in keyword arguments.
218
+ # request = Google::Cloud::OsConfig::V1::ExecutePatchJobRequest.new
219
+ #
220
+ # # Call the execute_patch_job method.
221
+ # result = client.execute_patch_job request
222
+ #
223
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchJob.
224
+ # p result
225
+ #
192
226
  def execute_patch_job request, options = nil
193
227
  raise ::ArgumentError, "request must be provided" if request.nil?
194
228
 
@@ -252,6 +286,22 @@ module Google
252
286
  # @return [::Google::Cloud::OsConfig::V1::PatchJob]
253
287
  #
254
288
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
289
+ #
290
+ # @example Basic example
291
+ # require "google/cloud/os_config/v1"
292
+ #
293
+ # # Create a client object. The client can be reused for multiple calls.
294
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
295
+ #
296
+ # # Create a request. To set request fields, pass in keyword arguments.
297
+ # request = Google::Cloud::OsConfig::V1::GetPatchJobRequest.new
298
+ #
299
+ # # Call the get_patch_job method.
300
+ # result = client.get_patch_job request
301
+ #
302
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchJob.
303
+ # p result
304
+ #
255
305
  def get_patch_job request, options = nil
256
306
  raise ::ArgumentError, "request must be provided" if request.nil?
257
307
 
@@ -315,6 +365,22 @@ module Google
315
365
  # @return [::Google::Cloud::OsConfig::V1::PatchJob]
316
366
  #
317
367
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
368
+ #
369
+ # @example Basic example
370
+ # require "google/cloud/os_config/v1"
371
+ #
372
+ # # Create a client object. The client can be reused for multiple calls.
373
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
374
+ #
375
+ # # Create a request. To set request fields, pass in keyword arguments.
376
+ # request = Google::Cloud::OsConfig::V1::CancelPatchJobRequest.new
377
+ #
378
+ # # Call the cancel_patch_job method.
379
+ # result = client.cancel_patch_job request
380
+ #
381
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchJob.
382
+ # p result
383
+ #
318
384
  def cancel_patch_job request, options = nil
319
385
  raise ::ArgumentError, "request must be provided" if request.nil?
320
386
 
@@ -386,6 +452,26 @@ module Google
386
452
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1::PatchJob>]
387
453
  #
388
454
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
455
+ #
456
+ # @example Basic example
457
+ # require "google/cloud/os_config/v1"
458
+ #
459
+ # # Create a client object. The client can be reused for multiple calls.
460
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
461
+ #
462
+ # # Create a request. To set request fields, pass in keyword arguments.
463
+ # request = Google::Cloud::OsConfig::V1::ListPatchJobsRequest.new
464
+ #
465
+ # # Call the list_patch_jobs method.
466
+ # result = client.list_patch_jobs request
467
+ #
468
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
469
+ # # over elements, and API calls will be issued to fetch pages as needed.
470
+ # result.each do |item|
471
+ # # Each element is of type ::Google::Cloud::OsConfig::V1::PatchJob.
472
+ # p item
473
+ # end
474
+ #
389
475
  def list_patch_jobs request, options = nil
390
476
  raise ::ArgumentError, "request must be provided" if request.nil?
391
477
 
@@ -459,6 +545,26 @@ module Google
459
545
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1::PatchJobInstanceDetails>]
460
546
  #
461
547
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
548
+ #
549
+ # @example Basic example
550
+ # require "google/cloud/os_config/v1"
551
+ #
552
+ # # Create a client object. The client can be reused for multiple calls.
553
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
554
+ #
555
+ # # Create a request. To set request fields, pass in keyword arguments.
556
+ # request = Google::Cloud::OsConfig::V1::ListPatchJobInstanceDetailsRequest.new
557
+ #
558
+ # # Call the list_patch_job_instance_details method.
559
+ # result = client.list_patch_job_instance_details request
560
+ #
561
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
562
+ # # over elements, and API calls will be issued to fetch pages as needed.
563
+ # result.each do |item|
564
+ # # Each element is of type ::Google::Cloud::OsConfig::V1::PatchJobInstanceDetails.
565
+ # p item
566
+ # end
567
+ #
462
568
  def list_patch_job_instance_details request, options = nil
463
569
  raise ::ArgumentError, "request must be provided" if request.nil?
464
570
 
@@ -533,6 +639,22 @@ module Google
533
639
  # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
534
640
  #
535
641
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
642
+ #
643
+ # @example Basic example
644
+ # require "google/cloud/os_config/v1"
645
+ #
646
+ # # Create a client object. The client can be reused for multiple calls.
647
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
648
+ #
649
+ # # Create a request. To set request fields, pass in keyword arguments.
650
+ # request = Google::Cloud::OsConfig::V1::CreatePatchDeploymentRequest.new
651
+ #
652
+ # # Call the create_patch_deployment method.
653
+ # result = client.create_patch_deployment request
654
+ #
655
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
656
+ # p result
657
+ #
536
658
  def create_patch_deployment request, options = nil
537
659
  raise ::ArgumentError, "request must be provided" if request.nil?
538
660
 
@@ -596,6 +718,22 @@ module Google
596
718
  # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
597
719
  #
598
720
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
721
+ #
722
+ # @example Basic example
723
+ # require "google/cloud/os_config/v1"
724
+ #
725
+ # # Create a client object. The client can be reused for multiple calls.
726
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
727
+ #
728
+ # # Create a request. To set request fields, pass in keyword arguments.
729
+ # request = Google::Cloud::OsConfig::V1::GetPatchDeploymentRequest.new
730
+ #
731
+ # # Call the get_patch_deployment method.
732
+ # result = client.get_patch_deployment request
733
+ #
734
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
735
+ # p result
736
+ #
599
737
  def get_patch_deployment request, options = nil
600
738
  raise ::ArgumentError, "request must be provided" if request.nil?
601
739
 
@@ -665,6 +803,26 @@ module Google
665
803
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1::PatchDeployment>]
666
804
  #
667
805
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
806
+ #
807
+ # @example Basic example
808
+ # require "google/cloud/os_config/v1"
809
+ #
810
+ # # Create a client object. The client can be reused for multiple calls.
811
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
812
+ #
813
+ # # Create a request. To set request fields, pass in keyword arguments.
814
+ # request = Google::Cloud::OsConfig::V1::ListPatchDeploymentsRequest.new
815
+ #
816
+ # # Call the list_patch_deployments method.
817
+ # result = client.list_patch_deployments request
818
+ #
819
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
820
+ # # over elements, and API calls will be issued to fetch pages as needed.
821
+ # result.each do |item|
822
+ # # Each element is of type ::Google::Cloud::OsConfig::V1::PatchDeployment.
823
+ # p item
824
+ # end
825
+ #
668
826
  def list_patch_deployments request, options = nil
669
827
  raise ::ArgumentError, "request must be provided" if request.nil?
670
828
 
@@ -729,6 +887,22 @@ module Google
729
887
  # @return [::Google::Protobuf::Empty]
730
888
  #
731
889
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
890
+ #
891
+ # @example Basic example
892
+ # require "google/cloud/os_config/v1"
893
+ #
894
+ # # Create a client object. The client can be reused for multiple calls.
895
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
896
+ #
897
+ # # Create a request. To set request fields, pass in keyword arguments.
898
+ # request = Google::Cloud::OsConfig::V1::DeletePatchDeploymentRequest.new
899
+ #
900
+ # # Call the delete_patch_deployment method.
901
+ # result = client.delete_patch_deployment request
902
+ #
903
+ # # The returned object is of type Google::Protobuf::Empty.
904
+ # p result
905
+ #
732
906
  def delete_patch_deployment request, options = nil
733
907
  raise ::ArgumentError, "request must be provided" if request.nil?
734
908
 
@@ -794,6 +968,22 @@ module Google
794
968
  # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
795
969
  #
796
970
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
971
+ #
972
+ # @example Basic example
973
+ # require "google/cloud/os_config/v1"
974
+ #
975
+ # # Create a client object. The client can be reused for multiple calls.
976
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
977
+ #
978
+ # # Create a request. To set request fields, pass in keyword arguments.
979
+ # request = Google::Cloud::OsConfig::V1::UpdatePatchDeploymentRequest.new
980
+ #
981
+ # # Call the update_patch_deployment method.
982
+ # result = client.update_patch_deployment request
983
+ #
984
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
985
+ # p result
986
+ #
797
987
  def update_patch_deployment request, options = nil
798
988
  raise ::ArgumentError, "request must be provided" if request.nil?
799
989
 
@@ -858,6 +1048,22 @@ module Google
858
1048
  # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
859
1049
  #
860
1050
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1051
+ #
1052
+ # @example Basic example
1053
+ # require "google/cloud/os_config/v1"
1054
+ #
1055
+ # # Create a client object. The client can be reused for multiple calls.
1056
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
1057
+ #
1058
+ # # Create a request. To set request fields, pass in keyword arguments.
1059
+ # request = Google::Cloud::OsConfig::V1::PausePatchDeploymentRequest.new
1060
+ #
1061
+ # # Call the pause_patch_deployment method.
1062
+ # result = client.pause_patch_deployment request
1063
+ #
1064
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
1065
+ # p result
1066
+ #
861
1067
  def pause_patch_deployment request, options = nil
862
1068
  raise ::ArgumentError, "request must be provided" if request.nil?
863
1069
 
@@ -922,6 +1128,22 @@ module Google
922
1128
  # @return [::Google::Cloud::OsConfig::V1::PatchDeployment]
923
1129
  #
924
1130
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1131
+ #
1132
+ # @example Basic example
1133
+ # require "google/cloud/os_config/v1"
1134
+ #
1135
+ # # Create a client object. The client can be reused for multiple calls.
1136
+ # client = Google::Cloud::OsConfig::V1::OsConfigService::Rest::Client.new
1137
+ #
1138
+ # # Create a request. To set request fields, pass in keyword arguments.
1139
+ # request = Google::Cloud::OsConfig::V1::ResumePatchDeploymentRequest.new
1140
+ #
1141
+ # # Call the resume_patch_deployment method.
1142
+ # result = client.resume_patch_deployment request
1143
+ #
1144
+ # # The returned object is of type Google::Cloud::OsConfig::V1::PatchDeployment.
1145
+ # p result
1146
+ #
925
1147
  def resume_patch_deployment request, options = nil
926
1148
  raise ::ArgumentError, "request must be provided" if request.nil?
927
1149
 
@@ -987,9 +1209,9 @@ module Google
987
1209
  # end
988
1210
  #
989
1211
  # @!attribute [rw] endpoint
990
- # The hostname or hostname:port of the service endpoint.
991
- # Defaults to `"osconfig.googleapis.com"`.
992
- # @return [::String]
1212
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1213
+ # nil, indicating to use the default endpoint in the current universe domain.
1214
+ # @return [::String,nil]
993
1215
  # @!attribute [rw] credentials
994
1216
  # Credentials to send with calls. You may provide any of the following types:
995
1217
  # * (`String`) The path to a service account key file in JSON format
@@ -1026,13 +1248,20 @@ module Google
1026
1248
  # @!attribute [rw] quota_project
1027
1249
  # A separate project against which to charge quota.
1028
1250
  # @return [::String]
1251
+ # @!attribute [rw] universe_domain
1252
+ # The universe domain within which to make requests. This determines the
1253
+ # default endpoint URL. The default value of nil uses the environment
1254
+ # universe (usually the default "googleapis.com" universe).
1255
+ # @return [::String,nil]
1029
1256
  #
1030
1257
  class Configuration
1031
1258
  extend ::Gapic::Config
1032
1259
 
1260
+ # @private
1261
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1033
1262
  DEFAULT_ENDPOINT = "osconfig.googleapis.com"
1034
1263
 
1035
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1264
+ config_attr :endpoint, nil, ::String, nil
1036
1265
  config_attr :credentials, nil do |value|
1037
1266
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1038
1267
  allowed.any? { |klass| klass === value }
@@ -1044,6 +1273,7 @@ module Google
1044
1273
  config_attr :metadata, nil, ::Hash, nil
1045
1274
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1046
1275
  config_attr :quota_project, nil, ::String, nil
1276
+ config_attr :universe_domain, nil, ::String, nil
1047
1277
 
1048
1278
  # @private
1049
1279
  def initialize parent_config = nil
@@ -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 execute_patch_job REST call
45
57
  #
@@ -33,6 +33,9 @@ module Google
33
33
  # manage package installations and patch jobs for Compute Engine VM instances.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ DEFAULT_ENDPOINT_TEMPLATE = "osconfig.$UNIVERSE_DOMAIN$"
38
+
36
39
  include Paths
37
40
 
38
41
  # @private
@@ -98,6 +101,15 @@ module Google
98
101
  @config
99
102
  end
100
103
 
104
+ ##
105
+ # The effective universe domain
106
+ #
107
+ # @return [String]
108
+ #
109
+ def universe_domain
110
+ @os_config_zonal_service_stub.universe_domain
111
+ end
112
+
101
113
  ##
102
114
  # Create a new OsConfigZonalService client object.
103
115
  #
@@ -131,8 +143,9 @@ module Google
131
143
  credentials = @config.credentials
132
144
  # Use self-signed JWT if the endpoint is unchanged from default,
133
145
  # but only if the default endpoint does not have a region prefix.
134
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
135
- !@config.endpoint.split(".").first.include?("-")
146
+ enable_self_signed_jwt = @config.endpoint.nil? ||
147
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
148
+ !@config.endpoint.split(".").first.include?("-"))
136
149
  credentials ||= Credentials.default scope: @config.scope,
137
150
  enable_self_signed_jwt: enable_self_signed_jwt
138
151
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -145,14 +158,18 @@ module Google
145
158
  config.credentials = credentials
146
159
  config.quota_project = @quota_project_id
147
160
  config.endpoint = @config.endpoint
161
+ config.universe_domain = @config.universe_domain
148
162
  end
149
163
 
150
164
  @os_config_zonal_service_stub = ::Gapic::ServiceStub.new(
151
165
  ::Google::Cloud::OsConfig::V1::OsConfigZonalService::Stub,
152
- credentials: credentials,
153
- endpoint: @config.endpoint,
166
+ credentials: credentials,
167
+ endpoint: @config.endpoint,
168
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
169
+ universe_domain: @config.universe_domain,
154
170
  channel_args: @config.channel_args,
155
- interceptors: @config.interceptors
171
+ interceptors: @config.interceptors,
172
+ channel_pool_config: @config.channel_pool
156
173
  )
157
174
  end
158
175
 
@@ -1414,9 +1431,9 @@ module Google
1414
1431
  # end
1415
1432
  #
1416
1433
  # @!attribute [rw] endpoint
1417
- # The hostname or hostname:port of the service endpoint.
1418
- # Defaults to `"osconfig.googleapis.com"`.
1419
- # @return [::String]
1434
+ # A custom service endpoint, as a hostname or hostname:port. The default is
1435
+ # nil, indicating to use the default endpoint in the current universe domain.
1436
+ # @return [::String,nil]
1420
1437
  # @!attribute [rw] credentials
1421
1438
  # Credentials to send with calls. You may provide any of the following types:
1422
1439
  # * (`String`) The path to a service account key file in JSON format
@@ -1462,13 +1479,20 @@ module Google
1462
1479
  # @!attribute [rw] quota_project
1463
1480
  # A separate project against which to charge quota.
1464
1481
  # @return [::String]
1482
+ # @!attribute [rw] universe_domain
1483
+ # The universe domain within which to make requests. This determines the
1484
+ # default endpoint URL. The default value of nil uses the environment
1485
+ # universe (usually the default "googleapis.com" universe).
1486
+ # @return [::String,nil]
1465
1487
  #
1466
1488
  class Configuration
1467
1489
  extend ::Gapic::Config
1468
1490
 
1491
+ # @private
1492
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1469
1493
  DEFAULT_ENDPOINT = "osconfig.googleapis.com"
1470
1494
 
1471
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1495
+ config_attr :endpoint, nil, ::String, nil
1472
1496
  config_attr :credentials, nil do |value|
1473
1497
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1474
1498
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1483,6 +1507,7 @@ module Google
1483
1507
  config_attr :metadata, nil, ::Hash, nil
1484
1508
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1485
1509
  config_attr :quota_project, nil, ::String, nil
1510
+ config_attr :universe_domain, nil, ::String, nil
1486
1511
 
1487
1512
  # @private
1488
1513
  def initialize parent_config = nil
@@ -1503,6 +1528,14 @@ module Google
1503
1528
  end
1504
1529
  end
1505
1530
 
1531
+ ##
1532
+ # Configuration for the channel pool
1533
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
1534
+ #
1535
+ def channel_pool
1536
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
1537
+ end
1538
+
1506
1539
  ##
1507
1540
  # Configuration RPC class for the OsConfigZonalService API.
1508
1541
  #
@@ -26,6 +26,9 @@ module Google
26
26
  module OsConfigZonalService
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "osconfig.$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,10 +102,13 @@ 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
- interceptors: @config.interceptors
110
+ interceptors: @config.interceptors,
111
+ channel_pool_config: @config.channel_pool
97
112
  )
98
113
 
99
114
  # Used by an LRO wrapper for some methods of this service
@@ -612,9 +627,9 @@ module Google
612
627
  # end
613
628
  #
614
629
  # @!attribute [rw] endpoint
615
- # The hostname or hostname:port of the service endpoint.
616
- # Defaults to `"osconfig.googleapis.com"`.
617
- # @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]
618
633
  # @!attribute [rw] credentials
619
634
  # Credentials to send with calls. You may provide any of the following types:
620
635
  # * (`String`) The path to a service account key file in JSON format
@@ -660,13 +675,20 @@ module Google
660
675
  # @!attribute [rw] quota_project
661
676
  # A separate project against which to charge quota.
662
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]
663
683
  #
664
684
  class Configuration
665
685
  extend ::Gapic::Config
666
686
 
687
+ # @private
688
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
667
689
  DEFAULT_ENDPOINT = "osconfig.googleapis.com"
668
690
 
669
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
691
+ config_attr :endpoint, nil, ::String, nil
670
692
  config_attr :credentials, nil do |value|
671
693
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
672
694
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -681,6 +703,7 @@ module Google
681
703
  config_attr :metadata, nil, ::Hash, nil
682
704
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
683
705
  config_attr :quota_project, nil, ::String, nil
706
+ config_attr :universe_domain, nil, ::String, nil
684
707
 
685
708
  # @private
686
709
  def initialize parent_config = nil
@@ -701,6 +724,14 @@ module Google
701
724
  end
702
725
  end
703
726
 
727
+ ##
728
+ # Configuration for the channel pool
729
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
730
+ #
731
+ def channel_pool
732
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
733
+ end
734
+
704
735
  ##
705
736
  # Configuration RPC class for the Operations API.
706
737
  #