google-cloud-service_directory-v1 0.3.1 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +1 -1
  4. data/lib/google/cloud/service_directory/v1/lookup_service/client.rb +54 -45
  5. data/lib/google/cloud/service_directory/v1/registration_service/client.rb +463 -113
  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/namespace_pb.rb +2 -2
  10. data/lib/google/cloud/servicedirectory/v1/registration_service_pb.rb +2 -2
  11. data/lib/google/cloud/servicedirectory/v1/service_pb.rb +2 -2
  12. data/proto_docs/google/api/field_behavior.rb +7 -1
  13. data/proto_docs/google/cloud/servicedirectory/v1/endpoint.rb +1 -1
  14. data/proto_docs/google/cloud/servicedirectory/v1/namespace.rb +1 -1
  15. data/proto_docs/google/cloud/servicedirectory/v1/service.rb +1 -1
  16. data/proto_docs/google/type/expr.rb +35 -12
  17. metadata +4 -4
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]
@@ -81,10 +80,7 @@ module Google
81
80
 
82
81
  default_config.timeout = 15.0
83
82
  default_config.retry_policy = {
84
- initial_delay: 1.0,
85
- max_delay: 60.0,
86
- multiplier: 1.3,
87
- retry_codes: [14, 2]
83
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 2]
88
84
  }
89
85
 
90
86
  default_config
@@ -116,19 +112,15 @@ module Google
116
112
  ##
117
113
  # Create a new RegistrationService client object.
118
114
  #
119
- # ## Examples
120
- #
121
- # To create a new RegistrationService client with the default
122
- # configuration:
123
- #
124
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
115
+ # @example
125
116
  #
126
- # To create a new RegistrationService client with a custom
127
- # configuration:
117
+ # # Create a client using the default configuration
118
+ # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new
128
119
  #
129
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
130
- # config.timeout = 10.0
131
- # 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
132
124
  #
133
125
  # @yield [config] Configure the RegistrationService client.
134
126
  # @yieldparam config [Client::Configuration]
@@ -148,14 +140,13 @@ module Google
148
140
 
149
141
  # Create credentials
150
142
  credentials = @config.credentials
151
- # 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,
152
144
  # but only if the default endpoint does not have a region prefix.
153
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
154
- @config.endpoint == Client.configure.endpoint &&
145
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
155
146
  !@config.endpoint.split(".").first.include?("-")
156
147
  credentials ||= Credentials.default scope: @config.scope,
157
148
  enable_self_signed_jwt: enable_self_signed_jwt
158
- if credentials.is_a?(String) || credentials.is_a?(Hash)
149
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
159
150
  credentials = Credentials.new credentials, scope: @config.scope
160
151
  end
161
152
  @quota_project_id = @config.quota_project
@@ -212,6 +203,21 @@ module Google
212
203
  #
213
204
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
214
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
+ #
215
221
  def create_namespace request, options = nil
216
222
  raise ::ArgumentError, "request must be provided" if request.nil?
217
223
 
@@ -229,16 +235,20 @@ module Google
229
235
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
230
236
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
231
237
 
232
- header_params = {
233
- "parent" => request.parent
234
- }
238
+ header_params = {}
239
+ if request.parent
240
+ header_params["parent"] = request.parent
241
+ end
242
+
235
243
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
236
244
  metadata[:"x-goog-request-params"] ||= request_params_header
237
245
 
238
246
  options.apply_defaults timeout: @config.rpcs.create_namespace.timeout,
239
247
  metadata: metadata,
240
248
  retry_policy: @config.rpcs.create_namespace.retry_policy
241
- options.apply_defaults metadata: @config.metadata,
249
+
250
+ options.apply_defaults timeout: @config.timeout,
251
+ metadata: @config.metadata,
242
252
  retry_policy: @config.retry_policy
243
253
 
244
254
  @registration_service_stub.call_rpc :create_namespace, request, options: options do |response, operation|
@@ -318,6 +328,27 @@ module Google
318
328
  #
319
329
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
320
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
+ #
321
352
  def list_namespaces request, options = nil
322
353
  raise ::ArgumentError, "request must be provided" if request.nil?
323
354
 
@@ -335,16 +366,20 @@ module Google
335
366
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
336
367
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
337
368
 
338
- header_params = {
339
- "parent" => request.parent
340
- }
369
+ header_params = {}
370
+ if request.parent
371
+ header_params["parent"] = request.parent
372
+ end
373
+
341
374
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
342
375
  metadata[:"x-goog-request-params"] ||= request_params_header
343
376
 
344
377
  options.apply_defaults timeout: @config.rpcs.list_namespaces.timeout,
345
378
  metadata: metadata,
346
379
  retry_policy: @config.rpcs.list_namespaces.retry_policy
347
- options.apply_defaults metadata: @config.metadata,
380
+
381
+ options.apply_defaults timeout: @config.timeout,
382
+ metadata: @config.metadata,
348
383
  retry_policy: @config.retry_policy
349
384
 
350
385
  @registration_service_stub.call_rpc :list_namespaces, request, options: options do |response, operation|
@@ -385,6 +420,21 @@ module Google
385
420
  #
386
421
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
387
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
+ #
388
438
  def get_namespace request, options = nil
389
439
  raise ::ArgumentError, "request must be provided" if request.nil?
390
440
 
@@ -402,16 +452,20 @@ module Google
402
452
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
403
453
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
404
454
 
405
- header_params = {
406
- "name" => request.name
407
- }
455
+ header_params = {}
456
+ if request.name
457
+ header_params["name"] = request.name
458
+ end
459
+
408
460
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
409
461
  metadata[:"x-goog-request-params"] ||= request_params_header
410
462
 
411
463
  options.apply_defaults timeout: @config.rpcs.get_namespace.timeout,
412
464
  metadata: metadata,
413
465
  retry_policy: @config.rpcs.get_namespace.retry_policy
414
- options.apply_defaults metadata: @config.metadata,
466
+
467
+ options.apply_defaults timeout: @config.timeout,
468
+ metadata: @config.metadata,
415
469
  retry_policy: @config.retry_policy
416
470
 
417
471
  @registration_service_stub.call_rpc :get_namespace, request, options: options do |response, operation|
@@ -453,6 +507,21 @@ module Google
453
507
  #
454
508
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
455
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
+ #
456
525
  def update_namespace request, options = nil
457
526
  raise ::ArgumentError, "request must be provided" if request.nil?
458
527
 
@@ -470,16 +539,20 @@ module Google
470
539
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
471
540
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
472
541
 
473
- header_params = {
474
- "namespace.name" => request.namespace.name
475
- }
542
+ header_params = {}
543
+ if request.namespace&.name
544
+ header_params["namespace.name"] = request.namespace.name
545
+ end
546
+
476
547
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
477
548
  metadata[:"x-goog-request-params"] ||= request_params_header
478
549
 
479
550
  options.apply_defaults timeout: @config.rpcs.update_namespace.timeout,
480
551
  metadata: metadata,
481
552
  retry_policy: @config.rpcs.update_namespace.retry_policy
482
- options.apply_defaults metadata: @config.metadata,
553
+
554
+ options.apply_defaults timeout: @config.timeout,
555
+ metadata: @config.metadata,
483
556
  retry_policy: @config.retry_policy
484
557
 
485
558
  @registration_service_stub.call_rpc :update_namespace, request, options: options do |response, operation|
@@ -520,6 +593,21 @@ module Google
520
593
  #
521
594
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
522
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
+ #
523
611
  def delete_namespace request, options = nil
524
612
  raise ::ArgumentError, "request must be provided" if request.nil?
525
613
 
@@ -537,16 +625,20 @@ module Google
537
625
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
538
626
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
539
627
 
540
- header_params = {
541
- "name" => request.name
542
- }
628
+ header_params = {}
629
+ if request.name
630
+ header_params["name"] = request.name
631
+ end
632
+
543
633
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
544
634
  metadata[:"x-goog-request-params"] ||= request_params_header
545
635
 
546
636
  options.apply_defaults timeout: @config.rpcs.delete_namespace.timeout,
547
637
  metadata: metadata,
548
638
  retry_policy: @config.rpcs.delete_namespace.retry_policy
549
- options.apply_defaults metadata: @config.metadata,
639
+
640
+ options.apply_defaults timeout: @config.timeout,
641
+ metadata: @config.metadata,
550
642
  retry_policy: @config.retry_policy
551
643
 
552
644
  @registration_service_stub.call_rpc :delete_namespace, request, options: options do |response, operation|
@@ -596,6 +688,21 @@ module Google
596
688
  #
597
689
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
598
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
+ #
599
706
  def create_service request, options = nil
600
707
  raise ::ArgumentError, "request must be provided" if request.nil?
601
708
 
@@ -613,16 +720,20 @@ module Google
613
720
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
614
721
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
615
722
 
616
- header_params = {
617
- "parent" => request.parent
618
- }
723
+ header_params = {}
724
+ if request.parent
725
+ header_params["parent"] = request.parent
726
+ end
727
+
619
728
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
620
729
  metadata[:"x-goog-request-params"] ||= request_params_header
621
730
 
622
731
  options.apply_defaults timeout: @config.rpcs.create_service.timeout,
623
732
  metadata: metadata,
624
733
  retry_policy: @config.rpcs.create_service.retry_policy
625
- options.apply_defaults metadata: @config.metadata,
734
+
735
+ options.apply_defaults timeout: @config.timeout,
736
+ metadata: @config.metadata,
626
737
  retry_policy: @config.retry_policy
627
738
 
628
739
  @registration_service_stub.call_rpc :create_service, request, options: options do |response, operation|
@@ -694,6 +805,27 @@ module Google
694
805
  #
695
806
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
696
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
+ #
697
829
  def list_services request, options = nil
698
830
  raise ::ArgumentError, "request must be provided" if request.nil?
699
831
 
@@ -711,16 +843,20 @@ module Google
711
843
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
712
844
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
713
845
 
714
- header_params = {
715
- "parent" => request.parent
716
- }
846
+ header_params = {}
847
+ if request.parent
848
+ header_params["parent"] = request.parent
849
+ end
850
+
717
851
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
718
852
  metadata[:"x-goog-request-params"] ||= request_params_header
719
853
 
720
854
  options.apply_defaults timeout: @config.rpcs.list_services.timeout,
721
855
  metadata: metadata,
722
856
  retry_policy: @config.rpcs.list_services.retry_policy
723
- options.apply_defaults metadata: @config.metadata,
857
+
858
+ options.apply_defaults timeout: @config.timeout,
859
+ metadata: @config.metadata,
724
860
  retry_policy: @config.retry_policy
725
861
 
726
862
  @registration_service_stub.call_rpc :list_services, request, options: options do |response, operation|
@@ -761,6 +897,21 @@ module Google
761
897
  #
762
898
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
763
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
+ #
764
915
  def get_service request, options = nil
765
916
  raise ::ArgumentError, "request must be provided" if request.nil?
766
917
 
@@ -778,16 +929,20 @@ module Google
778
929
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
779
930
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
780
931
 
781
- header_params = {
782
- "name" => request.name
783
- }
932
+ header_params = {}
933
+ if request.name
934
+ header_params["name"] = request.name
935
+ end
936
+
784
937
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
785
938
  metadata[:"x-goog-request-params"] ||= request_params_header
786
939
 
787
940
  options.apply_defaults timeout: @config.rpcs.get_service.timeout,
788
941
  metadata: metadata,
789
942
  retry_policy: @config.rpcs.get_service.retry_policy
790
- options.apply_defaults metadata: @config.metadata,
943
+
944
+ options.apply_defaults timeout: @config.timeout,
945
+ metadata: @config.metadata,
791
946
  retry_policy: @config.retry_policy
792
947
 
793
948
  @registration_service_stub.call_rpc :get_service, request, options: options do |response, operation|
@@ -829,6 +984,21 @@ module Google
829
984
  #
830
985
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
831
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
+ #
832
1002
  def update_service request, options = nil
833
1003
  raise ::ArgumentError, "request must be provided" if request.nil?
834
1004
 
@@ -846,16 +1016,20 @@ module Google
846
1016
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
847
1017
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
848
1018
 
849
- header_params = {
850
- "service.name" => request.service.name
851
- }
1019
+ header_params = {}
1020
+ if request.service&.name
1021
+ header_params["service.name"] = request.service.name
1022
+ end
1023
+
852
1024
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
853
1025
  metadata[:"x-goog-request-params"] ||= request_params_header
854
1026
 
855
1027
  options.apply_defaults timeout: @config.rpcs.update_service.timeout,
856
1028
  metadata: metadata,
857
1029
  retry_policy: @config.rpcs.update_service.retry_policy
858
- options.apply_defaults metadata: @config.metadata,
1030
+
1031
+ options.apply_defaults timeout: @config.timeout,
1032
+ metadata: @config.metadata,
859
1033
  retry_policy: @config.retry_policy
860
1034
 
861
1035
  @registration_service_stub.call_rpc :update_service, request, options: options do |response, operation|
@@ -896,6 +1070,21 @@ module Google
896
1070
  #
897
1071
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
898
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
+ #
899
1088
  def delete_service request, options = nil
900
1089
  raise ::ArgumentError, "request must be provided" if request.nil?
901
1090
 
@@ -913,16 +1102,20 @@ module Google
913
1102
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
914
1103
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
915
1104
 
916
- header_params = {
917
- "name" => request.name
918
- }
1105
+ header_params = {}
1106
+ if request.name
1107
+ header_params["name"] = request.name
1108
+ end
1109
+
919
1110
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
920
1111
  metadata[:"x-goog-request-params"] ||= request_params_header
921
1112
 
922
1113
  options.apply_defaults timeout: @config.rpcs.delete_service.timeout,
923
1114
  metadata: metadata,
924
1115
  retry_policy: @config.rpcs.delete_service.retry_policy
925
- options.apply_defaults metadata: @config.metadata,
1116
+
1117
+ options.apply_defaults timeout: @config.timeout,
1118
+ metadata: @config.metadata,
926
1119
  retry_policy: @config.retry_policy
927
1120
 
928
1121
  @registration_service_stub.call_rpc :delete_service, request, options: options do |response, operation|
@@ -972,6 +1165,21 @@ module Google
972
1165
  #
973
1166
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
974
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
+ #
975
1183
  def create_endpoint request, options = nil
976
1184
  raise ::ArgumentError, "request must be provided" if request.nil?
977
1185
 
@@ -989,16 +1197,20 @@ module Google
989
1197
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
990
1198
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
991
1199
 
992
- header_params = {
993
- "parent" => request.parent
994
- }
1200
+ header_params = {}
1201
+ if request.parent
1202
+ header_params["parent"] = request.parent
1203
+ end
1204
+
995
1205
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
996
1206
  metadata[:"x-goog-request-params"] ||= request_params_header
997
1207
 
998
1208
  options.apply_defaults timeout: @config.rpcs.create_endpoint.timeout,
999
1209
  metadata: metadata,
1000
1210
  retry_policy: @config.rpcs.create_endpoint.retry_policy
1001
- options.apply_defaults metadata: @config.metadata,
1211
+
1212
+ options.apply_defaults timeout: @config.timeout,
1213
+ metadata: @config.metadata,
1002
1214
  retry_policy: @config.retry_policy
1003
1215
 
1004
1216
  @registration_service_stub.call_rpc :create_endpoint, request, options: options do |response, operation|
@@ -1072,6 +1284,27 @@ module Google
1072
1284
  #
1073
1285
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1074
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
+ #
1075
1308
  def list_endpoints request, options = nil
1076
1309
  raise ::ArgumentError, "request must be provided" if request.nil?
1077
1310
 
@@ -1089,16 +1322,20 @@ module Google
1089
1322
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1090
1323
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1091
1324
 
1092
- header_params = {
1093
- "parent" => request.parent
1094
- }
1325
+ header_params = {}
1326
+ if request.parent
1327
+ header_params["parent"] = request.parent
1328
+ end
1329
+
1095
1330
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1096
1331
  metadata[:"x-goog-request-params"] ||= request_params_header
1097
1332
 
1098
1333
  options.apply_defaults timeout: @config.rpcs.list_endpoints.timeout,
1099
1334
  metadata: metadata,
1100
1335
  retry_policy: @config.rpcs.list_endpoints.retry_policy
1101
- options.apply_defaults metadata: @config.metadata,
1336
+
1337
+ options.apply_defaults timeout: @config.timeout,
1338
+ metadata: @config.metadata,
1102
1339
  retry_policy: @config.retry_policy
1103
1340
 
1104
1341
  @registration_service_stub.call_rpc :list_endpoints, request, options: options do |response, operation|
@@ -1139,6 +1376,21 @@ module Google
1139
1376
  #
1140
1377
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1141
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
+ #
1142
1394
  def get_endpoint request, options = nil
1143
1395
  raise ::ArgumentError, "request must be provided" if request.nil?
1144
1396
 
@@ -1156,16 +1408,20 @@ module Google
1156
1408
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1157
1409
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1158
1410
 
1159
- header_params = {
1160
- "name" => request.name
1161
- }
1411
+ header_params = {}
1412
+ if request.name
1413
+ header_params["name"] = request.name
1414
+ end
1415
+
1162
1416
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1163
1417
  metadata[:"x-goog-request-params"] ||= request_params_header
1164
1418
 
1165
1419
  options.apply_defaults timeout: @config.rpcs.get_endpoint.timeout,
1166
1420
  metadata: metadata,
1167
1421
  retry_policy: @config.rpcs.get_endpoint.retry_policy
1168
- options.apply_defaults metadata: @config.metadata,
1422
+
1423
+ options.apply_defaults timeout: @config.timeout,
1424
+ metadata: @config.metadata,
1169
1425
  retry_policy: @config.retry_policy
1170
1426
 
1171
1427
  @registration_service_stub.call_rpc :get_endpoint, request, options: options do |response, operation|
@@ -1207,6 +1463,21 @@ module Google
1207
1463
  #
1208
1464
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1209
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
+ #
1210
1481
  def update_endpoint request, options = nil
1211
1482
  raise ::ArgumentError, "request must be provided" if request.nil?
1212
1483
 
@@ -1224,16 +1495,20 @@ module Google
1224
1495
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1225
1496
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1226
1497
 
1227
- header_params = {
1228
- "endpoint.name" => request.endpoint.name
1229
- }
1498
+ header_params = {}
1499
+ if request.endpoint&.name
1500
+ header_params["endpoint.name"] = request.endpoint.name
1501
+ end
1502
+
1230
1503
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1231
1504
  metadata[:"x-goog-request-params"] ||= request_params_header
1232
1505
 
1233
1506
  options.apply_defaults timeout: @config.rpcs.update_endpoint.timeout,
1234
1507
  metadata: metadata,
1235
1508
  retry_policy: @config.rpcs.update_endpoint.retry_policy
1236
- options.apply_defaults metadata: @config.metadata,
1509
+
1510
+ options.apply_defaults timeout: @config.timeout,
1511
+ metadata: @config.metadata,
1237
1512
  retry_policy: @config.retry_policy
1238
1513
 
1239
1514
  @registration_service_stub.call_rpc :update_endpoint, request, options: options do |response, operation|
@@ -1273,6 +1548,21 @@ module Google
1273
1548
  #
1274
1549
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1275
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
+ #
1276
1566
  def delete_endpoint request, options = nil
1277
1567
  raise ::ArgumentError, "request must be provided" if request.nil?
1278
1568
 
@@ -1290,16 +1580,20 @@ module Google
1290
1580
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1291
1581
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1292
1582
 
1293
- header_params = {
1294
- "name" => request.name
1295
- }
1583
+ header_params = {}
1584
+ if request.name
1585
+ header_params["name"] = request.name
1586
+ end
1587
+
1296
1588
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1297
1589
  metadata[:"x-goog-request-params"] ||= request_params_header
1298
1590
 
1299
1591
  options.apply_defaults timeout: @config.rpcs.delete_endpoint.timeout,
1300
1592
  metadata: metadata,
1301
1593
  retry_policy: @config.rpcs.delete_endpoint.retry_policy
1302
- options.apply_defaults metadata: @config.metadata,
1594
+
1595
+ options.apply_defaults timeout: @config.timeout,
1596
+ metadata: @config.metadata,
1303
1597
  retry_policy: @config.retry_policy
1304
1598
 
1305
1599
  @registration_service_stub.call_rpc :delete_endpoint, request, options: options do |response, operation|
@@ -1343,6 +1637,21 @@ module Google
1343
1637
  #
1344
1638
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1345
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
+ #
1346
1655
  def get_iam_policy request, options = nil
1347
1656
  raise ::ArgumentError, "request must be provided" if request.nil?
1348
1657
 
@@ -1360,16 +1669,20 @@ module Google
1360
1669
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1361
1670
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1362
1671
 
1363
- header_params = {
1364
- "resource" => request.resource
1365
- }
1672
+ header_params = {}
1673
+ if request.resource
1674
+ header_params["resource"] = request.resource
1675
+ end
1676
+
1366
1677
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1367
1678
  metadata[:"x-goog-request-params"] ||= request_params_header
1368
1679
 
1369
1680
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
1370
1681
  metadata: metadata,
1371
1682
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
1372
- options.apply_defaults metadata: @config.metadata,
1683
+
1684
+ options.apply_defaults timeout: @config.timeout,
1685
+ metadata: @config.metadata,
1373
1686
  retry_policy: @config.retry_policy
1374
1687
 
1375
1688
  @registration_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -1415,6 +1728,21 @@ module Google
1415
1728
  #
1416
1729
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1417
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
+ #
1418
1746
  def set_iam_policy request, options = nil
1419
1747
  raise ::ArgumentError, "request must be provided" if request.nil?
1420
1748
 
@@ -1432,16 +1760,20 @@ module Google
1432
1760
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1433
1761
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1434
1762
 
1435
- header_params = {
1436
- "resource" => request.resource
1437
- }
1763
+ header_params = {}
1764
+ if request.resource
1765
+ header_params["resource"] = request.resource
1766
+ end
1767
+
1438
1768
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1439
1769
  metadata[:"x-goog-request-params"] ||= request_params_header
1440
1770
 
1441
1771
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
1442
1772
  metadata: metadata,
1443
1773
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
1444
- options.apply_defaults metadata: @config.metadata,
1774
+
1775
+ options.apply_defaults timeout: @config.timeout,
1776
+ metadata: @config.metadata,
1445
1777
  retry_policy: @config.retry_policy
1446
1778
 
1447
1779
  @registration_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -1487,6 +1819,21 @@ module Google
1487
1819
  #
1488
1820
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1489
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
+ #
1490
1837
  def test_iam_permissions request, options = nil
1491
1838
  raise ::ArgumentError, "request must be provided" if request.nil?
1492
1839
 
@@ -1504,16 +1851,20 @@ module Google
1504
1851
  gapic_version: ::Google::Cloud::ServiceDirectory::V1::VERSION
1505
1852
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1506
1853
 
1507
- header_params = {
1508
- "resource" => request.resource
1509
- }
1854
+ header_params = {}
1855
+ if request.resource
1856
+ header_params["resource"] = request.resource
1857
+ end
1858
+
1510
1859
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1511
1860
  metadata[:"x-goog-request-params"] ||= request_params_header
1512
1861
 
1513
1862
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
1514
1863
  metadata: metadata,
1515
1864
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
1516
- options.apply_defaults metadata: @config.metadata,
1865
+
1866
+ options.apply_defaults timeout: @config.timeout,
1867
+ metadata: @config.metadata,
1517
1868
  retry_policy: @config.retry_policy
1518
1869
 
1519
1870
  @registration_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -1537,22 +1888,21 @@ module Google
1537
1888
  # Configuration can be applied globally to all clients, or to a single client
1538
1889
  # on construction.
1539
1890
  #
1540
- # # Examples
1541
- #
1542
- # To modify the global config, setting the timeout for create_namespace
1543
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1544
- #
1545
- # ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.configure do |config|
1546
- # config.timeout = 10.0
1547
- # config.rpcs.create_namespace.timeout = 20.0
1548
- # end
1549
- #
1550
- # To apply the above configuration only to a new client:
1551
- #
1552
- # client = ::Google::Cloud::ServiceDirectory::V1::RegistrationService::Client.new do |config|
1553
- # config.timeout = 10.0
1554
- # config.rpcs.create_namespace.timeout = 20.0
1555
- # 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
1556
1906
  #
1557
1907
  # @!attribute [rw] endpoint
1558
1908
  # The hostname or hostname:port of the service endpoint.