dns_​async_​refresh

Version: v2025-02-18Includes use: Yes

Behavior name: DNS Asynchronous Refresh

Allow an edge server to use an expired DNS record when forwarding a request to your origin. The type A DNS record refreshes after content is served to the end user, so there is no wait for the DNS resolution. Avoid this behavior if you want to be able to disable a server immediately after its DNS record expires.

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" "dns_async_refresh" {
  rules_v2025_02_18 {
    name     = "DNS Asynchronous Refresh"
    comments = "Allow an edge server to use an expired DNS record when forwarding a request to your origin."
    behavior {
      dns_async_refresh {
        enabled = true
        timeout = "2h"
      }
    }
  }
}
"behaviors": [
  {
    "name": "dnsAsyncRefresh",
    "options": {
      "enabled": true,
      "timeout": "2h"
    }
  }
]

Options

Option Description
enabled
Allows edge servers to refresh an expired DNS record after serving content.
timeout
Sets the maximum allowed time an expired DNS record may be active.