google-cloud-security_center-v1p1beta1 0.7.3 → 0.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (26) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/AUTHENTICATION.md +7 -25
  4. data/README.md +1 -1
  5. data/lib/google/cloud/security_center/v1p1beta1/security_center/client.rb +513 -72
  6. data/lib/google/cloud/security_center/v1p1beta1/security_center/operations.rb +115 -12
  7. data/lib/google/cloud/security_center/v1p1beta1/version.rb +1 -1
  8. data/lib/google/cloud/security_center/v1p1beta1.rb +2 -0
  9. data/lib/google/cloud/securitycenter/v1p1beta1/asset_pb.rb +2 -2
  10. data/lib/google/cloud/securitycenter/v1p1beta1/finding_pb.rb +2 -2
  11. data/lib/google/cloud/securitycenter/v1p1beta1/folder_pb.rb +1 -1
  12. data/lib/google/cloud/securitycenter/v1p1beta1/notification_config_pb.rb +2 -2
  13. data/lib/google/cloud/securitycenter/v1p1beta1/notification_message_pb.rb +2 -2
  14. data/lib/google/cloud/securitycenter/v1p1beta1/organization_settings_pb.rb +2 -2
  15. data/lib/google/cloud/securitycenter/v1p1beta1/resource_pb.rb +2 -2
  16. data/lib/google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response_pb.rb +2 -2
  17. data/lib/google/cloud/securitycenter/v1p1beta1/security_marks_pb.rb +2 -2
  18. data/lib/google/cloud/securitycenter/v1p1beta1/securitycenter_service_pb.rb +2 -2
  19. data/lib/google/cloud/securitycenter/v1p1beta1/securitycenter_service_services_pb.rb +1 -1
  20. data/lib/google/cloud/securitycenter/v1p1beta1/source_pb.rb +2 -2
  21. data/proto_docs/google/api/resource.rb +10 -71
  22. data/proto_docs/google/cloud/securitycenter/v1p1beta1/securitycenter_service.rb +1 -1
  23. data/proto_docs/google/iam/v1/iam_policy.rb +8 -1
  24. data/proto_docs/google/iam/v1/options.rb +14 -4
  25. data/proto_docs/google/iam/v1/policy.rb +208 -38
  26. metadata +7 -13
@@ -214,6 +214,7 @@ module Google
214
214
 
215
215
  @operations_client = Operations.new do |config|
216
216
  config.credentials = credentials
217
+ config.quota_project = @quota_project_id
217
218
  config.endpoint = @config.endpoint
218
219
  end
219
220
 
@@ -268,6 +269,21 @@ module Google
268
269
  #
269
270
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
270
271
  #
272
+ # @example Basic example
273
+ # require "google/cloud/security_center/v1p1beta1"
274
+ #
275
+ # # Create a client object. The client can be reused for multiple calls.
276
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
277
+ #
278
+ # # Create a request. To set request fields, pass in keyword arguments.
279
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::CreateSourceRequest.new
280
+ #
281
+ # # Call the create_source method.
282
+ # result = client.create_source request
283
+ #
284
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Source.
285
+ # p result
286
+ #
271
287
  def create_source request, options = nil
272
288
  raise ::ArgumentError, "request must be provided" if request.nil?
273
289
 
@@ -285,9 +301,11 @@ module Google
285
301
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
286
302
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
287
303
 
288
- header_params = {
289
- "parent" => request.parent
290
- }
304
+ header_params = {}
305
+ if request.parent
306
+ header_params["parent"] = request.parent
307
+ end
308
+
291
309
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
292
310
  metadata[:"x-goog-request-params"] ||= request_params_header
293
311
 
@@ -343,6 +361,21 @@ module Google
343
361
  #
344
362
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
345
363
  #
364
+ # @example Basic example
365
+ # require "google/cloud/security_center/v1p1beta1"
366
+ #
367
+ # # Create a client object. The client can be reused for multiple calls.
368
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
369
+ #
370
+ # # Create a request. To set request fields, pass in keyword arguments.
371
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::CreateFindingRequest.new
372
+ #
373
+ # # Call the create_finding method.
374
+ # result = client.create_finding request
375
+ #
376
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Finding.
377
+ # p result
378
+ #
346
379
  def create_finding request, options = nil
347
380
  raise ::ArgumentError, "request must be provided" if request.nil?
348
381
 
@@ -360,9 +393,11 @@ module Google
360
393
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
361
394
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
362
395
 
363
- header_params = {
364
- "parent" => request.parent
365
- }
396
+ header_params = {}
397
+ if request.parent
398
+ header_params["parent"] = request.parent
399
+ end
400
+
366
401
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
367
402
  metadata[:"x-goog-request-params"] ||= request_params_header
368
403
 
@@ -419,6 +454,21 @@ module Google
419
454
  #
420
455
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
421
456
  #
457
+ # @example Basic example
458
+ # require "google/cloud/security_center/v1p1beta1"
459
+ #
460
+ # # Create a client object. The client can be reused for multiple calls.
461
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
462
+ #
463
+ # # Create a request. To set request fields, pass in keyword arguments.
464
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::CreateNotificationConfigRequest.new
465
+ #
466
+ # # Call the create_notification_config method.
467
+ # result = client.create_notification_config request
468
+ #
469
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::NotificationConfig.
470
+ # p result
471
+ #
422
472
  def create_notification_config request, options = nil
423
473
  raise ::ArgumentError, "request must be provided" if request.nil?
424
474
 
@@ -436,9 +486,11 @@ module Google
436
486
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
437
487
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
438
488
 
439
- header_params = {
440
- "parent" => request.parent
441
- }
489
+ header_params = {}
490
+ if request.parent
491
+ header_params["parent"] = request.parent
492
+ end
493
+
442
494
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
443
495
  metadata[:"x-goog-request-params"] ||= request_params_header
444
496
 
@@ -488,6 +540,21 @@ module Google
488
540
  #
489
541
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
490
542
  #
543
+ # @example Basic example
544
+ # require "google/cloud/security_center/v1p1beta1"
545
+ #
546
+ # # Create a client object. The client can be reused for multiple calls.
547
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
548
+ #
549
+ # # Create a request. To set request fields, pass in keyword arguments.
550
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::DeleteNotificationConfigRequest.new
551
+ #
552
+ # # Call the delete_notification_config method.
553
+ # result = client.delete_notification_config request
554
+ #
555
+ # # The returned object is of type Google::Protobuf::Empty.
556
+ # p result
557
+ #
491
558
  def delete_notification_config request, options = nil
492
559
  raise ::ArgumentError, "request must be provided" if request.nil?
493
560
 
@@ -505,9 +572,11 @@ module Google
505
572
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
506
573
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
507
574
 
508
- header_params = {
509
- "name" => request.name
510
- }
575
+ header_params = {}
576
+ if request.name
577
+ header_params["name"] = request.name
578
+ end
579
+
511
580
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
512
581
  metadata[:"x-goog-request-params"] ||= request_params_header
513
582
 
@@ -550,7 +619,7 @@ module Google
550
619
  # See the operation documentation for the appropriate value for this field.
551
620
  # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
552
621
  # OPTIONAL: A `GetPolicyOptions` object for specifying options to
553
- # `GetIamPolicy`. This field is only used by Cloud IAM.
622
+ # `GetIamPolicy`.
554
623
  #
555
624
  # @yield [response, operation] Access the result along with the RPC operation
556
625
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -560,6 +629,21 @@ module Google
560
629
  #
561
630
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
562
631
  #
632
+ # @example Basic example
633
+ # require "google/cloud/security_center/v1p1beta1"
634
+ #
635
+ # # Create a client object. The client can be reused for multiple calls.
636
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
637
+ #
638
+ # # Create a request. To set request fields, pass in keyword arguments.
639
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
640
+ #
641
+ # # Call the get_iam_policy method.
642
+ # result = client.get_iam_policy request
643
+ #
644
+ # # The returned object is of type Google::Iam::V1::Policy.
645
+ # p result
646
+ #
563
647
  def get_iam_policy request, options = nil
564
648
  raise ::ArgumentError, "request must be provided" if request.nil?
565
649
 
@@ -577,9 +661,11 @@ module Google
577
661
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
578
662
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
579
663
 
580
- header_params = {
581
- "resource" => request.resource
582
- }
664
+ header_params = {}
665
+ if request.resource
666
+ header_params["resource"] = request.resource
667
+ end
668
+
583
669
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
584
670
  metadata[:"x-goog-request-params"] ||= request_params_header
585
671
 
@@ -629,6 +715,21 @@ module Google
629
715
  #
630
716
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
631
717
  #
718
+ # @example Basic example
719
+ # require "google/cloud/security_center/v1p1beta1"
720
+ #
721
+ # # Create a client object. The client can be reused for multiple calls.
722
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
723
+ #
724
+ # # Create a request. To set request fields, pass in keyword arguments.
725
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::GetNotificationConfigRequest.new
726
+ #
727
+ # # Call the get_notification_config method.
728
+ # result = client.get_notification_config request
729
+ #
730
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::NotificationConfig.
731
+ # p result
732
+ #
632
733
  def get_notification_config request, options = nil
633
734
  raise ::ArgumentError, "request must be provided" if request.nil?
634
735
 
@@ -646,9 +747,11 @@ module Google
646
747
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
647
748
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
648
749
 
649
- header_params = {
650
- "name" => request.name
651
- }
750
+ header_params = {}
751
+ if request.name
752
+ header_params["name"] = request.name
753
+ end
754
+
652
755
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
653
756
  metadata[:"x-goog-request-params"] ||= request_params_header
654
757
 
@@ -698,6 +801,21 @@ module Google
698
801
  #
699
802
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
700
803
  #
804
+ # @example Basic example
805
+ # require "google/cloud/security_center/v1p1beta1"
806
+ #
807
+ # # Create a client object. The client can be reused for multiple calls.
808
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
809
+ #
810
+ # # Create a request. To set request fields, pass in keyword arguments.
811
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::GetOrganizationSettingsRequest.new
812
+ #
813
+ # # Call the get_organization_settings method.
814
+ # result = client.get_organization_settings request
815
+ #
816
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::OrganizationSettings.
817
+ # p result
818
+ #
701
819
  def get_organization_settings request, options = nil
702
820
  raise ::ArgumentError, "request must be provided" if request.nil?
703
821
 
@@ -715,9 +833,11 @@ module Google
715
833
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
716
834
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
717
835
 
718
- header_params = {
719
- "name" => request.name
720
- }
836
+ header_params = {}
837
+ if request.name
838
+ header_params["name"] = request.name
839
+ end
840
+
721
841
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
722
842
  metadata[:"x-goog-request-params"] ||= request_params_header
723
843
 
@@ -767,6 +887,21 @@ module Google
767
887
  #
768
888
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
769
889
  #
890
+ # @example Basic example
891
+ # require "google/cloud/security_center/v1p1beta1"
892
+ #
893
+ # # Create a client object. The client can be reused for multiple calls.
894
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
895
+ #
896
+ # # Create a request. To set request fields, pass in keyword arguments.
897
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::GetSourceRequest.new
898
+ #
899
+ # # Call the get_source method.
900
+ # result = client.get_source request
901
+ #
902
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Source.
903
+ # p result
904
+ #
770
905
  def get_source request, options = nil
771
906
  raise ::ArgumentError, "request must be provided" if request.nil?
772
907
 
@@ -784,9 +919,11 @@ module Google
784
919
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
785
920
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
786
921
 
787
- header_params = {
788
- "name" => request.name
789
- }
922
+ header_params = {}
923
+ if request.name
924
+ header_params["name"] = request.name
925
+ end
926
+
790
927
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
791
928
  metadata[:"x-goog-request-params"] ||= request_params_header
792
929
 
@@ -960,6 +1097,27 @@ module Google
960
1097
  #
961
1098
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
962
1099
  #
1100
+ # @example Basic example
1101
+ # require "google/cloud/security_center/v1p1beta1"
1102
+ #
1103
+ # # Create a client object. The client can be reused for multiple calls.
1104
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1105
+ #
1106
+ # # Create a request. To set request fields, pass in keyword arguments.
1107
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::GroupAssetsRequest.new
1108
+ #
1109
+ # # Call the group_assets method.
1110
+ # result = client.group_assets request
1111
+ #
1112
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1113
+ # # iterate over all elements by calling #each, and the enumerable
1114
+ # # will lazily make API calls to fetch subsequent pages. Other
1115
+ # # methods are also available for managing paging directly.
1116
+ # result.each do |response|
1117
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::GroupResult.
1118
+ # p response
1119
+ # end
1120
+ #
963
1121
  def group_assets request, options = nil
964
1122
  raise ::ArgumentError, "request must be provided" if request.nil?
965
1123
 
@@ -977,9 +1135,11 @@ module Google
977
1135
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
978
1136
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
979
1137
 
980
- header_params = {
981
- "parent" => request.parent
982
- }
1138
+ header_params = {}
1139
+ if request.parent
1140
+ header_params["parent"] = request.parent
1141
+ end
1142
+
983
1143
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
984
1144
  metadata[:"x-goog-request-params"] ||= request_params_header
985
1145
 
@@ -1153,6 +1313,27 @@ module Google
1153
1313
  #
1154
1314
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1155
1315
  #
1316
+ # @example Basic example
1317
+ # require "google/cloud/security_center/v1p1beta1"
1318
+ #
1319
+ # # Create a client object. The client can be reused for multiple calls.
1320
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1321
+ #
1322
+ # # Create a request. To set request fields, pass in keyword arguments.
1323
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::GroupFindingsRequest.new
1324
+ #
1325
+ # # Call the group_findings method.
1326
+ # result = client.group_findings request
1327
+ #
1328
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1329
+ # # iterate over all elements by calling #each, and the enumerable
1330
+ # # will lazily make API calls to fetch subsequent pages. Other
1331
+ # # methods are also available for managing paging directly.
1332
+ # result.each do |response|
1333
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::GroupResult.
1334
+ # p response
1335
+ # end
1336
+ #
1156
1337
  def group_findings request, options = nil
1157
1338
  raise ::ArgumentError, "request must be provided" if request.nil?
1158
1339
 
@@ -1170,9 +1351,11 @@ module Google
1170
1351
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1171
1352
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1172
1353
 
1173
- header_params = {
1174
- "parent" => request.parent
1175
- }
1354
+ header_params = {}
1355
+ if request.parent
1356
+ header_params["parent"] = request.parent
1357
+ end
1358
+
1176
1359
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1177
1360
  metadata[:"x-goog-request-params"] ||= request_params_header
1178
1361
 
@@ -1350,6 +1533,27 @@ module Google
1350
1533
  #
1351
1534
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1352
1535
  #
1536
+ # @example Basic example
1537
+ # require "google/cloud/security_center/v1p1beta1"
1538
+ #
1539
+ # # Create a client object. The client can be reused for multiple calls.
1540
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1541
+ #
1542
+ # # Create a request. To set request fields, pass in keyword arguments.
1543
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::ListAssetsRequest.new
1544
+ #
1545
+ # # Call the list_assets method.
1546
+ # result = client.list_assets request
1547
+ #
1548
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1549
+ # # iterate over all elements by calling #each, and the enumerable
1550
+ # # will lazily make API calls to fetch subsequent pages. Other
1551
+ # # methods are also available for managing paging directly.
1552
+ # result.each do |response|
1553
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::ListAssetsResponse::ListAssetsResult.
1554
+ # p response
1555
+ # end
1556
+ #
1353
1557
  def list_assets request, options = nil
1354
1558
  raise ::ArgumentError, "request must be provided" if request.nil?
1355
1559
 
@@ -1367,9 +1571,11 @@ module Google
1367
1571
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1368
1572
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1369
1573
 
1370
- header_params = {
1371
- "parent" => request.parent
1372
- }
1574
+ header_params = {}
1575
+ if request.parent
1576
+ header_params["parent"] = request.parent
1577
+ end
1578
+
1373
1579
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1374
1580
  metadata[:"x-goog-request-params"] ||= request_params_header
1375
1581
 
@@ -1544,6 +1750,27 @@ module Google
1544
1750
  #
1545
1751
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1546
1752
  #
1753
+ # @example Basic example
1754
+ # require "google/cloud/security_center/v1p1beta1"
1755
+ #
1756
+ # # Create a client object. The client can be reused for multiple calls.
1757
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1758
+ #
1759
+ # # Create a request. To set request fields, pass in keyword arguments.
1760
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::ListFindingsRequest.new
1761
+ #
1762
+ # # Call the list_findings method.
1763
+ # result = client.list_findings request
1764
+ #
1765
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1766
+ # # iterate over all elements by calling #each, and the enumerable
1767
+ # # will lazily make API calls to fetch subsequent pages. Other
1768
+ # # methods are also available for managing paging directly.
1769
+ # result.each do |response|
1770
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::ListFindingsResponse::ListFindingsResult.
1771
+ # p response
1772
+ # end
1773
+ #
1547
1774
  def list_findings request, options = nil
1548
1775
  raise ::ArgumentError, "request must be provided" if request.nil?
1549
1776
 
@@ -1561,9 +1788,11 @@ module Google
1561
1788
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1562
1789
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1563
1790
 
1564
- header_params = {
1565
- "parent" => request.parent
1566
- }
1791
+ header_params = {}
1792
+ if request.parent
1793
+ header_params["parent"] = request.parent
1794
+ end
1795
+
1567
1796
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1568
1797
  metadata[:"x-goog-request-params"] ||= request_params_header
1569
1798
 
@@ -1621,6 +1850,27 @@ module Google
1621
1850
  #
1622
1851
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1623
1852
  #
1853
+ # @example Basic example
1854
+ # require "google/cloud/security_center/v1p1beta1"
1855
+ #
1856
+ # # Create a client object. The client can be reused for multiple calls.
1857
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1858
+ #
1859
+ # # Create a request. To set request fields, pass in keyword arguments.
1860
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::ListNotificationConfigsRequest.new
1861
+ #
1862
+ # # Call the list_notification_configs method.
1863
+ # result = client.list_notification_configs request
1864
+ #
1865
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1866
+ # # iterate over all elements by calling #each, and the enumerable
1867
+ # # will lazily make API calls to fetch subsequent pages. Other
1868
+ # # methods are also available for managing paging directly.
1869
+ # result.each do |response|
1870
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::NotificationConfig.
1871
+ # p response
1872
+ # end
1873
+ #
1624
1874
  def list_notification_configs request, options = nil
1625
1875
  raise ::ArgumentError, "request must be provided" if request.nil?
1626
1876
 
@@ -1638,9 +1888,11 @@ module Google
1638
1888
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1639
1889
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1640
1890
 
1641
- header_params = {
1642
- "parent" => request.parent
1643
- }
1891
+ header_params = {}
1892
+ if request.parent
1893
+ header_params["parent"] = request.parent
1894
+ end
1895
+
1644
1896
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1645
1897
  metadata[:"x-goog-request-params"] ||= request_params_header
1646
1898
 
@@ -1699,6 +1951,27 @@ module Google
1699
1951
  #
1700
1952
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1701
1953
  #
1954
+ # @example Basic example
1955
+ # require "google/cloud/security_center/v1p1beta1"
1956
+ #
1957
+ # # Create a client object. The client can be reused for multiple calls.
1958
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
1959
+ #
1960
+ # # Create a request. To set request fields, pass in keyword arguments.
1961
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::ListSourcesRequest.new
1962
+ #
1963
+ # # Call the list_sources method.
1964
+ # result = client.list_sources request
1965
+ #
1966
+ # # The returned object is of type Gapic::PagedEnumerable. You can
1967
+ # # iterate over all elements by calling #each, and the enumerable
1968
+ # # will lazily make API calls to fetch subsequent pages. Other
1969
+ # # methods are also available for managing paging directly.
1970
+ # result.each do |response|
1971
+ # # Each element is of type ::Google::Cloud::SecurityCenter::V1p1beta1::Source.
1972
+ # p response
1973
+ # end
1974
+ #
1702
1975
  def list_sources request, options = nil
1703
1976
  raise ::ArgumentError, "request must be provided" if request.nil?
1704
1977
 
@@ -1716,9 +1989,11 @@ module Google
1716
1989
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1717
1990
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1718
1991
 
1719
- header_params = {
1720
- "parent" => request.parent
1721
- }
1992
+ header_params = {}
1993
+ if request.parent
1994
+ header_params["parent"] = request.parent
1995
+ end
1996
+
1722
1997
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1723
1998
  metadata[:"x-goog-request-params"] ||= request_params_header
1724
1999
 
@@ -1774,6 +2049,28 @@ module Google
1774
2049
  #
1775
2050
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1776
2051
  #
2052
+ # @example Basic example
2053
+ # require "google/cloud/security_center/v1p1beta1"
2054
+ #
2055
+ # # Create a client object. The client can be reused for multiple calls.
2056
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2057
+ #
2058
+ # # Create a request. To set request fields, pass in keyword arguments.
2059
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::RunAssetDiscoveryRequest.new
2060
+ #
2061
+ # # Call the run_asset_discovery method.
2062
+ # result = client.run_asset_discovery request
2063
+ #
2064
+ # # The returned object is of type Gapic::Operation. You can use this
2065
+ # # object to check the status of an operation, cancel it, or wait
2066
+ # # for results. Here is how to block until completion:
2067
+ # result.wait_until_done! timeout: 60
2068
+ # if result.response?
2069
+ # p result.response
2070
+ # else
2071
+ # puts "Error!"
2072
+ # end
2073
+ #
1777
2074
  def run_asset_discovery request, options = nil
1778
2075
  raise ::ArgumentError, "request must be provided" if request.nil?
1779
2076
 
@@ -1791,9 +2088,11 @@ module Google
1791
2088
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1792
2089
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1793
2090
 
1794
- header_params = {
1795
- "parent" => request.parent
1796
- }
2091
+ header_params = {}
2092
+ if request.parent
2093
+ header_params["parent"] = request.parent
2094
+ end
2095
+
1797
2096
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1798
2097
  metadata[:"x-goog-request-params"] ||= request_params_header
1799
2098
 
@@ -1850,6 +2149,21 @@ module Google
1850
2149
  #
1851
2150
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1852
2151
  #
2152
+ # @example Basic example
2153
+ # require "google/cloud/security_center/v1p1beta1"
2154
+ #
2155
+ # # Create a client object. The client can be reused for multiple calls.
2156
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2157
+ #
2158
+ # # Create a request. To set request fields, pass in keyword arguments.
2159
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::SetFindingStateRequest.new
2160
+ #
2161
+ # # Call the set_finding_state method.
2162
+ # result = client.set_finding_state request
2163
+ #
2164
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Finding.
2165
+ # p result
2166
+ #
1853
2167
  def set_finding_state request, options = nil
1854
2168
  raise ::ArgumentError, "request must be provided" if request.nil?
1855
2169
 
@@ -1867,9 +2181,11 @@ module Google
1867
2181
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1868
2182
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1869
2183
 
1870
- header_params = {
1871
- "name" => request.name
1872
- }
2184
+ header_params = {}
2185
+ if request.name
2186
+ header_params["name"] = request.name
2187
+ end
2188
+
1873
2189
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1874
2190
  metadata[:"x-goog-request-params"] ||= request_params_header
1875
2191
 
@@ -1902,7 +2218,7 @@ module Google
1902
2218
  # @param options [::Gapic::CallOptions, ::Hash]
1903
2219
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1904
2220
  #
1905
- # @overload set_iam_policy(resource: nil, policy: nil)
2221
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
1906
2222
  # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
1907
2223
  # least one keyword argument is required. To specify no parameters, or to keep all
1908
2224
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1915,6 +2231,12 @@ module Google
1915
2231
  # the policy is limited to a few 10s of KB. An empty policy is a
1916
2232
  # valid policy but certain Cloud Platform services (such as Projects)
1917
2233
  # might reject them.
2234
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2235
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
2236
+ # the fields in the mask will be modified. If no mask is provided, the
2237
+ # following default mask is used:
2238
+ #
2239
+ # `paths: "bindings, etag"`
1918
2240
  #
1919
2241
  # @yield [response, operation] Access the result along with the RPC operation
1920
2242
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -1924,6 +2246,21 @@ module Google
1924
2246
  #
1925
2247
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
1926
2248
  #
2249
+ # @example Basic example
2250
+ # require "google/cloud/security_center/v1p1beta1"
2251
+ #
2252
+ # # Create a client object. The client can be reused for multiple calls.
2253
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2254
+ #
2255
+ # # Create a request. To set request fields, pass in keyword arguments.
2256
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
2257
+ #
2258
+ # # Call the set_iam_policy method.
2259
+ # result = client.set_iam_policy request
2260
+ #
2261
+ # # The returned object is of type Google::Iam::V1::Policy.
2262
+ # p result
2263
+ #
1927
2264
  def set_iam_policy request, options = nil
1928
2265
  raise ::ArgumentError, "request must be provided" if request.nil?
1929
2266
 
@@ -1941,9 +2278,11 @@ module Google
1941
2278
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
1942
2279
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1943
2280
 
1944
- header_params = {
1945
- "resource" => request.resource
1946
- }
2281
+ header_params = {}
2282
+ if request.resource
2283
+ header_params["resource"] = request.resource
2284
+ end
2285
+
1947
2286
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1948
2287
  metadata[:"x-goog-request-params"] ||= request_params_header
1949
2288
 
@@ -1998,6 +2337,21 @@ module Google
1998
2337
  #
1999
2338
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2000
2339
  #
2340
+ # @example Basic example
2341
+ # require "google/cloud/security_center/v1p1beta1"
2342
+ #
2343
+ # # Create a client object. The client can be reused for multiple calls.
2344
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2345
+ #
2346
+ # # Create a request. To set request fields, pass in keyword arguments.
2347
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
2348
+ #
2349
+ # # Call the test_iam_permissions method.
2350
+ # result = client.test_iam_permissions request
2351
+ #
2352
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
2353
+ # p result
2354
+ #
2001
2355
  def test_iam_permissions request, options = nil
2002
2356
  raise ::ArgumentError, "request must be provided" if request.nil?
2003
2357
 
@@ -2015,9 +2369,11 @@ module Google
2015
2369
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2016
2370
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2017
2371
 
2018
- header_params = {
2019
- "resource" => request.resource
2020
- }
2372
+ header_params = {}
2373
+ if request.resource
2374
+ header_params["resource"] = request.resource
2375
+ end
2376
+
2021
2377
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2022
2378
  metadata[:"x-goog-request-params"] ||= request_params_header
2023
2379
 
@@ -2080,6 +2436,21 @@ module Google
2080
2436
  #
2081
2437
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2082
2438
  #
2439
+ # @example Basic example
2440
+ # require "google/cloud/security_center/v1p1beta1"
2441
+ #
2442
+ # # Create a client object. The client can be reused for multiple calls.
2443
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2444
+ #
2445
+ # # Create a request. To set request fields, pass in keyword arguments.
2446
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::UpdateFindingRequest.new
2447
+ #
2448
+ # # Call the update_finding method.
2449
+ # result = client.update_finding request
2450
+ #
2451
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Finding.
2452
+ # p result
2453
+ #
2083
2454
  def update_finding request, options = nil
2084
2455
  raise ::ArgumentError, "request must be provided" if request.nil?
2085
2456
 
@@ -2097,9 +2468,11 @@ module Google
2097
2468
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2098
2469
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2099
2470
 
2100
- header_params = {
2101
- "finding.name" => request.finding.name
2102
- }
2471
+ header_params = {}
2472
+ if request.finding&.name
2473
+ header_params["finding.name"] = request.finding.name
2474
+ end
2475
+
2103
2476
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2104
2477
  metadata[:"x-goog-request-params"] ||= request_params_header
2105
2478
 
@@ -2153,6 +2526,21 @@ module Google
2153
2526
  #
2154
2527
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2155
2528
  #
2529
+ # @example Basic example
2530
+ # require "google/cloud/security_center/v1p1beta1"
2531
+ #
2532
+ # # Create a client object. The client can be reused for multiple calls.
2533
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2534
+ #
2535
+ # # Create a request. To set request fields, pass in keyword arguments.
2536
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::UpdateNotificationConfigRequest.new
2537
+ #
2538
+ # # Call the update_notification_config method.
2539
+ # result = client.update_notification_config request
2540
+ #
2541
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::NotificationConfig.
2542
+ # p result
2543
+ #
2156
2544
  def update_notification_config request, options = nil
2157
2545
  raise ::ArgumentError, "request must be provided" if request.nil?
2158
2546
 
@@ -2170,9 +2558,11 @@ module Google
2170
2558
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2171
2559
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2172
2560
 
2173
- header_params = {
2174
- "notification_config.name" => request.notification_config.name
2175
- }
2561
+ header_params = {}
2562
+ if request.notification_config&.name
2563
+ header_params["notification_config.name"] = request.notification_config.name
2564
+ end
2565
+
2176
2566
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2177
2567
  metadata[:"x-goog-request-params"] ||= request_params_header
2178
2568
 
@@ -2215,7 +2605,7 @@ module Google
2215
2605
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2216
2606
  # The FieldMask to use when updating the settings resource.
2217
2607
  #
2218
- # If empty all mutable fields will be updated.
2608
+ # If empty all mutable fields will be updated.
2219
2609
  #
2220
2610
  # @yield [response, operation] Access the result along with the RPC operation
2221
2611
  # @yieldparam response [::Google::Cloud::SecurityCenter::V1p1beta1::OrganizationSettings]
@@ -2225,6 +2615,21 @@ module Google
2225
2615
  #
2226
2616
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2227
2617
  #
2618
+ # @example Basic example
2619
+ # require "google/cloud/security_center/v1p1beta1"
2620
+ #
2621
+ # # Create a client object. The client can be reused for multiple calls.
2622
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2623
+ #
2624
+ # # Create a request. To set request fields, pass in keyword arguments.
2625
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::UpdateOrganizationSettingsRequest.new
2626
+ #
2627
+ # # Call the update_organization_settings method.
2628
+ # result = client.update_organization_settings request
2629
+ #
2630
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::OrganizationSettings.
2631
+ # p result
2632
+ #
2228
2633
  def update_organization_settings request, options = nil
2229
2634
  raise ::ArgumentError, "request must be provided" if request.nil?
2230
2635
 
@@ -2242,9 +2647,11 @@ module Google
2242
2647
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2243
2648
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2244
2649
 
2245
- header_params = {
2246
- "organization_settings.name" => request.organization_settings.name
2247
- }
2650
+ header_params = {}
2651
+ if request.organization_settings&.name
2652
+ header_params["organization_settings.name"] = request.organization_settings.name
2653
+ end
2654
+
2248
2655
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2249
2656
  metadata[:"x-goog-request-params"] ||= request_params_header
2250
2657
 
@@ -2297,6 +2704,21 @@ module Google
2297
2704
  #
2298
2705
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2299
2706
  #
2707
+ # @example Basic example
2708
+ # require "google/cloud/security_center/v1p1beta1"
2709
+ #
2710
+ # # Create a client object. The client can be reused for multiple calls.
2711
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2712
+ #
2713
+ # # Create a request. To set request fields, pass in keyword arguments.
2714
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::UpdateSourceRequest.new
2715
+ #
2716
+ # # Call the update_source method.
2717
+ # result = client.update_source request
2718
+ #
2719
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::Source.
2720
+ # p result
2721
+ #
2300
2722
  def update_source request, options = nil
2301
2723
  raise ::ArgumentError, "request must be provided" if request.nil?
2302
2724
 
@@ -2314,9 +2736,11 @@ module Google
2314
2736
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2315
2737
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2316
2738
 
2317
- header_params = {
2318
- "source.name" => request.source.name
2319
- }
2739
+ header_params = {}
2740
+ if request.source&.name
2741
+ header_params["source.name"] = request.source.name
2742
+ end
2743
+
2320
2744
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2321
2745
  metadata[:"x-goog-request-params"] ||= request_params_header
2322
2746
 
@@ -2375,6 +2799,21 @@ module Google
2375
2799
  #
2376
2800
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
2377
2801
  #
2802
+ # @example Basic example
2803
+ # require "google/cloud/security_center/v1p1beta1"
2804
+ #
2805
+ # # Create a client object. The client can be reused for multiple calls.
2806
+ # client = Google::Cloud::SecurityCenter::V1p1beta1::SecurityCenter::Client.new
2807
+ #
2808
+ # # Create a request. To set request fields, pass in keyword arguments.
2809
+ # request = Google::Cloud::SecurityCenter::V1p1beta1::UpdateSecurityMarksRequest.new
2810
+ #
2811
+ # # Call the update_security_marks method.
2812
+ # result = client.update_security_marks request
2813
+ #
2814
+ # # The returned object is of type Google::Cloud::SecurityCenter::V1p1beta1::SecurityMarks.
2815
+ # p result
2816
+ #
2378
2817
  def update_security_marks request, options = nil
2379
2818
  raise ::ArgumentError, "request must be provided" if request.nil?
2380
2819
 
@@ -2392,9 +2831,11 @@ module Google
2392
2831
  gapic_version: ::Google::Cloud::SecurityCenter::V1p1beta1::VERSION
2393
2832
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2394
2833
 
2395
- header_params = {
2396
- "security_marks.name" => request.security_marks.name
2397
- }
2834
+ header_params = {}
2835
+ if request.security_marks&.name
2836
+ header_params["security_marks.name"] = request.security_marks.name
2837
+ end
2838
+
2398
2839
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2399
2840
  metadata[:"x-goog-request-params"] ||= request_params_header
2400
2841