Set poll interval: Request

To set the Endpoint Security (HX) host poll interval, send the following request:

PUT https://<IA_IP_address>:<port_number>/config/v1/device/<device_IP>/hostpoll/interval/<poll_interval>

Required header:

Cookie: px=<token>

Note
To use this request, your user account must be assigned to the Admin role.

Options

IA_IP_address—The IP address of the NDR appliance running the NDR API.
port_number—The port number of the NDR appliance running the NDR API.
token—This token authenticates the session. By default, the session times out after 24 hours.

Parameters

device_IP—IP address of the configured device.

poll_interval—Specifies how often the Endpoint Security (HX) host should be polled in hours, minutes, or seconds, formatted as an integer followed by either h, m, or s. For example, 1s, 600s, 30m, 4h.

Example

PUT https://xxx.xxx.xxx.xxx:443/config/v1/device/1.1.1.1/hostpoll/interval/30m

Required header:

Cookie: px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Set poll interval: Response

HTTP/1.1 [Response Code] [Response Message]				
Date: [Date]				
Content-Type: [Content Type]

Response fields

Response Code—A standard HTTP response code.
- 204—Request successful; the poll interval was set.
Date—Standard HTML date format.

Example

HTTP/1.1 200 OK
Date: Fri, 16 Aug 2019 10:33:09 GMT

cURL code sample: Set poll interval

curl -k --cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -X PUT https://xxx.xxx.xxx.xxx:443/config/v1/device/1.1.1.1/hostpoll/interval/3h

This cURL sample includes the following options:

-k—This option explicitly allows cURL to perform insecure SSL connections and transfers, which allows you to test your SSL connection without installing a CA certificate.
--cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"—This option specifies the authentication token for this session.
-X PUT—This option specifies using the PUT method.
https://xxx.xxx.xxx.xxx:443/config/v1/device/1.1.1.1/hostpoll/interval/3h—The polling interval request URL. Replace xxx.xxx.xxx.xxx with the IP address of your NDR appliance, 1.1.1.1 with the IP address of the configured device, and 3h with the interval.

Results

This example sets the Endpoint Security (HX) host polling interval to 3 hours.