route

Search…
route
Summary
Routes match the URI portion of the incoming request and route traffic to different shared_rules. This allows requests to routes like /api/v1 and /api/v2 to end up at entirely different hosts if desired. The routes objects support matching, prefix rewriting, and redirection of requests.
Example Object
1
{
2
  "zone_key": "default",
3
  "domain_key": "fibonacci",
4
  "route_key": "fibonacci-route",
5
  "path": "/",
6
  "prefix_rewrite": null,
7
  "redirects": null,
8
  "shared_rules_key": "",
9
  "rules": [
10
    {
11
      "rule_key": "default",
12
      "constraints": {
13
        "light": [
14
          {
15
            "constraint_key": "",
16
            "cluster_key": "fibonacci-service",
17
            "metadata": null,
18
            "properties": null,
19
            "response_data": {},
20
            "weight": 1
21
          }
22
        ],
23
        "dark": null,
24
        "tap": null
25
      }
26
    }
27
  ],
28
  "response_data": {},
29
  "cohort_seed": null,
30
  "retry_policy": {
31
    "num_retries": 3
32
  },
33
  "request_headers_to_add" : [],
34
  "request_headers_to_remove" : [],
35
  "response_headers_to_add" : [],
36
  "response_headers_to_remove" : []
37
}
Copied!
Features
​Path matching​
​Prefix Rewriting​
​Redirect​
​Routing Rules​
​Retry Policies​
See the routing documentation for an explanation of all of the routing features and how to set them.
Envoy Reference
​Envoy Route Reference​
Fields
route_key
A unique key to identify this route configuration in the Fabric API.
domain_key
String domain key to specify which domain object this route should attach to.
zone_key
The zone in which this object will live. It will only be able to be referenced by objects or sent to Sidecars that live in the same zone.
path
DEPRECATION: This field has been deprecated and will be removed in the next major version release. Use route_match instead.
Explicit path string to match on. E.g. "/services/catalog/" or "/apps/ui/".
route_match
​Route match to match against incoming requests.
prefix_rewrite
When a match is found using the values configured in route_match, the value of the :path header on the request will be replaced with this value for forwarding.
redirects
This field can be used to configure redirect routes for the domain. See Redirect for details.
Fields:
name
the name of the redirect
from
regex value that the incoming request :path will be regex matched to
to
the new URL that an incoming request matching from will route to
if set to "$host", will redirect to the name of the domain
redirect_type
determines the response code of the redirect
must be one of: "permanent" (for a 301 code), "temporary" (for a 307 code)
header_constraints
a list of header constraint objects
each header constraint has the following fields:
name
the header key to be compared to the incoming requests headers
will be compared without case sensitivity
value
must be a valid regex
the value to be compared to the value of the incoming request header with matching name
case_sensitive
boolean indicating whether the value will be compared to the value of the header with matching name with case sensitivity
invert
boolean value
shared_rules_key
Indicates the key of the shared_rules object to use for specifying a default cluster to forward to.
This field may be omitted if rules are defined directly.
rules
A list of rules to specify various more complex route matching and forwarding specifications.
response_data
A collection of annotations that should be applied to responses when handling a request. Configuration​
cohort_seed
This field has no effect.
retry_policy
A retry_policy that controls how this route will handle automatic retries to upstream clusters and govern timeouts.
high_priority
Defaults to false, which indicates this is normal traffic. If set to true, routes are considered high priority which allows different handling of the request.
filter_metadata
A map from string to metadata that can be used to provide virtual host-specific configurations for filters. See the per route filter configuration guide for info on setting this up.
request_headers_to_add
Specifies a set of headers that will be added to requests matching this route.
E.g.
1
"request_headers_to_add" : [
2
  {
3
    "key": "x-forwarded-proto",
4
    "value": "https"
5
  }
6
]
Copied!
request_headers_to_remove
Specifies a list of HTTP headers that should be removed from each request matching this route.
E.g.
1
"request_headers_to_remove" : [
2
  "request-header1",
3
  "request-header2",
4
]
Copied!
response_headers_to_add
Specifies a set of headers that will be added to responses matching this route.
E.g.
1
"response_headers_to_add" : [
2
  {
3
    "key": "x-forwarded-proto",
4
    "value": "https"
5
  }
6
]
Copied!
response_headers_to_remove
Specifies a list of HTTP headers that should be removed from each response matching this route.
E.g.
1
"response_headers_to_remove" : [
2
  "response-header1",
3
  "response-header2",
4
]
Copied!
checksum
An API calculated checksum. Can be used to verify that the API contains the expected object before performing a write.