Vulnerability Management: Plugin Update Interval for Sensor Profiles
Tenable has added the plugin_update_interval_hours parameter to the agent and scanner profile endpoints in Tenable Vulnerability Management. This parameter enables you to configure how frequently sensors assigned to a profile check for plugin updates, with intervals as frequent as once per hour instead of the default 24 hours. This helps new plugins reach your sensors sooner.
The Tenable Vulnerability Management interface presents this setting as the Set plugin check in cadence option.
Parameters
Specify the following property in the config object of the request body:
| Parameter | Data Type | Description |
|---|---|---|
plugin_update_interval_hours | Integer | Specifies how frequently sensors assigned to the profile check for plugin updates, in hours. Supported values are 1 through 24. If omitted or set to null, the default interval is 24 hours. |
A value outside the supported range, or a value that is not a whole number, returns a 400 response.
NoteThis feature requires Tenable Agent version 11.2.4 or later for agent profiles and Tenable Nessus version 10.12.7 or later for scanner profiles.
Affected Endpoints
The following endpoints have been updated:
| API Endpoint | Name | Update |
|---|---|---|
| POST /sensors/profiles/{sensor_type} | Create profile | Accepts plugin_update_interval_hours in the config object of the request body. |
| PUT /sensors/profiles/{sensor_type}/{profile_uuid} | Update profile | Accepts plugin_update_interval_hours in the config object of the request body. |
| GET /sensors/profiles/{sensor_type} | List profiles | Returns plugin_update_interval_hours for each profile with the setting configured. |
| GET /sensors/profiles/{sensor_type}/{profile_uuid} | Get profile details | Returns plugin_update_interval_hours when the profile has the setting configured. |
Both agent and scanner profiles support this property. Specify agent or scanners for the {sensor_type} path parameter.
Example Request
For example, to create an agent profile whose agents check for plugin updates every four hours, use the following cURL request:
curl --request POST \
--url https://cloud.tenable.com/sensors/profiles/agent \
--header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"name": "US-1A Sensors",
"description": "This profile targets sensors for US-1A.",
"config": {
"plugin_update_interval_hours": 4
}
}
'