google-cloud-security-private_ca-v1beta1 0.6.1 → 0.8.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.
@@ -34,6 +34,9 @@ module Google
34
34
  # certificate authorities and issued certificates.
35
35
  #
36
36
  class Client
37
+ # @private
38
+ DEFAULT_ENDPOINT_TEMPLATE = "privateca.$UNIVERSE_DOMAIN$"
39
+
37
40
  include Paths
38
41
 
39
42
  # @private
@@ -99,6 +102,15 @@ module Google
99
102
  @config
100
103
  end
101
104
 
105
+ ##
106
+ # The effective universe domain
107
+ #
108
+ # @return [String]
109
+ #
110
+ def universe_domain
111
+ @certificate_authority_service_stub.universe_domain
112
+ end
113
+
102
114
  ##
103
115
  # Create a new CertificateAuthorityService REST client object.
104
116
  #
@@ -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)
@@ -141,9 +154,15 @@ module Google
141
154
  config.credentials = credentials
142
155
  config.quota_project = @quota_project_id
143
156
  config.endpoint = @config.endpoint
157
+ config.universe_domain = @config.universe_domain
144
158
  end
145
159
 
146
- @certificate_authority_service_stub = ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
160
+ @certificate_authority_service_stub = ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::ServiceStub.new(
161
+ endpoint: @config.endpoint,
162
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
163
+ universe_domain: @config.universe_domain,
164
+ credentials: credentials
165
+ )
147
166
  end
148
167
 
149
168
  ##
@@ -206,6 +225,22 @@ module Google
206
225
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::Certificate]
207
226
  #
208
227
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
228
+ #
229
+ # @example Basic example
230
+ # require "google/cloud/security/private_ca/v1beta1"
231
+ #
232
+ # # Create a client object. The client can be reused for multiple calls.
233
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
234
+ #
235
+ # # Create a request. To set request fields, pass in keyword arguments.
236
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateRequest.new
237
+ #
238
+ # # Call the create_certificate method.
239
+ # result = client.create_certificate request
240
+ #
241
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
242
+ # p result
243
+ #
209
244
  def create_certificate request, options = nil
210
245
  raise ::ArgumentError, "request must be provided" if request.nil?
211
246
 
@@ -268,6 +303,22 @@ module Google
268
303
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::Certificate]
269
304
  #
270
305
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
306
+ #
307
+ # @example Basic example
308
+ # require "google/cloud/security/private_ca/v1beta1"
309
+ #
310
+ # # Create a client object. The client can be reused for multiple calls.
311
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
312
+ #
313
+ # # Create a request. To set request fields, pass in keyword arguments.
314
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRequest.new
315
+ #
316
+ # # Call the get_certificate method.
317
+ # result = client.get_certificate request
318
+ #
319
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
320
+ # p result
321
+ #
271
322
  def get_certificate request, options = nil
272
323
  raise ::ArgumentError, "request must be provided" if request.nil?
273
324
 
@@ -350,6 +401,26 @@ module Google
350
401
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::ListCertificatesResponse]
351
402
  #
352
403
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
404
+ #
405
+ # @example Basic example
406
+ # require "google/cloud/security/private_ca/v1beta1"
407
+ #
408
+ # # Create a client object. The client can be reused for multiple calls.
409
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
410
+ #
411
+ # # Create a request. To set request fields, pass in keyword arguments.
412
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ListCertificatesRequest.new
413
+ #
414
+ # # Call the list_certificates method.
415
+ # result = client.list_certificates request
416
+ #
417
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
418
+ # # over elements, and API calls will be issued to fetch pages as needed.
419
+ # result.each do |item|
420
+ # # Each element is of type ::Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
421
+ # p item
422
+ # end
423
+ #
353
424
  def list_certificates request, options = nil
354
425
  raise ::ArgumentError, "request must be provided" if request.nil?
355
426
 
@@ -429,6 +500,22 @@ module Google
429
500
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::Certificate]
430
501
  #
431
502
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
503
+ #
504
+ # @example Basic example
505
+ # require "google/cloud/security/private_ca/v1beta1"
506
+ #
507
+ # # Create a client object. The client can be reused for multiple calls.
508
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
509
+ #
510
+ # # Create a request. To set request fields, pass in keyword arguments.
511
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::RevokeCertificateRequest.new
512
+ #
513
+ # # Call the revoke_certificate method.
514
+ # result = client.revoke_certificate request
515
+ #
516
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
517
+ # p result
518
+ #
432
519
  def revoke_certificate request, options = nil
433
520
  raise ::ArgumentError, "request must be provided" if request.nil?
434
521
 
@@ -508,6 +595,22 @@ module Google
508
595
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::Certificate]
509
596
  #
510
597
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
598
+ #
599
+ # @example Basic example
600
+ # require "google/cloud/security/private_ca/v1beta1"
601
+ #
602
+ # # Create a client object. The client can be reused for multiple calls.
603
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
604
+ #
605
+ # # Create a request. To set request fields, pass in keyword arguments.
606
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRequest.new
607
+ #
608
+ # # Call the update_certificate method.
609
+ # result = client.update_certificate request
610
+ #
611
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::Certificate.
612
+ # p result
613
+ #
511
614
  def update_certificate request, options = nil
512
615
  raise ::ArgumentError, "request must be provided" if request.nil?
513
616
 
@@ -596,6 +699,29 @@ module Google
596
699
  # @return [::Gapic::Operation]
597
700
  #
598
701
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
702
+ #
703
+ # @example Basic example
704
+ # require "google/cloud/security/private_ca/v1beta1"
705
+ #
706
+ # # Create a client object. The client can be reused for multiple calls.
707
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
708
+ #
709
+ # # Create a request. To set request fields, pass in keyword arguments.
710
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ActivateCertificateAuthorityRequest.new
711
+ #
712
+ # # Call the activate_certificate_authority method.
713
+ # result = client.activate_certificate_authority request
714
+ #
715
+ # # The returned object is of type Gapic::Operation. You can use it to
716
+ # # check the status of an operation, cancel it, or wait for results.
717
+ # # Here is how to wait for a response.
718
+ # result.wait_until_done! timeout: 60
719
+ # if result.response?
720
+ # p result.response
721
+ # else
722
+ # puts "No response received."
723
+ # end
724
+ #
599
725
  def activate_certificate_authority request, options = nil
600
726
  raise ::ArgumentError, "request must be provided" if request.nil?
601
727
 
@@ -680,6 +806,29 @@ module Google
680
806
  # @return [::Gapic::Operation]
681
807
  #
682
808
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
809
+ #
810
+ # @example Basic example
811
+ # require "google/cloud/security/private_ca/v1beta1"
812
+ #
813
+ # # Create a client object. The client can be reused for multiple calls.
814
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
815
+ #
816
+ # # Create a request. To set request fields, pass in keyword arguments.
817
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::CreateCertificateAuthorityRequest.new
818
+ #
819
+ # # Call the create_certificate_authority method.
820
+ # result = client.create_certificate_authority request
821
+ #
822
+ # # The returned object is of type Gapic::Operation. You can use it to
823
+ # # check the status of an operation, cancel it, or wait for results.
824
+ # # Here is how to wait for a response.
825
+ # result.wait_until_done! timeout: 60
826
+ # if result.response?
827
+ # p result.response
828
+ # else
829
+ # puts "No response received."
830
+ # end
831
+ #
683
832
  def create_certificate_authority request, options = nil
684
833
  raise ::ArgumentError, "request must be provided" if request.nil?
685
834
 
@@ -758,6 +907,29 @@ module Google
758
907
  # @return [::Gapic::Operation]
759
908
  #
760
909
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
910
+ #
911
+ # @example Basic example
912
+ # require "google/cloud/security/private_ca/v1beta1"
913
+ #
914
+ # # Create a client object. The client can be reused for multiple calls.
915
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
916
+ #
917
+ # # Create a request. To set request fields, pass in keyword arguments.
918
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::DisableCertificateAuthorityRequest.new
919
+ #
920
+ # # Call the disable_certificate_authority method.
921
+ # result = client.disable_certificate_authority request
922
+ #
923
+ # # The returned object is of type Gapic::Operation. You can use it to
924
+ # # check the status of an operation, cancel it, or wait for results.
925
+ # # Here is how to wait for a response.
926
+ # result.wait_until_done! timeout: 60
927
+ # if result.response?
928
+ # p result.response
929
+ # else
930
+ # puts "No response received."
931
+ # end
932
+ #
761
933
  def disable_certificate_authority request, options = nil
762
934
  raise ::ArgumentError, "request must be provided" if request.nil?
763
935
 
@@ -836,6 +1008,29 @@ module Google
836
1008
  # @return [::Gapic::Operation]
837
1009
  #
838
1010
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1011
+ #
1012
+ # @example Basic example
1013
+ # require "google/cloud/security/private_ca/v1beta1"
1014
+ #
1015
+ # # Create a client object. The client can be reused for multiple calls.
1016
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1017
+ #
1018
+ # # Create a request. To set request fields, pass in keyword arguments.
1019
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::EnableCertificateAuthorityRequest.new
1020
+ #
1021
+ # # Call the enable_certificate_authority method.
1022
+ # result = client.enable_certificate_authority request
1023
+ #
1024
+ # # The returned object is of type Gapic::Operation. You can use it to
1025
+ # # check the status of an operation, cancel it, or wait for results.
1026
+ # # Here is how to wait for a response.
1027
+ # result.wait_until_done! timeout: 60
1028
+ # if result.response?
1029
+ # p result.response
1030
+ # else
1031
+ # puts "No response received."
1032
+ # end
1033
+ #
839
1034
  def enable_certificate_authority request, options = nil
840
1035
  raise ::ArgumentError, "request must be provided" if request.nil?
841
1036
 
@@ -906,6 +1101,22 @@ module Google
906
1101
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse]
907
1102
  #
908
1103
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1104
+ #
1105
+ # @example Basic example
1106
+ # require "google/cloud/security/private_ca/v1beta1"
1107
+ #
1108
+ # # Create a client object. The client can be reused for multiple calls.
1109
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1110
+ #
1111
+ # # Create a request. To set request fields, pass in keyword arguments.
1112
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrRequest.new
1113
+ #
1114
+ # # Call the fetch_certificate_authority_csr method.
1115
+ # result = client.fetch_certificate_authority_csr request
1116
+ #
1117
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::FetchCertificateAuthorityCsrResponse.
1118
+ # p result
1119
+ #
909
1120
  def fetch_certificate_authority_csr request, options = nil
910
1121
  raise ::ArgumentError, "request must be provided" if request.nil?
911
1122
 
@@ -969,6 +1180,22 @@ module Google
969
1180
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority]
970
1181
  #
971
1182
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1183
+ #
1184
+ # @example Basic example
1185
+ # require "google/cloud/security/private_ca/v1beta1"
1186
+ #
1187
+ # # Create a client object. The client can be reused for multiple calls.
1188
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1189
+ #
1190
+ # # Create a request. To set request fields, pass in keyword arguments.
1191
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateAuthorityRequest.new
1192
+ #
1193
+ # # Call the get_certificate_authority method.
1194
+ # result = client.get_certificate_authority request
1195
+ #
1196
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority.
1197
+ # p result
1198
+ #
972
1199
  def get_certificate_authority request, options = nil
973
1200
  raise ::ArgumentError, "request must be provided" if request.nil?
974
1201
 
@@ -1047,6 +1274,26 @@ module Google
1047
1274
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateAuthoritiesResponse]
1048
1275
  #
1049
1276
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1277
+ #
1278
+ # @example Basic example
1279
+ # require "google/cloud/security/private_ca/v1beta1"
1280
+ #
1281
+ # # Create a client object. The client can be reused for multiple calls.
1282
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1283
+ #
1284
+ # # Create a request. To set request fields, pass in keyword arguments.
1285
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateAuthoritiesRequest.new
1286
+ #
1287
+ # # Call the list_certificate_authorities method.
1288
+ # result = client.list_certificate_authorities request
1289
+ #
1290
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1291
+ # # over elements, and API calls will be issued to fetch pages as needed.
1292
+ # result.each do |item|
1293
+ # # Each element is of type ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthority.
1294
+ # p item
1295
+ # end
1296
+ #
1050
1297
  def list_certificate_authorities request, options = nil
1051
1298
  raise ::ArgumentError, "request must be provided" if request.nil?
1052
1299
 
@@ -1124,6 +1371,29 @@ module Google
1124
1371
  # @return [::Gapic::Operation]
1125
1372
  #
1126
1373
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1374
+ #
1375
+ # @example Basic example
1376
+ # require "google/cloud/security/private_ca/v1beta1"
1377
+ #
1378
+ # # Create a client object. The client can be reused for multiple calls.
1379
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1380
+ #
1381
+ # # Create a request. To set request fields, pass in keyword arguments.
1382
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::RestoreCertificateAuthorityRequest.new
1383
+ #
1384
+ # # Call the restore_certificate_authority method.
1385
+ # result = client.restore_certificate_authority request
1386
+ #
1387
+ # # The returned object is of type Gapic::Operation. You can use it to
1388
+ # # check the status of an operation, cancel it, or wait for results.
1389
+ # # Here is how to wait for a response.
1390
+ # result.wait_until_done! timeout: 60
1391
+ # if result.response?
1392
+ # p result.response
1393
+ # else
1394
+ # puts "No response received."
1395
+ # end
1396
+ #
1127
1397
  def restore_certificate_authority request, options = nil
1128
1398
  raise ::ArgumentError, "request must be provided" if request.nil?
1129
1399
 
@@ -1202,6 +1472,29 @@ module Google
1202
1472
  # @return [::Gapic::Operation]
1203
1473
  #
1204
1474
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1475
+ #
1476
+ # @example Basic example
1477
+ # require "google/cloud/security/private_ca/v1beta1"
1478
+ #
1479
+ # # Create a client object. The client can be reused for multiple calls.
1480
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1481
+ #
1482
+ # # Create a request. To set request fields, pass in keyword arguments.
1483
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ScheduleDeleteCertificateAuthorityRequest.new
1484
+ #
1485
+ # # Call the schedule_delete_certificate_authority method.
1486
+ # result = client.schedule_delete_certificate_authority request
1487
+ #
1488
+ # # The returned object is of type Gapic::Operation. You can use it to
1489
+ # # check the status of an operation, cancel it, or wait for results.
1490
+ # # Here is how to wait for a response.
1491
+ # result.wait_until_done! timeout: 60
1492
+ # if result.response?
1493
+ # p result.response
1494
+ # else
1495
+ # puts "No response received."
1496
+ # end
1497
+ #
1205
1498
  def schedule_delete_certificate_authority request, options = nil
1206
1499
  raise ::ArgumentError, "request must be provided" if request.nil?
1207
1500
 
@@ -1281,6 +1574,29 @@ module Google
1281
1574
  # @return [::Gapic::Operation]
1282
1575
  #
1283
1576
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1577
+ #
1578
+ # @example Basic example
1579
+ # require "google/cloud/security/private_ca/v1beta1"
1580
+ #
1581
+ # # Create a client object. The client can be reused for multiple calls.
1582
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1583
+ #
1584
+ # # Create a request. To set request fields, pass in keyword arguments.
1585
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateAuthorityRequest.new
1586
+ #
1587
+ # # Call the update_certificate_authority method.
1588
+ # result = client.update_certificate_authority request
1589
+ #
1590
+ # # The returned object is of type Gapic::Operation. You can use it to
1591
+ # # check the status of an operation, cancel it, or wait for results.
1592
+ # # Here is how to wait for a response.
1593
+ # result.wait_until_done! timeout: 60
1594
+ # if result.response?
1595
+ # p result.response
1596
+ # else
1597
+ # puts "No response received."
1598
+ # end
1599
+ #
1284
1600
  def update_certificate_authority request, options = nil
1285
1601
  raise ::ArgumentError, "request must be provided" if request.nil?
1286
1602
 
@@ -1345,6 +1661,22 @@ module Google
1345
1661
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList]
1346
1662
  #
1347
1663
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1664
+ #
1665
+ # @example Basic example
1666
+ # require "google/cloud/security/private_ca/v1beta1"
1667
+ #
1668
+ # # Create a client object. The client can be reused for multiple calls.
1669
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1670
+ #
1671
+ # # Create a request. To set request fields, pass in keyword arguments.
1672
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::GetCertificateRevocationListRequest.new
1673
+ #
1674
+ # # Call the get_certificate_revocation_list method.
1675
+ # result = client.get_certificate_revocation_list request
1676
+ #
1677
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList.
1678
+ # p result
1679
+ #
1348
1680
  def get_certificate_revocation_list request, options = nil
1349
1681
  raise ::ArgumentError, "request must be provided" if request.nil?
1350
1682
 
@@ -1423,6 +1755,26 @@ module Google
1423
1755
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateRevocationListsResponse]
1424
1756
  #
1425
1757
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1758
+ #
1759
+ # @example Basic example
1760
+ # require "google/cloud/security/private_ca/v1beta1"
1761
+ #
1762
+ # # Create a client object. The client can be reused for multiple calls.
1763
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1764
+ #
1765
+ # # Create a request. To set request fields, pass in keyword arguments.
1766
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ListCertificateRevocationListsRequest.new
1767
+ #
1768
+ # # Call the list_certificate_revocation_lists method.
1769
+ # result = client.list_certificate_revocation_lists request
1770
+ #
1771
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1772
+ # # over elements, and API calls will be issued to fetch pages as needed.
1773
+ # result.each do |item|
1774
+ # # Each element is of type ::Google::Cloud::Security::PrivateCA::V1beta1::CertificateRevocationList.
1775
+ # p item
1776
+ # end
1777
+ #
1426
1778
  def list_certificate_revocation_lists request, options = nil
1427
1779
  raise ::ArgumentError, "request must be provided" if request.nil?
1428
1780
 
@@ -1501,6 +1853,29 @@ module Google
1501
1853
  # @return [::Gapic::Operation]
1502
1854
  #
1503
1855
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1856
+ #
1857
+ # @example Basic example
1858
+ # require "google/cloud/security/private_ca/v1beta1"
1859
+ #
1860
+ # # Create a client object. The client can be reused for multiple calls.
1861
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1862
+ #
1863
+ # # Create a request. To set request fields, pass in keyword arguments.
1864
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::UpdateCertificateRevocationListRequest.new
1865
+ #
1866
+ # # Call the update_certificate_revocation_list method.
1867
+ # result = client.update_certificate_revocation_list request
1868
+ #
1869
+ # # The returned object is of type Gapic::Operation. You can use it to
1870
+ # # check the status of an operation, cancel it, or wait for results.
1871
+ # # Here is how to wait for a response.
1872
+ # result.wait_until_done! timeout: 60
1873
+ # if result.response?
1874
+ # p result.response
1875
+ # else
1876
+ # puts "No response received."
1877
+ # end
1878
+ #
1504
1879
  def update_certificate_revocation_list request, options = nil
1505
1880
  raise ::ArgumentError, "request must be provided" if request.nil?
1506
1881
 
@@ -1564,6 +1939,22 @@ module Google
1564
1939
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig]
1565
1940
  #
1566
1941
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1942
+ #
1943
+ # @example Basic example
1944
+ # require "google/cloud/security/private_ca/v1beta1"
1945
+ #
1946
+ # # Create a client object. The client can be reused for multiple calls.
1947
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
1948
+ #
1949
+ # # Create a request. To set request fields, pass in keyword arguments.
1950
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::GetReusableConfigRequest.new
1951
+ #
1952
+ # # Call the get_reusable_config method.
1953
+ # result = client.get_reusable_config request
1954
+ #
1955
+ # # The returned object is of type Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig.
1956
+ # p result
1957
+ #
1567
1958
  def get_reusable_config request, options = nil
1568
1959
  raise ::ArgumentError, "request must be provided" if request.nil?
1569
1960
 
@@ -1642,6 +2033,26 @@ module Google
1642
2033
  # @return [::Google::Cloud::Security::PrivateCA::V1beta1::ListReusableConfigsResponse]
1643
2034
  #
1644
2035
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
2036
+ #
2037
+ # @example Basic example
2038
+ # require "google/cloud/security/private_ca/v1beta1"
2039
+ #
2040
+ # # Create a client object. The client can be reused for multiple calls.
2041
+ # client = Google::Cloud::Security::PrivateCA::V1beta1::CertificateAuthorityService::Rest::Client.new
2042
+ #
2043
+ # # Create a request. To set request fields, pass in keyword arguments.
2044
+ # request = Google::Cloud::Security::PrivateCA::V1beta1::ListReusableConfigsRequest.new
2045
+ #
2046
+ # # Call the list_reusable_configs method.
2047
+ # result = client.list_reusable_configs request
2048
+ #
2049
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2050
+ # # over elements, and API calls will be issued to fetch pages as needed.
2051
+ # result.each do |item|
2052
+ # # Each element is of type ::Google::Cloud::Security::PrivateCA::V1beta1::ReusableConfig.
2053
+ # p item
2054
+ # end
2055
+ #
1645
2056
  def list_reusable_configs request, options = nil
1646
2057
  raise ::ArgumentError, "request must be provided" if request.nil?
1647
2058
 
@@ -1707,9 +2118,9 @@ module Google
1707
2118
  # end
1708
2119
  #
1709
2120
  # @!attribute [rw] endpoint
1710
- # The hostname or hostname:port of the service endpoint.
1711
- # Defaults to `"privateca.googleapis.com"`.
1712
- # @return [::String]
2121
+ # A custom service endpoint, as a hostname or hostname:port. The default is
2122
+ # nil, indicating to use the default endpoint in the current universe domain.
2123
+ # @return [::String,nil]
1713
2124
  # @!attribute [rw] credentials
1714
2125
  # Credentials to send with calls. You may provide any of the following types:
1715
2126
  # * (`String`) The path to a service account key file in JSON format
@@ -1746,13 +2157,20 @@ module Google
1746
2157
  # @!attribute [rw] quota_project
1747
2158
  # A separate project against which to charge quota.
1748
2159
  # @return [::String]
2160
+ # @!attribute [rw] universe_domain
2161
+ # The universe domain within which to make requests. This determines the
2162
+ # default endpoint URL. The default value of nil uses the environment
2163
+ # universe (usually the default "googleapis.com" universe).
2164
+ # @return [::String,nil]
1749
2165
  #
1750
2166
  class Configuration
1751
2167
  extend ::Gapic::Config
1752
2168
 
2169
+ # @private
2170
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1753
2171
  DEFAULT_ENDPOINT = "privateca.googleapis.com"
1754
2172
 
1755
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
2173
+ config_attr :endpoint, nil, ::String, nil
1756
2174
  config_attr :credentials, nil do |value|
1757
2175
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1758
2176
  allowed.any? { |klass| klass === value }
@@ -1764,6 +2182,7 @@ module Google
1764
2182
  config_attr :metadata, nil, ::Hash, nil
1765
2183
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1766
2184
  config_attr :quota_project, nil, ::String, nil
2185
+ config_attr :universe_domain, nil, ::String, nil
1767
2186
 
1768
2187
  # @private
1769
2188
  def initialize parent_config = nil