google-cloud-logging-v2 0.5.1 → 0.5.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (19) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +1 -1
  4. data/lib/google/cloud/logging/v2/config_service/client.rb +590 -157
  5. data/lib/google/cloud/logging/v2/logging_service/client.rb +175 -73
  6. data/lib/google/cloud/logging/v2/metrics_service/client.rb +155 -73
  7. data/lib/google/cloud/logging/v2/version.rb +1 -1
  8. data/lib/google/logging/v2/log_entry_pb.rb +2 -2
  9. data/lib/google/logging/v2/logging_config_pb.rb +2 -2
  10. data/lib/google/logging/v2/logging_metrics_pb.rb +2 -2
  11. data/lib/google/logging/v2/logging_pb.rb +2 -2
  12. data/proto_docs/google/api/distribution.rb +2 -2
  13. data/proto_docs/google/api/field_behavior.rb +7 -1
  14. data/proto_docs/google/api/launch_stage.rb +71 -0
  15. data/proto_docs/google/api/metric.rb +109 -36
  16. data/proto_docs/google/api/monitored_resource.rb +7 -6
  17. metadata +5 -6
  18. data/lib/google/logging/type/http_request_pb.rb +0 -38
  19. data/lib/google/logging/type/log_severity_pb.rb +0 -31
data/lib/google/cloud/logging/v2/config_service/client.rb CHANGED
@@ -41,13 +41,12 @@ module Google
41
41
  # See {::Google::Cloud::Logging::V2::ConfigService::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
- # ## Example
44
+ # @example
45
45
  #
46
- # To modify the configuration for all ConfigService clients:
47
- #
48
- # ::Google::Cloud::Logging::V2::ConfigService::Client.configure do |config|
49
- # config.timeout = 10.0
50
- # end
46
+ # # Modify the configuration for all ConfigService clients
47
+ # ::Google::Cloud::Logging::V2::ConfigService::Client.configure do |config|
48
+ # config.timeout = 10.0
49
+ # end
51
50
  #
52
51
  # @yield [config] Configure the Client client.
53
52
  # @yieldparam config [Client::Configuration]
@@ -67,52 +66,34 @@ module Google
67
66
 
68
67
  default_config.rpcs.list_sinks.timeout = 60.0
69
68
  default_config.rpcs.list_sinks.retry_policy = {
70
- initial_delay: 0.1,
71
- max_delay: 60.0,
72
- multiplier: 1.3,
73
- retry_codes: [4, 13, 14]
69
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
74
70
  }
75
71
 
76
72
  default_config.rpcs.get_sink.timeout = 60.0
77
73
  default_config.rpcs.get_sink.retry_policy = {
78
- initial_delay: 0.1,
79
- max_delay: 60.0,
80
- multiplier: 1.3,
81
- retry_codes: [4, 13, 14]
74
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
82
75
  }
83
76
 
84
77
  default_config.rpcs.create_sink.timeout = 120.0
85
78
 
86
79
  default_config.rpcs.update_sink.timeout = 60.0
87
80
  default_config.rpcs.update_sink.retry_policy = {
88
- initial_delay: 0.1,
89
- max_delay: 60.0,
90
- multiplier: 1.3,
91
- retry_codes: [4, 13, 14]
81
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
92
82
  }
93
83
 
94
84
  default_config.rpcs.delete_sink.timeout = 60.0
95
85
  default_config.rpcs.delete_sink.retry_policy = {
96
- initial_delay: 0.1,
97
- max_delay: 60.0,
98
- multiplier: 1.3,
99
- retry_codes: [4, 13, 14]
86
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
100
87
  }
101
88
 
102
89
  default_config.rpcs.list_exclusions.timeout = 60.0
103
90
  default_config.rpcs.list_exclusions.retry_policy = {
104
- initial_delay: 0.1,
105
- max_delay: 60.0,
106
- multiplier: 1.3,
107
- retry_codes: [4, 13, 14]
91
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
108
92
  }
109
93
 
110
94
  default_config.rpcs.get_exclusion.timeout = 60.0
111
95
  default_config.rpcs.get_exclusion.retry_policy = {
112
- initial_delay: 0.1,
113
- max_delay: 60.0,
114
- multiplier: 1.3,
115
- retry_codes: [4, 13, 14]
96
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
116
97
  }
117
98
 
118
99
  default_config.rpcs.create_exclusion.timeout = 120.0
@@ -121,10 +102,7 @@ module Google
121
102
 
122
103
  default_config.rpcs.delete_exclusion.timeout = 60.0
123
104
  default_config.rpcs.delete_exclusion.retry_policy = {
124
- initial_delay: 0.1,
125
- max_delay: 60.0,
126
- multiplier: 1.3,
127
- retry_codes: [4, 13, 14]
105
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 13, 14]
128
106
  }
129
107
 
130
108
  default_config
@@ -156,19 +134,15 @@ module Google
156
134
  ##
157
135
  # Create a new ConfigService client object.
158
136
  #
159
- # ## Examples
160
- #
161
- # To create a new ConfigService client with the default
162
- # configuration:
163
- #
164
- # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new
137
+ # @example
165
138
  #
166
- # To create a new ConfigService client with a custom
167
- # configuration:
139
+ # # Create a client using the default configuration
140
+ # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new
168
141
  #
169
- # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new do |config|
170
- # config.timeout = 10.0
171
- # end
142
+ # # Create a client using a custom configuration
143
+ # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new do |config|
144
+ # config.timeout = 10.0
145
+ # end
172
146
  #
173
147
  # @yield [config] Configure the ConfigService client.
174
148
  # @yieldparam config [Client::Configuration]
@@ -188,14 +162,13 @@ module Google
188
162
 
189
163
  # Create credentials
190
164
  credentials = @config.credentials
191
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
165
+ # Use self-signed JWT if the endpoint is unchanged from default,
192
166
  # but only if the default endpoint does not have a region prefix.
193
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
194
- @config.endpoint == Client.configure.endpoint &&
167
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
195
168
  !@config.endpoint.split(".").first.include?("-")
196
169
  credentials ||= Credentials.default scope: @config.scope,
197
170
  enable_self_signed_jwt: enable_self_signed_jwt
198
- if credentials.is_a?(String) || credentials.is_a?(Hash)
171
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
199
172
  credentials = Credentials.new credentials, scope: @config.scope
200
173
  end
201
174
  @quota_project_id = @config.quota_project
@@ -259,6 +232,27 @@ module Google
259
232
  #
260
233
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
261
234
  #
235
+ # @example Basic example
236
+ # require "google/cloud/logging/v2"
237
+ #
238
+ # # Create a client object. The client can be reused for multiple calls.
239
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
240
+ #
241
+ # # Create a request. To set request fields, pass in keyword arguments.
242
+ # request = Google::Cloud::Logging::V2::ListBucketsRequest.new
243
+ #
244
+ # # Call the list_buckets method.
245
+ # result = client.list_buckets request
246
+ #
247
+ # # The returned object is of type Gapic::PagedEnumerable. You can
248
+ # # iterate over all elements by calling #each, and the enumerable
249
+ # # will lazily make API calls to fetch subsequent pages. Other
250
+ # # methods are also available for managing paging directly.
251
+ # result.each do |response|
252
+ # # Each element is of type ::Google::Cloud::Logging::V2::LogBucket.
253
+ # p response
254
+ # end
255
+ #
262
256
  def list_buckets request, options = nil
263
257
  raise ::ArgumentError, "request must be provided" if request.nil?
264
258
 
@@ -276,16 +270,20 @@ module Google
276
270
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
277
271
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
278
272
 
279
- header_params = {
280
- "parent" => request.parent
281
- }
273
+ header_params = {}
274
+ if request.parent
275
+ header_params["parent"] = request.parent
276
+ end
277
+
282
278
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
283
279
  metadata[:"x-goog-request-params"] ||= request_params_header
284
280
 
285
281
  options.apply_defaults timeout: @config.rpcs.list_buckets.timeout,
286
282
  metadata: metadata,
287
283
  retry_policy: @config.rpcs.list_buckets.retry_policy
288
- options.apply_defaults metadata: @config.metadata,
284
+
285
+ options.apply_defaults timeout: @config.timeout,
286
+ metadata: @config.metadata,
289
287
  retry_policy: @config.retry_policy
290
288
 
291
289
  @config_service_stub.call_rpc :list_buckets, request, options: options do |response, operation|
@@ -334,6 +332,21 @@ module Google
334
332
  #
335
333
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
336
334
  #
335
+ # @example Basic example
336
+ # require "google/cloud/logging/v2"
337
+ #
338
+ # # Create a client object. The client can be reused for multiple calls.
339
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
340
+ #
341
+ # # Create a request. To set request fields, pass in keyword arguments.
342
+ # request = Google::Cloud::Logging::V2::GetBucketRequest.new
343
+ #
344
+ # # Call the get_bucket method.
345
+ # result = client.get_bucket request
346
+ #
347
+ # # The returned object is of type Google::Cloud::Logging::V2::LogBucket.
348
+ # p result
349
+ #
337
350
  def get_bucket request, options = nil
338
351
  raise ::ArgumentError, "request must be provided" if request.nil?
339
352
 
@@ -351,16 +364,20 @@ module Google
351
364
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
352
365
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
353
366
 
354
- header_params = {
355
- "name" => request.name
356
- }
367
+ header_params = {}
368
+ if request.name
369
+ header_params["name"] = request.name
370
+ end
371
+
357
372
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
358
373
  metadata[:"x-goog-request-params"] ||= request_params_header
359
374
 
360
375
  options.apply_defaults timeout: @config.rpcs.get_bucket.timeout,
361
376
  metadata: metadata,
362
377
  retry_policy: @config.rpcs.get_bucket.retry_policy
363
- options.apply_defaults metadata: @config.metadata,
378
+
379
+ options.apply_defaults timeout: @config.timeout,
380
+ metadata: @config.metadata,
364
381
  retry_policy: @config.retry_policy
365
382
 
366
383
  @config_service_stub.call_rpc :get_bucket, request, options: options do |response, operation|
@@ -413,6 +430,21 @@ module Google
413
430
  #
414
431
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
415
432
  #
433
+ # @example Basic example
434
+ # require "google/cloud/logging/v2"
435
+ #
436
+ # # Create a client object. The client can be reused for multiple calls.
437
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
438
+ #
439
+ # # Create a request. To set request fields, pass in keyword arguments.
440
+ # request = Google::Cloud::Logging::V2::CreateBucketRequest.new
441
+ #
442
+ # # Call the create_bucket method.
443
+ # result = client.create_bucket request
444
+ #
445
+ # # The returned object is of type Google::Cloud::Logging::V2::LogBucket.
446
+ # p result
447
+ #
416
448
  def create_bucket request, options = nil
417
449
  raise ::ArgumentError, "request must be provided" if request.nil?
418
450
 
@@ -430,16 +462,20 @@ module Google
430
462
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
431
463
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
432
464
 
433
- header_params = {
434
- "parent" => request.parent
435
- }
465
+ header_params = {}
466
+ if request.parent
467
+ header_params["parent"] = request.parent
468
+ end
469
+
436
470
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
437
471
  metadata[:"x-goog-request-params"] ||= request_params_header
438
472
 
439
473
  options.apply_defaults timeout: @config.rpcs.create_bucket.timeout,
440
474
  metadata: metadata,
441
475
  retry_policy: @config.rpcs.create_bucket.retry_policy
442
- options.apply_defaults metadata: @config.metadata,
476
+
477
+ options.apply_defaults timeout: @config.timeout,
478
+ metadata: @config.metadata,
443
479
  retry_policy: @config.retry_policy
444
480
 
445
481
  @config_service_stub.call_rpc :create_bucket, request, options: options do |response, operation|
@@ -509,6 +545,21 @@ module Google
509
545
  #
510
546
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
511
547
  #
548
+ # @example Basic example
549
+ # require "google/cloud/logging/v2"
550
+ #
551
+ # # Create a client object. The client can be reused for multiple calls.
552
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
553
+ #
554
+ # # Create a request. To set request fields, pass in keyword arguments.
555
+ # request = Google::Cloud::Logging::V2::UpdateBucketRequest.new
556
+ #
557
+ # # Call the update_bucket method.
558
+ # result = client.update_bucket request
559
+ #
560
+ # # The returned object is of type Google::Cloud::Logging::V2::LogBucket.
561
+ # p result
562
+ #
512
563
  def update_bucket request, options = nil
513
564
  raise ::ArgumentError, "request must be provided" if request.nil?
514
565
 
@@ -526,16 +577,20 @@ module Google
526
577
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
527
578
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
528
579
 
529
- header_params = {
530
- "name" => request.name
531
- }
580
+ header_params = {}
581
+ if request.name
582
+ header_params["name"] = request.name
583
+ end
584
+
532
585
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
533
586
  metadata[:"x-goog-request-params"] ||= request_params_header
534
587
 
535
588
  options.apply_defaults timeout: @config.rpcs.update_bucket.timeout,
536
589
  metadata: metadata,
537
590
  retry_policy: @config.rpcs.update_bucket.retry_policy
538
- options.apply_defaults metadata: @config.metadata,
591
+
592
+ options.apply_defaults timeout: @config.timeout,
593
+ metadata: @config.metadata,
539
594
  retry_policy: @config.retry_policy
540
595
 
541
596
  @config_service_stub.call_rpc :update_bucket, request, options: options do |response, operation|
@@ -586,6 +641,21 @@ module Google
586
641
  #
587
642
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
588
643
  #
644
+ # @example Basic example
645
+ # require "google/cloud/logging/v2"
646
+ #
647
+ # # Create a client object. The client can be reused for multiple calls.
648
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
649
+ #
650
+ # # Create a request. To set request fields, pass in keyword arguments.
651
+ # request = Google::Cloud::Logging::V2::DeleteBucketRequest.new
652
+ #
653
+ # # Call the delete_bucket method.
654
+ # result = client.delete_bucket request
655
+ #
656
+ # # The returned object is of type Google::Protobuf::Empty.
657
+ # p result
658
+ #
589
659
  def delete_bucket request, options = nil
590
660
  raise ::ArgumentError, "request must be provided" if request.nil?
591
661
 
@@ -603,16 +673,20 @@ module Google
603
673
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
604
674
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
605
675
 
606
- header_params = {
607
- "name" => request.name
608
- }
676
+ header_params = {}
677
+ if request.name
678
+ header_params["name"] = request.name
679
+ end
680
+
609
681
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
610
682
  metadata[:"x-goog-request-params"] ||= request_params_header
611
683
 
612
684
  options.apply_defaults timeout: @config.rpcs.delete_bucket.timeout,
613
685
  metadata: metadata,
614
686
  retry_policy: @config.rpcs.delete_bucket.retry_policy
615
- options.apply_defaults metadata: @config.metadata,
687
+
688
+ options.apply_defaults timeout: @config.timeout,
689
+ metadata: @config.metadata,
616
690
  retry_policy: @config.retry_policy
617
691
 
618
692
  @config_service_stub.call_rpc :delete_bucket, request, options: options do |response, operation|
@@ -661,6 +735,21 @@ module Google
661
735
  #
662
736
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
663
737
  #
738
+ # @example Basic example
739
+ # require "google/cloud/logging/v2"
740
+ #
741
+ # # Create a client object. The client can be reused for multiple calls.
742
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
743
+ #
744
+ # # Create a request. To set request fields, pass in keyword arguments.
745
+ # request = Google::Cloud::Logging::V2::UndeleteBucketRequest.new
746
+ #
747
+ # # Call the undelete_bucket method.
748
+ # result = client.undelete_bucket request
749
+ #
750
+ # # The returned object is of type Google::Protobuf::Empty.
751
+ # p result
752
+ #
664
753
  def undelete_bucket request, options = nil
665
754
  raise ::ArgumentError, "request must be provided" if request.nil?
666
755
 
@@ -678,16 +767,20 @@ module Google
678
767
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
679
768
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
680
769
 
681
- header_params = {
682
- "name" => request.name
683
- }
770
+ header_params = {}
771
+ if request.name
772
+ header_params["name"] = request.name
773
+ end
774
+
684
775
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
685
776
  metadata[:"x-goog-request-params"] ||= request_params_header
686
777
 
687
778
  options.apply_defaults timeout: @config.rpcs.undelete_bucket.timeout,
688
779
  metadata: metadata,
689
780
  retry_policy: @config.rpcs.undelete_bucket.retry_policy
690
- options.apply_defaults metadata: @config.metadata,
781
+
782
+ options.apply_defaults timeout: @config.timeout,
783
+ metadata: @config.metadata,
691
784
  retry_policy: @config.retry_policy
692
785
 
693
786
  @config_service_stub.call_rpc :undelete_bucket, request, options: options do |response, operation|
@@ -738,6 +831,27 @@ module Google
738
831
  #
739
832
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
740
833
  #
834
+ # @example Basic example
835
+ # require "google/cloud/logging/v2"
836
+ #
837
+ # # Create a client object. The client can be reused for multiple calls.
838
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
839
+ #
840
+ # # Create a request. To set request fields, pass in keyword arguments.
841
+ # request = Google::Cloud::Logging::V2::ListViewsRequest.new
842
+ #
843
+ # # Call the list_views method.
844
+ # result = client.list_views request
845
+ #
846
+ # # The returned object is of type Gapic::PagedEnumerable. You can
847
+ # # iterate over all elements by calling #each, and the enumerable
848
+ # # will lazily make API calls to fetch subsequent pages. Other
849
+ # # methods are also available for managing paging directly.
850
+ # result.each do |response|
851
+ # # Each element is of type ::Google::Cloud::Logging::V2::LogView.
852
+ # p response
853
+ # end
854
+ #
741
855
  def list_views request, options = nil
742
856
  raise ::ArgumentError, "request must be provided" if request.nil?
743
857
 
@@ -755,16 +869,20 @@ module Google
755
869
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
756
870
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
757
871
 
758
- header_params = {
759
- "parent" => request.parent
760
- }
872
+ header_params = {}
873
+ if request.parent
874
+ header_params["parent"] = request.parent
875
+ end
876
+
761
877
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
762
878
  metadata[:"x-goog-request-params"] ||= request_params_header
763
879
 
764
880
  options.apply_defaults timeout: @config.rpcs.list_views.timeout,
765
881
  metadata: metadata,
766
882
  retry_policy: @config.rpcs.list_views.retry_policy
767
- options.apply_defaults metadata: @config.metadata,
883
+
884
+ options.apply_defaults timeout: @config.timeout,
885
+ metadata: @config.metadata,
768
886
  retry_policy: @config.retry_policy
769
887
 
770
888
  @config_service_stub.call_rpc :list_views, request, options: options do |response, operation|
@@ -810,6 +928,21 @@ module Google
810
928
  #
811
929
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
812
930
  #
931
+ # @example Basic example
932
+ # require "google/cloud/logging/v2"
933
+ #
934
+ # # Create a client object. The client can be reused for multiple calls.
935
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
936
+ #
937
+ # # Create a request. To set request fields, pass in keyword arguments.
938
+ # request = Google::Cloud::Logging::V2::GetViewRequest.new
939
+ #
940
+ # # Call the get_view method.
941
+ # result = client.get_view request
942
+ #
943
+ # # The returned object is of type Google::Cloud::Logging::V2::LogView.
944
+ # p result
945
+ #
813
946
  def get_view request, options = nil
814
947
  raise ::ArgumentError, "request must be provided" if request.nil?
815
948
 
@@ -827,16 +960,20 @@ module Google
827
960
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
828
961
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
829
962
 
830
- header_params = {
831
- "name" => request.name
832
- }
963
+ header_params = {}
964
+ if request.name
965
+ header_params["name"] = request.name
966
+ end
967
+
833
968
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
834
969
  metadata[:"x-goog-request-params"] ||= request_params_header
835
970
 
836
971
  options.apply_defaults timeout: @config.rpcs.get_view.timeout,
837
972
  metadata: metadata,
838
973
  retry_policy: @config.rpcs.get_view.retry_policy
839
- options.apply_defaults metadata: @config.metadata,
974
+
975
+ options.apply_defaults timeout: @config.timeout,
976
+ metadata: @config.metadata,
840
977
  retry_policy: @config.retry_policy
841
978
 
842
979
  @config_service_stub.call_rpc :get_view, request, options: options do |response, operation|
@@ -886,6 +1023,21 @@ module Google
886
1023
  #
887
1024
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
888
1025
  #
1026
+ # @example Basic example
1027
+ # require "google/cloud/logging/v2"
1028
+ #
1029
+ # # Create a client object. The client can be reused for multiple calls.
1030
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1031
+ #
1032
+ # # Create a request. To set request fields, pass in keyword arguments.
1033
+ # request = Google::Cloud::Logging::V2::CreateViewRequest.new
1034
+ #
1035
+ # # Call the create_view method.
1036
+ # result = client.create_view request
1037
+ #
1038
+ # # The returned object is of type Google::Cloud::Logging::V2::LogView.
1039
+ # p result
1040
+ #
889
1041
  def create_view request, options = nil
890
1042
  raise ::ArgumentError, "request must be provided" if request.nil?
891
1043
 
@@ -903,16 +1055,20 @@ module Google
903
1055
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
904
1056
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
905
1057
 
906
- header_params = {
907
- "parent" => request.parent
908
- }
1058
+ header_params = {}
1059
+ if request.parent
1060
+ header_params["parent"] = request.parent
1061
+ end
1062
+
909
1063
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
910
1064
  metadata[:"x-goog-request-params"] ||= request_params_header
911
1065
 
912
1066
  options.apply_defaults timeout: @config.rpcs.create_view.timeout,
913
1067
  metadata: metadata,
914
1068
  retry_policy: @config.rpcs.create_view.retry_policy
915
- options.apply_defaults metadata: @config.metadata,
1069
+
1070
+ options.apply_defaults timeout: @config.timeout,
1071
+ metadata: @config.metadata,
916
1072
  retry_policy: @config.retry_policy
917
1073
 
918
1074
  @config_service_stub.call_rpc :create_view, request, options: options do |response, operation|
@@ -969,6 +1125,21 @@ module Google
969
1125
  #
970
1126
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
971
1127
  #
1128
+ # @example Basic example
1129
+ # require "google/cloud/logging/v2"
1130
+ #
1131
+ # # Create a client object. The client can be reused for multiple calls.
1132
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1133
+ #
1134
+ # # Create a request. To set request fields, pass in keyword arguments.
1135
+ # request = Google::Cloud::Logging::V2::UpdateViewRequest.new
1136
+ #
1137
+ # # Call the update_view method.
1138
+ # result = client.update_view request
1139
+ #
1140
+ # # The returned object is of type Google::Cloud::Logging::V2::LogView.
1141
+ # p result
1142
+ #
972
1143
  def update_view request, options = nil
973
1144
  raise ::ArgumentError, "request must be provided" if request.nil?
974
1145
 
@@ -986,16 +1157,20 @@ module Google
986
1157
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
987
1158
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
988
1159
 
989
- header_params = {
990
- "name" => request.name
991
- }
1160
+ header_params = {}
1161
+ if request.name
1162
+ header_params["name"] = request.name
1163
+ end
1164
+
992
1165
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
993
1166
  metadata[:"x-goog-request-params"] ||= request_params_header
994
1167
 
995
1168
  options.apply_defaults timeout: @config.rpcs.update_view.timeout,
996
1169
  metadata: metadata,
997
1170
  retry_policy: @config.rpcs.update_view.retry_policy
998
- options.apply_defaults metadata: @config.metadata,
1171
+
1172
+ options.apply_defaults timeout: @config.timeout,
1173
+ metadata: @config.metadata,
999
1174
  retry_policy: @config.retry_policy
1000
1175
 
1001
1176
  @config_service_stub.call_rpc :update_view, request, options: options do |response, operation|
@@ -1040,6 +1215,21 @@ module Google
1040
1215
  #
1041
1216
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1042
1217
  #
1218
+ # @example Basic example
1219
+ # require "google/cloud/logging/v2"
1220
+ #
1221
+ # # Create a client object. The client can be reused for multiple calls.
1222
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1223
+ #
1224
+ # # Create a request. To set request fields, pass in keyword arguments.
1225
+ # request = Google::Cloud::Logging::V2::DeleteViewRequest.new
1226
+ #
1227
+ # # Call the delete_view method.
1228
+ # result = client.delete_view request
1229
+ #
1230
+ # # The returned object is of type Google::Protobuf::Empty.
1231
+ # p result
1232
+ #
1043
1233
  def delete_view request, options = nil
1044
1234
  raise ::ArgumentError, "request must be provided" if request.nil?
1045
1235
 
@@ -1057,16 +1247,20 @@ module Google
1057
1247
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1058
1248
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1059
1249
 
1060
- header_params = {
1061
- "name" => request.name
1062
- }
1250
+ header_params = {}
1251
+ if request.name
1252
+ header_params["name"] = request.name
1253
+ end
1254
+
1063
1255
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1064
1256
  metadata[:"x-goog-request-params"] ||= request_params_header
1065
1257
 
1066
1258
  options.apply_defaults timeout: @config.rpcs.delete_view.timeout,
1067
1259
  metadata: metadata,
1068
1260
  retry_policy: @config.rpcs.delete_view.retry_policy
1069
- options.apply_defaults metadata: @config.metadata,
1261
+
1262
+ options.apply_defaults timeout: @config.timeout,
1263
+ metadata: @config.metadata,
1070
1264
  retry_policy: @config.retry_policy
1071
1265
 
1072
1266
  @config_service_stub.call_rpc :delete_view, request, options: options do |response, operation|
@@ -1120,6 +1314,27 @@ module Google
1120
1314
  #
1121
1315
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1122
1316
  #
1317
+ # @example Basic example
1318
+ # require "google/cloud/logging/v2"
1319
+ #
1320
+ # # Create a client object. The client can be reused for multiple calls.
1321
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1322
+ #
1323
+ # # Create a request. To set request fields, pass in keyword arguments.
1324
+ # request = Google::Cloud::Logging::V2::ListSinksRequest.new
1325
+ #
1326
+ # # Call the list_sinks method.
1327
+ # result = client.list_sinks request
1328
+ #
1329
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1330
+ # # iterate over all elements by calling #each, and the enumerable
1331
+ # # will lazily make API calls to fetch subsequent pages. Other
1332
+ # # methods are also available for managing paging directly.
1333
+ # result.each do |response|
1334
+ # # Each element is of type ::Google::Cloud::Logging::V2::LogSink.
1335
+ # p response
1336
+ # end
1337
+ #
1123
1338
  def list_sinks request, options = nil
1124
1339
  raise ::ArgumentError, "request must be provided" if request.nil?
1125
1340
 
@@ -1137,16 +1352,20 @@ module Google
1137
1352
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1138
1353
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1139
1354
 
1140
- header_params = {
1141
- "parent" => request.parent
1142
- }
1355
+ header_params = {}
1356
+ if request.parent
1357
+ header_params["parent"] = request.parent
1358
+ end
1359
+
1143
1360
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1144
1361
  metadata[:"x-goog-request-params"] ||= request_params_header
1145
1362
 
1146
1363
  options.apply_defaults timeout: @config.rpcs.list_sinks.timeout,
1147
1364
  metadata: metadata,
1148
1365
  retry_policy: @config.rpcs.list_sinks.retry_policy
1149
- options.apply_defaults metadata: @config.metadata,
1366
+
1367
+ options.apply_defaults timeout: @config.timeout,
1368
+ metadata: @config.metadata,
1150
1369
  retry_policy: @config.retry_policy
1151
1370
 
1152
1371
  @config_service_stub.call_rpc :list_sinks, request, options: options do |response, operation|
@@ -1194,6 +1413,21 @@ module Google
1194
1413
  #
1195
1414
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1196
1415
  #
1416
+ # @example Basic example
1417
+ # require "google/cloud/logging/v2"
1418
+ #
1419
+ # # Create a client object. The client can be reused for multiple calls.
1420
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1421
+ #
1422
+ # # Create a request. To set request fields, pass in keyword arguments.
1423
+ # request = Google::Cloud::Logging::V2::GetSinkRequest.new
1424
+ #
1425
+ # # Call the get_sink method.
1426
+ # result = client.get_sink request
1427
+ #
1428
+ # # The returned object is of type Google::Cloud::Logging::V2::LogSink.
1429
+ # p result
1430
+ #
1197
1431
  def get_sink request, options = nil
1198
1432
  raise ::ArgumentError, "request must be provided" if request.nil?
1199
1433
 
@@ -1211,16 +1445,20 @@ module Google
1211
1445
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1212
1446
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1213
1447
 
1214
- header_params = {
1215
- "sink_name" => request.sink_name
1216
- }
1448
+ header_params = {}
1449
+ if request.sink_name
1450
+ header_params["sink_name"] = request.sink_name
1451
+ end
1452
+
1217
1453
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1218
1454
  metadata[:"x-goog-request-params"] ||= request_params_header
1219
1455
 
1220
1456
  options.apply_defaults timeout: @config.rpcs.get_sink.timeout,
1221
1457
  metadata: metadata,
1222
1458
  retry_policy: @config.rpcs.get_sink.retry_policy
1223
- options.apply_defaults metadata: @config.metadata,
1459
+
1460
+ options.apply_defaults timeout: @config.timeout,
1461
+ metadata: @config.metadata,
1224
1462
  retry_policy: @config.retry_policy
1225
1463
 
1226
1464
  @config_service_stub.call_rpc :get_sink, request, options: options do |response, operation|
@@ -1285,6 +1523,21 @@ module Google
1285
1523
  #
1286
1524
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1287
1525
  #
1526
+ # @example Basic example
1527
+ # require "google/cloud/logging/v2"
1528
+ #
1529
+ # # Create a client object. The client can be reused for multiple calls.
1530
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1531
+ #
1532
+ # # Create a request. To set request fields, pass in keyword arguments.
1533
+ # request = Google::Cloud::Logging::V2::CreateSinkRequest.new
1534
+ #
1535
+ # # Call the create_sink method.
1536
+ # result = client.create_sink request
1537
+ #
1538
+ # # The returned object is of type Google::Cloud::Logging::V2::LogSink.
1539
+ # p result
1540
+ #
1288
1541
  def create_sink request, options = nil
1289
1542
  raise ::ArgumentError, "request must be provided" if request.nil?
1290
1543
 
@@ -1302,16 +1555,20 @@ module Google
1302
1555
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1303
1556
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1304
1557
 
1305
- header_params = {
1306
- "parent" => request.parent
1307
- }
1558
+ header_params = {}
1559
+ if request.parent
1560
+ header_params["parent"] = request.parent
1561
+ end
1562
+
1308
1563
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1309
1564
  metadata[:"x-goog-request-params"] ||= request_params_header
1310
1565
 
1311
1566
  options.apply_defaults timeout: @config.rpcs.create_sink.timeout,
1312
1567
  metadata: metadata,
1313
1568
  retry_policy: @config.rpcs.create_sink.retry_policy
1314
- options.apply_defaults metadata: @config.metadata,
1569
+
1570
+ options.apply_defaults timeout: @config.timeout,
1571
+ metadata: @config.metadata,
1315
1572
  retry_policy: @config.retry_policy
1316
1573
 
1317
1574
  @config_service_stub.call_rpc :create_sink, request, options: options do |response, operation|
@@ -1393,6 +1650,21 @@ module Google
1393
1650
  #
1394
1651
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1395
1652
  #
1653
+ # @example Basic example
1654
+ # require "google/cloud/logging/v2"
1655
+ #
1656
+ # # Create a client object. The client can be reused for multiple calls.
1657
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1658
+ #
1659
+ # # Create a request. To set request fields, pass in keyword arguments.
1660
+ # request = Google::Cloud::Logging::V2::UpdateSinkRequest.new
1661
+ #
1662
+ # # Call the update_sink method.
1663
+ # result = client.update_sink request
1664
+ #
1665
+ # # The returned object is of type Google::Cloud::Logging::V2::LogSink.
1666
+ # p result
1667
+ #
1396
1668
  def update_sink request, options = nil
1397
1669
  raise ::ArgumentError, "request must be provided" if request.nil?
1398
1670
 
@@ -1410,16 +1682,20 @@ module Google
1410
1682
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1411
1683
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1412
1684
 
1413
- header_params = {
1414
- "sink_name" => request.sink_name
1415
- }
1685
+ header_params = {}
1686
+ if request.sink_name
1687
+ header_params["sink_name"] = request.sink_name
1688
+ end
1689
+
1416
1690
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1417
1691
  metadata[:"x-goog-request-params"] ||= request_params_header
1418
1692
 
1419
1693
  options.apply_defaults timeout: @config.rpcs.update_sink.timeout,
1420
1694
  metadata: metadata,
1421
1695
  retry_policy: @config.rpcs.update_sink.retry_policy
1422
- options.apply_defaults metadata: @config.metadata,
1696
+
1697
+ options.apply_defaults timeout: @config.timeout,
1698
+ metadata: @config.metadata,
1423
1699
  retry_policy: @config.retry_policy
1424
1700
 
1425
1701
  @config_service_stub.call_rpc :update_sink, request, options: options do |response, operation|
@@ -1468,6 +1744,21 @@ module Google
1468
1744
  #
1469
1745
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1470
1746
  #
1747
+ # @example Basic example
1748
+ # require "google/cloud/logging/v2"
1749
+ #
1750
+ # # Create a client object. The client can be reused for multiple calls.
1751
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1752
+ #
1753
+ # # Create a request. To set request fields, pass in keyword arguments.
1754
+ # request = Google::Cloud::Logging::V2::DeleteSinkRequest.new
1755
+ #
1756
+ # # Call the delete_sink method.
1757
+ # result = client.delete_sink request
1758
+ #
1759
+ # # The returned object is of type Google::Protobuf::Empty.
1760
+ # p result
1761
+ #
1471
1762
  def delete_sink request, options = nil
1472
1763
  raise ::ArgumentError, "request must be provided" if request.nil?
1473
1764
 
@@ -1485,16 +1776,20 @@ module Google
1485
1776
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1486
1777
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1487
1778
 
1488
- header_params = {
1489
- "sink_name" => request.sink_name
1490
- }
1779
+ header_params = {}
1780
+ if request.sink_name
1781
+ header_params["sink_name"] = request.sink_name
1782
+ end
1783
+
1491
1784
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1492
1785
  metadata[:"x-goog-request-params"] ||= request_params_header
1493
1786
 
1494
1787
  options.apply_defaults timeout: @config.rpcs.delete_sink.timeout,
1495
1788
  metadata: metadata,
1496
1789
  retry_policy: @config.rpcs.delete_sink.retry_policy
1497
- options.apply_defaults metadata: @config.metadata,
1790
+
1791
+ options.apply_defaults timeout: @config.timeout,
1792
+ metadata: @config.metadata,
1498
1793
  retry_policy: @config.retry_policy
1499
1794
 
1500
1795
  @config_service_stub.call_rpc :delete_sink, request, options: options do |response, operation|
@@ -1548,6 +1843,27 @@ module Google
1548
1843
  #
1549
1844
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1550
1845
  #
1846
+ # @example Basic example
1847
+ # require "google/cloud/logging/v2"
1848
+ #
1849
+ # # Create a client object. The client can be reused for multiple calls.
1850
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1851
+ #
1852
+ # # Create a request. To set request fields, pass in keyword arguments.
1853
+ # request = Google::Cloud::Logging::V2::ListExclusionsRequest.new
1854
+ #
1855
+ # # Call the list_exclusions method.
1856
+ # result = client.list_exclusions request
1857
+ #
1858
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1859
+ # # iterate over all elements by calling #each, and the enumerable
1860
+ # # will lazily make API calls to fetch subsequent pages. Other
1861
+ # # methods are also available for managing paging directly.
1862
+ # result.each do |response|
1863
+ # # Each element is of type ::Google::Cloud::Logging::V2::LogExclusion.
1864
+ # p response
1865
+ # end
1866
+ #
1551
1867
  def list_exclusions request, options = nil
1552
1868
  raise ::ArgumentError, "request must be provided" if request.nil?
1553
1869
 
@@ -1565,16 +1881,20 @@ module Google
1565
1881
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1566
1882
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1567
1883
 
1568
- header_params = {
1569
- "parent" => request.parent
1570
- }
1884
+ header_params = {}
1885
+ if request.parent
1886
+ header_params["parent"] = request.parent
1887
+ end
1888
+
1571
1889
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1572
1890
  metadata[:"x-goog-request-params"] ||= request_params_header
1573
1891
 
1574
1892
  options.apply_defaults timeout: @config.rpcs.list_exclusions.timeout,
1575
1893
  metadata: metadata,
1576
1894
  retry_policy: @config.rpcs.list_exclusions.retry_policy
1577
- options.apply_defaults metadata: @config.metadata,
1895
+
1896
+ options.apply_defaults timeout: @config.timeout,
1897
+ metadata: @config.metadata,
1578
1898
  retry_policy: @config.retry_policy
1579
1899
 
1580
1900
  @config_service_stub.call_rpc :list_exclusions, request, options: options do |response, operation|
@@ -1622,6 +1942,21 @@ module Google
1622
1942
  #
1623
1943
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1624
1944
  #
1945
+ # @example Basic example
1946
+ # require "google/cloud/logging/v2"
1947
+ #
1948
+ # # Create a client object. The client can be reused for multiple calls.
1949
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
1950
+ #
1951
+ # # Create a request. To set request fields, pass in keyword arguments.
1952
+ # request = Google::Cloud::Logging::V2::GetExclusionRequest.new
1953
+ #
1954
+ # # Call the get_exclusion method.
1955
+ # result = client.get_exclusion request
1956
+ #
1957
+ # # The returned object is of type Google::Cloud::Logging::V2::LogExclusion.
1958
+ # p result
1959
+ #
1625
1960
  def get_exclusion request, options = nil
1626
1961
  raise ::ArgumentError, "request must be provided" if request.nil?
1627
1962
 
@@ -1639,16 +1974,20 @@ module Google
1639
1974
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1640
1975
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1641
1976
 
1642
- header_params = {
1643
- "name" => request.name
1644
- }
1977
+ header_params = {}
1978
+ if request.name
1979
+ header_params["name"] = request.name
1980
+ end
1981
+
1645
1982
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1646
1983
  metadata[:"x-goog-request-params"] ||= request_params_header
1647
1984
 
1648
1985
  options.apply_defaults timeout: @config.rpcs.get_exclusion.timeout,
1649
1986
  metadata: metadata,
1650
1987
  retry_policy: @config.rpcs.get_exclusion.retry_policy
1651
- options.apply_defaults metadata: @config.metadata,
1988
+
1989
+ options.apply_defaults timeout: @config.timeout,
1990
+ metadata: @config.metadata,
1652
1991
  retry_policy: @config.retry_policy
1653
1992
 
1654
1993
  @config_service_stub.call_rpc :get_exclusion, request, options: options do |response, operation|
@@ -1700,6 +2039,21 @@ module Google
1700
2039
  #
1701
2040
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1702
2041
  #
2042
+ # @example Basic example
2043
+ # require "google/cloud/logging/v2"
2044
+ #
2045
+ # # Create a client object. The client can be reused for multiple calls.
2046
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
2047
+ #
2048
+ # # Create a request. To set request fields, pass in keyword arguments.
2049
+ # request = Google::Cloud::Logging::V2::CreateExclusionRequest.new
2050
+ #
2051
+ # # Call the create_exclusion method.
2052
+ # result = client.create_exclusion request
2053
+ #
2054
+ # # The returned object is of type Google::Cloud::Logging::V2::LogExclusion.
2055
+ # p result
2056
+ #
1703
2057
  def create_exclusion request, options = nil
1704
2058
  raise ::ArgumentError, "request must be provided" if request.nil?
1705
2059
 
@@ -1717,16 +2071,20 @@ module Google
1717
2071
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1718
2072
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1719
2073
 
1720
- header_params = {
1721
- "parent" => request.parent
1722
- }
2074
+ header_params = {}
2075
+ if request.parent
2076
+ header_params["parent"] = request.parent
2077
+ end
2078
+
1723
2079
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1724
2080
  metadata[:"x-goog-request-params"] ||= request_params_header
1725
2081
 
1726
2082
  options.apply_defaults timeout: @config.rpcs.create_exclusion.timeout,
1727
2083
  metadata: metadata,
1728
2084
  retry_policy: @config.rpcs.create_exclusion.retry_policy
1729
- options.apply_defaults metadata: @config.metadata,
2085
+
2086
+ options.apply_defaults timeout: @config.timeout,
2087
+ metadata: @config.metadata,
1730
2088
  retry_policy: @config.retry_policy
1731
2089
 
1732
2090
  @config_service_stub.call_rpc :create_exclusion, request, options: options do |response, operation|
@@ -1784,6 +2142,21 @@ module Google
1784
2142
  #
1785
2143
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1786
2144
  #
2145
+ # @example Basic example
2146
+ # require "google/cloud/logging/v2"
2147
+ #
2148
+ # # Create a client object. The client can be reused for multiple calls.
2149
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
2150
+ #
2151
+ # # Create a request. To set request fields, pass in keyword arguments.
2152
+ # request = Google::Cloud::Logging::V2::UpdateExclusionRequest.new
2153
+ #
2154
+ # # Call the update_exclusion method.
2155
+ # result = client.update_exclusion request
2156
+ #
2157
+ # # The returned object is of type Google::Cloud::Logging::V2::LogExclusion.
2158
+ # p result
2159
+ #
1787
2160
  def update_exclusion request, options = nil
1788
2161
  raise ::ArgumentError, "request must be provided" if request.nil?
1789
2162
 
@@ -1801,16 +2174,20 @@ module Google
1801
2174
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1802
2175
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1803
2176
 
1804
- header_params = {
1805
- "name" => request.name
1806
- }
2177
+ header_params = {}
2178
+ if request.name
2179
+ header_params["name"] = request.name
2180
+ end
2181
+
1807
2182
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1808
2183
  metadata[:"x-goog-request-params"] ||= request_params_header
1809
2184
 
1810
2185
  options.apply_defaults timeout: @config.rpcs.update_exclusion.timeout,
1811
2186
  metadata: metadata,
1812
2187
  retry_policy: @config.rpcs.update_exclusion.retry_policy
1813
- options.apply_defaults metadata: @config.metadata,
2188
+
2189
+ options.apply_defaults timeout: @config.timeout,
2190
+ metadata: @config.metadata,
1814
2191
  retry_policy: @config.retry_policy
1815
2192
 
1816
2193
  @config_service_stub.call_rpc :update_exclusion, request, options: options do |response, operation|
@@ -1857,6 +2234,21 @@ module Google
1857
2234
  #
1858
2235
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1859
2236
  #
2237
+ # @example Basic example
2238
+ # require "google/cloud/logging/v2"
2239
+ #
2240
+ # # Create a client object. The client can be reused for multiple calls.
2241
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
2242
+ #
2243
+ # # Create a request. To set request fields, pass in keyword arguments.
2244
+ # request = Google::Cloud::Logging::V2::DeleteExclusionRequest.new
2245
+ #
2246
+ # # Call the delete_exclusion method.
2247
+ # result = client.delete_exclusion request
2248
+ #
2249
+ # # The returned object is of type Google::Protobuf::Empty.
2250
+ # p result
2251
+ #
1860
2252
  def delete_exclusion request, options = nil
1861
2253
  raise ::ArgumentError, "request must be provided" if request.nil?
1862
2254
 
@@ -1874,16 +2266,20 @@ module Google
1874
2266
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1875
2267
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1876
2268
 
1877
- header_params = {
1878
- "name" => request.name
1879
- }
2269
+ header_params = {}
2270
+ if request.name
2271
+ header_params["name"] = request.name
2272
+ end
2273
+
1880
2274
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1881
2275
  metadata[:"x-goog-request-params"] ||= request_params_header
1882
2276
 
1883
2277
  options.apply_defaults timeout: @config.rpcs.delete_exclusion.timeout,
1884
2278
  metadata: metadata,
1885
2279
  retry_policy: @config.rpcs.delete_exclusion.retry_policy
1886
- options.apply_defaults metadata: @config.metadata,
2280
+
2281
+ options.apply_defaults timeout: @config.timeout,
2282
+ metadata: @config.metadata,
1887
2283
  retry_policy: @config.retry_policy
1888
2284
 
1889
2285
  @config_service_stub.call_rpc :delete_exclusion, request, options: options do |response, operation|
@@ -1942,6 +2338,21 @@ module Google
1942
2338
  #
1943
2339
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1944
2340
  #
2341
+ # @example Basic example
2342
+ # require "google/cloud/logging/v2"
2343
+ #
2344
+ # # Create a client object. The client can be reused for multiple calls.
2345
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
2346
+ #
2347
+ # # Create a request. To set request fields, pass in keyword arguments.
2348
+ # request = Google::Cloud::Logging::V2::GetCmekSettingsRequest.new
2349
+ #
2350
+ # # Call the get_cmek_settings method.
2351
+ # result = client.get_cmek_settings request
2352
+ #
2353
+ # # The returned object is of type Google::Cloud::Logging::V2::CmekSettings.
2354
+ # p result
2355
+ #
1945
2356
  def get_cmek_settings request, options = nil
1946
2357
  raise ::ArgumentError, "request must be provided" if request.nil?
1947
2358
 
@@ -1959,16 +2370,20 @@ module Google
1959
2370
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
1960
2371
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1961
2372
 
1962
- header_params = {
1963
- "name" => request.name
1964
- }
2373
+ header_params = {}
2374
+ if request.name
2375
+ header_params["name"] = request.name
2376
+ end
2377
+
1965
2378
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1966
2379
  metadata[:"x-goog-request-params"] ||= request_params_header
1967
2380
 
1968
2381
  options.apply_defaults timeout: @config.rpcs.get_cmek_settings.timeout,
1969
2382
  metadata: metadata,
1970
2383
  retry_policy: @config.rpcs.get_cmek_settings.retry_policy
1971
- options.apply_defaults metadata: @config.metadata,
2384
+
2385
+ options.apply_defaults timeout: @config.timeout,
2386
+ metadata: @config.metadata,
1972
2387
  retry_policy: @config.retry_policy
1973
2388
 
1974
2389
  @config_service_stub.call_rpc :get_cmek_settings, request, options: options do |response, operation|
@@ -2047,6 +2462,21 @@ module Google
2047
2462
  #
2048
2463
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2049
2464
  #
2465
+ # @example Basic example
2466
+ # require "google/cloud/logging/v2"
2467
+ #
2468
+ # # Create a client object. The client can be reused for multiple calls.
2469
+ # client = Google::Cloud::Logging::V2::ConfigService::Client.new
2470
+ #
2471
+ # # Create a request. To set request fields, pass in keyword arguments.
2472
+ # request = Google::Cloud::Logging::V2::UpdateCmekSettingsRequest.new
2473
+ #
2474
+ # # Call the update_cmek_settings method.
2475
+ # result = client.update_cmek_settings request
2476
+ #
2477
+ # # The returned object is of type Google::Cloud::Logging::V2::CmekSettings.
2478
+ # p result
2479
+ #
2050
2480
  def update_cmek_settings request, options = nil
2051
2481
  raise ::ArgumentError, "request must be provided" if request.nil?
2052
2482
 
@@ -2064,16 +2494,20 @@ module Google
2064
2494
  gapic_version: ::Google::Cloud::Logging::V2::VERSION
2065
2495
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2066
2496
 
2067
- header_params = {
2068
- "name" => request.name
2069
- }
2497
+ header_params = {}
2498
+ if request.name
2499
+ header_params["name"] = request.name
2500
+ end
2501
+
2070
2502
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2071
2503
  metadata[:"x-goog-request-params"] ||= request_params_header
2072
2504
 
2073
2505
  options.apply_defaults timeout: @config.rpcs.update_cmek_settings.timeout,
2074
2506
  metadata: metadata,
2075
2507
  retry_policy: @config.rpcs.update_cmek_settings.retry_policy
2076
- options.apply_defaults metadata: @config.metadata,
2508
+
2509
+ options.apply_defaults timeout: @config.timeout,
2510
+ metadata: @config.metadata,
2077
2511
  retry_policy: @config.retry_policy
2078
2512
 
2079
2513
  @config_service_stub.call_rpc :update_cmek_settings, request, options: options do |response, operation|
@@ -2097,22 +2531,21 @@ module Google
2097
2531
  # Configuration can be applied globally to all clients, or to a single client
2098
2532
  # on construction.
2099
2533
  #
2100
- # # Examples
2101
- #
2102
- # To modify the global config, setting the timeout for list_buckets
2103
- # to 20 seconds, and all remaining timeouts to 10 seconds:
2104
- #
2105
- # ::Google::Cloud::Logging::V2::ConfigService::Client.configure do |config|
2106
- # config.timeout = 10.0
2107
- # config.rpcs.list_buckets.timeout = 20.0
2108
- # end
2109
- #
2110
- # To apply the above configuration only to a new client:
2111
- #
2112
- # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new do |config|
2113
- # config.timeout = 10.0
2114
- # config.rpcs.list_buckets.timeout = 20.0
2115
- # end
2534
+ # @example
2535
+ #
2536
+ # # Modify the global config, setting the timeout for
2537
+ # # list_buckets to 20 seconds,
2538
+ # # and all remaining timeouts to 10 seconds.
2539
+ # ::Google::Cloud::Logging::V2::ConfigService::Client.configure do |config|
2540
+ # config.timeout = 10.0
2541
+ # config.rpcs.list_buckets.timeout = 20.0
2542
+ # end
2543
+ #
2544
+ # # Apply the above configuration only to a new client.
2545
+ # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new do |config|
2546
+ # config.timeout = 10.0
2547
+ # config.rpcs.list_buckets.timeout = 20.0
2548
+ # end
2116
2549
  #
2117
2550
  # @!attribute [rw] endpoint
2118
2551
  # The hostname or hostname:port of the service endpoint.