google-apis-securitycenter_v1 0.53.0 → 0.55.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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