originFailureRecoveryPolicy


Configures how to detect an origin failure, in which case the origin‚ÄčFailure‚ÄčRecovery‚ÄčMethod behavior applies. You can also define up to three sets of criteria to detect origin failure based on specific response codes. Use it to apply specific retry or recovery actions. You can do this using Property Manager. Learn more about this process in Adaptive Media Delivery Implementation Guide. You can use the origin‚ÄčFailure‚ÄčRecovery‚ÄčMethod member to edit existing instances of the Origin Failure Recover Method behavior.

OptionTypeDescriptionRequires
enabledboolean

Activates and configures a recovery policy.

{"displayType":"boolean","tag":"input","type":"checkbox"}
enable‚ÄčIPAvoidanceboolean

Temporarily blocks an origin IP address that experienced a certain number of failures. When an IP address is blocked, the config‚ÄčName established for origin‚ÄčResponsiveness‚ÄčRecovery‚ÄčConfig‚ÄčName is applied.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
ip‚ÄčAvoidance‚ÄčError‚ÄčThresholdnumber

Defines the number of failures that need to occur to an origin address before it's blocked.

enable‚ÄčIPAvoidance is true
{"displayType":"number","tag":"input","type":"number"}
{"if":{"attribute":"enableIPAvoidance","op":"eq","value":true}}
ip‚ÄčAvoidance‚ÄčRetry‚ÄčIntervalnumber

Defines the number of seconds after which the IP address is removed from the blocklist.

enable‚ÄčIPAvoidance is true
{"displayType":"number","tag":"input","type":"number"}
{"if":{"attribute":"enableIPAvoidance","op":"eq","value":true}}
binary‚ÄčEquivalent‚ÄčContentboolean

Synchronizes content between the primary and backup origins, byte for byte.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
monitor‚ÄčOrigin‚ÄčResponsivenessboolean

Enables continuous monitoring of connectivity to the origin. If necessary, applies retry or recovery actions.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
origin‚ÄčResponsiveness‚ÄčTimeoutenum

The timeout threshold that triggers a retry or recovery action.

monitor‚ÄčOrigin‚ÄčResponsiveness is true
{"displayType":"enum","options":["AGGRESSIVE","MODERATE","CONSERVATIVE","USER_SPECIFIED"],"tag":"select"}
{"if":{"attribute":"monitorOriginResponsiveness","op":"eq","value":true}}
AGGRESSIVE

A 2 second threshold.

MODERATE

3 seconds.

CONSERVATIVE

4 seconds.

USER_‚ÄčSPECIFIED

Specify your own timeout.

origin‚ÄčResponsiveness‚ÄčCustom‚ÄčTimeoutnumber

Specify a custom timeout, from 1 to 10 seconds.

origin‚ÄčResponsiveness‚ÄčTimeout is USER_‚ÄčSPECIFIED
{"displayType":"number","tag":"input","type":"number"}
{"if":{"attribute":"originResponsivenessTimeout","op":"eq","value":"USER_SPECIFIED"}}
origin‚ÄčResponsiveness‚ÄčEnable‚ÄčRetryboolean

If a specific failure condition applies, attempts a retry on the same origin before executing the recovery method.

monitor‚ÄčOrigin‚ÄčResponsiveness is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorOriginResponsiveness","op":"eq","value":true}}
origin‚ÄčResponsiveness‚ÄčEnable‚ÄčRecoveryboolean

Enables a recovery action for a specific failure condition.

monitor‚ÄčOrigin‚ÄčResponsiveness is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorOriginResponsiveness","op":"eq","value":true}}
origin‚ÄčResponsiveness‚ÄčRecovery‚ÄčConfig‚ÄčNamestring

Specifies a recovery configuration using the config‚ÄčName you defined in the recovery‚ÄčConfig match criteria. Specify 3 to 20 alphanumeric characters or dashes. Ensure that you use the recovery‚ÄčConfig match criteria to apply this option.

origin‚ÄčResponsiveness‚ÄčEnable‚ÄčRecovery is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originResponsivenessEnableRecovery","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes1boolean

Enables continuous monitoring for the specific origin status codes that trigger retry or recovery actions.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
monitor‚ÄčResponse‚ÄčCodes1string array

Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry (501) or a range (501:504). If you configure other monitor‚ÄčStatus‚ÄčCodes* and monitor‚ÄčResponse‚ÄčCodes* options, you can't use the same codes here.

monitor‚ÄčStatus‚ÄčCodes1 is true
{"displayType":"string array","tag":"input","todo":true}
{"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes1Enable‚ÄčRetryboolean

When the defined response codes apply, attempts a retry on the same origin before executing the recovery method.

monitor‚ÄčStatus‚ÄčCodes1 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes1Enable‚ÄčRecoveryboolean

Enables the recovery action for the response codes you define.

monitor‚ÄčStatus‚ÄčCodes1 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes1Recovery‚ÄčConfig‚ÄčNamestring

Specifies a recovery configuration using the config‚ÄčName you defined in the recovery‚ÄčConfig match criteria. Specify 3 to 20 alphanumeric characters or dashes. Ensure that you use the recovery‚ÄčConfig match criteria to apply this option.

monitor‚ÄčStatus‚ÄčCodes1Enable‚ÄčRecovery is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"monitorStatusCodes1EnableRecovery","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes2boolean

Enables continuous monitoring for the specific origin status codes that trigger retry or recovery actions.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
monitor‚ÄčResponse‚ÄčCodes2string array

Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry (501) or a range (501:504). If you configure other monitor‚ÄčStatus‚ÄčCodes* and monitor‚ÄčResponse‚ÄčCodes* options, you can't use the same codes here.

monitor‚ÄčStatus‚ÄčCodes2 is true
{"displayType":"string array","tag":"input","todo":true}
{"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes2Enable‚ÄčRetryboolean

When the defined response codes apply, attempts a retry on the same origin before executing the recovery method.

monitor‚ÄčStatus‚ÄčCodes2 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes2Enable‚ÄčRecoveryboolean

Enables the recovery action for the response codes you define.

monitor‚ÄčStatus‚ÄčCodes2 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes2Recovery‚ÄčConfig‚ÄčNamestring

Specifies a recovery configuration using the config‚ÄčName you defined in the recovery‚ÄčConfig match criteria. Specify 3 to 20 alphanumeric characters or dashes. Ensure that you use the recovery‚ÄčConfig match criteria to apply this option.

monitor‚ÄčStatus‚ÄčCodes2Enable‚ÄčRecovery is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"monitorStatusCodes2EnableRecovery","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes3boolean

Enables continuous monitoring for the specific origin status codes that trigger retry or recovery actions.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
monitor‚ÄčResponse‚ÄčCodes3string array

Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry (501) or a range (501:504). If you configure other monitor‚ÄčStatus‚ÄčCodes* and monitor‚ÄčResponse‚ÄčCodes* options, you can't use the same codes here..

monitor‚ÄčStatus‚ÄčCodes3 is true
{"displayType":"string array","tag":"input","todo":true}
{"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes3Enable‚ÄčRetryboolean

When the defined response codes apply, attempts a retry on the same origin before executing the recovery method.

monitor‚ÄčStatus‚ÄčCodes3 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes3Enable‚ÄčRecoveryboolean

Enables the recovery action for the response codes you define.

monitor‚ÄčStatus‚ÄčCodes3 is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}}
monitor‚ÄčStatus‚ÄčCodes3Recovery‚ÄčConfig‚ÄčNamestring

Specifies a recovery configuration using the config‚ÄčName you defined in the recovery‚ÄčConfig match criteria. Specify 3 to 20 alphanumeric characters or dashes. Ensure that you use the recovery‚ÄčConfig match criteria to apply this option.

monitor‚ÄčStatus‚ÄčCodes3Enable‚ÄčRecovery is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"monitorStatusCodes3EnableRecovery","op":"eq","value":true}}