google-cloud-security_center_management-v1 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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