Package software.amazon.awssdk.retry

Class PredefinedRetryPolicies

java.lang.Object

software.amazon.awssdk.retry.PredefinedRetryPolicies

public class PredefinedRetryPolicies
extends Object

This class includes a set of pre-defined retry policies, including default policies used by SDK.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PredefinedRetryPolicies.SdkDefaultRetryCondition	The default implementation of RetryCondition used by the SDK.

Field Summary

Fields

Modifier and Type	Field	Description
static RetryPolicy	DEFAULT	SDK default retry policy (except for AmazonDynamoDBClient, whose constructor will replace the DEFAULT with DYNAMODB_DEFAULT.)
static RetryPolicy.BackoffStrategy	DEFAULT_BACKOFF_STRATEGY	The SDK default back-off strategy, which increases exponentially up to a max amount of delay.
static V2CompatibleBackoffStrategy	DEFAULT_BACKOFF_STRATEGY_V2	The SDK default back-off strategy, which increases exponentially up to a max amount of delay.
static int	DEFAULT_MAX_ERROR_RETRY	SDK default max retry count
static RetryPolicy.RetryCondition	DEFAULT_RETRY_CONDITION	The SDK default retry condition, which checks for various conditions in the following order: Never retry on requests with non-repeatable content; Retry on client exceptions caused by IOException; Retry on service exceptions that are either 500 internal server errors, 503 service unavailable errors, service throttling errors or clock skew errors.
static RetryPolicy	DYNAMODB_DEFAULT	Default policy for DynamoDB client
static RetryPolicy.BackoffStrategy	DYNAMODB_DEFAULT_BACKOFF_STRATEGY	The default back-off strategy for DynamoDB client, which increases exponentially up to a max amount of delay.
static int	DYNAMODB_DEFAULT_MAX_ERROR_RETRY	Default max retry count for DynamoDB client
static RetryPolicy	NO_RETRY_POLICY	No retry policy

Constructor Summary

Constructors

Constructor	Description
PredefinedRetryPolicies()

Method Summary

Modifier and Type	Method	Description
static RetryPolicy	getDefaultRetryPolicy()	Returns the SDK default retry policy.
static RetryPolicy	getDefaultRetryPolicyWithCustomMaxRetries(int maxErrorRetry)	Returns the SDK default retry policy with the specified max retry count.
static RetryPolicy	getDynamoDbDefaultRetryPolicy()	Returns the default retry policy for DynamoDB client.
static RetryPolicy	getDynamoDbDefaultRetryPolicyWithCustomMaxRetries(int maxErrorRetry)	Returns the default retry policy for DynamoDB client with the specified max retry count.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NO_RETRY_POLICY

public static final RetryPolicy NO_RETRY_POLICY

No retry policy

DEFAULT_MAX_ERROR_RETRY

public static final int DEFAULT_MAX_ERROR_RETRY

SDK default max retry count

See Also:

Constant Field Values

DEFAULT

public static final RetryPolicy DEFAULT

SDK default retry policy (except for AmazonDynamoDBClient, whose constructor will replace the DEFAULT with DYNAMODB_DEFAULT.)

DYNAMODB_DEFAULT_MAX_ERROR_RETRY

public static final int DYNAMODB_DEFAULT_MAX_ERROR_RETRY

Default max retry count for DynamoDB client

See Also:

Constant Field Values

DYNAMODB_DEFAULT

public static final RetryPolicy DYNAMODB_DEFAULT

Default policy for DynamoDB client

DEFAULT_RETRY_CONDITION

public static final RetryPolicy.RetryCondition DEFAULT_RETRY_CONDITION

The SDK default retry condition, which checks for various conditions in the following order:

• Never retry on requests with non-repeatable content;
• Retry on client exceptions caused by IOException;
• Retry on service exceptions that are either 500 internal server errors, 503 service unavailable errors, service throttling errors or clock skew errors.

DEFAULT_BACKOFF_STRATEGY

public static final RetryPolicy.BackoffStrategy DEFAULT_BACKOFF_STRATEGY

The SDK default back-off strategy, which increases exponentially up to a max amount of delay. It also applies a larger scale factor upon service throttling exception.

DEFAULT_BACKOFF_STRATEGY_V2

public static final V2CompatibleBackoffStrategy DEFAULT_BACKOFF_STRATEGY_V2

The SDK default back-off strategy, which increases exponentially up to a max amount of delay. It also applies a larger scale factor upon service throttling exception.

DYNAMODB_DEFAULT_BACKOFF_STRATEGY

public static final RetryPolicy.BackoffStrategy DYNAMODB_DEFAULT_BACKOFF_STRATEGY

The default back-off strategy for DynamoDB client, which increases exponentially up to a max amount of delay. Compared to the SDK default back-off strategy, it applies a smaller scale factor.

Constructor Detail

PredefinedRetryPolicies

public PredefinedRetryPolicies()

Method Detail

getDefaultRetryPolicy

public static RetryPolicy getDefaultRetryPolicy()

Returns the SDK default retry policy. This policy will honor the maxErrorRetry set in ClientConfiguration.

See Also:

LegacyClientConfiguration.setMaxErrorRetry(int)

getDynamoDbDefaultRetryPolicy

public static RetryPolicy getDynamoDbDefaultRetryPolicy()

Returns the default retry policy for DynamoDB client. This policy will honor the maxErrorRetry set in ClientConfiguration.

See Also:

LegacyClientConfiguration.setMaxErrorRetry(int)

getDefaultRetryPolicyWithCustomMaxRetries

public static RetryPolicy getDefaultRetryPolicyWithCustomMaxRetries(int maxErrorRetry)

Returns the SDK default retry policy with the specified max retry count.

getDynamoDbDefaultRetryPolicyWithCustomMaxRetries

public static RetryPolicy getDynamoDbDefaultRetryPolicyWithCustomMaxRetries(int maxErrorRetry)

Returns the default retry policy for DynamoDB client with the specified max retry count.