persistent_​client_​connection

Behavior name: Persistent Connections: Client to Edge

This behavior activates persistent connections between edge servers and clients, which allow for better performance and more efficient use of resources. Compare with the persistent_connection behavior, which configures persistent connections for the entire journey from origin to edge to client. Contact Akamai Professional Services for help configuring either.

This behavior is only supported with the HTTP/1.1 networking protocol that's automatically enabled in all properties. If you include this behavior in the same rule with http2, edge servers honor requests using either of these protocols, but the settings specified in the persistentClientConnection behavior won't apply. Both http2 applies persistent connections automatically.

Warning: Disabling or removing this behavior may negatively affect performance.

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" "persistent_client_connection" {
  rules_v2025_02_18 {
    name     = "Persistent Connections: Client to Edge"
    comments = "Activates persistent connections between edge servers and clients."
    behavior {
      persistent_client_connection {
        enabled = true
        timeout = "500s"
      }
    }
  }
}

"behaviors": [
  {
    "name": "persistentClientConnection",
    "options": {
      "enabled": true,
      "timeout": "500s"
    }
  }
]

Options