Retry policy
Automatically retry failed requests when a step encounters an intermittent issue such as a network failure or request rate limit. Set a retry policy to prevent having to manually trigger the step again.
Features
Retry policies can be:
- Created to support connection timeouts or failed requests based on header, status, response body, error, and HTTP method.
- Applied to all actions that use a given connection alias.
- Applied directly to an action step.
Use retry policies to define:
- The conditions that must be met to retry a step.
- The time interval to wait before retrying a step.
- The maximum number of retry attempts the step makes before stopping.
Associate a default retry policy to a Connection & Credentials alias and apply the retry policy to all HTTP connections.
Note: You can only create retry policies for JDBC, REST, and SOAP steps.
Parent Topic:Create an action in Workflow Studio
Create a retry policy
Automatically retry failed requests when a step encounters an intermittent issue such as a network failure or request rate limit. Set a retry policy to prevent having to manually trigger the step again.
Before you begin
- Role required: connection_admin or credential_admin
Procedure
Navigate to All > IntegrationHub > Retry Policy > Create New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name to uniquely identify the retry policy. |
| Connection Type | HTTP |
| Condition | Conditions that must be met to trigger the retry policy. Conditions that trigger a retry policy include the is, is not, contains, and contains not operators. |
| Retry Strategy |
Note: Honor "Retry-After" Header supports only REST and SOAP steps. |
| Interval \(seconds\) | Time interval in seconds after which a retry attempt should be made. This field applies only to Exponential Backoff and Fixed Interval retry strategies.Note: If Retry Strategy is Exponential Backoff, the time interval exponentially increases after every retry attempt till the maximum numbers of attempts is reached. |
| Count | Maximum number of retry attempts. This field applies only to Exponential Backoff and Fixed Interval retry strategies. If no value is specified, the maximum number of retry attempts is based on the value provided in the glide.fdih.retry.max_count system property. Default value of the glide.fdih.retry.max_count system property is 0. For more information about system properties, see Available system properties. |
| Max Elapsed Time \(seconds\) | Maximum cumulative time in seconds after which the retry attempts are stopped. This field appears only when Honor "Retry-After" Header is selected from Retry Strategy.Note: If the maximum retry time is specified in the glide.fdih.retry.max_time_in_seconds property, the system property value takes precedence over this field value. Also, make sure that the max elapsed time is equal to or greater than the system property value. |
Create a global system property with the following attributes.
For more information on how to create a property, see Add a system property. You can use this system property to specify the maximum time in seconds for a retry policy.
Field Value Name glide.fdih.retry.max_time_in_secondsType integerValue Default value: 86400(seconds) Maximum supported time:604800(seconds)Click Submit.
Retry policy with Retry Strategy as Exponential Backoff
Sample retry policy when Retry Strategy is Exponential Backoff
In this example, the policy is defined to attempt retry when one of these conditions is met:
- HTTP Method is GET and Error is Connection Timeout
- HTTP Method is GET and Status Code is 429
When the condition is met, retry attempts are made for a maximum number of three times. The time interval between the retry attempts is exponentially increased. The time intervals in this example are 10 seconds, 20 seconds, and 40 seconds.
What to do next
- Create a Connection & Credential alias, if you do not have the required alias.
Assign the retry policy as Default Retry Policy to the required Connection & Credential alias.
Note: A default retry policy is provided and is selected as Default Retry Policy. If you have created retry policies, you can select the required policy as Default Retry Policy.
Create an HTTP(s) Connection in the Connections related list for the Connection & Credential alias. For more information, see Connections and Credentials.
- Verify and view the details of the retry attempts by navigating to System Logs > Outbound HTTP Requests.