rewrite_​url

Behavior name: Modify Outgoing Request Path

Modifies the path of incoming requests to forward to the origin. This helps you offload URL-rewriting tasks to the edge to increase the origin server's performance, allows you to redirect links to different targets without changing markup, and hides your original directory structure.

Except for regular expression replacements, this behavior manipulates path expressions that start and end with a / character.

Note: This behavior's rewrite operations can't override any of the base_directory behavior's settings.

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" "rewrite_url" {
  rules_v2025_02_18 {
    name     = "Modify Outgoing Request Path"
    comments = "Modifies the path of incoming requests to forward to the origin."
    behavior {
      rewrite_url {
        behavior          = "REPLACE"
        match             = ""
        target_path       = ""
        match_multiple    = false
        keep_query_string = true
      }
    }
  }
}

"behaviors": [
  {
    "name": "rewriteUrl",
    "options": {
      "behavior": "REPLACE",
      "match": "",
      "targetPath": "",
      "matchMultiple": false,
      "keepQueryString": true
    }
  }
]

Options