1. Packages
  2. Azure Native
  3. API Docs
  4. frontdoor
  5. getRulesEngine
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi

azure-native.frontdoor.getRulesEngine

Explore with Pulumi AI

This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi

Gets a Rules Engine Configuration with the specified name within the specified Front Door.

Uses Azure REST API version 2021-06-01.

Other available API versions: 2020-01-01, 2020-04-01, 2020-05-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native frontdoor [ApiVersion]. See the version guide for details.

Using getRulesEngine

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getRulesEngine(args: GetRulesEngineArgs, opts?: InvokeOptions): Promise<GetRulesEngineResult>
function getRulesEngineOutput(args: GetRulesEngineOutputArgs, opts?: InvokeOptions): Output<GetRulesEngineResult>
Copy
def get_rules_engine(front_door_name: Optional[str] = None,
                     resource_group_name: Optional[str] = None,
                     rules_engine_name: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetRulesEngineResult
def get_rules_engine_output(front_door_name: Optional[pulumi.Input[str]] = None,
                     resource_group_name: Optional[pulumi.Input[str]] = None,
                     rules_engine_name: Optional[pulumi.Input[str]] = None,
                     opts: Optional[InvokeOptions] = None) -> Output[GetRulesEngineResult]
Copy
func LookupRulesEngine(ctx *Context, args *LookupRulesEngineArgs, opts ...InvokeOption) (*LookupRulesEngineResult, error)
func LookupRulesEngineOutput(ctx *Context, args *LookupRulesEngineOutputArgs, opts ...InvokeOption) LookupRulesEngineResultOutput
Copy

> Note: This function is named LookupRulesEngine in the Go SDK.

public static class GetRulesEngine 
{
    public static Task<GetRulesEngineResult> InvokeAsync(GetRulesEngineArgs args, InvokeOptions? opts = null)
    public static Output<GetRulesEngineResult> Invoke(GetRulesEngineInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetRulesEngineResult> getRulesEngine(GetRulesEngineArgs args, InvokeOptions options)
public static Output<GetRulesEngineResult> getRulesEngine(GetRulesEngineArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: azure-native:frontdoor:getRulesEngine
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

FrontDoorName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Front Door which is globally unique.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Resource group within the Azure subscription.
RulesEngineName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Rules Engine which is unique within the Front Door.
FrontDoorName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Front Door which is globally unique.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Resource group within the Azure subscription.
RulesEngineName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Rules Engine which is unique within the Front Door.
frontDoorName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Front Door which is globally unique.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Resource group within the Azure subscription.
rulesEngineName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Rules Engine which is unique within the Front Door.
frontDoorName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Front Door which is globally unique.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Resource group within the Azure subscription.
rulesEngineName
This property is required.
Changes to this property will trigger replacement.
string
Name of the Rules Engine which is unique within the Front Door.
front_door_name
This property is required.
Changes to this property will trigger replacement.
str
Name of the Front Door which is globally unique.
resource_group_name
This property is required.
Changes to this property will trigger replacement.
str
Name of the Resource group within the Azure subscription.
rules_engine_name
This property is required.
Changes to this property will trigger replacement.
str
Name of the Rules Engine which is unique within the Front Door.
frontDoorName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Front Door which is globally unique.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Resource group within the Azure subscription.
rulesEngineName
This property is required.
Changes to this property will trigger replacement.
String
Name of the Rules Engine which is unique within the Front Door.

getRulesEngine Result

The following output properties are available:

AzureApiVersion string
The Azure API version of the resource.
Id string
Resource ID.
Name string
Resource name.
ResourceState string
Resource status.
Type string
Resource type.
Rules List<Pulumi.AzureNative.FrontDoor.Outputs.RulesEngineRuleResponse>
A list of rules that define a particular Rules Engine Configuration.
AzureApiVersion string
The Azure API version of the resource.
Id string
Resource ID.
Name string
Resource name.
ResourceState string
Resource status.
Type string
Resource type.
Rules []RulesEngineRuleResponse
A list of rules that define a particular Rules Engine Configuration.
azureApiVersion String
The Azure API version of the resource.
id String
Resource ID.
name String
Resource name.
resourceState String
Resource status.
type String
Resource type.
rules List<RulesEngineRuleResponse>
A list of rules that define a particular Rules Engine Configuration.
azureApiVersion string
The Azure API version of the resource.
id string
Resource ID.
name string
Resource name.
resourceState string
Resource status.
type string
Resource type.
rules RulesEngineRuleResponse[]
A list of rules that define a particular Rules Engine Configuration.
azure_api_version str
The Azure API version of the resource.
id str
Resource ID.
name str
Resource name.
resource_state str
Resource status.
type str
Resource type.
rules Sequence[RulesEngineRuleResponse]
A list of rules that define a particular Rules Engine Configuration.
azureApiVersion String
The Azure API version of the resource.
id String
Resource ID.
name String
Resource name.
resourceState String
Resource status.
type String
Resource type.
rules List<Property Map>
A list of rules that define a particular Rules Engine Configuration.

Supporting Types

CacheConfigurationResponse

CacheDuration string
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
DynamicCompression string
Whether to use dynamic compression for cached content
QueryParameterStripDirective string
Treatment of URL query terms when forming the cache key.
QueryParameters string
query parameters to include or exclude (comma separated).
CacheDuration string
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
DynamicCompression string
Whether to use dynamic compression for cached content
QueryParameterStripDirective string
Treatment of URL query terms when forming the cache key.
QueryParameters string
query parameters to include or exclude (comma separated).
cacheDuration String
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
dynamicCompression String
Whether to use dynamic compression for cached content
queryParameterStripDirective String
Treatment of URL query terms when forming the cache key.
queryParameters String
query parameters to include or exclude (comma separated).
cacheDuration string
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
dynamicCompression string
Whether to use dynamic compression for cached content
queryParameterStripDirective string
Treatment of URL query terms when forming the cache key.
queryParameters string
query parameters to include or exclude (comma separated).
cache_duration str
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
dynamic_compression str
Whether to use dynamic compression for cached content
query_parameter_strip_directive str
Treatment of URL query terms when forming the cache key.
query_parameters str
query parameters to include or exclude (comma separated).
cacheDuration String
The duration for which the content needs to be cached. Allowed format is in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requires the value to be no more than a year
dynamicCompression String
Whether to use dynamic compression for cached content
queryParameterStripDirective String
Treatment of URL query terms when forming the cache key.
queryParameters String
query parameters to include or exclude (comma separated).

ForwardingConfigurationResponse

BackendPool Pulumi.AzureNative.FrontDoor.Inputs.SubResourceResponse
A reference to the BackendPool which this rule routes to.
CacheConfiguration Pulumi.AzureNative.FrontDoor.Inputs.CacheConfigurationResponse
The caching configuration associated with this rule.
CustomForwardingPath string
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
ForwardingProtocol string
Protocol this rule will use when forwarding traffic to backends.
BackendPool SubResourceResponse
A reference to the BackendPool which this rule routes to.
CacheConfiguration CacheConfigurationResponse
The caching configuration associated with this rule.
CustomForwardingPath string
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
ForwardingProtocol string
Protocol this rule will use when forwarding traffic to backends.
backendPool SubResourceResponse
A reference to the BackendPool which this rule routes to.
cacheConfiguration CacheConfigurationResponse
The caching configuration associated with this rule.
customForwardingPath String
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
forwardingProtocol String
Protocol this rule will use when forwarding traffic to backends.
backendPool SubResourceResponse
A reference to the BackendPool which this rule routes to.
cacheConfiguration CacheConfigurationResponse
The caching configuration associated with this rule.
customForwardingPath string
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
forwardingProtocol string
Protocol this rule will use when forwarding traffic to backends.
backend_pool SubResourceResponse
A reference to the BackendPool which this rule routes to.
cache_configuration CacheConfigurationResponse
The caching configuration associated with this rule.
custom_forwarding_path str
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
forwarding_protocol str
Protocol this rule will use when forwarding traffic to backends.
backendPool Property Map
A reference to the BackendPool which this rule routes to.
cacheConfiguration Property Map
The caching configuration associated with this rule.
customForwardingPath String
A custom path used to rewrite resource paths matched by this rule. Leave empty to use incoming path.
forwardingProtocol String
Protocol this rule will use when forwarding traffic to backends.

HeaderActionResponse

HeaderActionType This property is required. string
Which type of manipulation to apply to the header.
HeaderName This property is required. string
The name of the header this action will apply to.
Value string
The value to update the given header name with. This value is not used if the actionType is Delete.
HeaderActionType This property is required. string
Which type of manipulation to apply to the header.
HeaderName This property is required. string
The name of the header this action will apply to.
Value string
The value to update the given header name with. This value is not used if the actionType is Delete.
headerActionType This property is required. String
Which type of manipulation to apply to the header.
headerName This property is required. String
The name of the header this action will apply to.
value String
The value to update the given header name with. This value is not used if the actionType is Delete.
headerActionType This property is required. string
Which type of manipulation to apply to the header.
headerName This property is required. string
The name of the header this action will apply to.
value string
The value to update the given header name with. This value is not used if the actionType is Delete.
header_action_type This property is required. str
Which type of manipulation to apply to the header.
header_name This property is required. str
The name of the header this action will apply to.
value str
The value to update the given header name with. This value is not used if the actionType is Delete.
headerActionType This property is required. String
Which type of manipulation to apply to the header.
headerName This property is required. String
The name of the header this action will apply to.
value String
The value to update the given header name with. This value is not used if the actionType is Delete.

RedirectConfigurationResponse

CustomFragment string
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
CustomHost string
Host to redirect. Leave empty to use the incoming host as the destination host.
CustomPath string
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
CustomQueryString string
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
RedirectProtocol string
The protocol of the destination to where the traffic is redirected
RedirectType string
The redirect type the rule will use when redirecting traffic.
CustomFragment string
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
CustomHost string
Host to redirect. Leave empty to use the incoming host as the destination host.
CustomPath string
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
CustomQueryString string
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
RedirectProtocol string
The protocol of the destination to where the traffic is redirected
RedirectType string
The redirect type the rule will use when redirecting traffic.
customFragment String
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
customHost String
Host to redirect. Leave empty to use the incoming host as the destination host.
customPath String
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
customQueryString String
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
redirectProtocol String
The protocol of the destination to where the traffic is redirected
redirectType String
The redirect type the rule will use when redirecting traffic.
customFragment string
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
customHost string
Host to redirect. Leave empty to use the incoming host as the destination host.
customPath string
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
customQueryString string
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
redirectProtocol string
The protocol of the destination to where the traffic is redirected
redirectType string
The redirect type the rule will use when redirecting traffic.
custom_fragment str
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
custom_host str
Host to redirect. Leave empty to use the incoming host as the destination host.
custom_path str
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
custom_query_string str
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
redirect_protocol str
The protocol of the destination to where the traffic is redirected
redirect_type str
The redirect type the rule will use when redirecting traffic.
customFragment String
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #.
customHost String
Host to redirect. Leave empty to use the incoming host as the destination host.
customPath String
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
customQueryString String
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. The first ? and & will be added automatically so do not include them in the front, but do separate multiple query strings with &.
redirectProtocol String
The protocol of the destination to where the traffic is redirected
redirectType String
The redirect type the rule will use when redirecting traffic.

RulesEngineActionResponse

RequestHeaderActions []HeaderActionResponse
A list of header actions to apply from the request from AFD to the origin.
ResponseHeaderActions []HeaderActionResponse
A list of header actions to apply from the response from AFD to the client.
RouteConfigurationOverride ForwardingConfigurationResponse | RedirectConfigurationResponse
Override the route configuration.
requestHeaderActions List<HeaderActionResponse>
A list of header actions to apply from the request from AFD to the origin.
responseHeaderActions List<HeaderActionResponse>
A list of header actions to apply from the response from AFD to the client.
routeConfigurationOverride ForwardingConfigurationResponse | RedirectConfigurationResponse
Override the route configuration.
requestHeaderActions HeaderActionResponse[]
A list of header actions to apply from the request from AFD to the origin.
responseHeaderActions HeaderActionResponse[]
A list of header actions to apply from the response from AFD to the client.
routeConfigurationOverride ForwardingConfigurationResponse | RedirectConfigurationResponse
Override the route configuration.
request_header_actions Sequence[HeaderActionResponse]
A list of header actions to apply from the request from AFD to the origin.
response_header_actions Sequence[HeaderActionResponse]
A list of header actions to apply from the response from AFD to the client.
route_configuration_override ForwardingConfigurationResponse | RedirectConfigurationResponse
Override the route configuration.
requestHeaderActions List<Property Map>
A list of header actions to apply from the request from AFD to the origin.
responseHeaderActions List<Property Map>
A list of header actions to apply from the response from AFD to the client.
routeConfigurationOverride Property Map | Property Map
Override the route configuration.

RulesEngineMatchConditionResponse

RulesEngineMatchValue This property is required. List<string>
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
RulesEngineMatchVariable This property is required. string
Match Variable
RulesEngineOperator This property is required. string
Describes operator to apply to the match condition.
NegateCondition bool
Describes if this is negate condition or not
Selector string
Name of selector in RequestHeader or RequestBody to be matched
Transforms List<string>
List of transforms
RulesEngineMatchValue This property is required. []string
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
RulesEngineMatchVariable This property is required. string
Match Variable
RulesEngineOperator This property is required. string
Describes operator to apply to the match condition.
NegateCondition bool
Describes if this is negate condition or not
Selector string
Name of selector in RequestHeader or RequestBody to be matched
Transforms []string
List of transforms
rulesEngineMatchValue This property is required. List<String>
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
rulesEngineMatchVariable This property is required. String
Match Variable
rulesEngineOperator This property is required. String
Describes operator to apply to the match condition.
negateCondition Boolean
Describes if this is negate condition or not
selector String
Name of selector in RequestHeader or RequestBody to be matched
transforms List<String>
List of transforms
rulesEngineMatchValue This property is required. string[]
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
rulesEngineMatchVariable This property is required. string
Match Variable
rulesEngineOperator This property is required. string
Describes operator to apply to the match condition.
negateCondition boolean
Describes if this is negate condition or not
selector string
Name of selector in RequestHeader or RequestBody to be matched
transforms string[]
List of transforms
rules_engine_match_value This property is required. Sequence[str]
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
rules_engine_match_variable This property is required. str
Match Variable
rules_engine_operator This property is required. str
Describes operator to apply to the match condition.
negate_condition bool
Describes if this is negate condition or not
selector str
Name of selector in RequestHeader or RequestBody to be matched
transforms Sequence[str]
List of transforms
rulesEngineMatchValue This property is required. List<String>
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match.
rulesEngineMatchVariable This property is required. String
Match Variable
rulesEngineOperator This property is required. String
Describes operator to apply to the match condition.
negateCondition Boolean
Describes if this is negate condition or not
selector String
Name of selector in RequestHeader or RequestBody to be matched
transforms List<String>
List of transforms

RulesEngineRuleResponse

Action This property is required. Pulumi.AzureNative.FrontDoor.Inputs.RulesEngineActionResponse
Actions to perform on the request and response if all of the match conditions are met.
Name This property is required. string
A name to refer to this specific rule.
Priority This property is required. int
A priority assigned to this rule.
MatchConditions List<Pulumi.AzureNative.FrontDoor.Inputs.RulesEngineMatchConditionResponse>
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
MatchProcessingBehavior string
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
Action This property is required. RulesEngineActionResponse
Actions to perform on the request and response if all of the match conditions are met.
Name This property is required. string
A name to refer to this specific rule.
Priority This property is required. int
A priority assigned to this rule.
MatchConditions []RulesEngineMatchConditionResponse
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
MatchProcessingBehavior string
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
action This property is required. RulesEngineActionResponse
Actions to perform on the request and response if all of the match conditions are met.
name This property is required. String
A name to refer to this specific rule.
priority This property is required. Integer
A priority assigned to this rule.
matchConditions List<RulesEngineMatchConditionResponse>
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
matchProcessingBehavior String
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
action This property is required. RulesEngineActionResponse
Actions to perform on the request and response if all of the match conditions are met.
name This property is required. string
A name to refer to this specific rule.
priority This property is required. number
A priority assigned to this rule.
matchConditions RulesEngineMatchConditionResponse[]
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
matchProcessingBehavior string
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
action This property is required. RulesEngineActionResponse
Actions to perform on the request and response if all of the match conditions are met.
name This property is required. str
A name to refer to this specific rule.
priority This property is required. int
A priority assigned to this rule.
match_conditions Sequence[RulesEngineMatchConditionResponse]
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
match_processing_behavior str
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
action This property is required. Property Map
Actions to perform on the request and response if all of the match conditions are met.
name This property is required. String
A name to refer to this specific rule.
priority This property is required. Number
A priority assigned to this rule.
matchConditions List<Property Map>
A list of match conditions that must meet in order for the actions of this rule to run. Having no match conditions means the actions will always run.
matchProcessingBehavior String
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.

SubResourceResponse

Id string
Resource ID.
Id string
Resource ID.
id String
Resource ID.
id string
Resource ID.
id str
Resource ID.
id String
Resource ID.

Package Details

Repository
Azure Native pulumi/pulumi-azure-native
License
Apache-2.0
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.2.0 published on Monday, Apr 14, 2025 by Pulumi