google-apis-securitycenter_v1 0.53.0 → 0.55.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.
@@ -852,6 +852,321 @@ module Google
852
852
  execute_or_queue_command(command, &block)
853
853
  end
854
854
 
855
+ # Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the
856
+ # given CRM parent, and also creates inherited
857
+ # SecurityHealthAnalyticsCustomModules for all CRM descendants of the given
858
+ # parent. These modules are enabled by default.
859
+ # @param [String] parent
860
+ # Required. Resource name of the new custom module's parent. Its format is "
861
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
862
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
863
+ # securityHealthAnalyticsSettings"
864
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
865
+ # @param [String] fields
866
+ # Selector specifying which fields to include in a partial response.
867
+ # @param [String] quota_user
868
+ # Available to use for quota purposes for server-side applications. Can be any
869
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
870
+ # @param [Google::Apis::RequestOptions] options
871
+ # Request-specific options
872
+ #
873
+ # @yield [result, err] Result & error if block supplied
874
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
875
+ # @yieldparam err [StandardError] error object if request failed
876
+ #
877
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
878
+ #
879
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
880
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
881
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
882
+ def create_folder_security_health_analytics_setting_custom_module(parent, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, fields: nil, quota_user: nil, options: nil, &block)
883
+ command = make_simple_command(:post, 'v1/{+parent}/customModules', options)
884
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
885
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
886
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
887
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
888
+ command.params['parent'] = parent unless parent.nil?
889
+ command.query['fields'] = fields unless fields.nil?
890
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
891
+ execute_or_queue_command(command, &block)
892
+ end
893
+
894
+ # Deletes the specified SecurityHealthAnalyticsCustomModule and all of its
895
+ # descendants in the CRM hierarchy. This method is only supported for resident
896
+ # custom modules.
897
+ # @param [String] name
898
+ # Required. Name of the custom module to delete. Its format is "organizations/`
899
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
900
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
901
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
902
+ # customModule`"
903
+ # @param [String] fields
904
+ # Selector specifying which fields to include in a partial response.
905
+ # @param [String] quota_user
906
+ # Available to use for quota purposes for server-side applications. Can be any
907
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
908
+ # @param [Google::Apis::RequestOptions] options
909
+ # Request-specific options
910
+ #
911
+ # @yield [result, err] Result & error if block supplied
912
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
913
+ # @yieldparam err [StandardError] error object if request failed
914
+ #
915
+ # @return [Google::Apis::SecuritycenterV1::Empty]
916
+ #
917
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
918
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
919
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
920
+ def delete_folder_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
921
+ command = make_simple_command(:delete, 'v1/{+name}', options)
922
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
923
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
924
+ command.params['name'] = name unless name.nil?
925
+ command.query['fields'] = fields unless fields.nil?
926
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
927
+ execute_or_queue_command(command, &block)
928
+ end
929
+
930
+ # Retrieves a SecurityHealthAnalyticsCustomModule.
931
+ # @param [String] name
932
+ # Required. Name of the custom module to get. Its format is "organizations/`
933
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
934
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
935
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
936
+ # customModule`"
937
+ # @param [String] fields
938
+ # Selector specifying which fields to include in a partial response.
939
+ # @param [String] quota_user
940
+ # Available to use for quota purposes for server-side applications. Can be any
941
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
942
+ # @param [Google::Apis::RequestOptions] options
943
+ # Request-specific options
944
+ #
945
+ # @yield [result, err] Result & error if block supplied
946
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
947
+ # @yieldparam err [StandardError] error object if request failed
948
+ #
949
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
950
+ #
951
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
952
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
953
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
954
+ def get_folder_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
955
+ command = make_simple_command(:get, 'v1/{+name}', options)
956
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
957
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
958
+ command.params['name'] = name unless name.nil?
959
+ command.query['fields'] = fields unless fields.nil?
960
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
961
+ execute_or_queue_command(command, &block)
962
+ end
963
+
964
+ # Returns a list of all SecurityHealthAnalyticsCustomModules for the given
965
+ # parent. This includes resident modules defined at the scope of the parent, and
966
+ # inherited modules, inherited from CRM ancestors.
967
+ # @param [String] parent
968
+ # Required. Name of parent to list custom modules. Its format is "organizations/`
969
+ # organization`/securityHealthAnalyticsSettings", "folders/`folder`/
970
+ # securityHealthAnalyticsSettings", or "projects/`project`/
971
+ # securityHealthAnalyticsSettings"
972
+ # @param [Fixnum] page_size
973
+ # The maximum number of results to return in a single response. Default is 10,
974
+ # minimum is 1, maximum is 1000.
975
+ # @param [String] page_token
976
+ # The value returned by the last call indicating a continuation
977
+ # @param [String] fields
978
+ # Selector specifying which fields to include in a partial response.
979
+ # @param [String] quota_user
980
+ # Available to use for quota purposes for server-side applications. Can be any
981
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
982
+ # @param [Google::Apis::RequestOptions] options
983
+ # Request-specific options
984
+ #
985
+ # @yield [result, err] Result & error if block supplied
986
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse] parsed result object
987
+ # @yieldparam err [StandardError] error object if request failed
988
+ #
989
+ # @return [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse]
990
+ #
991
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
992
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
993
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
994
+ def list_folder_security_health_analytics_setting_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
995
+ command = make_simple_command(:get, 'v1/{+parent}/customModules', options)
996
+ command.response_representation = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse::Representation
997
+ command.response_class = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse
998
+ command.params['parent'] = parent unless parent.nil?
999
+ command.query['pageSize'] = page_size unless page_size.nil?
1000
+ command.query['pageToken'] = page_token unless page_token.nil?
1001
+ command.query['fields'] = fields unless fields.nil?
1002
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1003
+ execute_or_queue_command(command, &block)
1004
+ end
1005
+
1006
+ # Returns a list of all resident SecurityHealthAnalyticsCustomModules under the
1007
+ # given CRM parent and all of the parent’s CRM descendants.
1008
+ # @param [String] parent
1009
+ # Required. Name of parent to list descendant custom modules. Its format is "
1010
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
1011
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
1012
+ # securityHealthAnalyticsSettings"
1013
+ # @param [Fixnum] page_size
1014
+ # The maximum number of results to return in a single response. Default is 10,
1015
+ # minimum is 1, maximum is 1000.
1016
+ # @param [String] page_token
1017
+ # The value returned by the last call indicating a continuation
1018
+ # @param [String] fields
1019
+ # Selector specifying which fields to include in a partial response.
1020
+ # @param [String] quota_user
1021
+ # Available to use for quota purposes for server-side applications. Can be any
1022
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1023
+ # @param [Google::Apis::RequestOptions] options
1024
+ # Request-specific options
1025
+ #
1026
+ # @yield [result, err] Result & error if block supplied
1027
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse] parsed result object
1028
+ # @yieldparam err [StandardError] error object if request failed
1029
+ #
1030
+ # @return [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse]
1031
+ #
1032
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1033
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1034
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1035
+ def list_folder_security_health_analytics_setting_custom_module_descendant(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1036
+ command = make_simple_command(:get, 'v1/{+parent}/customModules:listDescendant', options)
1037
+ command.response_representation = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse::Representation
1038
+ command.response_class = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse
1039
+ command.params['parent'] = parent unless parent.nil?
1040
+ command.query['pageSize'] = page_size unless page_size.nil?
1041
+ command.query['pageToken'] = page_token unless page_token.nil?
1042
+ command.query['fields'] = fields unless fields.nil?
1043
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1044
+ execute_or_queue_command(command, &block)
1045
+ end
1046
+
1047
+ # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
1048
+ # the given update mask. Updating the enablement state is supported on both
1049
+ # resident and inherited modules (though resident modules cannot have an
1050
+ # enablement state of "inherited"). Updating the display name and custom config
1051
+ # of a module is supported on resident modules only.
1052
+ # @param [String] name
1053
+ # Immutable. The resource name of the custom module. Its format is "
1054
+ # organizations/`organization`/securityHealthAnalyticsSettings/customModules/`
1055
+ # customModule`", or "folders/`folder`/securityHealthAnalyticsSettings/
1056
+ # customModules/`customModule`", or "projects/`project`/
1057
+ # securityHealthAnalyticsSettings/customModules/`customModule`" The id `
1058
+ # customModule` is server-generated and is not user settable. It will be a
1059
+ # numeric id containing 1-20 digits.
1060
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
1061
+ # @param [String] update_mask
1062
+ # The list of fields to update.
1063
+ # @param [String] fields
1064
+ # Selector specifying which fields to include in a partial response.
1065
+ # @param [String] quota_user
1066
+ # Available to use for quota purposes for server-side applications. Can be any
1067
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1068
+ # @param [Google::Apis::RequestOptions] options
1069
+ # Request-specific options
1070
+ #
1071
+ # @yield [result, err] Result & error if block supplied
1072
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
1073
+ # @yieldparam err [StandardError] error object if request failed
1074
+ #
1075
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
1076
+ #
1077
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1078
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1079
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1080
+ def patch_folder_security_health_analytics_setting_custom_module(name, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1081
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1082
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
1083
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
1084
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
1085
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
1086
+ command.params['name'] = name unless name.nil?
1087
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1088
+ command.query['fields'] = fields unless fields.nil?
1089
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1090
+ execute_or_queue_command(command, &block)
1091
+ end
1092
+
1093
+ # Retrieves an EffectiveSecurityHealthAnalyticsCustomModule.
1094
+ # @param [String] name
1095
+ # Required. Name of the effective custom module to get. Its format is "
1096
+ # organizations/`organization`/securityHealthAnalyticsSettings/
1097
+ # effectiveCustomModules/`customModule`", "folders/`folder`/
1098
+ # securityHealthAnalyticsSettings/effectiveCustomModules/`customModule`", or "
1099
+ # projects/`project`/securityHealthAnalyticsSettings/effectiveCustomModules/`
1100
+ # customModule`"
1101
+ # @param [String] fields
1102
+ # Selector specifying which fields to include in a partial response.
1103
+ # @param [String] quota_user
1104
+ # Available to use for quota purposes for server-side applications. Can be any
1105
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1106
+ # @param [Google::Apis::RequestOptions] options
1107
+ # Request-specific options
1108
+ #
1109
+ # @yield [result, err] Result & error if block supplied
1110
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule] parsed result object
1111
+ # @yieldparam err [StandardError] error object if request failed
1112
+ #
1113
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule]
1114
+ #
1115
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1116
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1117
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1118
+ def get_folder_security_health_analytics_setting_effective_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
1119
+ command = make_simple_command(:get, 'v1/{+name}', options)
1120
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule::Representation
1121
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
1122
+ command.params['name'] = name unless name.nil?
1123
+ command.query['fields'] = fields unless fields.nil?
1124
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1125
+ execute_or_queue_command(command, &block)
1126
+ end
1127
+
1128
+ # Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the
1129
+ # given parent. This includes resident modules defined at the scope of the
1130
+ # parent, and inherited modules, inherited from CRM ancestors.
1131
+ # @param [String] parent
1132
+ # Required. Name of parent to list effective custom modules. Its format is "
1133
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
1134
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
1135
+ # securityHealthAnalyticsSettings"
1136
+ # @param [Fixnum] page_size
1137
+ # The maximum number of results to return in a single response. Default is 10,
1138
+ # minimum is 1, maximum is 1000.
1139
+ # @param [String] page_token
1140
+ # The value returned by the last call indicating a continuation
1141
+ # @param [String] fields
1142
+ # Selector specifying which fields to include in a partial response.
1143
+ # @param [String] quota_user
1144
+ # Available to use for quota purposes for server-side applications. Can be any
1145
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1146
+ # @param [Google::Apis::RequestOptions] options
1147
+ # Request-specific options
1148
+ #
1149
+ # @yield [result, err] Result & error if block supplied
1150
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse] parsed result object
1151
+ # @yieldparam err [StandardError] error object if request failed
1152
+ #
1153
+ # @return [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse]
1154
+ #
1155
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1156
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1157
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1158
+ def list_folder_security_health_analytics_setting_effective_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1159
+ command = make_simple_command(:get, 'v1/{+parent}/effectiveCustomModules', options)
1160
+ command.response_representation = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse::Representation
1161
+ command.response_class = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse
1162
+ command.params['parent'] = parent unless parent.nil?
1163
+ command.query['pageSize'] = page_size unless page_size.nil?
1164
+ command.query['pageToken'] = page_token unless page_token.nil?
1165
+ command.query['fields'] = fields unless fields.nil?
1166
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1167
+ execute_or_queue_command(command, &block)
1168
+ end
1169
+
855
1170
  # Lists all sources belonging to an organization.
856
1171
  # @param [String] parent
857
1172
  # Required. Resource name of the parent of sources to list. Its format should be
@@ -1051,9 +1366,11 @@ module Google
1051
1366
  # Creates or updates a finding. The corresponding source must exist for a
1052
1367
  # finding creation to succeed.
1053
1368
  # @param [String] name
1054
- # The relative resource name of this finding. See: https://cloud.google.com/apis/
1055
- # design/resource_names#relative_resource_name Example: "organizations/`
1056
- # organization_id`/sources/`source_id`/findings/`finding_id`"
1369
+ # The [relative resource name](https://cloud.google.com/apis/design/
1370
+ # resource_names#relative_resource_name) of the finding. Example: "organizations/
1371
+ # `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
1372
+ # folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
1373
+ # sources/`source_id`/findings/`finding_id`".
1057
1374
  # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
1058
1375
  # @param [String] update_mask
1059
1376
  # The FieldMask to use when updating the finding resource. This field should not
@@ -2197,12 +2514,318 @@ module Google
2197
2514
  execute_or_queue_command(command, &block)
2198
2515
  end
2199
2516
 
2200
- # Deletes a long-running operation. This method indicates that the client is no
2201
- # longer interested in the operation result. It does not cancel the operation.
2202
- # If the server doesn't support this method, it returns `google.rpc.Code.
2203
- # UNIMPLEMENTED`.
2517
+ # Deletes a long-running operation. This method indicates that the client is no
2518
+ # longer interested in the operation result. It does not cancel the operation.
2519
+ # If the server doesn't support this method, it returns `google.rpc.Code.
2520
+ # UNIMPLEMENTED`.
2521
+ # @param [String] name
2522
+ # The name of the operation resource to be deleted.
2523
+ # @param [String] fields
2524
+ # Selector specifying which fields to include in a partial response.
2525
+ # @param [String] quota_user
2526
+ # Available to use for quota purposes for server-side applications. Can be any
2527
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2528
+ # @param [Google::Apis::RequestOptions] options
2529
+ # Request-specific options
2530
+ #
2531
+ # @yield [result, err] Result & error if block supplied
2532
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2533
+ # @yieldparam err [StandardError] error object if request failed
2534
+ #
2535
+ # @return [Google::Apis::SecuritycenterV1::Empty]
2536
+ #
2537
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2538
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2539
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2540
+ def delete_organization_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2541
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2542
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2543
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
2544
+ command.params['name'] = name unless name.nil?
2545
+ command.query['fields'] = fields unless fields.nil?
2546
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2547
+ execute_or_queue_command(command, &block)
2548
+ end
2549
+
2550
+ # Gets the latest state of a long-running operation. Clients can use this method
2551
+ # to poll the operation result at intervals as recommended by the API service.
2552
+ # @param [String] name
2553
+ # The name of the operation resource.
2554
+ # @param [String] fields
2555
+ # Selector specifying which fields to include in a partial response.
2556
+ # @param [String] quota_user
2557
+ # Available to use for quota purposes for server-side applications. Can be any
2558
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2559
+ # @param [Google::Apis::RequestOptions] options
2560
+ # Request-specific options
2561
+ #
2562
+ # @yield [result, err] Result & error if block supplied
2563
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Operation] parsed result object
2564
+ # @yieldparam err [StandardError] error object if request failed
2565
+ #
2566
+ # @return [Google::Apis::SecuritycenterV1::Operation]
2567
+ #
2568
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2569
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2570
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2571
+ def get_organization_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2572
+ command = make_simple_command(:get, 'v1/{+name}', options)
2573
+ command.response_representation = Google::Apis::SecuritycenterV1::Operation::Representation
2574
+ command.response_class = Google::Apis::SecuritycenterV1::Operation
2575
+ command.params['name'] = name unless name.nil?
2576
+ command.query['fields'] = fields unless fields.nil?
2577
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2578
+ execute_or_queue_command(command, &block)
2579
+ end
2580
+
2581
+ # Lists operations that match the specified filter in the request. If the server
2582
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
2583
+ # @param [String] name
2584
+ # The name of the operation's parent resource.
2585
+ # @param [String] filter
2586
+ # The standard list filter.
2587
+ # @param [Fixnum] page_size
2588
+ # The standard list page size.
2589
+ # @param [String] page_token
2590
+ # The standard list page token.
2591
+ # @param [String] fields
2592
+ # Selector specifying which fields to include in a partial response.
2593
+ # @param [String] quota_user
2594
+ # Available to use for quota purposes for server-side applications. Can be any
2595
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2596
+ # @param [Google::Apis::RequestOptions] options
2597
+ # Request-specific options
2598
+ #
2599
+ # @yield [result, err] Result & error if block supplied
2600
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListOperationsResponse] parsed result object
2601
+ # @yieldparam err [StandardError] error object if request failed
2602
+ #
2603
+ # @return [Google::Apis::SecuritycenterV1::ListOperationsResponse]
2604
+ #
2605
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2606
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2607
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2608
+ def list_organization_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2609
+ command = make_simple_command(:get, 'v1/{+name}', options)
2610
+ command.response_representation = Google::Apis::SecuritycenterV1::ListOperationsResponse::Representation
2611
+ command.response_class = Google::Apis::SecuritycenterV1::ListOperationsResponse
2612
+ command.params['name'] = name unless name.nil?
2613
+ command.query['filter'] = filter unless filter.nil?
2614
+ command.query['pageSize'] = page_size unless page_size.nil?
2615
+ command.query['pageToken'] = page_token unless page_token.nil?
2616
+ command.query['fields'] = fields unless fields.nil?
2617
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2618
+ execute_or_queue_command(command, &block)
2619
+ end
2620
+
2621
+ # Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the
2622
+ # given CRM parent, and also creates inherited
2623
+ # SecurityHealthAnalyticsCustomModules for all CRM descendants of the given
2624
+ # parent. These modules are enabled by default.
2625
+ # @param [String] parent
2626
+ # Required. Resource name of the new custom module's parent. Its format is "
2627
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
2628
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
2629
+ # securityHealthAnalyticsSettings"
2630
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
2631
+ # @param [String] fields
2632
+ # Selector specifying which fields to include in a partial response.
2633
+ # @param [String] quota_user
2634
+ # Available to use for quota purposes for server-side applications. Can be any
2635
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2636
+ # @param [Google::Apis::RequestOptions] options
2637
+ # Request-specific options
2638
+ #
2639
+ # @yield [result, err] Result & error if block supplied
2640
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
2641
+ # @yieldparam err [StandardError] error object if request failed
2642
+ #
2643
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
2644
+ #
2645
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2646
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2647
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2648
+ def create_organization_security_health_analytics_setting_custom_module(parent, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2649
+ command = make_simple_command(:post, 'v1/{+parent}/customModules', options)
2650
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
2651
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
2652
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
2653
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
2654
+ command.params['parent'] = parent unless parent.nil?
2655
+ command.query['fields'] = fields unless fields.nil?
2656
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2657
+ execute_or_queue_command(command, &block)
2658
+ end
2659
+
2660
+ # Deletes the specified SecurityHealthAnalyticsCustomModule and all of its
2661
+ # descendants in the CRM hierarchy. This method is only supported for resident
2662
+ # custom modules.
2663
+ # @param [String] name
2664
+ # Required. Name of the custom module to delete. Its format is "organizations/`
2665
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
2666
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
2667
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
2668
+ # customModule`"
2669
+ # @param [String] fields
2670
+ # Selector specifying which fields to include in a partial response.
2671
+ # @param [String] quota_user
2672
+ # Available to use for quota purposes for server-side applications. Can be any
2673
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2674
+ # @param [Google::Apis::RequestOptions] options
2675
+ # Request-specific options
2676
+ #
2677
+ # @yield [result, err] Result & error if block supplied
2678
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2679
+ # @yieldparam err [StandardError] error object if request failed
2680
+ #
2681
+ # @return [Google::Apis::SecuritycenterV1::Empty]
2682
+ #
2683
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2684
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2685
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2686
+ def delete_organization_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
2687
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2688
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2689
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
2690
+ command.params['name'] = name unless name.nil?
2691
+ command.query['fields'] = fields unless fields.nil?
2692
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2693
+ execute_or_queue_command(command, &block)
2694
+ end
2695
+
2696
+ # Retrieves a SecurityHealthAnalyticsCustomModule.
2697
+ # @param [String] name
2698
+ # Required. Name of the custom module to get. Its format is "organizations/`
2699
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
2700
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
2701
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
2702
+ # customModule`"
2703
+ # @param [String] fields
2704
+ # Selector specifying which fields to include in a partial response.
2705
+ # @param [String] quota_user
2706
+ # Available to use for quota purposes for server-side applications. Can be any
2707
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2708
+ # @param [Google::Apis::RequestOptions] options
2709
+ # Request-specific options
2710
+ #
2711
+ # @yield [result, err] Result & error if block supplied
2712
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
2713
+ # @yieldparam err [StandardError] error object if request failed
2714
+ #
2715
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
2716
+ #
2717
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2718
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2719
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2720
+ def get_organization_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
2721
+ command = make_simple_command(:get, 'v1/{+name}', options)
2722
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
2723
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
2724
+ command.params['name'] = name unless name.nil?
2725
+ command.query['fields'] = fields unless fields.nil?
2726
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2727
+ execute_or_queue_command(command, &block)
2728
+ end
2729
+
2730
+ # Returns a list of all SecurityHealthAnalyticsCustomModules for the given
2731
+ # parent. This includes resident modules defined at the scope of the parent, and
2732
+ # inherited modules, inherited from CRM ancestors.
2733
+ # @param [String] parent
2734
+ # Required. Name of parent to list custom modules. Its format is "organizations/`
2735
+ # organization`/securityHealthAnalyticsSettings", "folders/`folder`/
2736
+ # securityHealthAnalyticsSettings", or "projects/`project`/
2737
+ # securityHealthAnalyticsSettings"
2738
+ # @param [Fixnum] page_size
2739
+ # The maximum number of results to return in a single response. Default is 10,
2740
+ # minimum is 1, maximum is 1000.
2741
+ # @param [String] page_token
2742
+ # The value returned by the last call indicating a continuation
2743
+ # @param [String] fields
2744
+ # Selector specifying which fields to include in a partial response.
2745
+ # @param [String] quota_user
2746
+ # Available to use for quota purposes for server-side applications. Can be any
2747
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2748
+ # @param [Google::Apis::RequestOptions] options
2749
+ # Request-specific options
2750
+ #
2751
+ # @yield [result, err] Result & error if block supplied
2752
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse] parsed result object
2753
+ # @yieldparam err [StandardError] error object if request failed
2754
+ #
2755
+ # @return [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse]
2756
+ #
2757
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2758
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2759
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2760
+ def list_organization_security_health_analytics_setting_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2761
+ command = make_simple_command(:get, 'v1/{+parent}/customModules', options)
2762
+ command.response_representation = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse::Representation
2763
+ command.response_class = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse
2764
+ command.params['parent'] = parent unless parent.nil?
2765
+ command.query['pageSize'] = page_size unless page_size.nil?
2766
+ command.query['pageToken'] = page_token unless page_token.nil?
2767
+ command.query['fields'] = fields unless fields.nil?
2768
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2769
+ execute_or_queue_command(command, &block)
2770
+ end
2771
+
2772
+ # Returns a list of all resident SecurityHealthAnalyticsCustomModules under the
2773
+ # given CRM parent and all of the parent’s CRM descendants.
2774
+ # @param [String] parent
2775
+ # Required. Name of parent to list descendant custom modules. Its format is "
2776
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
2777
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
2778
+ # securityHealthAnalyticsSettings"
2779
+ # @param [Fixnum] page_size
2780
+ # The maximum number of results to return in a single response. Default is 10,
2781
+ # minimum is 1, maximum is 1000.
2782
+ # @param [String] page_token
2783
+ # The value returned by the last call indicating a continuation
2784
+ # @param [String] fields
2785
+ # Selector specifying which fields to include in a partial response.
2786
+ # @param [String] quota_user
2787
+ # Available to use for quota purposes for server-side applications. Can be any
2788
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2789
+ # @param [Google::Apis::RequestOptions] options
2790
+ # Request-specific options
2791
+ #
2792
+ # @yield [result, err] Result & error if block supplied
2793
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse] parsed result object
2794
+ # @yieldparam err [StandardError] error object if request failed
2795
+ #
2796
+ # @return [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse]
2797
+ #
2798
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2799
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2800
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2801
+ def list_organization_security_health_analytics_setting_custom_module_descendant(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2802
+ command = make_simple_command(:get, 'v1/{+parent}/customModules:listDescendant', options)
2803
+ command.response_representation = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse::Representation
2804
+ command.response_class = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse
2805
+ command.params['parent'] = parent unless parent.nil?
2806
+ command.query['pageSize'] = page_size unless page_size.nil?
2807
+ command.query['pageToken'] = page_token unless page_token.nil?
2808
+ command.query['fields'] = fields unless fields.nil?
2809
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2810
+ execute_or_queue_command(command, &block)
2811
+ end
2812
+
2813
+ # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
2814
+ # the given update mask. Updating the enablement state is supported on both
2815
+ # resident and inherited modules (though resident modules cannot have an
2816
+ # enablement state of "inherited"). Updating the display name and custom config
2817
+ # of a module is supported on resident modules only.
2204
2818
  # @param [String] name
2205
- # The name of the operation resource to be deleted.
2819
+ # Immutable. The resource name of the custom module. Its format is "
2820
+ # organizations/`organization`/securityHealthAnalyticsSettings/customModules/`
2821
+ # customModule`", or "folders/`folder`/securityHealthAnalyticsSettings/
2822
+ # customModules/`customModule`", or "projects/`project`/
2823
+ # securityHealthAnalyticsSettings/customModules/`customModule`" The id `
2824
+ # customModule` is server-generated and is not user settable. It will be a
2825
+ # numeric id containing 1-20 digits.
2826
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
2827
+ # @param [String] update_mask
2828
+ # The list of fields to update.
2206
2829
  # @param [String] fields
2207
2830
  # Selector specifying which fields to include in a partial response.
2208
2831
  # @param [String] quota_user
@@ -2212,28 +2835,35 @@ module Google
2212
2835
  # Request-specific options
2213
2836
  #
2214
2837
  # @yield [result, err] Result & error if block supplied
2215
- # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2838
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
2216
2839
  # @yieldparam err [StandardError] error object if request failed
2217
2840
  #
2218
- # @return [Google::Apis::SecuritycenterV1::Empty]
2841
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
2219
2842
  #
2220
2843
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2221
2844
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2222
2845
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2223
- def delete_organization_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2224
- command = make_simple_command(:delete, 'v1/{+name}', options)
2225
- command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2226
- command.response_class = Google::Apis::SecuritycenterV1::Empty
2846
+ def patch_organization_security_health_analytics_setting_custom_module(name, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2847
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2848
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
2849
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
2850
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
2851
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
2227
2852
  command.params['name'] = name unless name.nil?
2853
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2228
2854
  command.query['fields'] = fields unless fields.nil?
2229
2855
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2230
2856
  execute_or_queue_command(command, &block)
2231
2857
  end
2232
2858
 
2233
- # Gets the latest state of a long-running operation. Clients can use this method
2234
- # to poll the operation result at intervals as recommended by the API service.
2859
+ # Retrieves an EffectiveSecurityHealthAnalyticsCustomModule.
2235
2860
  # @param [String] name
2236
- # The name of the operation resource.
2861
+ # Required. Name of the effective custom module to get. Its format is "
2862
+ # organizations/`organization`/securityHealthAnalyticsSettings/
2863
+ # effectiveCustomModules/`customModule`", "folders/`folder`/
2864
+ # securityHealthAnalyticsSettings/effectiveCustomModules/`customModule`", or "
2865
+ # projects/`project`/securityHealthAnalyticsSettings/effectiveCustomModules/`
2866
+ # customModule`"
2237
2867
  # @param [String] fields
2238
2868
  # Selector specifying which fields to include in a partial response.
2239
2869
  # @param [String] quota_user
@@ -2243,34 +2873,37 @@ module Google
2243
2873
  # Request-specific options
2244
2874
  #
2245
2875
  # @yield [result, err] Result & error if block supplied
2246
- # @yieldparam result [Google::Apis::SecuritycenterV1::Operation] parsed result object
2876
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule] parsed result object
2247
2877
  # @yieldparam err [StandardError] error object if request failed
2248
2878
  #
2249
- # @return [Google::Apis::SecuritycenterV1::Operation]
2879
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule]
2250
2880
  #
2251
2881
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2252
2882
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2253
2883
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2254
- def get_organization_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2884
+ def get_organization_security_health_analytics_setting_effective_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
2255
2885
  command = make_simple_command(:get, 'v1/{+name}', options)
2256
- command.response_representation = Google::Apis::SecuritycenterV1::Operation::Representation
2257
- command.response_class = Google::Apis::SecuritycenterV1::Operation
2886
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule::Representation
2887
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
2258
2888
  command.params['name'] = name unless name.nil?
2259
2889
  command.query['fields'] = fields unless fields.nil?
2260
2890
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2261
2891
  execute_or_queue_command(command, &block)
2262
2892
  end
2263
2893
 
2264
- # Lists operations that match the specified filter in the request. If the server
2265
- # doesn't support this method, it returns `UNIMPLEMENTED`.
2266
- # @param [String] name
2267
- # The name of the operation's parent resource.
2268
- # @param [String] filter
2269
- # The standard list filter.
2894
+ # Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the
2895
+ # given parent. This includes resident modules defined at the scope of the
2896
+ # parent, and inherited modules, inherited from CRM ancestors.
2897
+ # @param [String] parent
2898
+ # Required. Name of parent to list effective custom modules. Its format is "
2899
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
2900
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
2901
+ # securityHealthAnalyticsSettings"
2270
2902
  # @param [Fixnum] page_size
2271
- # The standard list page size.
2903
+ # The maximum number of results to return in a single response. Default is 10,
2904
+ # minimum is 1, maximum is 1000.
2272
2905
  # @param [String] page_token
2273
- # The standard list page token.
2906
+ # The value returned by the last call indicating a continuation
2274
2907
  # @param [String] fields
2275
2908
  # Selector specifying which fields to include in a partial response.
2276
2909
  # @param [String] quota_user
@@ -2280,20 +2913,19 @@ module Google
2280
2913
  # Request-specific options
2281
2914
  #
2282
2915
  # @yield [result, err] Result & error if block supplied
2283
- # @yieldparam result [Google::Apis::SecuritycenterV1::ListOperationsResponse] parsed result object
2916
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse] parsed result object
2284
2917
  # @yieldparam err [StandardError] error object if request failed
2285
2918
  #
2286
- # @return [Google::Apis::SecuritycenterV1::ListOperationsResponse]
2919
+ # @return [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse]
2287
2920
  #
2288
2921
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2289
2922
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2290
2923
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2291
- def list_organization_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2292
- command = make_simple_command(:get, 'v1/{+name}', options)
2293
- command.response_representation = Google::Apis::SecuritycenterV1::ListOperationsResponse::Representation
2294
- command.response_class = Google::Apis::SecuritycenterV1::ListOperationsResponse
2295
- command.params['name'] = name unless name.nil?
2296
- command.query['filter'] = filter unless filter.nil?
2924
+ def list_organization_security_health_analytics_setting_effective_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2925
+ command = make_simple_command(:get, 'v1/{+parent}/effectiveCustomModules', options)
2926
+ command.response_representation = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse::Representation
2927
+ command.response_class = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse
2928
+ command.params['parent'] = parent unless parent.nil?
2297
2929
  command.query['pageSize'] = page_size unless page_size.nil?
2298
2930
  command.query['pageToken'] = page_token unless page_token.nil?
2299
2931
  command.query['fields'] = fields unless fields.nil?
@@ -2749,9 +3381,11 @@ module Google
2749
3381
  # Creates or updates a finding. The corresponding source must exist for a
2750
3382
  # finding creation to succeed.
2751
3383
  # @param [String] name
2752
- # The relative resource name of this finding. See: https://cloud.google.com/apis/
2753
- # design/resource_names#relative_resource_name Example: "organizations/`
2754
- # organization_id`/sources/`source_id`/findings/`finding_id`"
3384
+ # The [relative resource name](https://cloud.google.com/apis/design/
3385
+ # resource_names#relative_resource_name) of the finding. Example: "organizations/
3386
+ # `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
3387
+ # folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
3388
+ # sources/`source_id`/findings/`finding_id`".
2755
3389
  # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
2756
3390
  # @param [String] update_mask
2757
3391
  # The FieldMask to use when updating the finding resource. This field should not
@@ -3752,6 +4386,321 @@ module Google
3752
4386
  execute_or_queue_command(command, &block)
3753
4387
  end
3754
4388
 
4389
+ # Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the
4390
+ # given CRM parent, and also creates inherited
4391
+ # SecurityHealthAnalyticsCustomModules for all CRM descendants of the given
4392
+ # parent. These modules are enabled by default.
4393
+ # @param [String] parent
4394
+ # Required. Resource name of the new custom module's parent. Its format is "
4395
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
4396
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
4397
+ # securityHealthAnalyticsSettings"
4398
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
4399
+ # @param [String] fields
4400
+ # Selector specifying which fields to include in a partial response.
4401
+ # @param [String] quota_user
4402
+ # Available to use for quota purposes for server-side applications. Can be any
4403
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4404
+ # @param [Google::Apis::RequestOptions] options
4405
+ # Request-specific options
4406
+ #
4407
+ # @yield [result, err] Result & error if block supplied
4408
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
4409
+ # @yieldparam err [StandardError] error object if request failed
4410
+ #
4411
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
4412
+ #
4413
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4414
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4415
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4416
+ def create_project_security_health_analytics_setting_custom_module(parent, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4417
+ command = make_simple_command(:post, 'v1/{+parent}/customModules', options)
4418
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
4419
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
4420
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
4421
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
4422
+ command.params['parent'] = parent unless parent.nil?
4423
+ command.query['fields'] = fields unless fields.nil?
4424
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4425
+ execute_or_queue_command(command, &block)
4426
+ end
4427
+
4428
+ # Deletes the specified SecurityHealthAnalyticsCustomModule and all of its
4429
+ # descendants in the CRM hierarchy. This method is only supported for resident
4430
+ # custom modules.
4431
+ # @param [String] name
4432
+ # Required. Name of the custom module to delete. Its format is "organizations/`
4433
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
4434
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
4435
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
4436
+ # customModule`"
4437
+ # @param [String] fields
4438
+ # Selector specifying which fields to include in a partial response.
4439
+ # @param [String] quota_user
4440
+ # Available to use for quota purposes for server-side applications. Can be any
4441
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4442
+ # @param [Google::Apis::RequestOptions] options
4443
+ # Request-specific options
4444
+ #
4445
+ # @yield [result, err] Result & error if block supplied
4446
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
4447
+ # @yieldparam err [StandardError] error object if request failed
4448
+ #
4449
+ # @return [Google::Apis::SecuritycenterV1::Empty]
4450
+ #
4451
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4452
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4453
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4454
+ def delete_project_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
4455
+ command = make_simple_command(:delete, 'v1/{+name}', options)
4456
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
4457
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
4458
+ command.params['name'] = name unless name.nil?
4459
+ command.query['fields'] = fields unless fields.nil?
4460
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4461
+ execute_or_queue_command(command, &block)
4462
+ end
4463
+
4464
+ # Retrieves a SecurityHealthAnalyticsCustomModule.
4465
+ # @param [String] name
4466
+ # Required. Name of the custom module to get. Its format is "organizations/`
4467
+ # organization`/securityHealthAnalyticsSettings/customModules/`customModule`", "
4468
+ # folders/`folder`/securityHealthAnalyticsSettings/customModules/`customModule`",
4469
+ # or "projects/`project`/securityHealthAnalyticsSettings/customModules/`
4470
+ # customModule`"
4471
+ # @param [String] fields
4472
+ # Selector specifying which fields to include in a partial response.
4473
+ # @param [String] quota_user
4474
+ # Available to use for quota purposes for server-side applications. Can be any
4475
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4476
+ # @param [Google::Apis::RequestOptions] options
4477
+ # Request-specific options
4478
+ #
4479
+ # @yield [result, err] Result & error if block supplied
4480
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
4481
+ # @yieldparam err [StandardError] error object if request failed
4482
+ #
4483
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
4484
+ #
4485
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4486
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4487
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4488
+ def get_project_security_health_analytics_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
4489
+ command = make_simple_command(:get, 'v1/{+name}', options)
4490
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
4491
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
4492
+ command.params['name'] = name unless name.nil?
4493
+ command.query['fields'] = fields unless fields.nil?
4494
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4495
+ execute_or_queue_command(command, &block)
4496
+ end
4497
+
4498
+ # Returns a list of all SecurityHealthAnalyticsCustomModules for the given
4499
+ # parent. This includes resident modules defined at the scope of the parent, and
4500
+ # inherited modules, inherited from CRM ancestors.
4501
+ # @param [String] parent
4502
+ # Required. Name of parent to list custom modules. Its format is "organizations/`
4503
+ # organization`/securityHealthAnalyticsSettings", "folders/`folder`/
4504
+ # securityHealthAnalyticsSettings", or "projects/`project`/
4505
+ # securityHealthAnalyticsSettings"
4506
+ # @param [Fixnum] page_size
4507
+ # The maximum number of results to return in a single response. Default is 10,
4508
+ # minimum is 1, maximum is 1000.
4509
+ # @param [String] page_token
4510
+ # The value returned by the last call indicating a continuation
4511
+ # @param [String] fields
4512
+ # Selector specifying which fields to include in a partial response.
4513
+ # @param [String] quota_user
4514
+ # Available to use for quota purposes for server-side applications. Can be any
4515
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4516
+ # @param [Google::Apis::RequestOptions] options
4517
+ # Request-specific options
4518
+ #
4519
+ # @yield [result, err] Result & error if block supplied
4520
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse] parsed result object
4521
+ # @yieldparam err [StandardError] error object if request failed
4522
+ #
4523
+ # @return [Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse]
4524
+ #
4525
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4526
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4527
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4528
+ def list_project_security_health_analytics_setting_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4529
+ command = make_simple_command(:get, 'v1/{+parent}/customModules', options)
4530
+ command.response_representation = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse::Representation
4531
+ command.response_class = Google::Apis::SecuritycenterV1::ListSecurityHealthAnalyticsCustomModulesResponse
4532
+ command.params['parent'] = parent unless parent.nil?
4533
+ command.query['pageSize'] = page_size unless page_size.nil?
4534
+ command.query['pageToken'] = page_token unless page_token.nil?
4535
+ command.query['fields'] = fields unless fields.nil?
4536
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4537
+ execute_or_queue_command(command, &block)
4538
+ end
4539
+
4540
+ # Returns a list of all resident SecurityHealthAnalyticsCustomModules under the
4541
+ # given CRM parent and all of the parent’s CRM descendants.
4542
+ # @param [String] parent
4543
+ # Required. Name of parent to list descendant custom modules. Its format is "
4544
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
4545
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
4546
+ # securityHealthAnalyticsSettings"
4547
+ # @param [Fixnum] page_size
4548
+ # The maximum number of results to return in a single response. Default is 10,
4549
+ # minimum is 1, maximum is 1000.
4550
+ # @param [String] page_token
4551
+ # The value returned by the last call indicating a continuation
4552
+ # @param [String] fields
4553
+ # Selector specifying which fields to include in a partial response.
4554
+ # @param [String] quota_user
4555
+ # Available to use for quota purposes for server-side applications. Can be any
4556
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4557
+ # @param [Google::Apis::RequestOptions] options
4558
+ # Request-specific options
4559
+ #
4560
+ # @yield [result, err] Result & error if block supplied
4561
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse] parsed result object
4562
+ # @yieldparam err [StandardError] error object if request failed
4563
+ #
4564
+ # @return [Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse]
4565
+ #
4566
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4567
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4568
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4569
+ def list_project_security_health_analytics_setting_custom_module_descendant(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4570
+ command = make_simple_command(:get, 'v1/{+parent}/customModules:listDescendant', options)
4571
+ command.response_representation = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse::Representation
4572
+ command.response_class = Google::Apis::SecuritycenterV1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse
4573
+ command.params['parent'] = parent unless parent.nil?
4574
+ command.query['pageSize'] = page_size unless page_size.nil?
4575
+ command.query['pageToken'] = page_token unless page_token.nil?
4576
+ command.query['fields'] = fields unless fields.nil?
4577
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4578
+ execute_or_queue_command(command, &block)
4579
+ end
4580
+
4581
+ # Updates the SecurityHealthAnalyticsCustomModule under the given name based on
4582
+ # the given update mask. Updating the enablement state is supported on both
4583
+ # resident and inherited modules (though resident modules cannot have an
4584
+ # enablement state of "inherited"). Updating the display name and custom config
4585
+ # of a module is supported on resident modules only.
4586
+ # @param [String] name
4587
+ # Immutable. The resource name of the custom module. Its format is "
4588
+ # organizations/`organization`/securityHealthAnalyticsSettings/customModules/`
4589
+ # customModule`", or "folders/`folder`/securityHealthAnalyticsSettings/
4590
+ # customModules/`customModule`", or "projects/`project`/
4591
+ # securityHealthAnalyticsSettings/customModules/`customModule`" The id `
4592
+ # customModule` is server-generated and is not user settable. It will be a
4593
+ # numeric id containing 1-20 digits.
4594
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
4595
+ # @param [String] update_mask
4596
+ # The list of fields to update.
4597
+ # @param [String] fields
4598
+ # Selector specifying which fields to include in a partial response.
4599
+ # @param [String] quota_user
4600
+ # Available to use for quota purposes for server-side applications. Can be any
4601
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4602
+ # @param [Google::Apis::RequestOptions] options
4603
+ # Request-specific options
4604
+ #
4605
+ # @yield [result, err] Result & error if block supplied
4606
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule] parsed result object
4607
+ # @yieldparam err [StandardError] error object if request failed
4608
+ #
4609
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule]
4610
+ #
4611
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4612
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4613
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4614
+ def patch_project_security_health_analytics_setting_custom_module(name, google_cloud_securitycenter_v1_security_health_analytics_custom_module_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4615
+ command = make_simple_command(:patch, 'v1/{+name}', options)
4616
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
4617
+ command.request_object = google_cloud_securitycenter_v1_security_health_analytics_custom_module_object
4618
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule::Representation
4619
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1SecurityHealthAnalyticsCustomModule
4620
+ command.params['name'] = name unless name.nil?
4621
+ command.query['updateMask'] = update_mask unless update_mask.nil?
4622
+ command.query['fields'] = fields unless fields.nil?
4623
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4624
+ execute_or_queue_command(command, &block)
4625
+ end
4626
+
4627
+ # Retrieves an EffectiveSecurityHealthAnalyticsCustomModule.
4628
+ # @param [String] name
4629
+ # Required. Name of the effective custom module to get. Its format is "
4630
+ # organizations/`organization`/securityHealthAnalyticsSettings/
4631
+ # effectiveCustomModules/`customModule`", "folders/`folder`/
4632
+ # securityHealthAnalyticsSettings/effectiveCustomModules/`customModule`", or "
4633
+ # projects/`project`/securityHealthAnalyticsSettings/effectiveCustomModules/`
4634
+ # customModule`"
4635
+ # @param [String] fields
4636
+ # Selector specifying which fields to include in a partial response.
4637
+ # @param [String] quota_user
4638
+ # Available to use for quota purposes for server-side applications. Can be any
4639
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4640
+ # @param [Google::Apis::RequestOptions] options
4641
+ # Request-specific options
4642
+ #
4643
+ # @yield [result, err] Result & error if block supplied
4644
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule] parsed result object
4645
+ # @yieldparam err [StandardError] error object if request failed
4646
+ #
4647
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule]
4648
+ #
4649
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4650
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4651
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4652
+ def get_project_security_health_analytics_setting_effective_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
4653
+ command = make_simple_command(:get, 'v1/{+name}', options)
4654
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule::Representation
4655
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1EffectiveSecurityHealthAnalyticsCustomModule
4656
+ command.params['name'] = name unless name.nil?
4657
+ command.query['fields'] = fields unless fields.nil?
4658
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4659
+ execute_or_queue_command(command, &block)
4660
+ end
4661
+
4662
+ # Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the
4663
+ # given parent. This includes resident modules defined at the scope of the
4664
+ # parent, and inherited modules, inherited from CRM ancestors.
4665
+ # @param [String] parent
4666
+ # Required. Name of parent to list effective custom modules. Its format is "
4667
+ # organizations/`organization`/securityHealthAnalyticsSettings", "folders/`
4668
+ # folder`/securityHealthAnalyticsSettings", or "projects/`project`/
4669
+ # securityHealthAnalyticsSettings"
4670
+ # @param [Fixnum] page_size
4671
+ # The maximum number of results to return in a single response. Default is 10,
4672
+ # minimum is 1, maximum is 1000.
4673
+ # @param [String] page_token
4674
+ # The value returned by the last call indicating a continuation
4675
+ # @param [String] fields
4676
+ # Selector specifying which fields to include in a partial response.
4677
+ # @param [String] quota_user
4678
+ # Available to use for quota purposes for server-side applications. Can be any
4679
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4680
+ # @param [Google::Apis::RequestOptions] options
4681
+ # Request-specific options
4682
+ #
4683
+ # @yield [result, err] Result & error if block supplied
4684
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse] parsed result object
4685
+ # @yieldparam err [StandardError] error object if request failed
4686
+ #
4687
+ # @return [Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse]
4688
+ #
4689
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4690
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4691
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4692
+ def list_project_security_health_analytics_setting_effective_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4693
+ command = make_simple_command(:get, 'v1/{+parent}/effectiveCustomModules', options)
4694
+ command.response_representation = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse::Representation
4695
+ command.response_class = Google::Apis::SecuritycenterV1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse
4696
+ command.params['parent'] = parent unless parent.nil?
4697
+ command.query['pageSize'] = page_size unless page_size.nil?
4698
+ command.query['pageToken'] = page_token unless page_token.nil?
4699
+ command.query['fields'] = fields unless fields.nil?
4700
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4701
+ execute_or_queue_command(command, &block)
4702
+ end
4703
+
3755
4704
  # Lists all sources belonging to an organization.
3756
4705
  # @param [String] parent
3757
4706
  # Required. Resource name of the parent of sources to list. Its format should be
@@ -3951,9 +4900,11 @@ module Google
3951
4900
  # Creates or updates a finding. The corresponding source must exist for a
3952
4901
  # finding creation to succeed.
3953
4902
  # @param [String] name
3954
- # The relative resource name of this finding. See: https://cloud.google.com/apis/
3955
- # design/resource_names#relative_resource_name Example: "organizations/`
3956
- # organization_id`/sources/`source_id`/findings/`finding_id`"
4903
+ # The [relative resource name](https://cloud.google.com/apis/design/
4904
+ # resource_names#relative_resource_name) of the finding. Example: "organizations/
4905
+ # `organization_id`/sources/`source_id`/findings/`finding_id`", "folders/`
4906
+ # folder_id`/sources/`source_id`/findings/`finding_id`", "projects/`project_id`/
4907
+ # sources/`source_id`/findings/`finding_id`".
3957
4908
  # @param [Google::Apis::SecuritycenterV1::Finding] finding_object
3958
4909
  # @param [String] update_mask
3959
4910
  # The FieldMask to use when updating the finding resource. This field should not