Update Sensor Ids Feature Config

Update the appliance IDS configuration

Update the appliance IDS feature configuration. This operation can be called to bulk update the sensors to enable or disable IDS configuration. The operation will either update all or none of the sensors.

Request

URI

POST

https://{api_host}/sensors/feature-config/ids-events

COPY

Query Parameters

string

action

Required

Action to enable or disable ids events with or without pcap for reporting by sensor. Valid values are 'enable_without_pcap', 'enable_with_pcap' and 'disable'.

Request Body

Feature configuration information of the sensor.

SensorIdsFeatureConfig of type(s) application/json

Required

Show optional properties

{
    "sensor_ids": [
        {}
    ]
}

{
    "sensor_ids": [
        "string"
    ]
}

array of string

sensor_ids

Required

Constraints: minItems: 1 maxItems: 25

Specifies the sensor ids for which this feature should be enabled or disabled.

Authentication

This operation uses the following authentication methods.

enterprise_admin

security_engineer

Responses

200

Returns SensorIdsFeatureConfigResponse of type(s) application/json

{
    "enabled": false,
    "pcap_enabled": false,
    "successful_sensor_ids": [
        "string"
    ],
    "failed_sensor_ids": [
        "string"
    ]
}

boolean

enabled

Optional

Constraints: default: true

Specifies whether this feature is enabled.

boolean

pcap_enabled

Optional

Flag to activate or deactivate pcap for IDS events.

array of string

successful_sensor_ids

Optional

Constraints: minItems: 1 maxItems: 25

Specifies the sensor ids for which the update is successful.

array of string

failed_sensor_ids

Optional

Specifies the sensor ids for which update feature has failed.

default

Error

Returns Error of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

Vendor Extension

This operation contains the following vendor extensions defined in the spec:

                    platform-sensor-lic

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"sensor_ids":["string"]}' https://{api_host}/sensors/feature-config/ids-events

On This Page

Description

Request

Query Parameters

Request Body

Authentication

Response

200 Response Body

Errors

Vendor Extension

Sensor Operations

POST