Update Sensor Flow Feature Config

Update the appliance flow collection configuration

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

Request

URI

POST

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

COPY

Query Parameters

string

action

Required

Action to enable or disable flow collection. Valid values are 'enable' and 'disable'.

Request Body

Feature configuration information of the sensor.

SensorFlowFeatureConfig 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 the feaure should be enabled or disabled.

Authentication

This operation uses the following authentication methods.

enterprise_admin

security_engineer

Responses

200

Returns SensorFlowFeatureConfigResponse of type(s) application/json

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

boolean

enabled

Optional

Constraints: default: true

Specifies whether this feature is enabled. Default is true.

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/flow-events

On This Page

Description

Request

Query Parameters

Request Body

Authentication

Response

200 Response Body

Errors

Vendor Extension

Sensor Operations

POST