Rapid7 Blackouts API

A blackout is a period of time when all scanning activities for the specified scope are blocked. A blackout can be scoped globally or to a specific App, this is implied by the scope property; scope value of APP requires that an appropriate app.id value is also provided. There are two options available to specify how often a blackout will occur, either a frequency or a recurrence rule (rrule). Only frequency supports the use of ONCE only blackouts. If providing a rrule, the following fields are permitted:FREQ where FREQ is one of: HOURLY, DAILY, WEEKLY, MONTHLY INTERVALBYDAY where value is: a single day, SA,SU to represent weekend, or all weekdays. BYMONTHDAY where value is a range between: 1 - 31. BYSETPOS where value is one of: -1, 1, 2, 3, 4COUNTIf providing a rrule, the RFC 2445 section-4.8.5.4 IETF specification can be used as a guide for how to create rrules. Example: rrule = "FREQ=MONTHLY;INTERVAL=1;BYDAY=FR;BYSETPOS=-1" represents 'Run every month on the last Friday'.If providing a frequency, the frequency of a blackout is defined by both the type and interval; specifying a type of ONCE does not require an interval. The permitted types are as follows:ONCEHOURLYDAILYWEEKLYMONTHLYEither a frequency or a rrule must be provided for create/update operations.If a frequency.type other than ONCE is provided, the date and time of the blackout recurrences will be calculated based on the frequency or rrule defined, until the threshold of last_start (if one is provided, otherwise until a date considerably far into the future). The value of first_start and first_end define the initial period of the Blackout; duration of this period is adhered to at every recurrence, hence why there is no need to model a last_end.