Agent Scan: Recurring

Related Endpoints:

This example request body configures an agent scan to run every Monday. The example specifies the following:

  • A Basic Agent Scan template (uuid). To determine agent template UUIDs, use the List templates endpoint.
  • An agent group (agent_group_id) that specifies targets for the scan. This parameter requires the UUID of the agent group, not its numeric ID. To determine agent group UUIDs, use the uuid attribute returned by the List agent groups endpoint. For more information about agent groups, see Agent Groups.
{
    "uuid": "df9bccd0-c2ee-4129-b781-18d09d1063c98f23937a4bd45a1d",
    "settings": {
    "name": "western-region-assets",
    "description": "recurring",
    "folder_id": 0,
    "scanner_id": null,
    "scanner_uuid": "b6ea8954-5c69-421d-93ae-12a53cdb604eac2e5cbc95310260",
    "enabled": true,
    "scan_time_window": 180,
    "launch": "WEEKLY",
    "starttime": "20140826T133000",
    "rrules": "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO",
    "timezone": "US/Mountain",
    "target_groups": "[]",
    "agent_group_id": [
      "9bd87b50-7349-4a52-8a41-573b9a4b9bb6"
    ],
    "text_targets": null,
    "file_targets": null,
    "tag_targets": [],
    "emails": "[email protected],[email protected]",
    "acls": [
      {
        "permissions": 0,
        "owner": null,
        "display_name": null,
        "name": null,
        "id": null,
        "type": "default"
      },
      {
        "permissions": 16,
        "owner": 0,
        "display_name": "Analyst Group",
        "name": "Analyst Group",
        "id": 1,
        "type": "group"
      },
      {
        "permissions": 128,
        "owner": 1,
        "display_name": "[email protected]",
        "name": "[email protected]",
        "id": 2,
        "type": "user"
      }
    ]
  }
}

Did this page help you?