Task Parameters

<< Click to Display Table of Contents >>

Raynet One Data Hub > 14.0 u1 > Connectors > Alphabetic Connector List > Qualys > Connector Parameters 

Task Parameters

Page Size

This parameter specifies the page size (number of records) during a paginated API request.

 

Technical Name

page_size

Category

Technical

Type

Integer

Default Value

300

Example Values

300

 

Changing the page size should only be necessary if running into connection issues or rate limitation. The larger the page the longer every single request takes. However, the total number of necessary requests decreases. The sweet spot depends on the server capabilities and the connection quality. Most APIs limit the maximum page size.

 

Connection Timeout (in ms)

This parameter specifies the time after which a running request will be aborted. If set to null, the default timeout of the system will be used.

 

Technical Name

timeout

Category

Technical

Type

Integer

null

Default Value

null

Example Values

null, 10000

 

Initial Delay (in ms)

This parameter represents the initial time (in milliseconds) to wait before a failed request will be reattempted.

 

Technical Name

initial_delay

Category

Technical

Type

Integer

Default Value

1000

Example Values

1000

 

When a request fails, Raynet One Data Hub does a so-called exponential backoff. The delay starts with this duration and then exponentially increases with every failed attempt.

 

Maximum Delay (in ms)

This parameter represents the maximum time (in milliseconds) to wait before an HTTP request that has been failed will be reattempted. If set to null, the delay will not be restricted.

 

Technical Name

max_delay

Category

Technical

Type

Integer

null

Default Value

600000

Example Values

600000

 

When a request fails, Raynet One Data Hub does a so-called exponential backoff. The delay starts with this duration and then exponentially increases with every failed attempt. In order to limit the total runtime of the connector, it is possible to set a maximum delay.

 

Maximum Number of Attempts

This parameter represents the maximum number of attempts after which an HTTP request will fail permanently.

 

Technical Name

max_attempts

Category

Technical

Type

Integer

Default Value

20

Example Values

20

 

Failed requests will be resend by the connector before failing the whole connector run. When experiencing a lot of connectivity issues which are not related to server overload or some kind of rate limitation, it is recommended to increase this parameter as well as the Timeout and the Maximum Delay parameter.