ad_​scaler_​circuit_​breaker

Version: v2025-02-18Includes use: No

Behavior name: Ad Scaler Circuit Breaker

This behavior works with manifest​_rerouting to provide the scale and reliability of Akamai network while simultaneously allowing third party partners to modify the requested media content with value-added features. The ad​Scaler​Circuit​Breaker behavior specifies the fallback action in case the technology partner encounters errors and can't modify the requested media object.

Default behavior

These samples reflect the behavior's default settings. You can use these as is in your configurations or make adjustments based on the behavior's available options.

data "akamai_property_rules_builder" "ad_scaler_circuit_breaker" {
  rules_v2025_02_18 {
    name     = "Ad Scaler Circuit Breaker"
    comments = "Control the settings related to the fallback action when a partner gets errors and can't modify the requested media object."
    behavior {
      ad_scaler_circuit_breaker {
        response_delay_based   = false
        response_code_based    = false
      }
    }
  }
}
"behaviors": [
  {
    "name": "adScalerCircuitBreaker",
    "options": {
      "responseDelayBased": false,
      "responseCodeBased": false
    }
  }
]

Options

Option Description
response_​delay_​based
Triggers a fallback action based on the delayed response from the technology partner's server.
response_​delay_​threshold
Specifies the maximum response delay that, if exceeded, triggers the fallback action. Value: 500ms
response_​code_​based

Triggers a fallback action based on the response code from the technology partner's server.

response_​codes
Specifies the codes in the partner's response that trigger the fallback action. Value is one of:
  • SAME_​AS_​RECEIVED. Return the same error received from the partner platform.
  • 408. Return a 408 error.
  • 500. Return a 500 error.
  • 502. Return a 502 error.
  • 504. Return a 504 error.
  • SPECIFY_​YOUR_​OWN. Customize the error.
fallback_​action_​response_​code_​based
Specifies the fallback action. Value is one of:
  • RETURN_​AKAMAI_​COPY. Return an unmodified Akamai copy of the manifest file to the requesting client.
  • RETURN_​ERROR. Return an error as the server response.
return_​error_​response_​code_​based
Specifies the error to include in the response to the client. Value is one of:
  • SAME_​AS_​RECEIVED. Return the same error received from the partner platform.
  • 408. Return a 408 error.
  • 500. Return a 500 error.
  • 502. Return a 502 error.
  • 504. Return a 504 error.
  • SPECIFY_​YOUR_​OWN. Customize the error.
specify_​your_​own_​response_​code_​based
Defines a custom error response.