mediaOriginFailover


Specifies how edge servers respond when the origin is unresponsive, or suffers from server or content errors. You can specify how many times to retry, switch to a backup origin hostname, or configure a redirect.

OptionTypeDescriptionRequires
detect‚ÄčOrigin‚ÄčUnresponsiveboolean

Allows you to configure what happens when the origin is unresponsive.

{"displayType":"boolean","tag":"input","type":"checkbox"}
origin‚ÄčUnresponsive‚ÄčDetection‚ÄčLevelenum

Specify the level of response to slow origin connections.

detect‚ÄčOrigin‚ÄčUnresponsive is true
{"displayType":"enum","options":["AGGRESSIVE","CONSERVATIVE","MODERATE"],"tag":"select"}
{"if":{"attribute":"detectOriginUnresponsive","op":"eq","value":true}}
AGGRESSIVE

Aggressive response.

CONSERVATIVE

Conservative response.

MODERATE

Moderate response.

origin‚ÄčUnresponsive‚ÄčBlacklist‚ÄčOrigin‚ÄčIpboolean

Enabling this blacklists the origin's IP address.

detect‚ÄčOrigin‚ÄčUnresponsive is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"detectOriginUnresponsive","op":"eq","value":true}}
origin‚ÄčUnresponsive‚ÄčBlacklist‚ÄčWindowenum

This sets the delay before blacklisting an IP address.

origin‚ÄčUnresponsive‚ÄčBlacklist‚ÄčOrigin‚ÄčIp is true
{"displayType":"enum","options":["TEN_S","THIRTY_S"],"tag":"select"}
{"if":{"attribute":"originUnresponsiveBlacklistOriginIp","op":"eq","value":true}}
TEN_‚ÄčS

10 seconds.

THIRTY_‚ÄčS

30 seconds.

origin‚ÄčUnresponsive‚ÄčRecoveryenum

This sets the recovery option.

detect‚ÄčOrigin‚ÄčUnresponsive is true
{"displayType":"enum","options":["RETRY_X_TIMES","SWITCH_TO_BACKUP_ORIGIN","REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"],"tag":"select"}
{"if":{"attribute":"detectOriginUnresponsive","op":"eq","value":true}}
RETRY_‚ÄčX_TIMES

Retry.

SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN

Switch to a backup origin.

REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION

Redirect to a different origin.

origin‚ÄčUnresponsive‚ÄčRetry‚ÄčLimitenum

Sets how many times to retry.

origin‚ÄčUnresponsive‚ÄčRecovery is RETRY_‚ÄčX_TIMES
{"displayType":"enum","options":["ONE","TWO","THREE"],"tag":"select"}
{"if":{"attribute":"originUnresponsiveRecovery","op":"eq","value":"RETRY_X_TIMES"}}
Supported values:
ONE
THREE
TWO
origin‚ÄčUnresponsive‚ÄčBackup‚ÄčHoststring

This specifies the origin hostname.

origin‚ÄčUnresponsive‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnresponsiveRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"}}
origin‚ÄčUnresponsive‚ÄčAlternate‚ÄčHoststring

This specifies the redirect's destination hostname.

origin‚ÄčUnresponsive‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnresponsiveRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
origin‚ÄčUnresponsive‚ÄčModify‚ÄčRequest‚ÄčPathboolean

Modifies the request path.

origin‚ÄčUnresponsive‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†origin‚ÄčUnresponsive‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"originUnresponsiveRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"originUnresponsiveRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
origin‚ÄčUnresponsive‚ÄčModified‚ÄčPathstring

This specifies the path to form the new URL.

origin‚ÄčUnresponsive‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnresponsiveModifyRequestPath","op":"eq","value":true}}
origin‚ÄčUnresponsive‚ÄčInclude‚ÄčQuery‚ÄčStringboolean

Enabling this includes the original set of query parameters.

origin‚ÄčUnresponsive‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"originUnresponsiveModifyRequestPath","op":"eq","value":true}}
origin‚ÄčUnresponsive‚ÄčRedirect‚ÄčMethodenum

Specifies the redirect response code.

origin‚ÄčUnresponsive‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"enum","options":["301","302"],"tag":"select"}
{"if":{"attribute":"originUnresponsiveRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
Supported values:
301
302
origin‚ÄčUnresponsive‚ÄčChange‚ÄčProtocolboolean

This allows you to change the request protocol.

origin‚ÄčUnresponsive‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†origin‚ÄčUnresponsive‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"originUnresponsiveRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"originUnresponsiveRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
origin‚ÄčUnresponsive‚ÄčProtocolenum

Specifies which protocol to use.

origin‚ÄčUnresponsive‚ÄčChange‚ÄčProtocol is true
{"displayType":"enum","options":["HTTP","HTTPS"],"tag":"select"}
{"if":{"attribute":"originUnresponsiveChangeProtocol","op":"eq","value":true}}
Supported values:
HTTP
HTTPS
detect‚ÄčOrigin‚ÄčUnavailableboolean

Allows you to configure failover settings when the origin server responds with errors.

{"displayType":"boolean","tag":"input","type":"checkbox"}
origin‚ÄčUnavailable‚ÄčDetection‚ÄčLevelenum

Specify RESPONSE_‚ÄčCODES, the only available option.

detect‚ÄčOrigin‚ÄčUnavailable is true
{"displayType":"enum","options":["RESPONSE_CODES"],"tag":"select"}
{"if":{"attribute":"detectOriginUnavailable","op":"eq","value":true}}
RESPONSE_‚ÄčCODES

This is the only value currently available.

origin‚ÄčUnavailable‚ÄčResponse‚ÄčCodesstring array

Specifies the set of response codes identifying when the origin responds with errors.

detect‚ÄčOrigin‚ÄčUnavailable is true
{"displayType":"string array","tag":"input","todo":true}
{"if":{"attribute":"detectOriginUnavailable","op":"eq","value":true}}
origin‚ÄčUnavailable‚ÄčBlacklist‚ÄčOrigin‚ÄčIpboolean

Enabling this blacklists the origin's IP address.

detect‚ÄčOrigin‚ÄčUnavailable is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"detectOriginUnavailable","op":"eq","value":true}}
origin‚ÄčUnavailable‚ÄčBlacklist‚ÄčWindowenum

This sets the delay before blacklisting an IP address.

origin‚ÄčUnavailable‚ÄčBlacklist‚ÄčOrigin‚ÄčIp is true
{"displayType":"enum","options":["TEN_S","THIRTY_S"],"tag":"select"}
{"if":{"attribute":"originUnavailableBlacklistOriginIp","op":"eq","value":true}}
TEN_‚ÄčS

10 seconds.

THIRTY_‚ÄčS

30 seconds.

origin‚ÄčUnavailable‚ÄčRecoveryenum

This sets the recovery option.

detect‚ÄčOrigin‚ÄčUnavailable is true
{"displayType":"enum","options":["RETRY_X_TIMES","SWITCH_TO_BACKUP_ORIGIN","REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"],"tag":"select"}
{"if":{"attribute":"detectOriginUnavailable","op":"eq","value":true}}
RETRY_‚ÄčX_TIMES

Retry.

SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN

Switch to a backup origin.

REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION

Redirect to a different origin.

origin‚ÄčUnavailable‚ÄčRetry‚ÄčLimitenum

Sets how many times to retry.

origin‚ÄčUnavailable‚ÄčRecovery is RETRY_‚ÄčX_TIMES
{"displayType":"enum","options":["ONE","TWO","THREE"],"tag":"select"}
{"if":{"attribute":"originUnavailableRecovery","op":"eq","value":"RETRY_X_TIMES"}}
Supported values:
ONE
THREE
TWO
origin‚ÄčUnavailable‚ÄčBackup‚ÄčHoststring

This specifies the origin hostname.

origin‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"}}
origin‚ÄčUnavailable‚ÄčAlternate‚ÄčHoststring

This specifies the redirect's destination hostname.

origin‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
origin‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPathboolean

Modifies the request path.

origin‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†origin‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"originUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"originUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
origin‚ÄčUnavailable‚ÄčModified‚ÄčPathstring

This specifies the path to form the new URL.

origin‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"originUnavailableModifyRequestPath","op":"eq","value":true}}
origin‚ÄčUnavailable‚ÄčInclude‚ÄčQuery‚ÄčStringboolean

Enabling this includes the original set of query parameters.

origin‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"originUnavailableModifyRequestPath","op":"eq","value":true}}
origin‚ÄčUnavailable‚ÄčRedirect‚ÄčMethodenum

Specifies either a redirect response code.

origin‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"enum","options":["301","302"],"tag":"select"}
{"if":{"attribute":"originUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
Supported values:
301
302
origin‚ÄčUnavailable‚ÄčChange‚ÄčProtocolboolean

Modifies the request protocol.

origin‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†origin‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"originUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"originUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
origin‚ÄčUnavailable‚ÄčProtocolenum

Specifies either the HTTP or HTTPS protocol.

origin‚ÄčUnavailable‚ÄčChange‚ÄčProtocol is true
{"displayType":"enum","options":["HTTP","HTTPS"],"tag":"select"}
{"if":{"attribute":"originUnavailableChangeProtocol","op":"eq","value":true}}
Supported values:
HTTP
HTTPS
detect‚ÄčObject‚ÄčUnavailableboolean

Allows you to configure failover settings when the origin has content errors.

{"displayType":"boolean","tag":"input","type":"checkbox"}
object‚ÄčUnavailable‚ÄčDetection‚ÄčLevelenum

Specify RESPONSE_‚ÄčCODES, the only available option.

detect‚ÄčObject‚ÄčUnavailable is true
{"displayType":"enum","options":["RESPONSE_CODES"],"tag":"select"}
{"if":{"attribute":"detectObjectUnavailable","op":"eq","value":true}}
RESPONSE_‚ÄčCODES

This is the only value currently available.

object‚ÄčUnavailable‚ÄčResponse‚ÄčCodesstring array

Specifies the set of response codes identifying when there are content errors.

detect‚ÄčObject‚ÄčUnavailable is true
{"displayType":"string array","tag":"input","todo":true}
{"if":{"attribute":"detectObjectUnavailable","op":"eq","value":true}}
object‚ÄčUnavailable‚ÄčBlacklist‚ÄčOrigin‚ÄčIpboolean

Enabling this blacklists the origin's IP address.

detect‚ÄčObject‚ÄčUnavailable is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"detectObjectUnavailable","op":"eq","value":true}}
object‚ÄčUnavailable‚ÄčBlacklist‚ÄčWindowenum

This sets the delay before blacklisting an IP address.

object‚ÄčUnavailable‚ÄčBlacklist‚ÄčOrigin‚ÄčIp is true
{"displayType":"enum","options":["TEN_S","THIRTY_S"],"tag":"select"}
{"if":{"attribute":"objectUnavailableBlacklistOriginIp","op":"eq","value":true}}
TEN_‚ÄčS

10 seconds.

THIRTY_‚ÄčS

30 seconds.

object‚ÄčUnavailable‚ÄčRecoveryenum

This sets the recovery option.

detect‚ÄčObject‚ÄčUnavailable is true
{"displayType":"enum","options":["RETRY_X_TIMES","SWITCH_TO_BACKUP_ORIGIN","REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"],"tag":"select"}
{"if":{"attribute":"detectObjectUnavailable","op":"eq","value":true}}
RETRY_‚ÄčX_TIMES

Retry.

SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN

Switch to a backup origin.

REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION

Redirect to a different origin.

object‚ÄčUnavailable‚ÄčRetry‚ÄčLimitenum

Sets how many times to retry.

object‚ÄčUnavailable‚ÄčRecovery is RETRY_‚ÄčX_TIMES
{"displayType":"enum","options":["ONE","TWO","THREE"],"tag":"select"}
{"if":{"attribute":"objectUnavailableRecovery","op":"eq","value":"RETRY_X_TIMES"}}
Supported values:
ONE
THREE
TWO
object‚ÄčUnavailable‚ÄčBackup‚ÄčHoststring

This specifies the origin hostname.

object‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"objectUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"}}
object‚ÄčUnavailable‚ÄčAlternate‚ÄčHoststring

This specifies the redirect's destination hostname.

object‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"objectUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
object‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPathboolean

Enabling this allows you to modify the request path.

object‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†object‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"objectUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"objectUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
object‚ÄčUnavailable‚ÄčModified‚ÄčPathstring

This specifies the path to form the new URL.

object‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"objectUnavailableModifyRequestPath","op":"eq","value":true}}
object‚ÄčUnavailable‚ÄčInclude‚ÄčQuery‚ÄčStringboolean

Enabling this includes the original set of query parameters.

object‚ÄčUnavailable‚ÄčModify‚ÄčRequest‚ÄčPath is true
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"objectUnavailableModifyRequestPath","op":"eq","value":true}}
object‚ÄčUnavailable‚ÄčRedirect‚ÄčMethodenum

Specifies a redirect response code.

object‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"enum","options":["301","302"],"tag":"select"}
{"if":{"attribute":"objectUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}}
Supported values:
301
302
object‚ÄčUnavailable‚ÄčChange‚ÄčProtocolboolean

Changes the request protocol.

object‚ÄčUnavailable‚ÄčRecovery is SWITCH_‚ÄčTO_‚ÄčBACKUP_‚ÄčORIGIN
OR¬†object‚ÄčUnavailable‚ÄčRecovery is REDIRECT_‚ÄčTO_‚ÄčDIFFERENT_‚ÄčORIGIN_‚ÄčLOCATION
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"op":"or","params":[{"attribute":"objectUnavailableRecovery","op":"eq","value":"SWITCH_TO_BACKUP_ORIGIN"},{"attribute":"objectUnavailableRecovery","op":"eq","value":"REDIRECT_TO_DIFFERENT_ORIGIN_LOCATION"}]}}
object‚ÄčUnavailable‚ÄčProtocolenum

Specifies either the HTTP or HTTPS protocol.

object‚ÄčUnavailable‚ÄčChange‚ÄčProtocol is true
{"displayType":"enum","options":["HTTP","HTTPS"],"tag":"select"}
{"if":{"attribute":"objectUnavailableChangeProtocol","op":"eq","value":true}}
Supported values:
HTTP
HTTPS
client‚ÄčResponse‚ÄčCodestring

Specifies the response code served to the client.

{"displayType":"string","tag":"input","type":"text"}
cache‚ÄčError‚ÄčResponseboolean

When enabled, caches the error response.

{"displayType":"boolean","tag":"input","type":"checkbox"}
cache‚ÄčWindowenum

This sets error response's TTL.

cache‚ÄčError‚ÄčResponse is true
{"displayType":"enum","options":["ONE_S","TEN_S","THIRTY_S"],"tag":"select"}
{"if":{"attribute":"cacheErrorResponse","op":"eq","value":true}}
ONE_‚ÄčS

1 second.

TEN_‚ÄčS

10 seconds.

THIRTY_‚ÄčS

30 seconds.