- Property Manager name: Origin Failure Recovery Policy
- Behavior version: The
v2024-10-21
rule format supports theoriginFailureRecoveryPolicy
behavior v1.0. - Rule format status: GA, stable
- Access: Read/Write
- Allowed in includes: Yes
Configures how to detect an origin failure, in which case the originFailureRecoveryMethod
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 originFailureRecoveryMethod
member to edit existing instances of the Origin Failure Recover Method behavior.
Option | Type | Description | Requires | |
---|---|---|---|---|
enabled | boolean | Activates and configures a recovery policy. | {"displayType":"boolean","tag":"input","type":"checkbox"} | |
enableIPAvoidance | boolean | Temporarily blocks an origin IP address that experienced a certain number of failures. When an IP address is blocked, the | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
ipAvoidanceErrorThreshold | number | Defines the number of failures that need to occur to an origin address before it's blocked. | enableIPAvoidance is true | {"displayType":"number","tag":"input","type":"number"} {"if":{"attribute":"enableIPAvoidance","op":"eq","value":true}} |
ipAvoidanceRetryInterval | number | Defines the number of seconds after which the IP address is removed from the blocklist. | enableIPAvoidance is true | {"displayType":"number","tag":"input","type":"number"} {"if":{"attribute":"enableIPAvoidance","op":"eq","value":true}} |
binaryEquivalentContent | boolean | Synchronizes content between the primary and backup origins, byte for byte. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
monitorOriginResponsiveness | boolean | 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}} | |
originResponsivenessTimeout | enum | The timeout threshold that triggers a retry or recovery action. | monitorOriginResponsiveness 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. | |||
originResponsivenessCustomTimeout | number | Specify a custom timeout, from 1 to 10 seconds. | originResponsivenessTimeout is USER_SPECIFIED | {"displayType":"number","tag":"input","type":"number"} {"if":{"attribute":"originResponsivenessTimeout","op":"eq","value":"USER_SPECIFIED"}} |
originResponsivenessEnableRetry | boolean | If a specific failure condition applies, attempts a retry on the same origin before executing the recovery method. | monitorOriginResponsiveness is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorOriginResponsiveness","op":"eq","value":true}} |
originResponsivenessEnableRecovery | boolean | Enables a recovery action for a specific failure condition. | monitorOriginResponsiveness is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorOriginResponsiveness","op":"eq","value":true}} |
originResponsivenessRecoveryConfigName | string | Specifies a recovery configuration using the | originResponsivenessEnableRecovery is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"originResponsivenessEnableRecovery","op":"eq","value":true}} |
monitorStatusCodes1 | boolean | 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}} | |
monitorResponseCodes1 | string array | Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry ( | monitorStatusCodes1 is true | {"displayType":"string array","tag":"input","todo":true} {"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}} |
monitorStatusCodes1EnableRetry | boolean | When the defined response codes apply, attempts a retry on the same origin before executing the recovery method. | monitorStatusCodes1 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}} |
monitorStatusCodes1EnableRecovery | boolean | Enables the recovery action for the response codes you define. | monitorStatusCodes1 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes1","op":"eq","value":true}} |
monitorStatusCodes1RecoveryConfigName | string | Specifies a recovery configuration using the | monitorStatusCodes1EnableRecovery is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"monitorStatusCodes1EnableRecovery","op":"eq","value":true}} |
monitorStatusCodes2 | boolean | 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}} | |
monitorResponseCodes2 | string array | Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry ( | monitorStatusCodes2 is true | {"displayType":"string array","tag":"input","todo":true} {"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}} |
monitorStatusCodes2EnableRetry | boolean | When the defined response codes apply, attempts a retry on the same origin before executing the recovery method. | monitorStatusCodes2 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}} |
monitorStatusCodes2EnableRecovery | boolean | Enables the recovery action for the response codes you define. | monitorStatusCodes2 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes2","op":"eq","value":true}} |
monitorStatusCodes2RecoveryConfigName | string | Specifies a recovery configuration using the | monitorStatusCodes2EnableRecovery is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"monitorStatusCodes2EnableRecovery","op":"eq","value":true}} |
monitorStatusCodes3 | boolean | 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}} | |
monitorResponseCodes3 | string array | Defines the origin response codes that trigger a subsequent retry or recovery action. Specify a single code entry ( | monitorStatusCodes3 is true | {"displayType":"string array","tag":"input","todo":true} {"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}} |
monitorStatusCodes3EnableRetry | boolean | When the defined response codes apply, attempts a retry on the same origin before executing the recovery method. | monitorStatusCodes3 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}} |
monitorStatusCodes3EnableRecovery | boolean | Enables the recovery action for the response codes you define. | monitorStatusCodes3 is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"monitorStatusCodes3","op":"eq","value":true}} |
monitorStatusCodes3RecoveryConfigName | string | Specifies a recovery configuration using the | monitorStatusCodes3EnableRecovery is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"monitorStatusCodes3EnableRecovery","op":"eq","value":true}} |