google-apis-securitycenter_v1 0.61.0 → 0.62.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.
@@ -2070,6 +2070,218 @@ module Google
2070
2070
  execute_or_queue_command(command, &block)
2071
2071
  end
2072
2072
 
2073
+ # Validates the given Event Threat Detection custom module.
2074
+ # @param [String] parent
2075
+ # Required. Resource name of the parent to validate the Custom Module under. Its
2076
+ # format is: * "organizations/`organization`/eventThreatDetectionSettings".
2077
+ # @param [Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleRequest] validate_event_threat_detection_custom_module_request_object
2078
+ # @param [String] fields
2079
+ # Selector specifying which fields to include in a partial response.
2080
+ # @param [String] quota_user
2081
+ # Available to use for quota purposes for server-side applications. Can be any
2082
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2083
+ # @param [Google::Apis::RequestOptions] options
2084
+ # Request-specific options
2085
+ #
2086
+ # @yield [result, err] Result & error if block supplied
2087
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleResponse] parsed result object
2088
+ # @yieldparam err [StandardError] error object if request failed
2089
+ #
2090
+ # @return [Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleResponse]
2091
+ #
2092
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2093
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2094
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2095
+ def validate_organization_event_threat_detection_setting_custom_module(parent, validate_event_threat_detection_custom_module_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2096
+ command = make_simple_command(:post, 'v1/{+parent}:validateCustomModule', options)
2097
+ command.request_representation = Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleRequest::Representation
2098
+ command.request_object = validate_event_threat_detection_custom_module_request_object
2099
+ command.response_representation = Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleResponse::Representation
2100
+ command.response_class = Google::Apis::SecuritycenterV1::ValidateEventThreatDetectionCustomModuleResponse
2101
+ command.params['parent'] = parent unless parent.nil?
2102
+ command.query['fields'] = fields unless fields.nil?
2103
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2104
+ execute_or_queue_command(command, &block)
2105
+ end
2106
+
2107
+ # Creates an Event Threat Detection custom module.
2108
+ # @param [String] parent
2109
+ # Required. The new custom module's parent. Its format is: * "organizations/`
2110
+ # organization`/eventThreatDetectionSettings".
2111
+ # @param [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule] event_threat_detection_custom_module_object
2112
+ # @param [String] fields
2113
+ # Selector specifying which fields to include in a partial response.
2114
+ # @param [String] quota_user
2115
+ # Available to use for quota purposes for server-side applications. Can be any
2116
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2117
+ # @param [Google::Apis::RequestOptions] options
2118
+ # Request-specific options
2119
+ #
2120
+ # @yield [result, err] Result & error if block supplied
2121
+ # @yieldparam result [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule] parsed result object
2122
+ # @yieldparam err [StandardError] error object if request failed
2123
+ #
2124
+ # @return [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule]
2125
+ #
2126
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2127
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2128
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2129
+ def create_organization_event_threat_detection_setting_custom_module(parent, event_threat_detection_custom_module_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2130
+ command = make_simple_command(:post, 'v1/{+parent}/customModules', options)
2131
+ command.request_representation = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule::Representation
2132
+ command.request_object = event_threat_detection_custom_module_object
2133
+ command.response_representation = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule::Representation
2134
+ command.response_class = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule
2135
+ command.params['parent'] = parent unless parent.nil?
2136
+ command.query['fields'] = fields unless fields.nil?
2137
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2138
+ execute_or_queue_command(command, &block)
2139
+ end
2140
+
2141
+ # Deletes an Event Threat Detection custom module.
2142
+ # @param [String] name
2143
+ # Required. Name of the custom module to delete. Its format is: * "organizations/
2144
+ # `organization`/eventThreatDetectionSettings/customModules/`module`".
2145
+ # @param [String] fields
2146
+ # Selector specifying which fields to include in a partial response.
2147
+ # @param [String] quota_user
2148
+ # Available to use for quota purposes for server-side applications. Can be any
2149
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2150
+ # @param [Google::Apis::RequestOptions] options
2151
+ # Request-specific options
2152
+ #
2153
+ # @yield [result, err] Result & error if block supplied
2154
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2155
+ # @yieldparam err [StandardError] error object if request failed
2156
+ #
2157
+ # @return [Google::Apis::SecuritycenterV1::Empty]
2158
+ #
2159
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2160
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2161
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2162
+ def delete_organization_event_threat_detection_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
2163
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2164
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2165
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
2166
+ command.params['name'] = name unless name.nil?
2167
+ command.query['fields'] = fields unless fields.nil?
2168
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2169
+ execute_or_queue_command(command, &block)
2170
+ end
2171
+
2172
+ # Gets an Event Threat Detection custom module.
2173
+ # @param [String] name
2174
+ # Required. Name of the custom module to get. Its format is: * "organizations/`
2175
+ # organization`/eventThreatDetectionSettings/customModules/`module`".
2176
+ # @param [String] fields
2177
+ # Selector specifying which fields to include in a partial response.
2178
+ # @param [String] quota_user
2179
+ # Available to use for quota purposes for server-side applications. Can be any
2180
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2181
+ # @param [Google::Apis::RequestOptions] options
2182
+ # Request-specific options
2183
+ #
2184
+ # @yield [result, err] Result & error if block supplied
2185
+ # @yieldparam result [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule] parsed result object
2186
+ # @yieldparam err [StandardError] error object if request failed
2187
+ #
2188
+ # @return [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule]
2189
+ #
2190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2193
+ def get_organization_event_threat_detection_setting_custom_module(name, fields: nil, quota_user: nil, options: nil, &block)
2194
+ command = make_simple_command(:get, 'v1/{+name}', options)
2195
+ command.response_representation = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule::Representation
2196
+ command.response_class = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule
2197
+ command.params['name'] = name unless name.nil?
2198
+ command.query['fields'] = fields unless fields.nil?
2199
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2200
+ execute_or_queue_command(command, &block)
2201
+ end
2202
+
2203
+ # Lists Event Threat Detection custom modules.
2204
+ # @param [String] parent
2205
+ # Required. Name of the parent to list custom modules under. Its format is: * "
2206
+ # organizations/`organization`/eventThreatDetectionSettings".
2207
+ # @param [Fixnum] page_size
2208
+ # The maximum number of modules to return. The service may return fewer than
2209
+ # this value. If unspecified, at most 10 configs will be returned. The maximum
2210
+ # value is 1000; values above 1000 will be coerced to 1000.
2211
+ # @param [String] page_token
2212
+ # A page token, received from a previous `ListEventThreatDetectionCustomModules`
2213
+ # call. Provide this to retrieve the subsequent page. When paginating, all other
2214
+ # parameters provided to `ListEventThreatDetectionCustomModules` must match the
2215
+ # call that provided the page token.
2216
+ # @param [String] fields
2217
+ # Selector specifying which fields to include in a partial response.
2218
+ # @param [String] quota_user
2219
+ # Available to use for quota purposes for server-side applications. Can be any
2220
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2221
+ # @param [Google::Apis::RequestOptions] options
2222
+ # Request-specific options
2223
+ #
2224
+ # @yield [result, err] Result & error if block supplied
2225
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListEventThreatDetectionCustomModulesResponse] parsed result object
2226
+ # @yieldparam err [StandardError] error object if request failed
2227
+ #
2228
+ # @return [Google::Apis::SecuritycenterV1::ListEventThreatDetectionCustomModulesResponse]
2229
+ #
2230
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2231
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2232
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2233
+ def list_organization_event_threat_detection_setting_custom_modules(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2234
+ command = make_simple_command(:get, 'v1/{+parent}/customModules', options)
2235
+ command.response_representation = Google::Apis::SecuritycenterV1::ListEventThreatDetectionCustomModulesResponse::Representation
2236
+ command.response_class = Google::Apis::SecuritycenterV1::ListEventThreatDetectionCustomModulesResponse
2237
+ command.params['parent'] = parent unless parent.nil?
2238
+ command.query['pageSize'] = page_size unless page_size.nil?
2239
+ command.query['pageToken'] = page_token unless page_token.nil?
2240
+ command.query['fields'] = fields unless fields.nil?
2241
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2242
+ execute_or_queue_command(command, &block)
2243
+ end
2244
+
2245
+ # Updates an Event Threat Detection custom module.
2246
+ # @param [String] name
2247
+ # Immutable. The resource name of the Event Threat Detection custom module. Its
2248
+ # format is: * "organizations/`organization`/eventThreatDetectionSettings/
2249
+ # customModules/`module`". * "folders/`folder`/eventThreatDetectionSettings/
2250
+ # customModules/`module`". * "projects/`project`/eventThreatDetectionSettings/
2251
+ # customModules/`module`".
2252
+ # @param [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule] event_threat_detection_custom_module_object
2253
+ # @param [String] update_mask
2254
+ # The list of fields to be updated. If empty all mutable fields will be updated.
2255
+ # @param [String] fields
2256
+ # Selector specifying which fields to include in a partial response.
2257
+ # @param [String] quota_user
2258
+ # Available to use for quota purposes for server-side applications. Can be any
2259
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2260
+ # @param [Google::Apis::RequestOptions] options
2261
+ # Request-specific options
2262
+ #
2263
+ # @yield [result, err] Result & error if block supplied
2264
+ # @yieldparam result [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule] parsed result object
2265
+ # @yieldparam err [StandardError] error object if request failed
2266
+ #
2267
+ # @return [Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule]
2268
+ #
2269
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2270
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2271
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2272
+ def patch_organization_event_threat_detection_setting_custom_module(name, event_threat_detection_custom_module_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2273
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2274
+ command.request_representation = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule::Representation
2275
+ command.request_object = event_threat_detection_custom_module_object
2276
+ command.response_representation = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule::Representation
2277
+ command.response_class = Google::Apis::SecuritycenterV1::EventThreatDetectionCustomModule
2278
+ command.params['name'] = name unless name.nil?
2279
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2280
+ command.query['fields'] = fields unless fields.nil?
2281
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2282
+ execute_or_queue_command(command, &block)
2283
+ end
2284
+
2073
2285
  # Kicks off an LRO to bulk mute findings for a parent based on a filter. The
2074
2286
  # parent can be either an organization, folder or project. The findings matched
2075
2287
  # by the filter will be muted after the LRO is done.
@@ -2622,6 +2834,182 @@ module Google
2622
2834
  execute_or_queue_command(command, &block)
2623
2835
  end
2624
2836
 
2837
+ # Creates a ResourceValueConfig for an organization. Maps user's tags to
2838
+ # difference resource values for use by the attack path simulation.
2839
+ # @param [String] parent
2840
+ # Required. Resource name of the new ResourceValueConfig's parent. The parent
2841
+ # field in the CreateResourceValueConfigRequest messages must either be empty or
2842
+ # match this field.
2843
+ # @param [Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsRequest] batch_create_resource_value_configs_request_object
2844
+ # @param [String] fields
2845
+ # Selector specifying which fields to include in a partial response.
2846
+ # @param [String] quota_user
2847
+ # Available to use for quota purposes for server-side applications. Can be any
2848
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2849
+ # @param [Google::Apis::RequestOptions] options
2850
+ # Request-specific options
2851
+ #
2852
+ # @yield [result, err] Result & error if block supplied
2853
+ # @yieldparam result [Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsResponse] parsed result object
2854
+ # @yieldparam err [StandardError] error object if request failed
2855
+ #
2856
+ # @return [Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsResponse]
2857
+ #
2858
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2859
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2860
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2861
+ def batch_create_resource_value_configs(parent, batch_create_resource_value_configs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2862
+ command = make_simple_command(:post, 'v1/{+parent}/resourceValueConfigs:batchCreate', options)
2863
+ command.request_representation = Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsRequest::Representation
2864
+ command.request_object = batch_create_resource_value_configs_request_object
2865
+ command.response_representation = Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsResponse::Representation
2866
+ command.response_class = Google::Apis::SecuritycenterV1::BatchCreateResourceValueConfigsResponse
2867
+ command.params['parent'] = parent unless parent.nil?
2868
+ command.query['fields'] = fields unless fields.nil?
2869
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2870
+ execute_or_queue_command(command, &block)
2871
+ end
2872
+
2873
+ # Deletes a ResourceValueConfig.
2874
+ # @param [String] name
2875
+ # Required. Name of the ResourceValueConfig to delete
2876
+ # @param [String] fields
2877
+ # Selector specifying which fields to include in a partial response.
2878
+ # @param [String] quota_user
2879
+ # Available to use for quota purposes for server-side applications. Can be any
2880
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2881
+ # @param [Google::Apis::RequestOptions] options
2882
+ # Request-specific options
2883
+ #
2884
+ # @yield [result, err] Result & error if block supplied
2885
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Empty] parsed result object
2886
+ # @yieldparam err [StandardError] error object if request failed
2887
+ #
2888
+ # @return [Google::Apis::SecuritycenterV1::Empty]
2889
+ #
2890
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2891
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2892
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2893
+ def delete_organization_resource_value_config(name, fields: nil, quota_user: nil, options: nil, &block)
2894
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2895
+ command.response_representation = Google::Apis::SecuritycenterV1::Empty::Representation
2896
+ command.response_class = Google::Apis::SecuritycenterV1::Empty
2897
+ command.params['name'] = name unless name.nil?
2898
+ command.query['fields'] = fields unless fields.nil?
2899
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2900
+ execute_or_queue_command(command, &block)
2901
+ end
2902
+
2903
+ # Gets a ResourceValueConfig.
2904
+ # @param [String] name
2905
+ # Required. Name of the resource value config to retrieve. Its format is
2906
+ # organizations/`organization`/resourceValueConfigs/`config_id`.
2907
+ # @param [String] fields
2908
+ # Selector specifying which fields to include in a partial response.
2909
+ # @param [String] quota_user
2910
+ # Available to use for quota purposes for server-side applications. Can be any
2911
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2912
+ # @param [Google::Apis::RequestOptions] options
2913
+ # Request-specific options
2914
+ #
2915
+ # @yield [result, err] Result & error if block supplied
2916
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig] parsed result object
2917
+ # @yieldparam err [StandardError] error object if request failed
2918
+ #
2919
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig]
2920
+ #
2921
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2922
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2923
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2924
+ def get_organization_resource_value_config(name, fields: nil, quota_user: nil, options: nil, &block)
2925
+ command = make_simple_command(:get, 'v1/{+name}', options)
2926
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig::Representation
2927
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig
2928
+ command.params['name'] = name unless name.nil?
2929
+ command.query['fields'] = fields unless fields.nil?
2930
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2931
+ execute_or_queue_command(command, &block)
2932
+ end
2933
+
2934
+ # Lists all ResourceValueConfigs.
2935
+ # @param [String] parent
2936
+ # Required. The parent, which owns the collection of resource value configs. Its
2937
+ # format is "organizations/[organization_id]"
2938
+ # @param [Fixnum] page_size
2939
+ # The number of results to return. The service may return fewer than this value.
2940
+ # If unspecified, at most 10 configs will be returned. The maximum value is 1000;
2941
+ # values above 1000 will be coerced to 1000.
2942
+ # @param [String] page_token
2943
+ # A page token, received from a previous `ListResourceValueConfigs` call.
2944
+ # Provide this to retrieve the subsequent page. When paginating, all other
2945
+ # parameters provided to `ListResourceValueConfigs` must match the call that
2946
+ # provided the page token. page_size can be specified, and the new page_size
2947
+ # will be used.
2948
+ # @param [String] fields
2949
+ # Selector specifying which fields to include in a partial response.
2950
+ # @param [String] quota_user
2951
+ # Available to use for quota purposes for server-side applications. Can be any
2952
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2953
+ # @param [Google::Apis::RequestOptions] options
2954
+ # Request-specific options
2955
+ #
2956
+ # @yield [result, err] Result & error if block supplied
2957
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListResourceValueConfigsResponse] parsed result object
2958
+ # @yieldparam err [StandardError] error object if request failed
2959
+ #
2960
+ # @return [Google::Apis::SecuritycenterV1::ListResourceValueConfigsResponse]
2961
+ #
2962
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2963
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2964
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2965
+ def list_organization_resource_value_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2966
+ command = make_simple_command(:get, 'v1/{+parent}/resourceValueConfigs', options)
2967
+ command.response_representation = Google::Apis::SecuritycenterV1::ListResourceValueConfigsResponse::Representation
2968
+ command.response_class = Google::Apis::SecuritycenterV1::ListResourceValueConfigsResponse
2969
+ command.params['parent'] = parent unless parent.nil?
2970
+ command.query['pageSize'] = page_size unless page_size.nil?
2971
+ command.query['pageToken'] = page_token unless page_token.nil?
2972
+ command.query['fields'] = fields unless fields.nil?
2973
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2974
+ execute_or_queue_command(command, &block)
2975
+ end
2976
+
2977
+ # Updates an existing ResourceValueConfigs with new rules.
2978
+ # @param [String] name
2979
+ # Name for the resource value config
2980
+ # @param [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig] google_cloud_securitycenter_v1_resource_value_config_object
2981
+ # @param [String] update_mask
2982
+ # The list of fields to be updated. If empty all mutable fields will be updated.
2983
+ # @param [String] fields
2984
+ # Selector specifying which fields to include in a partial response.
2985
+ # @param [String] quota_user
2986
+ # Available to use for quota purposes for server-side applications. Can be any
2987
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2988
+ # @param [Google::Apis::RequestOptions] options
2989
+ # Request-specific options
2990
+ #
2991
+ # @yield [result, err] Result & error if block supplied
2992
+ # @yieldparam result [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig] parsed result object
2993
+ # @yieldparam err [StandardError] error object if request failed
2994
+ #
2995
+ # @return [Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig]
2996
+ #
2997
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2998
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2999
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3000
+ def patch_organization_resource_value_config(name, google_cloud_securitycenter_v1_resource_value_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3001
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3002
+ command.request_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig::Representation
3003
+ command.request_object = google_cloud_securitycenter_v1_resource_value_config_object
3004
+ command.response_representation = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig::Representation
3005
+ command.response_class = Google::Apis::SecuritycenterV1::GoogleCloudSecuritycenterV1ResourceValueConfig
3006
+ command.params['name'] = name unless name.nil?
3007
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3008
+ command.query['fields'] = fields unless fields.nil?
3009
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3010
+ execute_or_queue_command(command, &block)
3011
+ end
3012
+
2625
3013
  # Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the
2626
3014
  # given CRM parent, and also creates inherited
2627
3015
  # SecurityHealthAnalyticsCustomModules for all CRM descendants of the given
@@ -2937,6 +3325,274 @@ module Google
2937
3325
  execute_or_queue_command(command, &block)
2938
3326
  end
2939
3327
 
3328
+ # Get the simulation by name or the latest simulation for the given organization.
3329
+ # @param [String] name
3330
+ # Required. The organization name or simulation name of this simulation Valid
3331
+ # format: "organizations/`organization`/simulations/latest" "organizations/`
3332
+ # organization`/simulations/`simulation`"
3333
+ # @param [String] fields
3334
+ # Selector specifying which fields to include in a partial response.
3335
+ # @param [String] quota_user
3336
+ # Available to use for quota purposes for server-side applications. Can be any
3337
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3338
+ # @param [Google::Apis::RequestOptions] options
3339
+ # Request-specific options
3340
+ #
3341
+ # @yield [result, err] Result & error if block supplied
3342
+ # @yieldparam result [Google::Apis::SecuritycenterV1::Simulation] parsed result object
3343
+ # @yieldparam err [StandardError] error object if request failed
3344
+ #
3345
+ # @return [Google::Apis::SecuritycenterV1::Simulation]
3346
+ #
3347
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3348
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3349
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3350
+ def get_organization_simulation(name, fields: nil, quota_user: nil, options: nil, &block)
3351
+ command = make_simple_command(:get, 'v1/{+name}', options)
3352
+ command.response_representation = Google::Apis::SecuritycenterV1::Simulation::Representation
3353
+ command.response_class = Google::Apis::SecuritycenterV1::Simulation
3354
+ command.params['name'] = name unless name.nil?
3355
+ command.query['fields'] = fields unless fields.nil?
3356
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3357
+ execute_or_queue_command(command, &block)
3358
+ end
3359
+
3360
+ # Lists the attack paths for a set of simulation results or valued resources and
3361
+ # filter.
3362
+ # @param [String] parent
3363
+ # Required. Name of parent to list attack paths. Valid formats: "organizations/`
3364
+ # organization`", "organizations/`organization`/simulations/`simulation`" "
3365
+ # organizations/`organization`/simulations/`simulation`/attackExposureResults/`
3366
+ # attack_exposure_result_v2`" "organizations/`organization`/simulations/`
3367
+ # simulation`/valuedResources/`valued_resource`"
3368
+ # @param [String] filter
3369
+ # The filter expression that filters the attack path in the response. Supported
3370
+ # fields: * `valued_resources` supports =
3371
+ # @param [Fixnum] page_size
3372
+ # The maximum number of results to return in a single response. Default is 10,
3373
+ # minimum is 1, maximum is 1000.
3374
+ # @param [String] page_token
3375
+ # The value returned by the last `ListAttackPathsResponse`; indicates that this
3376
+ # is a continuation of a prior `ListAttackPaths` call, and that the system
3377
+ # should return the next page of data.
3378
+ # @param [String] fields
3379
+ # Selector specifying which fields to include in a partial response.
3380
+ # @param [String] quota_user
3381
+ # Available to use for quota purposes for server-side applications. Can be any
3382
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3383
+ # @param [Google::Apis::RequestOptions] options
3384
+ # Request-specific options
3385
+ #
3386
+ # @yield [result, err] Result & error if block supplied
3387
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListAttackPathsResponse] parsed result object
3388
+ # @yieldparam err [StandardError] error object if request failed
3389
+ #
3390
+ # @return [Google::Apis::SecuritycenterV1::ListAttackPathsResponse]
3391
+ #
3392
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3393
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3394
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3395
+ def list_organization_simulation_attack_exposure_result_attack_paths(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3396
+ command = make_simple_command(:get, 'v1/{+parent}/attackPaths', options)
3397
+ command.response_representation = Google::Apis::SecuritycenterV1::ListAttackPathsResponse::Representation
3398
+ command.response_class = Google::Apis::SecuritycenterV1::ListAttackPathsResponse
3399
+ command.params['parent'] = parent unless parent.nil?
3400
+ command.query['filter'] = filter unless filter.nil?
3401
+ command.query['pageSize'] = page_size unless page_size.nil?
3402
+ command.query['pageToken'] = page_token unless page_token.nil?
3403
+ command.query['fields'] = fields unless fields.nil?
3404
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3405
+ execute_or_queue_command(command, &block)
3406
+ end
3407
+
3408
+ # Lists the valued resources for a set of simulation results and filter.
3409
+ # @param [String] parent
3410
+ # Required. Name of parent to list valued resources. Valid formats: "
3411
+ # organizations/`organization`", "organizations/`organization`/simulations/`
3412
+ # simulation`" "organizations/`organization`/simulations/`simulation`/
3413
+ # attackExposureResults/`attack_exposure_result_v2`"
3414
+ # @param [String] filter
3415
+ # The filter expression that filters the valued resources in the response.
3416
+ # Supported fields: * `resource_value` supports = * `resource_type` supports =
3417
+ # @param [Fixnum] page_size
3418
+ # The maximum number of results to return in a single response. Default is 10,
3419
+ # minimum is 1, maximum is 1000.
3420
+ # @param [String] page_token
3421
+ # The value returned by the last `ListValuedResourcesResponse`; indicates that
3422
+ # this is a continuation of a prior `ListValuedResources` call, and that the
3423
+ # system should return the next page of data.
3424
+ # @param [String] fields
3425
+ # Selector specifying which fields to include in a partial response.
3426
+ # @param [String] quota_user
3427
+ # Available to use for quota purposes for server-side applications. Can be any
3428
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3429
+ # @param [Google::Apis::RequestOptions] options
3430
+ # Request-specific options
3431
+ #
3432
+ # @yield [result, err] Result & error if block supplied
3433
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListValuedResourcesResponse] parsed result object
3434
+ # @yieldparam err [StandardError] error object if request failed
3435
+ #
3436
+ # @return [Google::Apis::SecuritycenterV1::ListValuedResourcesResponse]
3437
+ #
3438
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3439
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3440
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3441
+ def list_organization_simulation_attack_exposure_result_valued_resources(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3442
+ command = make_simple_command(:get, 'v1/{+parent}/valuedResources', options)
3443
+ command.response_representation = Google::Apis::SecuritycenterV1::ListValuedResourcesResponse::Representation
3444
+ command.response_class = Google::Apis::SecuritycenterV1::ListValuedResourcesResponse
3445
+ command.params['parent'] = parent unless parent.nil?
3446
+ command.query['filter'] = filter unless filter.nil?
3447
+ command.query['pageSize'] = page_size unless page_size.nil?
3448
+ command.query['pageToken'] = page_token unless page_token.nil?
3449
+ command.query['fields'] = fields unless fields.nil?
3450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3451
+ execute_or_queue_command(command, &block)
3452
+ end
3453
+
3454
+ # Lists the attack paths for a set of simulation results or valued resources and
3455
+ # filter.
3456
+ # @param [String] parent
3457
+ # Required. Name of parent to list attack paths. Valid formats: "organizations/`
3458
+ # organization`", "organizations/`organization`/simulations/`simulation`" "
3459
+ # organizations/`organization`/simulations/`simulation`/attackExposureResults/`
3460
+ # attack_exposure_result_v2`" "organizations/`organization`/simulations/`
3461
+ # simulation`/valuedResources/`valued_resource`"
3462
+ # @param [String] filter
3463
+ # The filter expression that filters the attack path in the response. Supported
3464
+ # fields: * `valued_resources` supports =
3465
+ # @param [Fixnum] page_size
3466
+ # The maximum number of results to return in a single response. Default is 10,
3467
+ # minimum is 1, maximum is 1000.
3468
+ # @param [String] page_token
3469
+ # The value returned by the last `ListAttackPathsResponse`; indicates that this
3470
+ # is a continuation of a prior `ListAttackPaths` call, and that the system
3471
+ # should return the next page of data.
3472
+ # @param [String] fields
3473
+ # Selector specifying which fields to include in a partial response.
3474
+ # @param [String] quota_user
3475
+ # Available to use for quota purposes for server-side applications. Can be any
3476
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3477
+ # @param [Google::Apis::RequestOptions] options
3478
+ # Request-specific options
3479
+ #
3480
+ # @yield [result, err] Result & error if block supplied
3481
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListAttackPathsResponse] parsed result object
3482
+ # @yieldparam err [StandardError] error object if request failed
3483
+ #
3484
+ # @return [Google::Apis::SecuritycenterV1::ListAttackPathsResponse]
3485
+ #
3486
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3487
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3488
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3489
+ def list_organization_simulation_attack_paths(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3490
+ command = make_simple_command(:get, 'v1/{+parent}/attackPaths', options)
3491
+ command.response_representation = Google::Apis::SecuritycenterV1::ListAttackPathsResponse::Representation
3492
+ command.response_class = Google::Apis::SecuritycenterV1::ListAttackPathsResponse
3493
+ command.params['parent'] = parent unless parent.nil?
3494
+ command.query['filter'] = filter unless filter.nil?
3495
+ command.query['pageSize'] = page_size unless page_size.nil?
3496
+ command.query['pageToken'] = page_token unless page_token.nil?
3497
+ command.query['fields'] = fields unless fields.nil?
3498
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3499
+ execute_or_queue_command(command, &block)
3500
+ end
3501
+
3502
+ # Lists the valued resources for a set of simulation results and filter.
3503
+ # @param [String] parent
3504
+ # Required. Name of parent to list valued resources. Valid formats: "
3505
+ # organizations/`organization`", "organizations/`organization`/simulations/`
3506
+ # simulation`" "organizations/`organization`/simulations/`simulation`/
3507
+ # attackExposureResults/`attack_exposure_result_v2`"
3508
+ # @param [String] filter
3509
+ # The filter expression that filters the valued resources in the response.
3510
+ # Supported fields: * `resource_value` supports = * `resource_type` supports =
3511
+ # @param [Fixnum] page_size
3512
+ # The maximum number of results to return in a single response. Default is 10,
3513
+ # minimum is 1, maximum is 1000.
3514
+ # @param [String] page_token
3515
+ # The value returned by the last `ListValuedResourcesResponse`; indicates that
3516
+ # this is a continuation of a prior `ListValuedResources` call, and that the
3517
+ # system should return the next page of data.
3518
+ # @param [String] fields
3519
+ # Selector specifying which fields to include in a partial response.
3520
+ # @param [String] quota_user
3521
+ # Available to use for quota purposes for server-side applications. Can be any
3522
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3523
+ # @param [Google::Apis::RequestOptions] options
3524
+ # Request-specific options
3525
+ #
3526
+ # @yield [result, err] Result & error if block supplied
3527
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListValuedResourcesResponse] parsed result object
3528
+ # @yieldparam err [StandardError] error object if request failed
3529
+ #
3530
+ # @return [Google::Apis::SecuritycenterV1::ListValuedResourcesResponse]
3531
+ #
3532
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3533
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3534
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3535
+ def list_organization_simulation_valued_resources(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3536
+ command = make_simple_command(:get, 'v1/{+parent}/valuedResources', options)
3537
+ command.response_representation = Google::Apis::SecuritycenterV1::ListValuedResourcesResponse::Representation
3538
+ command.response_class = Google::Apis::SecuritycenterV1::ListValuedResourcesResponse
3539
+ command.params['parent'] = parent unless parent.nil?
3540
+ command.query['filter'] = filter unless filter.nil?
3541
+ command.query['pageSize'] = page_size unless page_size.nil?
3542
+ command.query['pageToken'] = page_token unless page_token.nil?
3543
+ command.query['fields'] = fields unless fields.nil?
3544
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3545
+ execute_or_queue_command(command, &block)
3546
+ end
3547
+
3548
+ # Lists the attack paths for a set of simulation results or valued resources and
3549
+ # filter.
3550
+ # @param [String] parent
3551
+ # Required. Name of parent to list attack paths. Valid formats: "organizations/`
3552
+ # organization`", "organizations/`organization`/simulations/`simulation`" "
3553
+ # organizations/`organization`/simulations/`simulation`/attackExposureResults/`
3554
+ # attack_exposure_result_v2`" "organizations/`organization`/simulations/`
3555
+ # simulation`/valuedResources/`valued_resource`"
3556
+ # @param [String] filter
3557
+ # The filter expression that filters the attack path in the response. Supported
3558
+ # fields: * `valued_resources` supports =
3559
+ # @param [Fixnum] page_size
3560
+ # The maximum number of results to return in a single response. Default is 10,
3561
+ # minimum is 1, maximum is 1000.
3562
+ # @param [String] page_token
3563
+ # The value returned by the last `ListAttackPathsResponse`; indicates that this
3564
+ # is a continuation of a prior `ListAttackPaths` call, and that the system
3565
+ # should return the next page of data.
3566
+ # @param [String] fields
3567
+ # Selector specifying which fields to include in a partial response.
3568
+ # @param [String] quota_user
3569
+ # Available to use for quota purposes for server-side applications. Can be any
3570
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3571
+ # @param [Google::Apis::RequestOptions] options
3572
+ # Request-specific options
3573
+ #
3574
+ # @yield [result, err] Result & error if block supplied
3575
+ # @yieldparam result [Google::Apis::SecuritycenterV1::ListAttackPathsResponse] parsed result object
3576
+ # @yieldparam err [StandardError] error object if request failed
3577
+ #
3578
+ # @return [Google::Apis::SecuritycenterV1::ListAttackPathsResponse]
3579
+ #
3580
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3581
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3582
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3583
+ def list_organization_simulation_valued_resource_attack_paths(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3584
+ command = make_simple_command(:get, 'v1/{+parent}/attackPaths', options)
3585
+ command.response_representation = Google::Apis::SecuritycenterV1::ListAttackPathsResponse::Representation
3586
+ command.response_class = Google::Apis::SecuritycenterV1::ListAttackPathsResponse
3587
+ command.params['parent'] = parent unless parent.nil?
3588
+ command.query['filter'] = filter unless filter.nil?
3589
+ command.query['pageSize'] = page_size unless page_size.nil?
3590
+ command.query['pageToken'] = page_token unless page_token.nil?
3591
+ command.query['fields'] = fields unless fields.nil?
3592
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3593
+ execute_or_queue_command(command, &block)
3594
+ end
3595
+
2940
3596
  # Creates a source.
2941
3597
  # @param [String] parent
2942
3598
  # Required. Resource name of the new source's parent. Its format should be "