google-cloud-monitoring-v3 0.4.2 → 0.6.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/monitoring/v3/alert_policy_service/client.rb +157 -61
  3. data/lib/google/cloud/monitoring/v3/group_service/client.rb +189 -68
  4. data/lib/google/cloud/monitoring/v3/metric_service/client.rb +360 -80
  5. data/lib/google/cloud/monitoring/v3/notification_channel_service/client.rb +286 -87
  6. data/lib/google/cloud/monitoring/v3/query_service/client.rb +60 -41
  7. data/lib/google/cloud/monitoring/v3/service_monitoring_service/client.rb +281 -84
  8. data/lib/google/cloud/monitoring/v3/uptime_check_service/client.rb +182 -63
  9. data/lib/google/cloud/monitoring/v3/version.rb +1 -1
  10. data/lib/google/monitoring/v3/alert_pb.rb +17 -2
  11. data/lib/google/monitoring/v3/alert_service_pb.rb +2 -2
  12. data/lib/google/monitoring/v3/alert_service_services_pb.rb +1 -1
  13. data/lib/google/monitoring/v3/common_pb.rb +2 -2
  14. data/lib/google/monitoring/v3/group_pb.rb +1 -1
  15. data/lib/google/monitoring/v3/group_service_pb.rb +2 -2
  16. data/lib/google/monitoring/v3/group_service_services_pb.rb +1 -1
  17. data/lib/google/monitoring/v3/metric_pb.rb +2 -2
  18. data/lib/google/monitoring/v3/metric_service_pb.rb +2 -2
  19. data/lib/google/monitoring/v3/metric_service_services_pb.rb +13 -1
  20. data/lib/google/monitoring/v3/mutation_record_pb.rb +1 -1
  21. data/lib/google/monitoring/v3/notification_pb.rb +2 -2
  22. data/lib/google/monitoring/v3/notification_service_pb.rb +2 -2
  23. data/lib/google/monitoring/v3/notification_service_services_pb.rb +1 -1
  24. data/lib/google/monitoring/v3/query_service_pb.rb +2 -2
  25. data/lib/google/monitoring/v3/query_service_services_pb.rb +1 -1
  26. data/lib/google/monitoring/v3/service_pb.rb +5 -2
  27. data/lib/google/monitoring/v3/service_service_pb.rb +2 -2
  28. data/lib/google/monitoring/v3/service_service_services_pb.rb +1 -1
  29. data/lib/google/monitoring/v3/uptime_pb.rb +2 -2
  30. data/lib/google/monitoring/v3/uptime_service_pb.rb +3 -2
  31. data/lib/google/monitoring/v3/uptime_service_services_pb.rb +1 -1
  32. data/proto_docs/google/longrunning/operations.rb +164 -0
  33. data/proto_docs/google/monitoring/v3/alert.rb +68 -3
  34. data/proto_docs/google/monitoring/v3/alert_service.rb +4 -2
  35. data/proto_docs/google/monitoring/v3/common.rb +17 -5
  36. data/proto_docs/google/monitoring/v3/group_service.rb +4 -2
  37. data/proto_docs/google/monitoring/v3/metric.rb +3 -1
  38. data/proto_docs/google/monitoring/v3/metric_service.rb +13 -8
  39. data/proto_docs/google/monitoring/v3/notification_service.rb +8 -4
  40. data/proto_docs/google/monitoring/v3/service.rb +38 -6
  41. data/proto_docs/google/monitoring/v3/service_service.rb +4 -2
  42. data/proto_docs/google/monitoring/v3/span_context.rb +2 -2
  43. data/proto_docs/google/monitoring/v3/uptime.rb +5 -2
  44. data/proto_docs/google/monitoring/v3/uptime_service.rb +4 -2
  45. metadata +5 -4
data/lib/google/cloud/monitoring/v3/service_monitoring_service/client.rb CHANGED
@@ -44,13 +44,12 @@ module Google
44
44
  # See {::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client::Configuration}
45
45
  # for a description of the configuration fields.
46
46
  #
47
- # ## Example
47
+ # @example
48
48
  #
49
- # To modify the configuration for all ServiceMonitoringService clients:
50
- #
51
- # ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.configure do |config|
52
- # config.timeout = 10.0
53
- # end
49
+ # # Modify the configuration for all ServiceMonitoringService clients
50
+ # ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.configure do |config|
51
+ # config.timeout = 10.0
52
+ # end
54
53
  #
55
54
  # @yield [config] Configure the Client client.
56
55
  # @yieldparam config [Client::Configuration]
@@ -72,38 +71,38 @@ module Google
72
71
 
73
72
  default_config.rpcs.get_service.timeout = 30.0
74
73
  default_config.rpcs.get_service.retry_policy = {
75
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
74
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
76
75
  }
77
76
 
78
77
  default_config.rpcs.list_services.timeout = 30.0
79
78
  default_config.rpcs.list_services.retry_policy = {
80
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
79
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
81
80
  }
82
81
 
83
82
  default_config.rpcs.update_service.timeout = 30.0
84
83
 
85
84
  default_config.rpcs.delete_service.timeout = 30.0
86
85
  default_config.rpcs.delete_service.retry_policy = {
87
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
86
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
88
87
  }
89
88
 
90
89
  default_config.rpcs.create_service_level_objective.timeout = 30.0
91
90
 
92
91
  default_config.rpcs.get_service_level_objective.timeout = 30.0
93
92
  default_config.rpcs.get_service_level_objective.retry_policy = {
94
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
93
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
95
94
  }
96
95
 
97
96
  default_config.rpcs.list_service_level_objectives.timeout = 30.0
98
97
  default_config.rpcs.list_service_level_objectives.retry_policy = {
99
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
98
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
100
99
  }
101
100
 
102
101
  default_config.rpcs.update_service_level_objective.timeout = 30.0
103
102
 
104
103
  default_config.rpcs.delete_service_level_objective.timeout = 30.0
105
104
  default_config.rpcs.delete_service_level_objective.retry_policy = {
106
- initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [4, 14]
105
+ initial_delay: 0.1, max_delay: 30.0, multiplier: 1.3, retry_codes: [14]
107
106
  }
108
107
 
109
108
  default_config
@@ -135,19 +134,15 @@ module Google
135
134
  ##
136
135
  # Create a new ServiceMonitoringService client object.
137
136
  #
138
- # ## Examples
139
- #
140
- # To create a new ServiceMonitoringService client with the default
141
- # configuration:
142
- #
143
- # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
137
+ # @example
144
138
  #
145
- # To create a new ServiceMonitoringService client with a custom
146
- # configuration:
139
+ # # Create a client using the default configuration
140
+ # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
147
141
  #
148
- # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new do |config|
149
- # config.timeout = 10.0
150
- # end
142
+ # # Create a client using a custom configuration
143
+ # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new do |config|
144
+ # config.timeout = 10.0
145
+ # end
151
146
  #
152
147
  # @yield [config] Configure the ServiceMonitoringService client.
153
148
  # @yieldparam config [Client::Configuration]
@@ -167,10 +162,9 @@ module Google
167
162
 
168
163
  # Create credentials
169
164
  credentials = @config.credentials
170
- # 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,
171
166
  # but only if the default endpoint does not have a region prefix.
172
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
173
- @config.endpoint == Client.configure.endpoint &&
167
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
174
168
  !@config.endpoint.split(".").first.include?("-")
175
169
  credentials ||= Credentials.default scope: @config.scope,
176
170
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -210,7 +204,8 @@ module Google
210
204
  # the default parameter values, pass an empty Hash as a request object (see above).
211
205
  #
212
206
  # @param parent [::String]
213
- # Required. Resource name of the parent workspace. The format is:
207
+ # Required. Resource [name](https://cloud.google.com/monitoring/api/v3#project_name) of
208
+ # the parent workspace. The format is:
214
209
  #
215
210
  # projects/[PROJECT_ID_OR_NUMBER]
216
211
  # @param service_id [::String]
@@ -227,6 +222,21 @@ module Google
227
222
  #
228
223
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
229
224
  #
225
+ # @example Basic example
226
+ # require "google/cloud/monitoring/v3"
227
+ #
228
+ # # Create a client object. The client can be reused for multiple calls.
229
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
230
+ #
231
+ # # Create a request. To set request fields, pass in keyword arguments.
232
+ # request = Google::Cloud::Monitoring::V3::CreateServiceRequest.new
233
+ #
234
+ # # Call the create_service method.
235
+ # result = client.create_service request
236
+ #
237
+ # # The returned object is of type Google::Cloud::Monitoring::V3::Service.
238
+ # p result
239
+ #
230
240
  def create_service request, options = nil
231
241
  raise ::ArgumentError, "request must be provided" if request.nil?
232
242
 
@@ -244,16 +254,20 @@ module Google
244
254
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
245
255
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
246
256
 
247
- header_params = {
248
- "parent" => request.parent
249
- }
257
+ header_params = {}
258
+ if request.parent
259
+ header_params["parent"] = request.parent
260
+ end
261
+
250
262
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
251
263
  metadata[:"x-goog-request-params"] ||= request_params_header
252
264
 
253
265
  options.apply_defaults timeout: @config.rpcs.create_service.timeout,
254
266
  metadata: metadata,
255
267
  retry_policy: @config.rpcs.create_service.retry_policy
256
- options.apply_defaults metadata: @config.metadata,
268
+
269
+ options.apply_defaults timeout: @config.timeout,
270
+ metadata: @config.metadata,
257
271
  retry_policy: @config.retry_policy
258
272
 
259
273
  @service_monitoring_service_stub.call_rpc :create_service, request, options: options do |response, operation|
@@ -295,6 +309,21 @@ module Google
295
309
  #
296
310
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
297
311
  #
312
+ # @example Basic example
313
+ # require "google/cloud/monitoring/v3"
314
+ #
315
+ # # Create a client object. The client can be reused for multiple calls.
316
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
317
+ #
318
+ # # Create a request. To set request fields, pass in keyword arguments.
319
+ # request = Google::Cloud::Monitoring::V3::GetServiceRequest.new
320
+ #
321
+ # # Call the get_service method.
322
+ # result = client.get_service request
323
+ #
324
+ # # The returned object is of type Google::Cloud::Monitoring::V3::Service.
325
+ # p result
326
+ #
298
327
  def get_service request, options = nil
299
328
  raise ::ArgumentError, "request must be provided" if request.nil?
300
329
 
@@ -312,16 +341,20 @@ module Google
312
341
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
313
342
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
314
343
 
315
- header_params = {
316
- "name" => request.name
317
- }
344
+ header_params = {}
345
+ if request.name
346
+ header_params["name"] = request.name
347
+ end
348
+
318
349
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
319
350
  metadata[:"x-goog-request-params"] ||= request_params_header
320
351
 
321
352
  options.apply_defaults timeout: @config.rpcs.get_service.timeout,
322
353
  metadata: metadata,
323
354
  retry_policy: @config.rpcs.get_service.retry_policy
324
- options.apply_defaults metadata: @config.metadata,
355
+
356
+ options.apply_defaults timeout: @config.timeout,
357
+ metadata: @config.metadata,
325
358
  retry_policy: @config.retry_policy
326
359
 
327
360
  @service_monitoring_service_stub.call_rpc :get_service, request, options: options do |response, operation|
@@ -352,7 +385,8 @@ module Google
352
385
  #
353
386
  # @param parent [::String]
354
387
  # Required. Resource name of the parent containing the listed services, either a
355
- # project or a Monitoring Workspace. The formats are:
388
+ # [project](https://cloud.google.com/monitoring/api/v3#project_name) or a
389
+ # Monitoring Workspace. The formats are:
356
390
  #
357
391
  # projects/[PROJECT_ID_OR_NUMBER]
358
392
  # workspaces/[HOST_PROJECT_ID_OR_NUMBER]
@@ -392,6 +426,27 @@ module Google
392
426
  #
393
427
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
394
428
  #
429
+ # @example Basic example
430
+ # require "google/cloud/monitoring/v3"
431
+ #
432
+ # # Create a client object. The client can be reused for multiple calls.
433
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
434
+ #
435
+ # # Create a request. To set request fields, pass in keyword arguments.
436
+ # request = Google::Cloud::Monitoring::V3::ListServicesRequest.new
437
+ #
438
+ # # Call the list_services method.
439
+ # result = client.list_services request
440
+ #
441
+ # # The returned object is of type Gapic::PagedEnumerable. You can
442
+ # # iterate over all elements by calling #each, and the enumerable
443
+ # # will lazily make API calls to fetch subsequent pages. Other
444
+ # # methods are also available for managing paging directly.
445
+ # result.each do |response|
446
+ # # Each element is of type ::Google::Cloud::Monitoring::V3::Service.
447
+ # p response
448
+ # end
449
+ #
395
450
  def list_services request, options = nil
396
451
  raise ::ArgumentError, "request must be provided" if request.nil?
397
452
 
@@ -409,16 +464,20 @@ module Google
409
464
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
410
465
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
411
466
 
412
- header_params = {
413
- "parent" => request.parent
414
- }
467
+ header_params = {}
468
+ if request.parent
469
+ header_params["parent"] = request.parent
470
+ end
471
+
415
472
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
416
473
  metadata[:"x-goog-request-params"] ||= request_params_header
417
474
 
418
475
  options.apply_defaults timeout: @config.rpcs.list_services.timeout,
419
476
  metadata: metadata,
420
477
  retry_policy: @config.rpcs.list_services.retry_policy
421
- options.apply_defaults metadata: @config.metadata,
478
+
479
+ options.apply_defaults timeout: @config.timeout,
480
+ metadata: @config.metadata,
422
481
  retry_policy: @config.retry_policy
423
482
 
424
483
  @service_monitoring_service_stub.call_rpc :list_services, request, options: options do |response, operation|
@@ -462,6 +521,21 @@ module Google
462
521
  #
463
522
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
464
523
  #
524
+ # @example Basic example
525
+ # require "google/cloud/monitoring/v3"
526
+ #
527
+ # # Create a client object. The client can be reused for multiple calls.
528
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
529
+ #
530
+ # # Create a request. To set request fields, pass in keyword arguments.
531
+ # request = Google::Cloud::Monitoring::V3::UpdateServiceRequest.new
532
+ #
533
+ # # Call the update_service method.
534
+ # result = client.update_service request
535
+ #
536
+ # # The returned object is of type Google::Cloud::Monitoring::V3::Service.
537
+ # p result
538
+ #
465
539
  def update_service request, options = nil
466
540
  raise ::ArgumentError, "request must be provided" if request.nil?
467
541
 
@@ -479,16 +553,20 @@ module Google
479
553
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
480
554
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
481
555
 
482
- header_params = {
483
- "service.name" => request.service.name
484
- }
556
+ header_params = {}
557
+ if request.service&.name
558
+ header_params["service.name"] = request.service.name
559
+ end
560
+
485
561
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
486
562
  metadata[:"x-goog-request-params"] ||= request_params_header
487
563
 
488
564
  options.apply_defaults timeout: @config.rpcs.update_service.timeout,
489
565
  metadata: metadata,
490
566
  retry_policy: @config.rpcs.update_service.retry_policy
491
- options.apply_defaults metadata: @config.metadata,
567
+
568
+ options.apply_defaults timeout: @config.timeout,
569
+ metadata: @config.metadata,
492
570
  retry_policy: @config.retry_policy
493
571
 
494
572
  @service_monitoring_service_stub.call_rpc :update_service, request, options: options do |response, operation|
@@ -530,6 +608,21 @@ module Google
530
608
  #
531
609
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
532
610
  #
611
+ # @example Basic example
612
+ # require "google/cloud/monitoring/v3"
613
+ #
614
+ # # Create a client object. The client can be reused for multiple calls.
615
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
616
+ #
617
+ # # Create a request. To set request fields, pass in keyword arguments.
618
+ # request = Google::Cloud::Monitoring::V3::DeleteServiceRequest.new
619
+ #
620
+ # # Call the delete_service method.
621
+ # result = client.delete_service request
622
+ #
623
+ # # The returned object is of type Google::Protobuf::Empty.
624
+ # p result
625
+ #
533
626
  def delete_service request, options = nil
534
627
  raise ::ArgumentError, "request must be provided" if request.nil?
535
628
 
@@ -547,16 +640,20 @@ module Google
547
640
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
548
641
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
549
642
 
550
- header_params = {
551
- "name" => request.name
552
- }
643
+ header_params = {}
644
+ if request.name
645
+ header_params["name"] = request.name
646
+ end
647
+
553
648
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
554
649
  metadata[:"x-goog-request-params"] ||= request_params_header
555
650
 
556
651
  options.apply_defaults timeout: @config.rpcs.delete_service.timeout,
557
652
  metadata: metadata,
558
653
  retry_policy: @config.rpcs.delete_service.retry_policy
559
- options.apply_defaults metadata: @config.metadata,
654
+
655
+ options.apply_defaults timeout: @config.timeout,
656
+ metadata: @config.metadata,
560
657
  retry_policy: @config.retry_policy
561
658
 
562
659
  @service_monitoring_service_stub.call_rpc :delete_service, request, options: options do |response, operation|
@@ -606,6 +703,21 @@ module Google
606
703
  #
607
704
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
608
705
  #
706
+ # @example Basic example
707
+ # require "google/cloud/monitoring/v3"
708
+ #
709
+ # # Create a client object. The client can be reused for multiple calls.
710
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
711
+ #
712
+ # # Create a request. To set request fields, pass in keyword arguments.
713
+ # request = Google::Cloud::Monitoring::V3::CreateServiceLevelObjectiveRequest.new
714
+ #
715
+ # # Call the create_service_level_objective method.
716
+ # result = client.create_service_level_objective request
717
+ #
718
+ # # The returned object is of type Google::Cloud::Monitoring::V3::ServiceLevelObjective.
719
+ # p result
720
+ #
609
721
  def create_service_level_objective request, options = nil
610
722
  raise ::ArgumentError, "request must be provided" if request.nil?
611
723
 
@@ -623,16 +735,20 @@ module Google
623
735
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
624
736
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
625
737
 
626
- header_params = {
627
- "parent" => request.parent
628
- }
738
+ header_params = {}
739
+ if request.parent
740
+ header_params["parent"] = request.parent
741
+ end
742
+
629
743
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
630
744
  metadata[:"x-goog-request-params"] ||= request_params_header
631
745
 
632
746
  options.apply_defaults timeout: @config.rpcs.create_service_level_objective.timeout,
633
747
  metadata: metadata,
634
748
  retry_policy: @config.rpcs.create_service_level_objective.retry_policy
635
- options.apply_defaults metadata: @config.metadata,
749
+
750
+ options.apply_defaults timeout: @config.timeout,
751
+ metadata: @config.metadata,
636
752
  retry_policy: @config.retry_policy
637
753
 
638
754
  @service_monitoring_service_stub.call_rpc :create_service_level_objective, request, options: options do |response, operation|
@@ -679,6 +795,21 @@ module Google
679
795
  #
680
796
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
681
797
  #
798
+ # @example Basic example
799
+ # require "google/cloud/monitoring/v3"
800
+ #
801
+ # # Create a client object. The client can be reused for multiple calls.
802
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
803
+ #
804
+ # # Create a request. To set request fields, pass in keyword arguments.
805
+ # request = Google::Cloud::Monitoring::V3::GetServiceLevelObjectiveRequest.new
806
+ #
807
+ # # Call the get_service_level_objective method.
808
+ # result = client.get_service_level_objective request
809
+ #
810
+ # # The returned object is of type Google::Cloud::Monitoring::V3::ServiceLevelObjective.
811
+ # p result
812
+ #
682
813
  def get_service_level_objective request, options = nil
683
814
  raise ::ArgumentError, "request must be provided" if request.nil?
684
815
 
@@ -696,16 +827,20 @@ module Google
696
827
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
697
828
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
698
829
 
699
- header_params = {
700
- "name" => request.name
701
- }
830
+ header_params = {}
831
+ if request.name
832
+ header_params["name"] = request.name
833
+ end
834
+
702
835
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
703
836
  metadata[:"x-goog-request-params"] ||= request_params_header
704
837
 
705
838
  options.apply_defaults timeout: @config.rpcs.get_service_level_objective.timeout,
706
839
  metadata: metadata,
707
840
  retry_policy: @config.rpcs.get_service_level_objective.retry_policy
708
- options.apply_defaults metadata: @config.metadata,
841
+
842
+ options.apply_defaults timeout: @config.timeout,
843
+ metadata: @config.metadata,
709
844
  retry_policy: @config.retry_policy
710
845
 
711
846
  @service_monitoring_service_stub.call_rpc :get_service_level_objective, request, options: options do |response, operation|
@@ -763,6 +898,27 @@ module Google
763
898
  #
764
899
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
765
900
  #
901
+ # @example Basic example
902
+ # require "google/cloud/monitoring/v3"
903
+ #
904
+ # # Create a client object. The client can be reused for multiple calls.
905
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
906
+ #
907
+ # # Create a request. To set request fields, pass in keyword arguments.
908
+ # request = Google::Cloud::Monitoring::V3::ListServiceLevelObjectivesRequest.new
909
+ #
910
+ # # Call the list_service_level_objectives method.
911
+ # result = client.list_service_level_objectives request
912
+ #
913
+ # # The returned object is of type Gapic::PagedEnumerable. You can
914
+ # # iterate over all elements by calling #each, and the enumerable
915
+ # # will lazily make API calls to fetch subsequent pages. Other
916
+ # # methods are also available for managing paging directly.
917
+ # result.each do |response|
918
+ # # Each element is of type ::Google::Cloud::Monitoring::V3::ServiceLevelObjective.
919
+ # p response
920
+ # end
921
+ #
766
922
  def list_service_level_objectives request, options = nil
767
923
  raise ::ArgumentError, "request must be provided" if request.nil?
768
924
 
@@ -780,16 +936,20 @@ module Google
780
936
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
781
937
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
782
938
 
783
- header_params = {
784
- "parent" => request.parent
785
- }
939
+ header_params = {}
940
+ if request.parent
941
+ header_params["parent"] = request.parent
942
+ end
943
+
786
944
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
787
945
  metadata[:"x-goog-request-params"] ||= request_params_header
788
946
 
789
947
  options.apply_defaults timeout: @config.rpcs.list_service_level_objectives.timeout,
790
948
  metadata: metadata,
791
949
  retry_policy: @config.rpcs.list_service_level_objectives.retry_policy
792
- options.apply_defaults metadata: @config.metadata,
950
+
951
+ options.apply_defaults timeout: @config.timeout,
952
+ metadata: @config.metadata,
793
953
  retry_policy: @config.retry_policy
794
954
 
795
955
  @service_monitoring_service_stub.call_rpc :list_service_level_objectives, request, options: options do |response, operation|
@@ -833,6 +993,21 @@ module Google
833
993
  #
834
994
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
835
995
  #
996
+ # @example Basic example
997
+ # require "google/cloud/monitoring/v3"
998
+ #
999
+ # # Create a client object. The client can be reused for multiple calls.
1000
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
1001
+ #
1002
+ # # Create a request. To set request fields, pass in keyword arguments.
1003
+ # request = Google::Cloud::Monitoring::V3::UpdateServiceLevelObjectiveRequest.new
1004
+ #
1005
+ # # Call the update_service_level_objective method.
1006
+ # result = client.update_service_level_objective request
1007
+ #
1008
+ # # The returned object is of type Google::Cloud::Monitoring::V3::ServiceLevelObjective.
1009
+ # p result
1010
+ #
836
1011
  def update_service_level_objective request, options = nil
837
1012
  raise ::ArgumentError, "request must be provided" if request.nil?
838
1013
 
@@ -850,16 +1025,20 @@ module Google
850
1025
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
851
1026
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
852
1027
 
853
- header_params = {
854
- "service_level_objective.name" => request.service_level_objective.name
855
- }
1028
+ header_params = {}
1029
+ if request.service_level_objective&.name
1030
+ header_params["service_level_objective.name"] = request.service_level_objective.name
1031
+ end
1032
+
856
1033
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
857
1034
  metadata[:"x-goog-request-params"] ||= request_params_header
858
1035
 
859
1036
  options.apply_defaults timeout: @config.rpcs.update_service_level_objective.timeout,
860
1037
  metadata: metadata,
861
1038
  retry_policy: @config.rpcs.update_service_level_objective.retry_policy
862
- options.apply_defaults metadata: @config.metadata,
1039
+
1040
+ options.apply_defaults timeout: @config.timeout,
1041
+ metadata: @config.metadata,
863
1042
  retry_policy: @config.retry_policy
864
1043
 
865
1044
  @service_monitoring_service_stub.call_rpc :update_service_level_objective, request, options: options do |response, operation|
@@ -901,6 +1080,21 @@ module Google
901
1080
  #
902
1081
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
903
1082
  #
1083
+ # @example Basic example
1084
+ # require "google/cloud/monitoring/v3"
1085
+ #
1086
+ # # Create a client object. The client can be reused for multiple calls.
1087
+ # client = Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new
1088
+ #
1089
+ # # Create a request. To set request fields, pass in keyword arguments.
1090
+ # request = Google::Cloud::Monitoring::V3::DeleteServiceLevelObjectiveRequest.new
1091
+ #
1092
+ # # Call the delete_service_level_objective method.
1093
+ # result = client.delete_service_level_objective request
1094
+ #
1095
+ # # The returned object is of type Google::Protobuf::Empty.
1096
+ # p result
1097
+ #
904
1098
  def delete_service_level_objective request, options = nil
905
1099
  raise ::ArgumentError, "request must be provided" if request.nil?
906
1100
 
@@ -918,16 +1112,20 @@ module Google
918
1112
  gapic_version: ::Google::Cloud::Monitoring::V3::VERSION
919
1113
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
920
1114
 
921
- header_params = {
922
- "name" => request.name
923
- }
1115
+ header_params = {}
1116
+ if request.name
1117
+ header_params["name"] = request.name
1118
+ end
1119
+
924
1120
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
925
1121
  metadata[:"x-goog-request-params"] ||= request_params_header
926
1122
 
927
1123
  options.apply_defaults timeout: @config.rpcs.delete_service_level_objective.timeout,
928
1124
  metadata: metadata,
929
1125
  retry_policy: @config.rpcs.delete_service_level_objective.retry_policy
930
- options.apply_defaults metadata: @config.metadata,
1126
+
1127
+ options.apply_defaults timeout: @config.timeout,
1128
+ metadata: @config.metadata,
931
1129
  retry_policy: @config.retry_policy
932
1130
 
933
1131
  @service_monitoring_service_stub.call_rpc :delete_service_level_objective, request, options: options do |response, operation|
@@ -951,22 +1149,21 @@ module Google
951
1149
  # Configuration can be applied globally to all clients, or to a single client
952
1150
  # on construction.
953
1151
  #
954
- # # Examples
955
- #
956
- # To modify the global config, setting the timeout for create_service
957
- # to 20 seconds, and all remaining timeouts to 10 seconds:
958
- #
959
- # ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.configure do |config|
960
- # config.timeout = 10.0
961
- # config.rpcs.create_service.timeout = 20.0
962
- # end
963
- #
964
- # To apply the above configuration only to a new client:
965
- #
966
- # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new do |config|
967
- # config.timeout = 10.0
968
- # config.rpcs.create_service.timeout = 20.0
969
- # end
1152
+ # @example
1153
+ #
1154
+ # # Modify the global config, setting the timeout for
1155
+ # # create_service to 20 seconds,
1156
+ # # and all remaining timeouts to 10 seconds.
1157
+ # ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.configure do |config|
1158
+ # config.timeout = 10.0
1159
+ # config.rpcs.create_service.timeout = 20.0
1160
+ # end
1161
+ #
1162
+ # # Apply the above configuration only to a new client.
1163
+ # client = ::Google::Cloud::Monitoring::V3::ServiceMonitoringService::Client.new do |config|
1164
+ # config.timeout = 10.0
1165
+ # config.rpcs.create_service.timeout = 20.0
1166
+ # end
970
1167
  #
971
1168
  # @!attribute [rw] endpoint
972
1169
  # The hostname or hostname:port of the service endpoint.