com.microsoft.azure.storage.blob

Class RequestRetryOptions

java.lang.Object

com.microsoft.azure.storage.blob.RequestRetryOptions

public final class RequestRetryOptions
extends Object

Options for configuring the RequestRetryFactory. Please refer to the Factory for more information. Note that there is no option for overall operation timeout. This is because Rx object have a timeout field which provides this functionality.

Constructor Summary

Constructors

Constructor and Description
RequestRetryOptions() Constructor with default retry values: Exponential backoff, maxTries=4, tryTimeout=30, retryDelayInMs=4000, maxRetryDelayInMs=120000, secondaryHost=null.
RequestRetryOptions(RetryPolicyType retryPolicyType, Integer maxTries, Integer tryTimeout, Long retryDelayInMs, Long maxRetryDelayInMs, String secondaryHost) Configures how the HttpPipeline should retry requests.

Method Summary

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestRetryOptions

public RequestRetryOptions()

Constructor with default retry values: Exponential backoff, maxTries=4, tryTimeout=30, retryDelayInMs=4000, maxRetryDelayInMs=120000, secondaryHost=null.

RequestRetryOptions

public RequestRetryOptions(RetryPolicyType retryPolicyType,
                           Integer maxTries,
                           Integer tryTimeout,
                           Long retryDelayInMs,
                           Long maxRetryDelayInMs,
                           String secondaryHost)

Configures how the HttpPipeline should retry requests.

Parameters:

retryPolicyType - A RetryPolicyType specifying the type of retry pattern to use. A value of null accepts the default.

maxTries - Specifies the maximum number of attempts an operation will be tried before producing an error. A value of null means that you accept our default policy. A value of 1 means 1 try and no retries.

tryTimeout - Indicates the maximum time allowed for any single try of an HTTP request. A value of null means that you accept our default. NOTE: When transferring large amounts of data, the default TryTimeout will probably not be sufficient. You should override this value based on the bandwidth available to the host machine and proximity to the Storage service. A good starting point may be something like (60 seconds per MB of anticipated-payload-size).

retryDelayInMs - Specifies the amount of delay to use before retrying an operation. A value of null means you accept the default value. The delay increases (exponentially or linearly) with each retry up to a maximum specified by MaxRetryDelay. If you specify null, then you must also specify null for MaxRetryDelay.

maxRetryDelayInMs - Specifies the maximum delay allowed before retrying an operation. A value of null means you accept the default value. If you specify null, then you must also specify null for RetryDelay.

secondaryHost - If a secondaryHost is specified, retries will be tried against this host. If secondaryHost is null (the default) then operations are not retried against another host. NOTE: Before setting this field, make sure you understand the issues around reading stale and potentially-inconsistent data at this webpage