google-cloud-service_directory-v1 0.3.2 → 0.3.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (18) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/AUTHENTICATION.md +7 -25
  4. data/lib/google/cloud/service_directory/v1/lookup_service/client.rb +52 -40
  5. data/lib/google/cloud/service_directory/v1/registration_service/client.rb +461 -108
  6. data/lib/google/cloud/service_directory/v1/version.rb +1 -1
  7. data/lib/google/cloud/servicedirectory/v1/endpoint_pb.rb +2 -2
  8. data/lib/google/cloud/servicedirectory/v1/lookup_service_pb.rb +2 -2
  9. data/lib/google/cloud/servicedirectory/v1/lookup_service_services_pb.rb +1 -1
  10. data/lib/google/cloud/servicedirectory/v1/namespace_pb.rb +2 -2
  11. data/lib/google/cloud/servicedirectory/v1/registration_service_pb.rb +2 -2
  12. data/lib/google/cloud/servicedirectory/v1/registration_service_services_pb.rb +1 -1
  13. data/lib/google/cloud/servicedirectory/v1/service_pb.rb +2 -2
  14. data/proto_docs/google/api/resource.rb +10 -71
  15. data/proto_docs/google/cloud/servicedirectory/v1/endpoint.rb +1 -1
  16. data/proto_docs/google/cloud/servicedirectory/v1/namespace.rb +1 -1
  17. data/proto_docs/google/cloud/servicedirectory/v1/service.rb +1 -1
  18. metadata +5 -5
data/lib/google/cloud/service_directory/v1/registration_service/client.rb CHANGED
@@ -55,13 +55,12 @@ module Google
55
55
  # See {::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client::Configuration}
56
56
  # for a description of the configuration fields.
57
57
  #
58
- # ## Example
58
+ # @example
59
59
  #
60
- # To modify the configuration for all RegistrationService clients:
61
- #
62
- # ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.configure do |config|
63
- # config.timeout = 10.0
64
- # end
60
+ # # Modify the configuration for all RegistrationService clients
61
+ # ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.configure do |config|
62
+ # config.timeout = 10.0
63
+ # end
65
64
  #
66
65
  # @yield [config] Configure the Client client.
67
66
  # @yieldparam config [Client::Configuration]
@@ -113,19 +112,15 @@ module Google
113
112
  ##
114
113
  # Create a new RegistrationService client object.
115
114
  #
116
- # ## Examples
117
- #
118
- # To create a new RegistrationService client with the default
119
- # configuration:
120
- #
121
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
115
+ # @example
122
116
  #
123
- # To create a new RegistrationService client with a custom
124
- # configuration:
117
+ # # Create a client using the default configuration
118
+ # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
125
119
  #
126
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
127
- # config.timeout = 10.0
128
- # end
120
+ # # Create a client using a custom configuration
121
+ # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
122
+ # config.timeout = 10.0
123
+ # end
129
124
  #
130
125
  # @yield [config] Configure the RegistrationService client.
131
126
  # @yieldparam config [Client::Configuration]
@@ -145,10 +140,9 @@ module Google
145
140
 
146
141
  # Create credentials
147
142
  credentials = @config.credentials
148
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
143
+ # Use self-signed JWT if the endpoint is unchanged from default,
149
144
  # but only if the default endpoint does not have a region prefix.
150
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
151
- @config.endpoint == Client.configure.endpoint &&
145
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
152
146
  !@config.endpoint.split(".").first.include?("-")
153
147
  credentials ||= Credentials.default scope: @config.scope,
154
148
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -209,6 +203,21 @@ module Google
209
203
  #
210
204
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
211
205
  #
206
+ # @example Basic example
207
+ # require "google/cloud/service_directory/v1"
208
+ #
209
+ # # Create a client object. The client can be reused for multiple calls.
210
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
211
+ #
212
+ # # Create a request. To set request fields, pass in keyword arguments.
213
+ # request = Google::Cloud::ServiceDirectory::V1::CreateNamespaceRequest.new
214
+ #
215
+ # # Call the create_namespace method.
216
+ # result = client.create_namespace request
217
+ #
218
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Namespace.
219
+ # p result
220
+ #
212
221
  def create_namespace request, options = nil
213
222
  raise ::ArgumentError, "request must be provided" if request.nil?
214
223
 
@@ -226,16 +235,20 @@ module Google
226
235
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
227
236
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
228
237
 
229
- header_params = {
230
- "parent" => request.parent
231
- }
238
+ header_params = {}
239
+ if request.parent
240
+ header_params["parent"] = request.parent
241
+ end
242
+
232
243
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
233
244
  metadata[:"x-goog-request-params"] ||= request_params_header
234
245
 
235
246
  options.apply_defaults timeout: @config.rpcs.create_namespace.timeout,
236
247
  metadata: metadata,
237
248
  retry_policy: @config.rpcs.create_namespace.retry_policy
238
- options.apply_defaults metadata: @config.metadata,
249
+
250
+ options.apply_defaults timeout: @config.timeout,
251
+ metadata: @config.metadata,
239
252
  retry_policy: @config.retry_policy
240
253
 
241
254
  @registration_service_stub.call_rpc :create_namespace, request, options: options do |response, operation|
@@ -315,6 +328,27 @@ module Google
315
328
  #
316
329
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
317
330
  #
331
+ # @example Basic example
332
+ # require "google/cloud/service_directory/v1"
333
+ #
334
+ # # Create a client object. The client can be reused for multiple calls.
335
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
336
+ #
337
+ # # Create a request. To set request fields, pass in keyword arguments.
338
+ # request = Google::Cloud::ServiceDirectory::V1::ListNamespacesRequest.new
339
+ #
340
+ # # Call the list_namespaces method.
341
+ # result = client.list_namespaces request
342
+ #
343
+ # # The returned object is of type Gapic::PagedEnumerable. You can
344
+ # # iterate over all elements by calling #each, and the enumerable
345
+ # # will lazily make API calls to fetch subsequent pages. Other
346
+ # # methods are also available for managing paging directly.
347
+ # result.each do |response|
348
+ # # Each element is of type ::Google::Cloud::ServiceDirectory::V1::Namespace.
349
+ # p response
350
+ # end
351
+ #
318
352
  def list_namespaces request, options = nil
319
353
  raise ::ArgumentError, "request must be provided" if request.nil?
320
354
 
@@ -332,16 +366,20 @@ module Google
332
366
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
333
367
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
334
368
 
335
- header_params = {
336
- "parent" => request.parent
337
- }
369
+ header_params = {}
370
+ if request.parent
371
+ header_params["parent"] = request.parent
372
+ end
373
+
338
374
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
339
375
  metadata[:"x-goog-request-params"] ||= request_params_header
340
376
 
341
377
  options.apply_defaults timeout: @config.rpcs.list_namespaces.timeout,
342
378
  metadata: metadata,
343
379
  retry_policy: @config.rpcs.list_namespaces.retry_policy
344
- options.apply_defaults metadata: @config.metadata,
380
+
381
+ options.apply_defaults timeout: @config.timeout,
382
+ metadata: @config.metadata,
345
383
  retry_policy: @config.retry_policy
346
384
 
347
385
  @registration_service_stub.call_rpc :list_namespaces, request, options: options do |response, operation|
@@ -382,6 +420,21 @@ module Google
382
420
  #
383
421
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
384
422
  #
423
+ # @example Basic example
424
+ # require "google/cloud/service_directory/v1"
425
+ #
426
+ # # Create a client object. The client can be reused for multiple calls.
427
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
428
+ #
429
+ # # Create a request. To set request fields, pass in keyword arguments.
430
+ # request = Google::Cloud::ServiceDirectory::V1::GetNamespaceRequest.new
431
+ #
432
+ # # Call the get_namespace method.
433
+ # result = client.get_namespace request
434
+ #
435
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Namespace.
436
+ # p result
437
+ #
385
438
  def get_namespace request, options = nil
386
439
  raise ::ArgumentError, "request must be provided" if request.nil?
387
440
 
@@ -399,16 +452,20 @@ module Google
399
452
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
400
453
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
401
454
 
402
- header_params = {
403
- "name" => request.name
404
- }
455
+ header_params = {}
456
+ if request.name
457
+ header_params["name"] = request.name
458
+ end
459
+
405
460
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
406
461
  metadata[:"x-goog-request-params"] ||= request_params_header
407
462
 
408
463
  options.apply_defaults timeout: @config.rpcs.get_namespace.timeout,
409
464
  metadata: metadata,
410
465
  retry_policy: @config.rpcs.get_namespace.retry_policy
411
- options.apply_defaults metadata: @config.metadata,
466
+
467
+ options.apply_defaults timeout: @config.timeout,
468
+ metadata: @config.metadata,
412
469
  retry_policy: @config.retry_policy
413
470
 
414
471
  @registration_service_stub.call_rpc :get_namespace, request, options: options do |response, operation|
@@ -450,6 +507,21 @@ module Google
450
507
  #
451
508
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
452
509
  #
510
+ # @example Basic example
511
+ # require "google/cloud/service_directory/v1"
512
+ #
513
+ # # Create a client object. The client can be reused for multiple calls.
514
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
515
+ #
516
+ # # Create a request. To set request fields, pass in keyword arguments.
517
+ # request = Google::Cloud::ServiceDirectory::V1::UpdateNamespaceRequest.new
518
+ #
519
+ # # Call the update_namespace method.
520
+ # result = client.update_namespace request
521
+ #
522
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Namespace.
523
+ # p result
524
+ #
453
525
  def update_namespace request, options = nil
454
526
  raise ::ArgumentError, "request must be provided" if request.nil?
455
527
 
@@ -467,16 +539,20 @@ module Google
467
539
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
468
540
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
469
541
 
470
- header_params = {
471
- "namespace.name" => request.namespace.name
472
- }
542
+ header_params = {}
543
+ if request.namespace&.name
544
+ header_params["namespace.name"] = request.namespace.name
545
+ end
546
+
473
547
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
474
548
  metadata[:"x-goog-request-params"] ||= request_params_header
475
549
 
476
550
  options.apply_defaults timeout: @config.rpcs.update_namespace.timeout,
477
551
  metadata: metadata,
478
552
  retry_policy: @config.rpcs.update_namespace.retry_policy
479
- options.apply_defaults metadata: @config.metadata,
553
+
554
+ options.apply_defaults timeout: @config.timeout,
555
+ metadata: @config.metadata,
480
556
  retry_policy: @config.retry_policy
481
557
 
482
558
  @registration_service_stub.call_rpc :update_namespace, request, options: options do |response, operation|
@@ -517,6 +593,21 @@ module Google
517
593
  #
518
594
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
519
595
  #
596
+ # @example Basic example
597
+ # require "google/cloud/service_directory/v1"
598
+ #
599
+ # # Create a client object. The client can be reused for multiple calls.
600
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
601
+ #
602
+ # # Create a request. To set request fields, pass in keyword arguments.
603
+ # request = Google::Cloud::ServiceDirectory::V1::DeleteNamespaceRequest.new
604
+ #
605
+ # # Call the delete_namespace method.
606
+ # result = client.delete_namespace request
607
+ #
608
+ # # The returned object is of type Google::Protobuf::Empty.
609
+ # p result
610
+ #
520
611
  def delete_namespace request, options = nil
521
612
  raise ::ArgumentError, "request must be provided" if request.nil?
522
613
 
@@ -534,16 +625,20 @@ module Google
534
625
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
535
626
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
536
627
 
537
- header_params = {
538
- "name" => request.name
539
- }
628
+ header_params = {}
629
+ if request.name
630
+ header_params["name"] = request.name
631
+ end
632
+
540
633
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
541
634
  metadata[:"x-goog-request-params"] ||= request_params_header
542
635
 
543
636
  options.apply_defaults timeout: @config.rpcs.delete_namespace.timeout,
544
637
  metadata: metadata,
545
638
  retry_policy: @config.rpcs.delete_namespace.retry_policy
546
- options.apply_defaults metadata: @config.metadata,
639
+
640
+ options.apply_defaults timeout: @config.timeout,
641
+ metadata: @config.metadata,
547
642
  retry_policy: @config.retry_policy
548
643
 
549
644
  @registration_service_stub.call_rpc :delete_namespace, request, options: options do |response, operation|
@@ -593,6 +688,21 @@ module Google
593
688
  #
594
689
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
595
690
  #
691
+ # @example Basic example
692
+ # require "google/cloud/service_directory/v1"
693
+ #
694
+ # # Create a client object. The client can be reused for multiple calls.
695
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
696
+ #
697
+ # # Create a request. To set request fields, pass in keyword arguments.
698
+ # request = Google::Cloud::ServiceDirectory::V1::CreateServiceRequest.new
699
+ #
700
+ # # Call the create_service method.
701
+ # result = client.create_service request
702
+ #
703
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Service.
704
+ # p result
705
+ #
596
706
  def create_service request, options = nil
597
707
  raise ::ArgumentError, "request must be provided" if request.nil?
598
708
 
@@ -610,16 +720,20 @@ module Google
610
720
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
611
721
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
612
722
 
613
- header_params = {
614
- "parent" => request.parent
615
- }
723
+ header_params = {}
724
+ if request.parent
725
+ header_params["parent"] = request.parent
726
+ end
727
+
616
728
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
617
729
  metadata[:"x-goog-request-params"] ||= request_params_header
618
730
 
619
731
  options.apply_defaults timeout: @config.rpcs.create_service.timeout,
620
732
  metadata: metadata,
621
733
  retry_policy: @config.rpcs.create_service.retry_policy
622
- options.apply_defaults metadata: @config.metadata,
734
+
735
+ options.apply_defaults timeout: @config.timeout,
736
+ metadata: @config.metadata,
623
737
  retry_policy: @config.retry_policy
624
738
 
625
739
  @registration_service_stub.call_rpc :create_service, request, options: options do |response, operation|
@@ -691,6 +805,27 @@ module Google
691
805
  #
692
806
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
693
807
  #
808
+ # @example Basic example
809
+ # require "google/cloud/service_directory/v1"
810
+ #
811
+ # # Create a client object. The client can be reused for multiple calls.
812
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
813
+ #
814
+ # # Create a request. To set request fields, pass in keyword arguments.
815
+ # request = Google::Cloud::ServiceDirectory::V1::ListServicesRequest.new
816
+ #
817
+ # # Call the list_services method.
818
+ # result = client.list_services request
819
+ #
820
+ # # The returned object is of type Gapic::PagedEnumerable. You can
821
+ # # iterate over all elements by calling #each, and the enumerable
822
+ # # will lazily make API calls to fetch subsequent pages. Other
823
+ # # methods are also available for managing paging directly.
824
+ # result.each do |response|
825
+ # # Each element is of type ::Google::Cloud::ServiceDirectory::V1::Service.
826
+ # p response
827
+ # end
828
+ #
694
829
  def list_services request, options = nil
695
830
  raise ::ArgumentError, "request must be provided" if request.nil?
696
831
 
@@ -708,16 +843,20 @@ module Google
708
843
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
709
844
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
710
845
 
711
- header_params = {
712
- "parent" => request.parent
713
- }
846
+ header_params = {}
847
+ if request.parent
848
+ header_params["parent"] = request.parent
849
+ end
850
+
714
851
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
715
852
  metadata[:"x-goog-request-params"] ||= request_params_header
716
853
 
717
854
  options.apply_defaults timeout: @config.rpcs.list_services.timeout,
718
855
  metadata: metadata,
719
856
  retry_policy: @config.rpcs.list_services.retry_policy
720
- options.apply_defaults metadata: @config.metadata,
857
+
858
+ options.apply_defaults timeout: @config.timeout,
859
+ metadata: @config.metadata,
721
860
  retry_policy: @config.retry_policy
722
861
 
723
862
  @registration_service_stub.call_rpc :list_services, request, options: options do |response, operation|
@@ -758,6 +897,21 @@ module Google
758
897
  #
759
898
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
760
899
  #
900
+ # @example Basic example
901
+ # require "google/cloud/service_directory/v1"
902
+ #
903
+ # # Create a client object. The client can be reused for multiple calls.
904
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
905
+ #
906
+ # # Create a request. To set request fields, pass in keyword arguments.
907
+ # request = Google::Cloud::ServiceDirectory::V1::GetServiceRequest.new
908
+ #
909
+ # # Call the get_service method.
910
+ # result = client.get_service request
911
+ #
912
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Service.
913
+ # p result
914
+ #
761
915
  def get_service request, options = nil
762
916
  raise ::ArgumentError, "request must be provided" if request.nil?
763
917
 
@@ -775,16 +929,20 @@ module Google
775
929
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
776
930
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
777
931
 
778
- header_params = {
779
- "name" => request.name
780
- }
932
+ header_params = {}
933
+ if request.name
934
+ header_params["name"] = request.name
935
+ end
936
+
781
937
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
782
938
  metadata[:"x-goog-request-params"] ||= request_params_header
783
939
 
784
940
  options.apply_defaults timeout: @config.rpcs.get_service.timeout,
785
941
  metadata: metadata,
786
942
  retry_policy: @config.rpcs.get_service.retry_policy
787
- options.apply_defaults metadata: @config.metadata,
943
+
944
+ options.apply_defaults timeout: @config.timeout,
945
+ metadata: @config.metadata,
788
946
  retry_policy: @config.retry_policy
789
947
 
790
948
  @registration_service_stub.call_rpc :get_service, request, options: options do |response, operation|
@@ -826,6 +984,21 @@ module Google
826
984
  #
827
985
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
828
986
  #
987
+ # @example Basic example
988
+ # require "google/cloud/service_directory/v1"
989
+ #
990
+ # # Create a client object. The client can be reused for multiple calls.
991
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
992
+ #
993
+ # # Create a request. To set request fields, pass in keyword arguments.
994
+ # request = Google::Cloud::ServiceDirectory::V1::UpdateServiceRequest.new
995
+ #
996
+ # # Call the update_service method.
997
+ # result = client.update_service request
998
+ #
999
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Service.
1000
+ # p result
1001
+ #
829
1002
  def update_service request, options = nil
830
1003
  raise ::ArgumentError, "request must be provided" if request.nil?
831
1004
 
@@ -843,16 +1016,20 @@ module Google
843
1016
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
844
1017
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
845
1018
 
846
- header_params = {
847
- "service.name" => request.service.name
848
- }
1019
+ header_params = {}
1020
+ if request.service&.name
1021
+ header_params["service.name"] = request.service.name
1022
+ end
1023
+
849
1024
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
850
1025
  metadata[:"x-goog-request-params"] ||= request_params_header
851
1026
 
852
1027
  options.apply_defaults timeout: @config.rpcs.update_service.timeout,
853
1028
  metadata: metadata,
854
1029
  retry_policy: @config.rpcs.update_service.retry_policy
855
- options.apply_defaults metadata: @config.metadata,
1030
+
1031
+ options.apply_defaults timeout: @config.timeout,
1032
+ metadata: @config.metadata,
856
1033
  retry_policy: @config.retry_policy
857
1034
 
858
1035
  @registration_service_stub.call_rpc :update_service, request, options: options do |response, operation|
@@ -893,6 +1070,21 @@ module Google
893
1070
  #
894
1071
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
895
1072
  #
1073
+ # @example Basic example
1074
+ # require "google/cloud/service_directory/v1"
1075
+ #
1076
+ # # Create a client object. The client can be reused for multiple calls.
1077
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1078
+ #
1079
+ # # Create a request. To set request fields, pass in keyword arguments.
1080
+ # request = Google::Cloud::ServiceDirectory::V1::DeleteServiceRequest.new
1081
+ #
1082
+ # # Call the delete_service method.
1083
+ # result = client.delete_service request
1084
+ #
1085
+ # # The returned object is of type Google::Protobuf::Empty.
1086
+ # p result
1087
+ #
896
1088
  def delete_service request, options = nil
897
1089
  raise ::ArgumentError, "request must be provided" if request.nil?
898
1090
 
@@ -910,16 +1102,20 @@ module Google
910
1102
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
911
1103
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
912
1104
 
913
- header_params = {
914
- "name" => request.name
915
- }
1105
+ header_params = {}
1106
+ if request.name
1107
+ header_params["name"] = request.name
1108
+ end
1109
+
916
1110
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
917
1111
  metadata[:"x-goog-request-params"] ||= request_params_header
918
1112
 
919
1113
  options.apply_defaults timeout: @config.rpcs.delete_service.timeout,
920
1114
  metadata: metadata,
921
1115
  retry_policy: @config.rpcs.delete_service.retry_policy
922
- options.apply_defaults metadata: @config.metadata,
1116
+
1117
+ options.apply_defaults timeout: @config.timeout,
1118
+ metadata: @config.metadata,
923
1119
  retry_policy: @config.retry_policy
924
1120
 
925
1121
  @registration_service_stub.call_rpc :delete_service, request, options: options do |response, operation|
@@ -969,6 +1165,21 @@ module Google
969
1165
  #
970
1166
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
971
1167
  #
1168
+ # @example Basic example
1169
+ # require "google/cloud/service_directory/v1"
1170
+ #
1171
+ # # Create a client object. The client can be reused for multiple calls.
1172
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1173
+ #
1174
+ # # Create a request. To set request fields, pass in keyword arguments.
1175
+ # request = Google::Cloud::ServiceDirectory::V1::CreateEndpointRequest.new
1176
+ #
1177
+ # # Call the create_endpoint method.
1178
+ # result = client.create_endpoint request
1179
+ #
1180
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Endpoint.
1181
+ # p result
1182
+ #
972
1183
  def create_endpoint request, options = nil
973
1184
  raise ::ArgumentError, "request must be provided" if request.nil?
974
1185
 
@@ -986,16 +1197,20 @@ module Google
986
1197
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
987
1198
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
988
1199
 
989
- header_params = {
990
- "parent" => request.parent
991
- }
1200
+ header_params = {}
1201
+ if request.parent
1202
+ header_params["parent"] = request.parent
1203
+ end
1204
+
992
1205
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
993
1206
  metadata[:"x-goog-request-params"] ||= request_params_header
994
1207
 
995
1208
  options.apply_defaults timeout: @config.rpcs.create_endpoint.timeout,
996
1209
  metadata: metadata,
997
1210
  retry_policy: @config.rpcs.create_endpoint.retry_policy
998
- options.apply_defaults metadata: @config.metadata,
1211
+
1212
+ options.apply_defaults timeout: @config.timeout,
1213
+ metadata: @config.metadata,
999
1214
  retry_policy: @config.retry_policy
1000
1215
 
1001
1216
  @registration_service_stub.call_rpc :create_endpoint, request, options: options do |response, operation|
@@ -1069,6 +1284,27 @@ module Google
1069
1284
  #
1070
1285
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1071
1286
  #
1287
+ # @example Basic example
1288
+ # require "google/cloud/service_directory/v1"
1289
+ #
1290
+ # # Create a client object. The client can be reused for multiple calls.
1291
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1292
+ #
1293
+ # # Create a request. To set request fields, pass in keyword arguments.
1294
+ # request = Google::Cloud::ServiceDirectory::V1::ListEndpointsRequest.new
1295
+ #
1296
+ # # Call the list_endpoints method.
1297
+ # result = client.list_endpoints request
1298
+ #
1299
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1300
+ # # iterate over all elements by calling #each, and the enumerable
1301
+ # # will lazily make API calls to fetch subsequent pages. Other
1302
+ # # methods are also available for managing paging directly.
1303
+ # result.each do |response|
1304
+ # # Each element is of type ::Google::Cloud::ServiceDirectory::V1::Endpoint.
1305
+ # p response
1306
+ # end
1307
+ #
1072
1308
  def list_endpoints request, options = nil
1073
1309
  raise ::ArgumentError, "request must be provided" if request.nil?
1074
1310
 
@@ -1086,16 +1322,20 @@ module Google
1086
1322
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1087
1323
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1088
1324
 
1089
- header_params = {
1090
- "parent" => request.parent
1091
- }
1325
+ header_params = {}
1326
+ if request.parent
1327
+ header_params["parent"] = request.parent
1328
+ end
1329
+
1092
1330
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1093
1331
  metadata[:"x-goog-request-params"] ||= request_params_header
1094
1332
 
1095
1333
  options.apply_defaults timeout: @config.rpcs.list_endpoints.timeout,
1096
1334
  metadata: metadata,
1097
1335
  retry_policy: @config.rpcs.list_endpoints.retry_policy
1098
- options.apply_defaults metadata: @config.metadata,
1336
+
1337
+ options.apply_defaults timeout: @config.timeout,
1338
+ metadata: @config.metadata,
1099
1339
  retry_policy: @config.retry_policy
1100
1340
 
1101
1341
  @registration_service_stub.call_rpc :list_endpoints, request, options: options do |response, operation|
@@ -1136,6 +1376,21 @@ module Google
1136
1376
  #
1137
1377
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1138
1378
  #
1379
+ # @example Basic example
1380
+ # require "google/cloud/service_directory/v1"
1381
+ #
1382
+ # # Create a client object. The client can be reused for multiple calls.
1383
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1384
+ #
1385
+ # # Create a request. To set request fields, pass in keyword arguments.
1386
+ # request = Google::Cloud::ServiceDirectory::V1::GetEndpointRequest.new
1387
+ #
1388
+ # # Call the get_endpoint method.
1389
+ # result = client.get_endpoint request
1390
+ #
1391
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Endpoint.
1392
+ # p result
1393
+ #
1139
1394
  def get_endpoint request, options = nil
1140
1395
  raise ::ArgumentError, "request must be provided" if request.nil?
1141
1396
 
@@ -1153,16 +1408,20 @@ module Google
1153
1408
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1154
1409
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1155
1410
 
1156
- header_params = {
1157
- "name" => request.name
1158
- }
1411
+ header_params = {}
1412
+ if request.name
1413
+ header_params["name"] = request.name
1414
+ end
1415
+
1159
1416
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1160
1417
  metadata[:"x-goog-request-params"] ||= request_params_header
1161
1418
 
1162
1419
  options.apply_defaults timeout: @config.rpcs.get_endpoint.timeout,
1163
1420
  metadata: metadata,
1164
1421
  retry_policy: @config.rpcs.get_endpoint.retry_policy
1165
- options.apply_defaults metadata: @config.metadata,
1422
+
1423
+ options.apply_defaults timeout: @config.timeout,
1424
+ metadata: @config.metadata,
1166
1425
  retry_policy: @config.retry_policy
1167
1426
 
1168
1427
  @registration_service_stub.call_rpc :get_endpoint, request, options: options do |response, operation|
@@ -1204,6 +1463,21 @@ module Google
1204
1463
  #
1205
1464
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1206
1465
  #
1466
+ # @example Basic example
1467
+ # require "google/cloud/service_directory/v1"
1468
+ #
1469
+ # # Create a client object. The client can be reused for multiple calls.
1470
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1471
+ #
1472
+ # # Create a request. To set request fields, pass in keyword arguments.
1473
+ # request = Google::Cloud::ServiceDirectory::V1::UpdateEndpointRequest.new
1474
+ #
1475
+ # # Call the update_endpoint method.
1476
+ # result = client.update_endpoint request
1477
+ #
1478
+ # # The returned object is of type Google::Cloud::ServiceDirectory::V1::Endpoint.
1479
+ # p result
1480
+ #
1207
1481
  def update_endpoint request, options = nil
1208
1482
  raise ::ArgumentError, "request must be provided" if request.nil?
1209
1483
 
@@ -1221,16 +1495,20 @@ module Google
1221
1495
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1222
1496
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1223
1497
 
1224
- header_params = {
1225
- "endpoint.name" => request.endpoint.name
1226
- }
1498
+ header_params = {}
1499
+ if request.endpoint&.name
1500
+ header_params["endpoint.name"] = request.endpoint.name
1501
+ end
1502
+
1227
1503
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1228
1504
  metadata[:"x-goog-request-params"] ||= request_params_header
1229
1505
 
1230
1506
  options.apply_defaults timeout: @config.rpcs.update_endpoint.timeout,
1231
1507
  metadata: metadata,
1232
1508
  retry_policy: @config.rpcs.update_endpoint.retry_policy
1233
- options.apply_defaults metadata: @config.metadata,
1509
+
1510
+ options.apply_defaults timeout: @config.timeout,
1511
+ metadata: @config.metadata,
1234
1512
  retry_policy: @config.retry_policy
1235
1513
 
1236
1514
  @registration_service_stub.call_rpc :update_endpoint, request, options: options do |response, operation|
@@ -1270,6 +1548,21 @@ module Google
1270
1548
  #
1271
1549
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1272
1550
  #
1551
+ # @example Basic example
1552
+ # require "google/cloud/service_directory/v1"
1553
+ #
1554
+ # # Create a client object. The client can be reused for multiple calls.
1555
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1556
+ #
1557
+ # # Create a request. To set request fields, pass in keyword arguments.
1558
+ # request = Google::Cloud::ServiceDirectory::V1::DeleteEndpointRequest.new
1559
+ #
1560
+ # # Call the delete_endpoint method.
1561
+ # result = client.delete_endpoint request
1562
+ #
1563
+ # # The returned object is of type Google::Protobuf::Empty.
1564
+ # p result
1565
+ #
1273
1566
  def delete_endpoint request, options = nil
1274
1567
  raise ::ArgumentError, "request must be provided" if request.nil?
1275
1568
 
@@ -1287,16 +1580,20 @@ module Google
1287
1580
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1288
1581
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1289
1582
 
1290
- header_params = {
1291
- "name" => request.name
1292
- }
1583
+ header_params = {}
1584
+ if request.name
1585
+ header_params["name"] = request.name
1586
+ end
1587
+
1293
1588
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1294
1589
  metadata[:"x-goog-request-params"] ||= request_params_header
1295
1590
 
1296
1591
  options.apply_defaults timeout: @config.rpcs.delete_endpoint.timeout,
1297
1592
  metadata: metadata,
1298
1593
  retry_policy: @config.rpcs.delete_endpoint.retry_policy
1299
- options.apply_defaults metadata: @config.metadata,
1594
+
1595
+ options.apply_defaults timeout: @config.timeout,
1596
+ metadata: @config.metadata,
1300
1597
  retry_policy: @config.retry_policy
1301
1598
 
1302
1599
  @registration_service_stub.call_rpc :delete_endpoint, request, options: options do |response, operation|
@@ -1340,6 +1637,21 @@ module Google
1340
1637
  #
1341
1638
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1342
1639
  #
1640
+ # @example Basic example
1641
+ # require "google/cloud/service_directory/v1"
1642
+ #
1643
+ # # Create a client object. The client can be reused for multiple calls.
1644
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1645
+ #
1646
+ # # Create a request. To set request fields, pass in keyword arguments.
1647
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
1648
+ #
1649
+ # # Call the get_iam_policy method.
1650
+ # result = client.get_iam_policy request
1651
+ #
1652
+ # # The returned object is of type Google::Iam::V1::Policy.
1653
+ # p result
1654
+ #
1343
1655
  def get_iam_policy request, options = nil
1344
1656
  raise ::ArgumentError, "request must be provided" if request.nil?
1345
1657
 
@@ -1357,16 +1669,20 @@ module Google
1357
1669
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1358
1670
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1359
1671
 
1360
- header_params = {
1361
- "resource" => request.resource
1362
- }
1672
+ header_params = {}
1673
+ if request.resource
1674
+ header_params["resource"] = request.resource
1675
+ end
1676
+
1363
1677
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1364
1678
  metadata[:"x-goog-request-params"] ||= request_params_header
1365
1679
 
1366
1680
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
1367
1681
  metadata: metadata,
1368
1682
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
1369
- options.apply_defaults metadata: @config.metadata,
1683
+
1684
+ options.apply_defaults timeout: @config.timeout,
1685
+ metadata: @config.metadata,
1370
1686
  retry_policy: @config.retry_policy
1371
1687
 
1372
1688
  @registration_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -1412,6 +1728,21 @@ module Google
1412
1728
  #
1413
1729
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1414
1730
  #
1731
+ # @example Basic example
1732
+ # require "google/cloud/service_directory/v1"
1733
+ #
1734
+ # # Create a client object. The client can be reused for multiple calls.
1735
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1736
+ #
1737
+ # # Create a request. To set request fields, pass in keyword arguments.
1738
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
1739
+ #
1740
+ # # Call the set_iam_policy method.
1741
+ # result = client.set_iam_policy request
1742
+ #
1743
+ # # The returned object is of type Google::Iam::V1::Policy.
1744
+ # p result
1745
+ #
1415
1746
  def set_iam_policy request, options = nil
1416
1747
  raise ::ArgumentError, "request must be provided" if request.nil?
1417
1748
 
@@ -1429,16 +1760,20 @@ module Google
1429
1760
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1430
1761
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1431
1762
 
1432
- header_params = {
1433
- "resource" => request.resource
1434
- }
1763
+ header_params = {}
1764
+ if request.resource
1765
+ header_params["resource"] = request.resource
1766
+ end
1767
+
1435
1768
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1436
1769
  metadata[:"x-goog-request-params"] ||= request_params_header
1437
1770
 
1438
1771
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
1439
1772
  metadata: metadata,
1440
1773
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
1441
- options.apply_defaults metadata: @config.metadata,
1774
+
1775
+ options.apply_defaults timeout: @config.timeout,
1776
+ metadata: @config.metadata,
1442
1777
  retry_policy: @config.retry_policy
1443
1778
 
1444
1779
  @registration_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -1484,6 +1819,21 @@ module Google
1484
1819
  #
1485
1820
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1486
1821
  #
1822
+ # @example Basic example
1823
+ # require "google/cloud/service_directory/v1"
1824
+ #
1825
+ # # Create a client object. The client can be reused for multiple calls.
1826
+ # client = Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
1827
+ #
1828
+ # # Create a request. To set request fields, pass in keyword arguments.
1829
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
1830
+ #
1831
+ # # Call the test_iam_permissions method.
1832
+ # result = client.test_iam_permissions request
1833
+ #
1834
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
1835
+ # p result
1836
+ #
1487
1837
  def test_iam_permissions request, options = nil
1488
1838
  raise ::ArgumentError, "request must be provided" if request.nil?
1489
1839
 
@@ -1501,16 +1851,20 @@ module Google
1501
1851
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1502
1852
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1503
1853
 
1504
- header_params = {
1505
- "resource" => request.resource
1506
- }
1854
+ header_params = {}
1855
+ if request.resource
1856
+ header_params["resource"] = request.resource
1857
+ end
1858
+
1507
1859
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1508
1860
  metadata[:"x-goog-request-params"] ||= request_params_header
1509
1861
 
1510
1862
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
1511
1863
  metadata: metadata,
1512
1864
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
1513
- options.apply_defaults metadata: @config.metadata,
1865
+
1866
+ options.apply_defaults timeout: @config.timeout,
1867
+ metadata: @config.metadata,
1514
1868
  retry_policy: @config.retry_policy
1515
1869
 
1516
1870
  @registration_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -1534,22 +1888,21 @@ module Google
1534
1888
  # Configuration can be applied globally to all clients, or to a single client
1535
1889
  # on construction.
1536
1890
  #
1537
- # # Examples
1538
- #
1539
- # To modify the global config, setting the timeout for create_namespace
1540
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1541
- #
1542
- # ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.configure do |config|
1543
- # config.timeout = 10.0
1544
- # config.rpcs.create_namespace.timeout = 20.0
1545
- # end
1546
- #
1547
- # To apply the above configuration only to a new client:
1548
- #
1549
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
1550
- # config.timeout = 10.0
1551
- # config.rpcs.create_namespace.timeout = 20.0
1552
- # end
1891
+ # @example
1892
+ #
1893
+ # # Modify the global config, setting the timeout for
1894
+ # # create_namespace to 20 seconds,
1895
+ # # and all remaining timeouts to 10 seconds.
1896
+ # ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.configure do |config|
1897
+ # config.timeout = 10.0
1898
+ # config.rpcs.create_namespace.timeout = 20.0
1899
+ # end
1900
+ #
1901
+ # # Apply the above configuration only to a new client.
1902
+ # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
1903
+ # config.timeout = 10.0
1904
+ # config.rpcs.create_namespace.timeout = 20.0
1905
+ # end
1553
1906
  #
1554
1907
  # @!attribute [rw] endpoint
1555
1908
  # The hostname or hostname:port of the service endpoint.