Skip to content
This repository was archived by the owner on Sep 10, 2024. It is now read-only.

Commit f8dd9d9

Browse files
authored
Merge pull request #18 from rapid7/release/6.5.50
Update generated library to version: 1.0.0-6.5.50
2 parents a730fc8 + c0ac0e9 commit f8dd9d9

17 files changed

Lines changed: 856 additions & 17 deletions

api-files/console-swagger.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

docs/Repeat.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Repeat
2+
3+
## Properties
4+
Name | Type | Description | Notes
5+
------------ | ------------- | ------------- | -------------
6+
**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)
13+
14+

docs/ScanApi.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -220,7 +220,7 @@ No authorization required
220220
[[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)
221221

222222
# **start_scan**
223-
> CreatedReferenceScanIDLink start_scan(id, scan=scan)
223+
> CreatedReferenceScanIDLink start_scan(id, override_blackout=override_blackout, scan=scan)
224224
225225
Site Scans
226226

@@ -237,11 +237,12 @@ from pprint import pprint
237237
# create an instance of the API class
238238
api_instance = rapid7vmconsole.ScanApi()
239239
id = 56 # int | The identifier of the site.
240+
override_blackout = false # bool | ${override.blackout} (optional) (default to false)
240241
scan = rapid7vmconsole.AdhocScan() # AdhocScan | The details for the scan. (optional)
241242

242243
try:
243244
# Site Scans
244-
api_response = api_instance.start_scan(id, scan=scan)
245+
api_response = api_instance.start_scan(id, override_blackout=override_blackout, scan=scan)
245246
pprint(api_response)
246247
except ApiException as e:
247248
print("Exception when calling ScanApi->start_scan: %s\n" % e)
@@ -252,6 +253,7 @@ except ApiException as e:
252253
Name | Type | Description | Notes
253254
------------- | ------------- | ------------- | -------------
254255
**id** | **int**| The identifier of the site. |
256+
**override_blackout** | **bool**| ${override.blackout} | [optional] [default to false]
255257
**scan** | [**AdhocScan**](AdhocScan.md)| The details for the scan. | [optional]
256258

257259
### Return type

docs/ScanEngineApi.md

Lines changed: 180 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,12 @@ Method | HTTP request | Description
77
[**add_scan_engine_pool_scan_engine**](ScanEngineApi.md#add_scan_engine_pool_scan_engine) | **PUT** /api/3/scan_engine_pools/{id}/engines/{engineId} | Engine Pool Engines
88
[**create_scan_engine**](ScanEngineApi.md#create_scan_engine) | **POST** /api/3/scan_engines | Scan Engines
99
[**create_scan_engine_pool**](ScanEngineApi.md#create_scan_engine_pool) | **POST** /api/3/scan_engine_pools | Engine Pools
10+
[**create_shared_secret**](ScanEngineApi.md#create_shared_secret) | **POST** /api/3/scan_engines/shared_secret | Scan Engine Shared Secret
1011
[**delete_scan_engine**](ScanEngineApi.md#delete_scan_engine) | **DELETE** /api/3/scan_engines/{id} | Scan Engine
12+
[**delete_shared_secret**](ScanEngineApi.md#delete_shared_secret) | **DELETE** /api/3/scan_engines/shared_secret | Scan Engine Shared Secret
1113
[**get_assigned_engine_pools**](ScanEngineApi.md#get_assigned_engine_pools) | **GET** /api/3/scan_engines/{id}/scan_engine_pools | Assigned Engine Pools
14+
[**get_current_shared_secret**](ScanEngineApi.md#get_current_shared_secret) | **GET** /api/3/scan_engines/shared_secret | Scan Engine Shared Secret
15+
[**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
1216
[**get_engine_pool**](ScanEngineApi.md#get_engine_pool) | **GET** /api/3/scan_engine_pools/{id} | Engine Pool
1317
[**get_scan_engine**](ScanEngineApi.md#get_scan_engine) | **GET** /api/3/scan_engines/{id} | Scan Engine
1418
[**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
170174

171175
[[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)
172176

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.
183+
184+
### Example
185+
```python
186+
from __future__ import print_function
187+
import time
188+
import rapid7vmconsole
189+
from rapid7vmconsole.rest import ApiException
190+
from pprint import pprint
191+
192+
# create an instance of the API class
193+
api_instance = rapid7vmconsole.ScanEngineApi()
194+
195+
try:
196+
# Scan Engine Shared Secret
197+
api_response = api_instance.create_shared_secret()
198+
pprint(api_response)
199+
except ApiException as e:
200+
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+
173221
# **delete_scan_engine**
174222
> Links delete_scan_engine(id)
175223
@@ -218,6 +266,50 @@ No authorization required
218266

219267
[[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)
220268

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.
275+
276+
### Example
277+
```python
278+
from __future__ import print_function
279+
import time
280+
import rapid7vmconsole
281+
from rapid7vmconsole.rest import ApiException
282+
from pprint import pprint
283+
284+
# create an instance of the API class
285+
api_instance = rapid7vmconsole.ScanEngineApi()
286+
287+
try:
288+
# Scan Engine Shared Secret
289+
api_response = api_instance.delete_shared_secret()
290+
pprint(api_response)
291+
except ApiException as e:
292+
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)
312+
221313
# **get_assigned_engine_pools**
222314
> ResourcesEnginePool get_assigned_engine_pools(id)
223315
@@ -266,6 +358,94 @@ No authorization required
266358

267359
[[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)
268360

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.
367+
368+
### Example
369+
```python
370+
from __future__ import print_function
371+
import time
372+
import rapid7vmconsole
373+
from rapid7vmconsole.rest import ApiException
374+
from pprint import pprint
375+
376+
# create an instance of the API class
377+
api_instance = rapid7vmconsole.ScanEngineApi()
378+
379+
try:
380+
# Scan Engine Shared Secret
381+
api_response = api_instance.get_current_shared_secret()
382+
pprint(api_response)
383+
except ApiException as e:
384+
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.
411+
412+
### Example
413+
```python
414+
from __future__ import print_function
415+
import time
416+
import rapid7vmconsole
417+
from rapid7vmconsole.rest import ApiException
418+
from pprint import pprint
419+
420+
# create an instance of the API class
421+
api_instance = rapid7vmconsole.ScanEngineApi()
422+
423+
try:
424+
# Scan Engine Shared Secret Time to live
425+
api_response = api_instance.get_current_shared_secret_time_to_live()
426+
pprint(api_response)
427+
except ApiException as e:
428+
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)
448+
269449
# **get_engine_pool**
270450
> EnginePool get_engine_pool(id)
271451

docs/ScanSchedule.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
1010
**links** | [**list[Link]**](Link.md) | | [optional]
1111
**next_runtimes** | **list[str]** | List the next 10 dates in the future the schedule will launch. | [optional]
1212
**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]
1414
**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]
1515
**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]
1616
**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]

git_push.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ if [ "$git_repo_id" = "" ]; then
1818
fi
1919

2020
if [ "$release_note" = "" ]; then
21-
release_note="Update generated library to version: 1.0.0-6.5.43"
21+
release_note="Update generated library to version: 1.0.0-6.5.50"
2222
echo "[INFO] No command line input provided. Set \$release_note to $release_note"
2323
fi
2424

rapid7vmconsole/__init__.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -200,6 +200,7 @@
200200
from rapid7vmconsole.models.references_with_vulnerability_natural_id_link import ReferencesWithVulnerabilityNaturalIDLink
201201
from rapid7vmconsole.models.references_with_web_application_id_link import ReferencesWithWebApplicationIDLink
202202
from rapid7vmconsole.models.remediation_resource import RemediationResource
203+
from rapid7vmconsole.models.repeat import Repeat
203204
from rapid7vmconsole.models.report import Report
204205
from rapid7vmconsole.models.report_config_category_filters import ReportConfigCategoryFilters
205206
from rapid7vmconsole.models.report_config_database_credentials_resource import ReportConfigDatabaseCredentialsResource

rapid7vmconsole/api/scan_api.py

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -472,6 +472,7 @@ def start_scan(self, id, **kwargs): # noqa: E501
472472
473473
:param async_req bool
474474
:param int id: The identifier of the site. (required)
475+
:param bool override_blackout: ${override.blackout}
475476
:param AdhocScan scan: The details for the scan.
476477
:return: CreatedReferenceScanIDLink
477478
If the method is called asynchronously,
@@ -495,13 +496,14 @@ def start_scan_with_http_info(self, id, **kwargs): # noqa: E501
495496
496497
:param async_req bool
497498
:param int id: The identifier of the site. (required)
499+
:param bool override_blackout: ${override.blackout}
498500
:param AdhocScan scan: The details for the scan.
499501
:return: CreatedReferenceScanIDLink
500502
If the method is called asynchronously,
501503
returns the request thread.
502504
"""
503505

504-
all_params = ['id', 'scan'] # noqa: E501
506+
all_params = ['id', 'override_blackout', 'scan'] # noqa: E501
505507
all_params.append('async_req')
506508
all_params.append('_return_http_data_only')
507509
all_params.append('_preload_content')
@@ -528,6 +530,8 @@ def start_scan_with_http_info(self, id, **kwargs): # noqa: E501
528530
path_params['id'] = params['id'] # noqa: E501
529531

530532
query_params = []
533+
if 'override_blackout' in params:
534+
query_params.append(('overrideBlackout', params['override_blackout'])) # noqa: E501
531535

532536
header_params = {}
533537

0 commit comments

Comments
 (0)