# Run ModSecurity batch settings

This function adds, updates, and removes global ModSecurity™ configuration directives.
The function modifies these directives in the 
file.



When you disable the Web Server role,
the system  this function.

This function  supports the following ModSecurity™ configuration directives:


  setting_idDocumentation
  0SecAuditEngine
  1SecConnEngine
  2SecRuleEngine
  3SecDisableBackendCompression
  4SecGeoLookupDb
  5SecGsbLookupDb
  6SecGuardianLog
  7SecHttpBlKey
  8SecPcreMatchLimit
  9SecPcreMatchLimitRecursion


Endpoint: GET /modsec_batch_settings
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `setting_id` (integer, required)
    The configuration setting's ID.



To configure multiple IDs, increment the parameter name. For example, ,
, and .

  - `state` (any, required)
    The configuration setting's current state.

* 
* 

Some settings accept additional values for this parameter. See the references above for more inforamation.



* To configure multiple settings, increment the parameter name. For example, ,
, and .
*  is ignored if  is set to  for the setting.

  - `remove` (integer)
    Whether to add or remove the configuration setting in the
 file.

*  — Remove the configuration setting.
*  — Add or update the configuration setting.

* To remove multiple settings, increment the parameter name. For example, ,
, and .
    Enum: 1, 0

## Response 200 fields (application/json):

  - `data` (object)

  - `data.updated_settings` (array)
    An array of objects that contains the configuration setting's information.

  - `data.updated_settings.default` (integer)
    The setting's default value.



The  file defines this value.
    Example: 1500

  - `data.updated_settings.description` (string)
    The setting's description.
    Example: "define the match limit of the PCRE library."

  - `data.updated_settings.directive` (string)
    The setting's Apache configuration directive.
    Example: "SecAuditEngine"

  - `data.updated_settings.engine` (integer)
    Whether the setting is an engine directive.

*  — Engine directive.
*  — Normal directive.
    Enum: 1, 0

  - `data.updated_settings.name` (string)
    The setting's name.
    Example: "Audit Log Level"

  - `data.updated_settings.radio_options` (array)
    An array of objects that contain the setting's options display information.

  - `data.updated_settings.radio_options.name` (string)
    The option's display name.
    Example: "Log all transactions."

  - `data.updated_settings.radio_options.option` (string)
    The option.
    Example: "On"

  - `data.updated_settings.setting_id` (integer)
    The setting ID.
    Example: 1

  - `data.updated_settings.state` (string)
    The setting's current state, as set by the  parameter's input value.
    Example: "On"

  - `data.updated_settings.type` (string)
    The form element that the WHM interface uses to display this setting.

*  — WHM users modify this setting via a text box.
*  — WHM users modify this setting via a radio button.
*  — WHM users modify this setting via a text box that 
allows numeric values.
    Example: "radio"

  - `data.updated_settings.url` (string)
    The URL of the setting's entry in the ModSecurity reference manual.
    Example: "https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#secpcrematchlimit"

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "modsec_batch_settings"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is . This field may display a success message when a function succeeds.
    Example: "OK"

  - `metadata.result` (integer)
    *  — Success.
*  — Failed. Check the  field for more details.
    Enum: 1, 0

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1