Site Failover

This behavior specifies how the edge server should respond when the origin isn't available.

How it works

With this behavior enabled, you can specify what action to take when the edge servers can't reach your origin. You can decide to serve stale content, an error page, or redirect. To apply this behavior, match on the Origin Timeout or Response Status Code.

Features and options

FieldWhat it doesSub-options
EnableEnables or disables the behavior.
ActionSelect the action edge servers should take when there is an origin failure.
  • Serve stale content. Serves content that is already in the cache. After serving the stale object, the Time To Live (TTL) timer is reset.
  • Redirect to a different location. Specifies a redirect action.
  • Use alternate hostname in this property. Serves alternate content from another hostname present on same configuration .
  • Use alternate hostname on provider network. Serves alternate content from hostname present on Akamai.
  • Serve alternate content from NetStorage. Serves NetStorage content.
  • Use dynamic hostname. Serve dynamic SaaS content if SaaS acceleration is available on your contract.
Destination HostnameWith Action set to Redirect to a different location, preserve the hostname from the original request or specify a different hostname.
  • Same as request
  • Static hostname
Static HostnameWith Destination Hostname set to Static hostname, specify the static (absolute) hostname for the redirect destination URL.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
Modify Request PathWith Action set to Redirect to a different location, Use dynamic hostname or Use alternate hostname in this property, specify if you want to modify the request path.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
  • No
  • Yes
Modified PathWith Action set to Redirect to a different location, Use alternate hostname in this property, Use alternate hostname on provider network, Use dynamic hostname or Serve alternate content from NetStorage, enter the path to replace the one in the original request.
Redirect MethodWith Action set to Redirect to a different location, select the redirect method.
  • 302
  • 301

Include Query StringWith Action set to Redirect to a different location, Use alternate hostname in this property, Use dynamic hostname or Use alternate hostname on provider network, set whether to preserve the query string.
  • Yes
  • No

Change ProtocolWith Action set to Redirect to a different location or Use dynamic hostname, specify if you want to change the protocol in the redirect URL.
  • Yes
  • No

ProtocolWith Change Protocol set to Yes, specify whether to use HTTP or HTTPS.
  • HTTP
  • HTTPS

Alternate Hostname in This PropertyWith Action set to Use alternate hostname in this property, specify the static (absolute) hostname for the redirect destination URL.

Note: The hostname must match one of the hostnames served by the property.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
Alternate Hostname on Provider NetworkWith Action set to Use alternate hostname on provider network, specify the static (absolute) hostname for the redirect destination URL.

Note: The hostname must match one of the hostnames served by your provider's network.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
Request PathWith Action set to Use alternate hostname on provider network, select the path you want the request to be forwarded to.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
  • Same
  • Other
NetStorage OriginWith Action set to Serve alternate content from NetStorage, specify the NetStorage origin that serves the alternate content.
Reporting CP CodeWith Action set to Serve alternate content from NetStorage, select the CP code to use for reporting this Site Failover traffic.
Response Status CodeWith Action set to Serve alternate content from NetStorage, select an HTTP Response Status Code to replace your existing status code.
  • 200 OK
  • 404 Not Found
  • 500 Internal Server Error
  • 100 Continue
  • 101 Switching Protocols
  • 102 Processing (WebDAV)
  • 103 Checkpoint
  • 122 Request-URI too long
  • 201 Created
  • 202 Accepted
  • 203 Non-Authoritative Information
  • 204 No Content
  • 205 Reset Content
  • 206 Partial Content
  • 207 Multi-Status (WebDAV)
  • 226 IM Used
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 403 Forbidden
  • 405 Method Not Allowed
  • 406 Not Acceptable
  • 407 Proxy Authentication Required
  • 408 Request Timeout
  • 409 Conflict
  • 410 Gone
  • 411 Length Required
  • 412 Precondition Failed
  • 413 Request Entity Too Large
  • 414 Request-URI Too Long
  • 415 Unsupported Media Type
  • 416 Requested Range Not Satisfiable
  • 417 Expectation Failed
  • 422 Unprocessable Entity (WebDAV)
  • 423 Locked (WebDAV)
  • 424 Failed Dependency (WebDAV)
  • 425 Unordered Collection
  • 426 Upgrade Required
  • 428 Precondition Required
  • 429 Too Many Requests
  • 431 Request Header Fields Too Large
  • 444 No Response
  • 449 Retry With
  • 450 Blocked by Windows Parental Controls
  • 499 Client Closed Request
  • 501 Not Implemented
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout
  • 505 HTTP Version Not Supported
  • 506 Variant Also Negotiates
  • 507 Insufficient Storage (WebDAV)
  • 509 Bandwidth Limit Exceeded (Apache bw/limited extension)
  • 510 Not Extended
  • 511 Network Authentication Required
  • 598 (Informal convention) network read timeout error
  • 599 (Informal convention) network connect timeout error
MethodWith Action set to Use dynamic hostname, specify the redirect method.
  • Redirect with status 301
  • Redirect with status 302
  • Serve as alternate content
SourceWith Action set to Use dynamic hostname, identify the component of the request that identifies the SaaS dynamic failaction
  • Hostname
  • Path
  • Query String
  • Cookie
Domain Name SuffixWith Action set to Use dynamic hostname, specify the static portion of the SaaS dynamic failaction.
Regular ExpressionWith Action set to Use dynamic hostname, specify the substitution pattern (a Perl-compatible regular expression) that defines the SaaS dynamic failaction.
ReplacementWith Action set to Use dynamic hostname, specify the replacement pattern that defines the SaaS dynamic failaction.
Use CNAME Chain?With Source set to Hostname, specify whether to use a CNAME chain to determine the hostname for the SaaS dynamic failaction.
  • Yes
  • No

CNAME LevelWith Use CNAME Chain? set to Yes, specify the number of elements in the CNAME chain backwards from the edge hostname that determines the hostname for the SaaS dynamic failaction.
Cookie NameWith Source set to Cookie, specify the name of the cookie that identifies this SaaS dynamic failaction.
Query ParameterWith Source set to Query String, specify the name of the query parameter that identifies this SaaS dynamic failaction.