mirror of
https://github.com/ghndrx/prowler.git
synced 2026-02-10 14:55:00 +00:00
docs: Boto3 configuration (#1885)
Co-authored-by: Toni de la Fuente <toni@blyx.com>
This commit is contained in:
31
docs/tutorials/aws/boto3-configuration.md
Normal file
31
docs/tutorials/aws/boto3-configuration.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
# Boto3 Retrier Configuration
|
||||||
|
|
||||||
|
Prowler's AWS Provider uses the Boto3 [Standard](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/retries.html) retry mode to assist in retrying client calls to AWS services when these kinds of errors or exceptions are experienced. This mode includes the following behaviours:
|
||||||
|
- A default value of 3 for maximum retry attempts. This can be overwritten with the `--aws-retries-max-attempts 5` argument.
|
||||||
|
- Retry attempts for an expanded list of errors/exceptions:
|
||||||
|
```
|
||||||
|
# Transient errors/exceptions
|
||||||
|
RequestTimeout
|
||||||
|
RequestTimeoutException
|
||||||
|
PriorRequestNotComplete
|
||||||
|
ConnectionError
|
||||||
|
HTTPClientError
|
||||||
|
|
||||||
|
# Service-side throttling/limit errors and exceptions
|
||||||
|
Throttling
|
||||||
|
ThrottlingException
|
||||||
|
ThrottledException
|
||||||
|
RequestThrottledException
|
||||||
|
TooManyRequestsException
|
||||||
|
ProvisionedThroughputExceededException
|
||||||
|
TransactionInProgressException
|
||||||
|
RequestLimitExceeded
|
||||||
|
BandwidthLimitExceeded
|
||||||
|
LimitExceededException
|
||||||
|
RequestThrottled
|
||||||
|
SlowDown
|
||||||
|
EC2ThrottledException
|
||||||
|
```
|
||||||
|
- Retry attempts on nondescriptive, transient error codes. Specifically, these HTTP status codes: 500, 502, 503, 504.
|
||||||
|
|
||||||
|
- Any retry attempt will include an exponential backoff by a base factor of 2 for a maximum backoff time of 20 seconds.
|
||||||
@@ -46,6 +46,7 @@ nav:
|
|||||||
- Checks v2 to v3 Mapping: tutorials/aws/v2_to_v3_checks_mapping.md
|
- Checks v2 to v3 Mapping: tutorials/aws/v2_to_v3_checks_mapping.md
|
||||||
- Tag-based Scan: tutorials/aws/tag-based-scan.md
|
- Tag-based Scan: tutorials/aws/tag-based-scan.md
|
||||||
- Resource ARNs based Scan: tutorials/aws/resource-arn-based-scan.md
|
- Resource ARNs based Scan: tutorials/aws/resource-arn-based-scan.md
|
||||||
|
- Boto3 Configuration: tutorials/aws/boto3-configuration.md
|
||||||
- Azure:
|
- Azure:
|
||||||
- Authentication: tutorials/azure/authentication.md
|
- Authentication: tutorials/azure/authentication.md
|
||||||
- Subscriptions: tutorials/azure/subscriptions.md
|
- Subscriptions: tutorials/azure/subscriptions.md
|
||||||
|
|||||||
Reference in New Issue
Block a user