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

Field

What it does

Sub-options

Enable

Enables or disables the behavior.

Action

Select the action edge servers should take when there is an origin failure.

  • **Serve stale content.** Serves content that is already in the cache.
  • **Redirect to a different location.** Specifies a redirect action.
  • **Use alternate hostname in this property.** Serves alternate content from your network.
  • **Use alternate hostname on provider network.** Serves alternate content from an external network.
  • **Serve alternate content from NetStorage.** Serves [NetStorage](https://learn.akamai.com/en-us/products/media_delivery/netstorage.html) content.
  • **Use dynamic hostname.** Serve dynamic SaaS content if SaaS acceleration is available on your contract.

Destination Hostname

With 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 Hostname

With 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 Path

With 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 Path

With 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 Method

With Action set to Redirect to a different location, select the redirect method.

**

  • 302
  • 301
**

Include Query String

With 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 Protocol

With 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
**

Protocol

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

**

  • HTTP
  • HTTPS
**

Alternate Hostname in This Property

With 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 Network

With 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 Path

With 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 Origin

With Action set to Serve alternate content from NetStorage, specify the NetStorage origin that serves the alternate content.

Reporting CP Code

With Action set to Serve alternate content from NetStorage, select the CP code to use for reporting this Site Failover traffic.

Response Status Code

With 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

Method

With Action set to Use dynamic hostname, specify the redirect method.

  • Redirect with status 301
  • Redirect with status 302
  • Serve as alternate content

Source

With 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 Suffix

With Action set to Use dynamic hostname, specify the static portion of the SaaS dynamic failaction.

Regular Expression

With Action set to Use dynamic hostname, specify the substitution pattern (a Perl-compatible regular expression) that defines the SaaS dynamic failaction.

Replacement

With 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 Level

With 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 Name

With Source set to Cookie, specify the name of the cookie that identifies this SaaS dynamic failaction.

Query Parameter

With Source set to Query String, specify the name of the query parameter that identifies this SaaS dynamic failaction.


Did this page help you?