Forward rewrite match rule
akamai_cloudlets_forward_rewrite_match_rule
Every policy version specifies the match rules that govern how the Cloudlet is used. Matches specify conditions that need to be met in the incoming request.
Use the akamai_cloudlets_forward_rewrite_match_rule
data source to build a match rule JSON object for the Forward Rewrite Cloudlet.
Example
This example returns the JSON-encoded rules for the Forward Rewrite Cloudlet.
data "akamai_cloudlets_forward_rewrite_match_rule" "example" {
match_rules {
name = "rule"
matches {
case_sensitive = false
check_ips = "CONNECTING_IP XFF_HEADERS"
match_operator = "equals"
match_type = "clientip"
match_value = "192.0.2.0"
negate = false
}
forward_settings {
path_and_qs = "/path"
use_incoming_query_string = true
origin_id = "1234"
}
}
}
Argument reference
This data source supports these arguments:
-
match_rules
- (Optional) A list of Cloudlet-specific match rules for a policy.-
name
- (Optional) The name of the rule. -
type
- (Optional) The type of Cloudlet the rule is for. For example, the string for Forward Rewrite isfrMatchRule
. -
start
- (Optional) The start time for this match. Specify the value in UTC in seconds since the epoch. -
end
- (Optional) The end time for this match. Specify the value in UTC in seconds since the epoch. -
matches
- (Optional) A list of conditions to apply to a Cloudlet, including:-
match_type
- (Optional) The type of match used, eitherheader
,hostname
,path
,extension
,query
,regex
,cookie
,deviceCharacteristics
,clientip
,continent
,countrycode
,regioncode
,protocol
,method
, orproxy
. -
match_value
- (Optional) This depends on thematch_type
. If thematch_type
ishostname
, thenmatch_value
is the fully qualified domain name, likewww.akamai.com
. -
match_operator
- (Optional) Compares a string expression with a pattern, eithercontains
,exists
, orequals
. -
case_sensitive
- (Optional) Whether the match is case sensitive. -
negate
- (Optional) Whether to negate the match. -
check_ips
- (Optional) Forclientip
,continent
,countrycode
,proxy
, andregioncode
match types, this defines the part of the request that determines the IP address to use. Values include the connecting IP address (CONNECTING_IP
) and the X_Forwarded_For header (XFF_HEADERS
). To select both, enter the two values separated by a space delimiter. When both values are included, the connecting IP address is evaluated first. -
object_match_value
- (Optional) Ifmatch_value
is empty, this argument is required. An object used when a rule includes more complex match criteria, like multiple value attributes. Includes these sub-arguments:-
name
- (Optional) If you're using amatch_type
that supports name attributes, specify the part the incoming request to match on, eithercookie
,header
,parameter
, orquery
. -
type
- (Required) The type of the array, eitherobject
orsimple
. Use thesimple
option when adding only an array of string-based values. -
name_case_sensitive
- (Optional) Whether thename
argument should be evaluated based on case sensitivity. -
name_has_wildcard
- (Optional) Whether thename
argument includes wildcards. -
options
- (Optional) If you set thetype
argument toobject
, use this array to list the values to match on.value
- (Optional) Specify the values in the incoming request to match on.value_has_wildcard
- (Optional) Whether thevalue
argument includes wildcards.value_case_sensitive
- (Optional) Whether thevalue
argument should be evaluated based on case sensitivity.value_escaped
- (Optional) Whether thevalue
argument should be compared in an escaped form.
-
value
- (Optional) If you set thetype
argument tosimple
, specify the values in the incoming request to match on.
-
-
-
-
match_url
- (Optional) If you're using a URL match, this specifies the URL that the Cloudlet uses to match the incoming request. -
forward_settings
- (Required) The data used to construct a new request URL if all match conditions are met. If all conditions are met, the edge server returns an HTTP response from the rewritten URL.origin_id
- (Optional) The ID of the new origin requests are forwarded to. This type of origin is known as a Conditional Origin.use_incoming_query_string
- (Optional) Whether the Cloudlet should include the query string from the request in the rewritten or forwarded URL.path_and_qs
- (Optional) When match conditions are met, this value defines the path, resource, or query string added to the rewritten URL.
-
disabled
- (Optional) Whether to disable a rule so it is not evaluated against incoming requests.
Attributes reference
This data source returns these attributes:
type
- The type of Cloudlet the rule is for.json
- Amatch_rules
JSON structure generated from the API schema that defines the rules for this policy.
Updated 6 months ago