google-cloud-security_center_management-v1 0.1.0 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -31,6 +31,9 @@ module Google
31
31
  # Service describing handlers for resources
32
32
  #
33
33
  class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
34
37
  # @private
35
38
  DEFAULT_ENDPOINT_TEMPLATE = "securitycentermanagement.$UNIVERSE_DOMAIN$"
36
39
 
@@ -269,11 +272,12 @@ module Google
269
272
  # the default parameter values, pass an empty Hash as a request object (see above).
270
273
  #
271
274
  # @param parent [::String]
272
- # Required. Name of parent to list effective custom modules. Its format is
273
- # "organizations/\\{organization}/locations/\\{location}",
274
- # "folders/\\{folder}/locations/\\{location}",
275
+ # Required. Name of parent to list effective custom modules. specified in one
276
+ # of the following formats:
277
+ # * `organizations/{organization}/locations/{location}`
278
+ # * `folders/{folder}/locations/{location}`
275
279
  # or
276
- # "projects/\\{project}/locations/\\{location}"
280
+ # `projects/{project}/locations/{location}`
277
281
  # @param page_size [::Integer]
278
282
  # Optional. The maximum number of results to return in a single response.
279
283
  # Default is 10, minimum is 1, maximum is 1000.
@@ -318,10 +322,11 @@ module Google
318
322
  # Customize the options with defaults
319
323
  metadata = @config.rpcs.list_effective_security_health_analytics_custom_modules.metadata.to_h
320
324
 
321
- # Set x-goog-api-client and x-goog-user-project headers
325
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
322
326
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
323
327
  lib_name: @config.lib_name, lib_version: @config.lib_version,
324
328
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
329
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
325
330
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
326
331
 
327
332
  header_params = {}
@@ -368,13 +373,12 @@ module Google
368
373
  # the default parameter values, pass an empty Hash as a request object (see above).
369
374
  #
370
375
  # @param name [::String]
371
- # Required. The resource name of the SHA custom module.
376
+ # Required. The full resource name of the custom module, specified in one of
377
+ # the following formats:
372
378
  #
373
- # Its format is:
374
- #
375
- # * "organizations/\\{organization}/locations/\\{location}/effectiveSecurityHealthAnalyticsCustomModules/\\{module_id}".
376
- # * "folders/\\{folder}/locations/\\{location}/effectiveSecurityHealthAnalyticsCustomModules/\\{module_id}".
377
- # * "projects/\\{project}/locations/\\{location}/effectiveSecurityHealthAnalyticsCustomModules/\\{module_id}".
379
+ # * `organizations/organization/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
380
+ # * `folders/folder/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
381
+ # * `projects/project/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
378
382
  #
379
383
  # @yield [response, operation] Access the result along with the RPC operation
380
384
  # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule]
@@ -410,10 +414,11 @@ module Google
410
414
  # Customize the options with defaults
411
415
  metadata = @config.rpcs.get_effective_security_health_analytics_custom_module.metadata.to_h
412
416
 
413
- # Set x-goog-api-client and x-goog-user-project headers
417
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
414
418
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
415
419
  lib_name: @config.lib_name, lib_version: @config.lib_version,
416
420
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
421
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
417
422
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
418
423
 
419
424
  header_params = {}
@@ -461,11 +466,12 @@ module Google
461
466
  # the default parameter values, pass an empty Hash as a request object (see above).
462
467
  #
463
468
  # @param parent [::String]
464
- # Required. Name of parent to list custom modules. Its format is
465
- # "organizations/\\{organization}/locations/\\{location}",
466
- # "folders/\\{folder}/locations/\\{location}",
467
- # or
468
- # "projects/\\{project}/locations/\\{location}"
469
+ # Required. Name of parent organization, folder, or project in which to list
470
+ # custom modules, specified in one of the following formats:
471
+ #
472
+ # * `organizations/{organization}/locations/{location}`
473
+ # * `folders/{folder}/locations/{location}`
474
+ # * `projects/{project}/locations/{location}`
469
475
  # @param page_size [::Integer]
470
476
  # Optional. The maximum number of results to return in a single response.
471
477
  # Default is 10, minimum is 1, maximum is 1000.
@@ -510,10 +516,11 @@ module Google
510
516
  # Customize the options with defaults
511
517
  metadata = @config.rpcs.list_security_health_analytics_custom_modules.metadata.to_h
512
518
 
513
- # Set x-goog-api-client and x-goog-user-project headers
519
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
514
520
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
515
521
  lib_name: @config.lib_name, lib_version: @config.lib_version,
516
522
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
523
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
517
524
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
518
525
 
519
526
  header_params = {}
@@ -561,11 +568,12 @@ module Google
561
568
  # the default parameter values, pass an empty Hash as a request object (see above).
562
569
  #
563
570
  # @param parent [::String]
564
- # Required. Name of parent to list custom modules. Its format is
565
- # "organizations/\\{organization}/locations/\\{location}",
566
- # "folders/\\{folder}/locations/\\{location}",
567
- # or
568
- # "projects/\\{project}/locations/\\{location}"
571
+ # Required. Name of the parent organization, folder, or project in which to
572
+ # list custom modules, specified in one of the following formats:
573
+ #
574
+ # * `organizations/{organization}/locations/{location}`
575
+ # * `folders/{folder}/locations/{location}`
576
+ # * `projects/{project}/locations/{location}`
569
577
  # @param page_size [::Integer]
570
578
  # Optional. The maximum number of results to return in a single response.
571
579
  # Default is 10, minimum is 1, maximum is 1000.
@@ -610,10 +618,11 @@ module Google
610
618
  # Customize the options with defaults
611
619
  metadata = @config.rpcs.list_descendant_security_health_analytics_custom_modules.metadata.to_h
612
620
 
613
- # Set x-goog-api-client and x-goog-user-project headers
621
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
614
622
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
615
623
  lib_name: @config.lib_name, lib_version: @config.lib_version,
616
624
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
625
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
617
626
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
618
627
 
619
628
  header_params = {}
@@ -696,10 +705,11 @@ module Google
696
705
  # Customize the options with defaults
697
706
  metadata = @config.rpcs.get_security_health_analytics_custom_module.metadata.to_h
698
707
 
699
- # Set x-goog-api-client and x-goog-user-project headers
708
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
700
709
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
701
710
  lib_name: @config.lib_name, lib_version: @config.lib_version,
702
711
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
712
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
703
713
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
704
714
 
705
715
  header_params = {}
@@ -748,11 +758,12 @@ module Google
748
758
  # the default parameter values, pass an empty Hash as a request object (see above).
749
759
  #
750
760
  # @param parent [::String]
751
- # Required. Name of the parent for the module. Its format is
752
- # "organizations/\\{organization}/locations/\\{location}",
753
- # "folders/\\{folder}/locations/\\{location}",
754
- # or
755
- # "projects/\\{project}/locations/\\{location}"
761
+ # Required. Name of the parent organization, folder, or project of the
762
+ # module, specified in one of the following formats:
763
+ #
764
+ # * `organizations/{organization}/locations/{location}`
765
+ # * `folders/{folder}/locations/{location}`
766
+ # * `projects/{project}/locations/{location}`
756
767
  # @param security_health_analytics_custom_module [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule, ::Hash]
757
768
  # Required. The resource being created
758
769
  # @param validate_only [::Boolean]
@@ -799,10 +810,11 @@ module Google
799
810
  # Customize the options with defaults
800
811
  metadata = @config.rpcs.create_security_health_analytics_custom_module.metadata.to_h
801
812
 
802
- # Set x-goog-api-client and x-goog-user-project headers
813
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
803
814
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
804
815
  lib_name: @config.lib_name, lib_version: @config.lib_version,
805
816
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
817
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
806
818
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
807
819
 
808
820
  header_params = {}
@@ -901,10 +913,11 @@ module Google
901
913
  # Customize the options with defaults
902
914
  metadata = @config.rpcs.update_security_health_analytics_custom_module.metadata.to_h
903
915
 
904
- # Set x-goog-api-client and x-goog-user-project headers
916
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
905
917
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
906
918
  lib_name: @config.lib_name, lib_version: @config.lib_version,
907
919
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
920
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
908
921
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
909
922
 
910
923
  header_params = {}
@@ -956,9 +969,9 @@ module Google
956
969
  #
957
970
  # Its format is:
958
971
  #
959
- # * "organizations/\\{organization}/locations/\\{location}/securityHealthAnalyticsCustomModules/\\{security_health_analytics_custom_module}".
960
- # * "folders/\\{folder}/locations/\\{location}/securityHealthAnalyticsCustomModules/\\{security_health_analytics_custom_module}".
961
- # * "projects/\\{project}/locations/\\{location}/securityHealthAnalyticsCustomModules/\\{security_health_analytics_custom_module}".
972
+ # * `organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
973
+ # * `folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
974
+ # * `projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
962
975
  # @param validate_only [::Boolean]
963
976
  # Optional. When set to true, only validations (including IAM checks) will
964
977
  # done for the request (module will not be deleted). An OK response indicates
@@ -1002,10 +1015,11 @@ module Google
1002
1015
  # Customize the options with defaults
1003
1016
  metadata = @config.rpcs.delete_security_health_analytics_custom_module.metadata.to_h
1004
1017
 
1005
- # Set x-goog-api-client and x-goog-user-project headers
1018
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1006
1019
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1007
1020
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1008
1021
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1022
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1009
1023
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1010
1024
 
1011
1025
  header_params = {}
@@ -1095,10 +1109,11 @@ module Google
1095
1109
  # Customize the options with defaults
1096
1110
  metadata = @config.rpcs.simulate_security_health_analytics_custom_module.metadata.to_h
1097
1111
 
1098
- # Set x-goog-api-client and x-goog-user-project headers
1112
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1099
1113
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1100
1114
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1101
1115
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1116
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1102
1117
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1103
1118
 
1104
1119
  header_params = {}
@@ -1147,10 +1162,10 @@ module Google
1147
1162
  #
1148
1163
  # @param parent [::String]
1149
1164
  # Required. Name of parent to list effective custom modules. Its format is
1150
- # "organizations/\\{organization}/locations/\\{location}",
1151
- # "folders/\\{folder}/locations/\\{location}",
1165
+ # `organizations/{organization}/locations/{location}`,
1166
+ # `folders/{folder}/locations/{location}`,
1152
1167
  # or
1153
- # "projects/\\{project}/locations/\\{location}"
1168
+ # `projects/{project}/locations/{location}`
1154
1169
  # @param page_size [::Integer]
1155
1170
  # Optional. The maximum number of results to return in a single response.
1156
1171
  # Default is 10, minimum is 1, maximum is 1000.
@@ -1195,10 +1210,11 @@ module Google
1195
1210
  # Customize the options with defaults
1196
1211
  metadata = @config.rpcs.list_effective_event_threat_detection_custom_modules.metadata.to_h
1197
1212
 
1198
- # Set x-goog-api-client and x-goog-user-project headers
1213
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1199
1214
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1200
1215
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1201
1216
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1217
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1202
1218
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1203
1219
 
1204
1220
  header_params = {}
@@ -1255,9 +1271,9 @@ module Google
1255
1271
  #
1256
1272
  # Its format is:
1257
1273
  #
1258
- # * "organizations/\\{organization}/locations/\\{location}/effectiveEventThreatDetectionCustomModules/\\{effective_event_threat_detection_custom_module}".
1259
- # * "folders/\\{folder}/locations/\\{location}/effectiveEventThreatDetectionCustomModules/\\{effective_event_threat_detection_custom_module}".
1260
- # * "projects/\\{project}/locations/\\{location}/effectiveEventThreatDetectionCustomModules/\\{effective_event_threat_detection_custom_module}".
1274
+ # * `organizations/{organization}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
1275
+ # * `folders/{folder}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
1276
+ # * `projects/{project}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
1261
1277
  #
1262
1278
  # @yield [response, operation] Access the result along with the RPC operation
1263
1279
  # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EffectiveEventThreatDetectionCustomModule]
@@ -1293,10 +1309,11 @@ module Google
1293
1309
  # Customize the options with defaults
1294
1310
  metadata = @config.rpcs.get_effective_event_threat_detection_custom_module.metadata.to_h
1295
1311
 
1296
- # Set x-goog-api-client and x-goog-user-project headers
1312
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1297
1313
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1298
1314
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1299
1315
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1316
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1300
1317
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1301
1318
 
1302
1319
  header_params = {}
@@ -1345,10 +1362,10 @@ module Google
1345
1362
  #
1346
1363
  # @param parent [::String]
1347
1364
  # Required. Name of parent to list custom modules. Its format is
1348
- # "organizations/\\{organization}/locations/\\{location}",
1349
- # "folders/\\{folder}/locations/\\{location}",
1365
+ # `organizations/{organization}/locations/{location}`,
1366
+ # `folders/{folder}/locations/{location}`,
1350
1367
  # or
1351
- # "projects/\\{project}/locations/\\{location}"
1368
+ # `projects/{project}/locations/{location}`
1352
1369
  # @param page_size [::Integer]
1353
1370
  # Optional. The maximum number of modules to return. The service may return
1354
1371
  # fewer than this value. If unspecified, at most 10 configs will be returned.
@@ -1400,10 +1417,11 @@ module Google
1400
1417
  # Customize the options with defaults
1401
1418
  metadata = @config.rpcs.list_event_threat_detection_custom_modules.metadata.to_h
1402
1419
 
1403
- # Set x-goog-api-client and x-goog-user-project headers
1420
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1404
1421
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1405
1422
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1406
1423
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1424
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1407
1425
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1408
1426
 
1409
1427
  header_params = {}
@@ -1452,10 +1470,10 @@ module Google
1452
1470
  #
1453
1471
  # @param parent [::String]
1454
1472
  # Required. Name of parent to list custom modules. Its format is
1455
- # "organizations/\\{organization}/locations/\\{location}",
1456
- # "folders/\\{folder}/locations/\\{location}",
1473
+ # `organizations/{organization}/locations/{location}`,
1474
+ # `folders/{folder}/locations/{location}`,
1457
1475
  # or
1458
- # "projects/\\{project}/locations/\\{location}"
1476
+ # `projects/{project}/locations/{location}`
1459
1477
  # @param page_size [::Integer]
1460
1478
  # Optional. The maximum number of modules to return. The service may return
1461
1479
  # fewer than this value. If unspecified, at most 10 configs will be returned.
@@ -1501,10 +1519,11 @@ module Google
1501
1519
  # Customize the options with defaults
1502
1520
  metadata = @config.rpcs.list_descendant_event_threat_detection_custom_modules.metadata.to_h
1503
1521
 
1504
- # Set x-goog-api-client and x-goog-user-project headers
1522
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1505
1523
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1506
1524
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1507
1525
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1526
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1508
1527
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1509
1528
 
1510
1529
  header_params = {}
@@ -1555,9 +1574,9 @@ module Google
1555
1574
  #
1556
1575
  # Its format is:
1557
1576
  #
1558
- # * "organizations/\\{organization}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1559
- # * "folders/\\{folder}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1560
- # * "projects/\\{project}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1577
+ # * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1578
+ # * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1579
+ # * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1561
1580
  #
1562
1581
  # @yield [response, operation] Access the result along with the RPC operation
1563
1582
  # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule]
@@ -1593,10 +1612,11 @@ module Google
1593
1612
  # Customize the options with defaults
1594
1613
  metadata = @config.rpcs.get_event_threat_detection_custom_module.metadata.to_h
1595
1614
 
1596
- # Set x-goog-api-client and x-goog-user-project headers
1615
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1597
1616
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1598
1617
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1599
1618
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1619
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1600
1620
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1601
1621
 
1602
1622
  header_params = {}
@@ -1646,10 +1666,10 @@ module Google
1646
1666
  #
1647
1667
  # @param parent [::String]
1648
1668
  # Required. Name of parent for the module. Its format is
1649
- # "organizations/\\{organization}/locations/\\{location}",
1650
- # "folders/\\{folder}/locations/\\{location}",
1669
+ # `organizations/{organization}/locations/{location}`,
1670
+ # `folders/{folder}/locations/{location}`,
1651
1671
  # or
1652
- # "projects/\\{project}/locations/\\{location}"
1672
+ # `projects/{project}/locations/{location}`
1653
1673
  # @param event_threat_detection_custom_module [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule, ::Hash]
1654
1674
  # Required. The module to create. The
1655
1675
  # event_threat_detection_custom_module.name will be ignored and server
@@ -1697,10 +1717,11 @@ module Google
1697
1717
  # Customize the options with defaults
1698
1718
  metadata = @config.rpcs.create_event_threat_detection_custom_module.metadata.to_h
1699
1719
 
1700
- # Set x-goog-api-client and x-goog-user-project headers
1720
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1701
1721
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1702
1722
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1703
1723
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1724
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1704
1725
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1705
1726
 
1706
1727
  header_params = {}
@@ -1801,10 +1822,11 @@ module Google
1801
1822
  # Customize the options with defaults
1802
1823
  metadata = @config.rpcs.update_event_threat_detection_custom_module.metadata.to_h
1803
1824
 
1804
- # Set x-goog-api-client and x-goog-user-project headers
1825
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1805
1826
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1806
1827
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1807
1828
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1829
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1808
1830
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1809
1831
 
1810
1832
  header_params = {}
@@ -1856,9 +1878,9 @@ module Google
1856
1878
  #
1857
1879
  # Its format is:
1858
1880
  #
1859
- # * "organizations/\\{organization}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1860
- # * "folders/\\{folder}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1861
- # * "projects/\\{project}/locations/\\{location}/eventThreatDetectionCustomModules/\\{event_threat_detection_custom_module}".
1881
+ # * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1882
+ # * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1883
+ # * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
1862
1884
  # @param validate_only [::Boolean]
1863
1885
  # Optional. When set to true, only validations (including IAM checks) will
1864
1886
  # done for the request (module will not be deleted). An OK response indicates
@@ -1902,10 +1924,11 @@ module Google
1902
1924
  # Customize the options with defaults
1903
1925
  metadata = @config.rpcs.delete_event_threat_detection_custom_module.metadata.to_h
1904
1926
 
1905
- # Set x-goog-api-client and x-goog-user-project headers
1927
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1906
1928
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1907
1929
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1908
1930
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
1931
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1909
1932
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1910
1933
 
1911
1934
  header_params = {}
@@ -1955,7 +1978,7 @@ module Google
1955
1978
  #
1956
1979
  # Its format is:
1957
1980
  #
1958
- # * "organizations/\\{organization}/locations/\\{location}".
1981
+ # * `organizations/{organization}/locations/{location}`.
1959
1982
  # @param raw_text [::String]
1960
1983
  # Required. The raw text of the module's contents. Used to generate error
1961
1984
  # messages.
@@ -1996,10 +2019,11 @@ module Google
1996
2019
  # Customize the options with defaults
1997
2020
  metadata = @config.rpcs.validate_event_threat_detection_custom_module.metadata.to_h
1998
2021
 
1999
- # Set x-goog-api-client and x-goog-user-project headers
2022
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2000
2023
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2001
2024
  lib_name: @config.lib_name, lib_version: @config.lib_version,
2002
2025
  gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
2026
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2003
2027
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2004
2028
 
2005
2029
  header_params = {}
@@ -2026,6 +2050,308 @@ module Google
2026
2050
  raise ::Google::Cloud::Error.from_error(e)
2027
2051
  end
2028
2052
 
2053
+ ##
2054
+ # Gets service settings for the specified Security Command Center service.
2055
+ #
2056
+ # @overload get_security_center_service(request, options = nil)
2057
+ # Pass arguments to `get_security_center_service` via a request object, either of type
2058
+ # {::Google::Cloud::SecurityCenterManagement::V1::GetSecurityCenterServiceRequest} or an equivalent Hash.
2059
+ #
2060
+ # @param request [::Google::Cloud::SecurityCenterManagement::V1::GetSecurityCenterServiceRequest, ::Hash]
2061
+ # A request object representing the call parameters. Required. To specify no
2062
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2063
+ # @param options [::Gapic::CallOptions, ::Hash]
2064
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2065
+ #
2066
+ # @overload get_security_center_service(name: nil)
2067
+ # Pass arguments to `get_security_center_service` via keyword arguments. Note that at
2068
+ # least one keyword argument is required. To specify no parameters, or to keep all
2069
+ # the default parameter values, pass an empty Hash as a request object (see above).
2070
+ #
2071
+ # @param name [::String]
2072
+ # Required. The Security Command Center service to retrieve.
2073
+ #
2074
+ # Formats:
2075
+ #
2076
+ # * organizations/\\{organization}/locations/\\{location}/securityCenterServices/\\{service}
2077
+ # * folders/\\{folder}/locations/\\{location}/securityCenterServices/\\{service}
2078
+ # * projects/\\{project}/locations/\\{location}/securityCenterServices/\\{service}
2079
+ #
2080
+ # The possible values for id \\{service} are:
2081
+ #
2082
+ # * container-threat-detection
2083
+ # * event-threat-detection
2084
+ # * security-health-analytics
2085
+ # * vm-threat-detection
2086
+ # * web-security-scanner
2087
+ #
2088
+ # @yield [response, operation] Access the result along with the RPC operation
2089
+ # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]
2090
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2091
+ #
2092
+ # @return [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]
2093
+ #
2094
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2095
+ #
2096
+ # @example Basic example
2097
+ # require "google/cloud/security_center_management/v1"
2098
+ #
2099
+ # # Create a client object. The client can be reused for multiple calls.
2100
+ # client = Google::Cloud::SecurityCenterManagement::V1::SecurityCenterManagement::Client.new
2101
+ #
2102
+ # # Create a request. To set request fields, pass in keyword arguments.
2103
+ # request = Google::Cloud::SecurityCenterManagement::V1::GetSecurityCenterServiceRequest.new
2104
+ #
2105
+ # # Call the get_security_center_service method.
2106
+ # result = client.get_security_center_service request
2107
+ #
2108
+ # # The returned object is of type Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService.
2109
+ # p result
2110
+ #
2111
+ def get_security_center_service request, options = nil
2112
+ raise ::ArgumentError, "request must be provided" if request.nil?
2113
+
2114
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::SecurityCenterManagement::V1::GetSecurityCenterServiceRequest
2115
+
2116
+ # Converts hash and nil to an options object
2117
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2118
+
2119
+ # Customize the options with defaults
2120
+ metadata = @config.rpcs.get_security_center_service.metadata.to_h
2121
+
2122
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2123
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2124
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2125
+ gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
2126
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2127
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2128
+
2129
+ header_params = {}
2130
+ if request.name
2131
+ header_params["name"] = request.name
2132
+ end
2133
+
2134
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2135
+ metadata[:"x-goog-request-params"] ||= request_params_header
2136
+
2137
+ options.apply_defaults timeout: @config.rpcs.get_security_center_service.timeout,
2138
+ metadata: metadata,
2139
+ retry_policy: @config.rpcs.get_security_center_service.retry_policy
2140
+
2141
+ options.apply_defaults timeout: @config.timeout,
2142
+ metadata: @config.metadata,
2143
+ retry_policy: @config.retry_policy
2144
+
2145
+ @security_center_management_stub.call_rpc :get_security_center_service, request, options: options do |response, operation|
2146
+ yield response, operation if block_given?
2147
+ return response
2148
+ end
2149
+ rescue ::GRPC::BadStatus => e
2150
+ raise ::Google::Cloud::Error.from_error(e)
2151
+ end
2152
+
2153
+ ##
2154
+ # Returns a list of all Security Command Center services for the given
2155
+ # parent.
2156
+ #
2157
+ # @overload list_security_center_services(request, options = nil)
2158
+ # Pass arguments to `list_security_center_services` via a request object, either of type
2159
+ # {::Google::Cloud::SecurityCenterManagement::V1::ListSecurityCenterServicesRequest} or an equivalent Hash.
2160
+ #
2161
+ # @param request [::Google::Cloud::SecurityCenterManagement::V1::ListSecurityCenterServicesRequest, ::Hash]
2162
+ # A request object representing the call parameters. Required. To specify no
2163
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2164
+ # @param options [::Gapic::CallOptions, ::Hash]
2165
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2166
+ #
2167
+ # @overload list_security_center_services(parent: nil, page_size: nil, page_token: nil)
2168
+ # Pass arguments to `list_security_center_services` via keyword arguments. Note that at
2169
+ # least one keyword argument is required. To specify no parameters, or to keep all
2170
+ # the default parameter values, pass an empty Hash as a request object (see above).
2171
+ #
2172
+ # @param parent [::String]
2173
+ # Required. The name of the parent to list Security Command Center services.
2174
+ #
2175
+ # Formats:
2176
+ #
2177
+ # * organizations/\\{organization}/locations/\\{location}
2178
+ # * folders/\\{folder}/locations/\\{location}
2179
+ # * projects/\\{project}/locations/\\{location}
2180
+ # @param page_size [::Integer]
2181
+ # Optional. The maximum number of results to return in a single response.
2182
+ # Default is 10, minimum is 1, maximum is 1000.
2183
+ # @param page_token [::String]
2184
+ # Optional. The value returned by the last call indicating a continuation.
2185
+ #
2186
+ # @yield [response, operation] Access the result along with the RPC operation
2187
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService>]
2188
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2189
+ #
2190
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService>]
2191
+ #
2192
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2193
+ #
2194
+ # @example Basic example
2195
+ # require "google/cloud/security_center_management/v1"
2196
+ #
2197
+ # # Create a client object. The client can be reused for multiple calls.
2198
+ # client = Google::Cloud::SecurityCenterManagement::V1::SecurityCenterManagement::Client.new
2199
+ #
2200
+ # # Create a request. To set request fields, pass in keyword arguments.
2201
+ # request = Google::Cloud::SecurityCenterManagement::V1::ListSecurityCenterServicesRequest.new
2202
+ #
2203
+ # # Call the list_security_center_services method.
2204
+ # result = client.list_security_center_services request
2205
+ #
2206
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2207
+ # # over elements, and API calls will be issued to fetch pages as needed.
2208
+ # result.each do |item|
2209
+ # # Each element is of type ::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService.
2210
+ # p item
2211
+ # end
2212
+ #
2213
+ def list_security_center_services request, options = nil
2214
+ raise ::ArgumentError, "request must be provided" if request.nil?
2215
+
2216
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::SecurityCenterManagement::V1::ListSecurityCenterServicesRequest
2217
+
2218
+ # Converts hash and nil to an options object
2219
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2220
+
2221
+ # Customize the options with defaults
2222
+ metadata = @config.rpcs.list_security_center_services.metadata.to_h
2223
+
2224
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2225
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2226
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2227
+ gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
2228
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2229
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2230
+
2231
+ header_params = {}
2232
+ if request.parent
2233
+ header_params["parent"] = request.parent
2234
+ end
2235
+
2236
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2237
+ metadata[:"x-goog-request-params"] ||= request_params_header
2238
+
2239
+ options.apply_defaults timeout: @config.rpcs.list_security_center_services.timeout,
2240
+ metadata: metadata,
2241
+ retry_policy: @config.rpcs.list_security_center_services.retry_policy
2242
+
2243
+ options.apply_defaults timeout: @config.timeout,
2244
+ metadata: @config.metadata,
2245
+ retry_policy: @config.retry_policy
2246
+
2247
+ @security_center_management_stub.call_rpc :list_security_center_services, request, options: options do |response, operation|
2248
+ response = ::Gapic::PagedEnumerable.new @security_center_management_stub, :list_security_center_services, request, response, operation, options
2249
+ yield response, operation if block_given?
2250
+ return response
2251
+ end
2252
+ rescue ::GRPC::BadStatus => e
2253
+ raise ::Google::Cloud::Error.from_error(e)
2254
+ end
2255
+
2256
+ ##
2257
+ # Updates a Security Command Center service using the given update mask.
2258
+ #
2259
+ # @overload update_security_center_service(request, options = nil)
2260
+ # Pass arguments to `update_security_center_service` via a request object, either of type
2261
+ # {::Google::Cloud::SecurityCenterManagement::V1::UpdateSecurityCenterServiceRequest} or an equivalent Hash.
2262
+ #
2263
+ # @param request [::Google::Cloud::SecurityCenterManagement::V1::UpdateSecurityCenterServiceRequest, ::Hash]
2264
+ # A request object representing the call parameters. Required. To specify no
2265
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2266
+ # @param options [::Gapic::CallOptions, ::Hash]
2267
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2268
+ #
2269
+ # @overload update_security_center_service(security_center_service: nil, update_mask: nil, validate_only: nil)
2270
+ # Pass arguments to `update_security_center_service` via keyword arguments. Note that at
2271
+ # least one keyword argument is required. To specify no parameters, or to keep all
2272
+ # the default parameter values, pass an empty Hash as a request object (see above).
2273
+ #
2274
+ # @param security_center_service [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService, ::Hash]
2275
+ # Required. The updated service.
2276
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2277
+ # Required. The list of fields to be updated. Possible values:
2278
+ #
2279
+ # * "intended_enablement_state"
2280
+ # * "modules"
2281
+ # @param validate_only [::Boolean]
2282
+ # Optional. When set to true, only validations (including IAM checks) will
2283
+ # done for the request (service will not be updated). An OK response
2284
+ # indicates the request is valid while an error response indicates the
2285
+ # request is invalid. Note that a subsequent request to actually update the
2286
+ # service could still fail because 1. the state could have changed (e.g. IAM
2287
+ # permission lost) or
2288
+ # 2. A failure occurred while trying to delete the module.
2289
+ #
2290
+ # @yield [response, operation] Access the result along with the RPC operation
2291
+ # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]
2292
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2293
+ #
2294
+ # @return [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]
2295
+ #
2296
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2297
+ #
2298
+ # @example Basic example
2299
+ # require "google/cloud/security_center_management/v1"
2300
+ #
2301
+ # # Create a client object. The client can be reused for multiple calls.
2302
+ # client = Google::Cloud::SecurityCenterManagement::V1::SecurityCenterManagement::Client.new
2303
+ #
2304
+ # # Create a request. To set request fields, pass in keyword arguments.
2305
+ # request = Google::Cloud::SecurityCenterManagement::V1::UpdateSecurityCenterServiceRequest.new
2306
+ #
2307
+ # # Call the update_security_center_service method.
2308
+ # result = client.update_security_center_service request
2309
+ #
2310
+ # # The returned object is of type Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService.
2311
+ # p result
2312
+ #
2313
+ def update_security_center_service request, options = nil
2314
+ raise ::ArgumentError, "request must be provided" if request.nil?
2315
+
2316
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::SecurityCenterManagement::V1::UpdateSecurityCenterServiceRequest
2317
+
2318
+ # Converts hash and nil to an options object
2319
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2320
+
2321
+ # Customize the options with defaults
2322
+ metadata = @config.rpcs.update_security_center_service.metadata.to_h
2323
+
2324
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2325
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2326
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2327
+ gapic_version: ::Google::Cloud::SecurityCenterManagement::V1::VERSION
2328
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2329
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2330
+
2331
+ header_params = {}
2332
+ if request.security_center_service&.name
2333
+ header_params["security_center_service.name"] = request.security_center_service.name
2334
+ end
2335
+
2336
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2337
+ metadata[:"x-goog-request-params"] ||= request_params_header
2338
+
2339
+ options.apply_defaults timeout: @config.rpcs.update_security_center_service.timeout,
2340
+ metadata: metadata,
2341
+ retry_policy: @config.rpcs.update_security_center_service.retry_policy
2342
+
2343
+ options.apply_defaults timeout: @config.timeout,
2344
+ metadata: @config.metadata,
2345
+ retry_policy: @config.retry_policy
2346
+
2347
+ @security_center_management_stub.call_rpc :update_security_center_service, request, options: options do |response, operation|
2348
+ yield response, operation if block_given?
2349
+ return response
2350
+ end
2351
+ rescue ::GRPC::BadStatus => e
2352
+ raise ::Google::Cloud::Error.from_error(e)
2353
+ end
2354
+
2029
2355
  ##
2030
2356
  # Configuration class for the SecurityCenterManagement API.
2031
2357
  #
@@ -2269,6 +2595,21 @@ module Google
2269
2595
  # @return [::Gapic::Config::Method]
2270
2596
  #
2271
2597
  attr_reader :validate_event_threat_detection_custom_module
2598
+ ##
2599
+ # RPC-specific configuration for `get_security_center_service`
2600
+ # @return [::Gapic::Config::Method]
2601
+ #
2602
+ attr_reader :get_security_center_service
2603
+ ##
2604
+ # RPC-specific configuration for `list_security_center_services`
2605
+ # @return [::Gapic::Config::Method]
2606
+ #
2607
+ attr_reader :list_security_center_services
2608
+ ##
2609
+ # RPC-specific configuration for `update_security_center_service`
2610
+ # @return [::Gapic::Config::Method]
2611
+ #
2612
+ attr_reader :update_security_center_service
2272
2613
 
2273
2614
  # @private
2274
2615
  def initialize parent_rpcs = nil
@@ -2308,6 +2649,12 @@ module Google
2308
2649
  @delete_event_threat_detection_custom_module = ::Gapic::Config::Method.new delete_event_threat_detection_custom_module_config
2309
2650
  validate_event_threat_detection_custom_module_config = parent_rpcs.validate_event_threat_detection_custom_module if parent_rpcs.respond_to? :validate_event_threat_detection_custom_module
2310
2651
  @validate_event_threat_detection_custom_module = ::Gapic::Config::Method.new validate_event_threat_detection_custom_module_config
2652
+ get_security_center_service_config = parent_rpcs.get_security_center_service if parent_rpcs.respond_to? :get_security_center_service
2653
+ @get_security_center_service = ::Gapic::Config::Method.new get_security_center_service_config
2654
+ list_security_center_services_config = parent_rpcs.list_security_center_services if parent_rpcs.respond_to? :list_security_center_services
2655
+ @list_security_center_services = ::Gapic::Config::Method.new list_security_center_services_config
2656
+ update_security_center_service_config = parent_rpcs.update_security_center_service if parent_rpcs.respond_to? :update_security_center_service
2657
+ @update_security_center_service = ::Gapic::Config::Method.new update_security_center_service_config
2311
2658
 
2312
2659
  yield self if block_given?
2313
2660
  end