You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 10, 2024. It is now read-only.
**day_of_week** | **str** | The day of the week the scheduled task should repeat. This property only applies to schedules with a `every` value of `\"day-of-month\"`. | [optional]
7
+
**every** | **str** | The frequency schedule repeats. Each value represents a different unit of time and is used in conjunction with the property `interval`. For example, a schedule can repeat hourly, daily, monthly, etc. The following table describes each supported value: | Value | Description | | ---------- | ---------------- | | hour | Specifies the schedule repeats in hourly increments. | | day | Specifies the schedule repeats in daily increments. | | week | Specifies the schedule repeats in weekly increments. | | date-of-month | Specifies the schedule repeats nth day of the `interval` month. Requires the property `dateOfMonth` to be specified. For example, if `dateOfMonth` is `17` and the `interval` is `2`, then the schedule will repeat every 2 months on the 17th day of the month. | | day-of-month | Specifies the schedule repeats on a monthly interval but instead of a specific date being specified, the day of the week and week of the month are specified. Requires the properties `dayOfWeek` and `weekOfMonth` to be specified. For example, if `dayOfWeek` is `\"friday\"`, `weekOfMonth` is `3`, and the `interval` is `4`, then the schedule will repeat every 4 months on the 3rd Friday of the month. | |
8
+
**interval** | **int** | The interval time the schedule should repeat. The is depends on the value set in `every`. For example, if the value in property `every` is set to `\"day\"` and `interval` is set to `2`, then the schedule will repeat every 2 days. |
9
+
**last_day_of_month** | **bool** | Whether to run the scheduled task on the last day of the month. | [optional]
10
+
**week_of_month** | **int** | The week of the month the scheduled task should repeat. For This property only applies to schedules with a `every` value of `\"day-of-month\"`. Each week of the month is counted in 7-day increments. For example, week 1 consists of days 1-7 of the month while week 2 consists of days 8-14 of the month and so forth. | [optional]
11
+
12
+
[[Back to Model list]](../README.md#documentation-for-models)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to README]](../README.md)
Copy file name to clipboardExpand all lines: docs/ScanApi.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -220,7 +220,7 @@ No authorization required
220
220
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
[**get_current_shared_secret_time_to_live**](ScanEngineApi.md#get_current_shared_secret_time_to_live) | **GET** /api/3/scan_engines/shared_secret/time_to_live | Scan Engine Shared Secret Time to live
12
16
[**get_engine_pool**](ScanEngineApi.md#get_engine_pool) | **GET** /api/3/scan_engine_pools/{id} | Engine Pool
[**get_scan_engine_pool_scan_engines**](ScanEngineApi.md#get_scan_engine_pool_scan_engines) | **GET** /api/3/scan_engine_pools/{id}/engines | Engine Pool Engines
@@ -170,6 +174,50 @@ No authorization required
170
174
171
175
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
172
176
177
+
# **create_shared_secret**
178
+
> str create_shared_secret()
179
+
180
+
Scan Engine Shared Secret
181
+
182
+
Returns the current valid shared secret or generates a new shared secret. The endpoint returns an existing shared secret if one was previously generated and it has not yet expired. Conversely, the endpoint will generate and return a new shared secret for either of the following conditions: a shared secret was not previously generated or the previously-generated shared secret has expired. The shared secret is valid for 60 minutes from the moment it is generated.
print("Exception when calling ScanEngineApi->create_shared_secret: %s\n"% e)
201
+
```
202
+
203
+
### Parameters
204
+
This endpoint does not need any parameter.
205
+
206
+
### Return type
207
+
208
+
**str**
209
+
210
+
### Authorization
211
+
212
+
No authorization required
213
+
214
+
### HTTP request headers
215
+
216
+
-**Content-Type**: application/json
217
+
-**Accept**: application/json;charset=UTF-8
218
+
219
+
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
220
+
173
221
# **delete_scan_engine**
174
222
> Links delete_scan_engine(id)
175
223
@@ -218,6 +266,50 @@ No authorization required
218
266
219
267
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
220
268
269
+
# **delete_shared_secret**
270
+
> Links delete_shared_secret()
271
+
272
+
Scan Engine Shared Secret
273
+
274
+
Revokes the current valid shared secret, if one exists.
print("Exception when calling ScanEngineApi->delete_shared_secret: %s\n"% e)
293
+
```
294
+
295
+
### Parameters
296
+
This endpoint does not need any parameter.
297
+
298
+
### Return type
299
+
300
+
[**Links**](Links.md)
301
+
302
+
### Authorization
303
+
304
+
No authorization required
305
+
306
+
### HTTP request headers
307
+
308
+
-**Content-Type**: application/json
309
+
-**Accept**: application/json;charset=UTF-8
310
+
311
+
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
268
360
361
+
# **get_current_shared_secret**
362
+
> str get_current_shared_secret()
363
+
364
+
Scan Engine Shared Secret
365
+
366
+
Returns the current valid shared secret, if one has been previously generated and it has not yet expired; otherwise the endpoint will respond with a 404 status code. Use this endpoint to detect whether a previously-generated shared secret is still valid.
print("Exception when calling ScanEngineApi->get_current_shared_secret: %s\n"% e)
385
+
```
386
+
387
+
### Parameters
388
+
This endpoint does not need any parameter.
389
+
390
+
### Return type
391
+
392
+
**str**
393
+
394
+
### Authorization
395
+
396
+
No authorization required
397
+
398
+
### HTTP request headers
399
+
400
+
-**Content-Type**: application/json
401
+
-**Accept**: application/json;charset=UTF-8
402
+
403
+
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
404
+
405
+
# **get_current_shared_secret_time_to_live**
406
+
> int get_current_shared_secret_time_to_live()
407
+
408
+
Scan Engine Shared Secret Time to live
409
+
410
+
Returns the number of seconds remaining for the current shared secret before it expires, if one has been previously generated and it has not yet expired; otherwise the endpoint will respond with a 404 status code.
print("Exception when calling ScanEngineApi->get_current_shared_secret_time_to_live: %s\n"% e)
429
+
```
430
+
431
+
### Parameters
432
+
This endpoint does not need any parameter.
433
+
434
+
### Return type
435
+
436
+
**int**
437
+
438
+
### Authorization
439
+
440
+
No authorization required
441
+
442
+
### HTTP request headers
443
+
444
+
-**Content-Type**: application/json
445
+
-**Accept**: application/json;charset=UTF-8
446
+
447
+
[[Back to top]](#)[[Back to API list]](../README.md#documentation-for-api-endpoints)[[Back to Model list]](../README.md#documentation-for-models)[[Back to README]](../README.md)
**next_runtimes** | **list[str]** | List the next 10 dates in the future the schedule will launch. | [optional]
12
12
**on_scan_repeat** | **str** | Specifies the desired behavior of a repeating scheduled scan when the previous scan was paused due to reaching is maximum duration. The following table describes each supported value: | Value | Description | | ---------- | ---------------- | | restart-scan | Stops the previously-paused scan and launches a new scan if the previous scan did not complete within the specified duration. If the previous scheduled scan was not paused, then a new scan is launched. | | resume-scan | Resumes the previously-paused scan if the previous scan did not complete within the specified duration. If the previous scheduled scan was not paused, then a new scan is launched. | |
13
-
**repeat** | [**ReportRepeat**](ReportRepeat.md) | Settings for repeating a scheduled task. | [optional]
13
+
**repeat** | [**Repeat**](Repeat.md) | Settings for repeating a scheduled scan. | [optional]
14
14
**scan_engine_id** | **int** | The identifier of the scan engine to be used for this scan schedule. If not set, the site's assigned scan engine will be used. | [optional]
15
15
**scan_name** | **str** | A user-defined name for the scan launched by the schedule. If not explicitly set in the schedule, the scan name will be generated prior to the scan launching. Scan names must be unique within the site's scan schedules. | [optional]
16
16
**scan_template_id** | **str** | The identifier of the scan template to be used for this scan schedule. If not set, the site's assigned scan template will be used. | [optional]
0 commit comments