--- title: Rules --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Rulesets](https://developers.cloudflare.com/api/python/resources/rulesets) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Rules ##### [Create an account or zone ruleset rule](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/rules/methods/create) rulesets.rules.create(strruleset\_id, RuleCreateParams\*\*kwargs) -> [RuleCreateResponse]() POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/{ruleset\_id}/rules ##### [Update an account or zone ruleset rule](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/rules/methods/edit) rulesets.rules.edit(strrule\_id, RuleEditParams\*\*kwargs) -> [RuleEditResponse]() PATCH/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/{ruleset\_id}/rules/{rule\_id} ##### [Delete an account or zone ruleset rule](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/rules/methods/delete) rulesets.rules.delete(strrule\_id, RuleDeleteParams\*\*kwargs) -> [RuleDeleteResponse]() DELETE/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/{ruleset\_id}/rules/{rule\_id} ##### ModelsExpand Collapse
class BlockRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["block"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action.
response: Optional\[ActionParametersResponse] The response to show when the block is applied. content: str The content to return. minLength1 Link to this property content\_type: str The type of the content to return. minLength1 Link to this property status\_code: int The status code to return. maximum499 minimum400 Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20block_rule%20%3E%20(schema)>)
class CompressResponseRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["compress\_response"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action.
algorithms: Iterable\[ActionParametersAlgorithm] Custom order for compression algorithms.
name: Optional\[Literal\["none", "auto", "default", 3 more]] Name of the compression algorithm to enable. One of the following: "none" Link to this property "auto" Link to this property "default" Link to this property "gzip" Link to this property "brotli" Link to this property "zstd" Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20compress_response_rule%20%3E%20(schema)>)
class DDoSDynamicRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["ddos\_dynamic"]] The action to perform when the rule matches. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20ddos_dynamic_rule%20%3E%20(schema)>)
class ExecuteRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["execute"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. id: str The ID of the ruleset to execute. Link to this property
matched\_data: Optional\[ActionParametersMatchedData] The configuration to use for matched data logging. public\_key: str The public key to encrypt matched data logs with. minLength1 Link to this property
Link to this property
overrides: Optional\[ActionParametersOverrides] A set of overrides to apply to the target ruleset. action: Optional\[str] An action to override all rules with. This option has lower precedence than rule and category overrides. Link to this property
categories: Optional\[Iterable\[ActionParametersOverridesCategory]] A list of category-level overrides. This option has the second-highest precedence after rule-level overrides. category: str The name of the category to override. minLength1 Link to this property action: Optional\[str] The action to override rules in the category with. Link to this property enabled: Optional\[bool] Whether to enable execution of rules in the category. Link to this property
sensitivity\_level: Optional\[Literal\["default", "medium", "low", "eoff"]] The sensitivity level to use for rules in the category. This option is only applicable for DDoS phases. One of the following: "default" Link to this property "medium" Link to this property "low" Link to this property "eoff" Link to this property
Link to this property
Link to this property enabled: Optional\[bool] Whether to enable execution of all rules. This option has lower precedence than rule and category overrides. Link to this property
rules: Optional\[Iterable\[ActionParametersOverridesRule]] A list of rule-level overrides. This option has the highest precedence. id: str The ID of the rule to override. Link to this property action: Optional\[str] The action to override the rule with. Link to this property enabled: Optional\[bool] Whether to enable execution of the rule. Link to this property score\_threshold: Optional\[int] The score threshold to use for the rule. Link to this property
sensitivity\_level: Optional\[Literal\["default", "medium", "low", "eoff"]] The sensitivity level to use for the rule. This option is only applicable for DDoS phases. One of the following: "default" Link to this property "medium" Link to this property "low" Link to this property "eoff" Link to this property
Link to this property
Link to this property
sensitivity\_level: Optional\[Literal\["default", "medium", "low", "eoff"]] A sensitivity level to set for all rules. This option has lower precedence than rule and category overrides and is only applicable for DDoS phases. One of the following: "default" Link to this property "medium" Link to this property "low" Link to this property "eoff" Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20execute_rule%20%3E%20(schema)>)
class ForceConnectionCloseRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["force\_connection\_close"]] The action to perform when the rule matches. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20force_connection_close_rule%20%3E%20(schema)>)
class LogCustomFieldRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["log\_custom\_field"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action.
cookie\_fields: Optional\[Iterable\[ActionParametersCookieField]] The cookie fields to log. name: str The name of the cookie. minLength1 Link to this property
Link to this property
raw\_response\_fields: Optional\[Iterable\[ActionParametersRawResponseField]] The raw response fields to log. name: str The name of the response header. minLength1 Link to this property preserve\_duplicates: Optional\[bool] Whether to log duplicate values of the same header. Link to this property
Link to this property
request\_fields: Optional\[Iterable\[ActionParametersRequestField]] The raw request fields to log. name: str The name of the header. minLength1 Link to this property
Link to this property
response\_fields: Optional\[Iterable\[ActionParametersResponseField]] The transformed response fields to log. name: str The name of the response header. minLength1 Link to this property preserve\_duplicates: Optional\[bool] Whether to log duplicate values of the same header. Link to this property
Link to this property
transformed\_request\_fields: Optional\[Iterable\[ActionParametersTransformedRequestField]] The transformed request fields to log. name: str The name of the header. minLength1 Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20log_custom_field_rule%20%3E%20(schema)>)
class LogRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["log"]] The action to perform when the rule matches. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20log_rule%20%3E%20(schema)>)
class Logging: … An object configuring the rule’s logging behavior. enabled: bool Whether to generate a log when the rule matches. Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20logging%20%3E%20(schema)>)
class ManagedChallengeRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["managed\_challenge"]] The action to perform when the rule matches. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20managed_challenge_rule%20%3E%20(schema)>)
class RedirectRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["redirect"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action.
from\_list: Optional\[ActionParametersFromList] A redirect based on a bulk list lookup. key: str An expression that evaluates to the list lookup key. minLength1 Link to this property name: str The name of the list to match against. Link to this property
Link to this property
from\_value: Optional\[ActionParametersFromValue] A redirect based on the request properties.
target\_url: ActionParametersFromValueTargetURL A URL to redirect the request to. expression: Optional\[str] An expression that evaluates to a URL to redirect the request to. minLength1 Link to this property value: Optional\[str] A URL to redirect the request to. minLength1 Link to this property
Link to this property preserve\_query\_string: Optional\[bool] Whether to keep the query string of the original request. Link to this property
status\_code: Optional\[Literal\[301, 302, 303, 2 more]] The status code to use for the redirect. One of the following: 301 Link to this property 302 Link to this property 303 Link to this property 307 Link to this property 308 Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20redirect_rule%20%3E%20(schema)>)
class RewriteRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["rewrite"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action.
headers: Optional\[Dict\[str, ActionParametersHeaders]] A map of headers to rewrite. One of the following:
class ActionParametersHeadersAddStaticHeader: … A header with a static value to add. operation: Literal\["add"] The operation to perform on the header. Link to this property value: str A static value for the header. minLength1 Link to this property
Link to this property
class ActionParametersHeadersAddDynamicHeader: … A header with a dynamic value to add. expression: str An expression that evaluates to a value for the header. minLength1 Link to this property operation: Literal\["add"] The operation to perform on the header. Link to this property
Link to this property
class ActionParametersHeadersSetStaticHeader: … A header with a static value to set. operation: Literal\["set"] The operation to perform on the header. Link to this property value: str A static value for the header. minLength1 Link to this property
Link to this property
class ActionParametersHeadersSetDynamicHeader: … A header with a dynamic value to set. expression: str An expression that evaluates to a value for the header. minLength1 Link to this property operation: Literal\["set"] The operation to perform on the header. Link to this property
Link to this property
class ActionParametersHeadersRemoveHeader: … A header to remove. operation: Literal\["remove"] The operation to perform on the header. Link to this property
Link to this property
Link to this property
uri: Optional\[ActionParametersURI] A URI path rewrite. One of the following:
class ActionParametersURIURIPath: … A URI path rewrite.
path: ActionParametersURIURIPathPath A URI path rewrite. expression: Optional\[str] An expression that evaluates to a value to rewrite the URI path to. minLength1 Link to this property value: Optional\[str] A value to rewrite the URI path to. minLength1 Link to this property
Link to this property origin: Optional\[bool] Whether to propagate the rewritten URI to origin. Link to this property
Link to this property
class ActionParametersURIURIQuery: … A URI query rewrite.
query: ActionParametersURIURIQueryQuery A URI query rewrite. expression: Optional\[str] An expression that evaluates to a value to rewrite the URI query to. minLength1 Link to this property value: Optional\[str] A value to rewrite the URI query to. Link to this property
Link to this property origin: Optional\[bool] Whether to propagate the rewritten URI to origin. Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20rewrite_rule%20%3E%20(schema)>)
class RouteRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["route"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. host\_header: Optional\[str] A value to rewrite the HTTP host header to. minLength1 Link to this property
origin: Optional\[ActionParametersOrigin] An origin to route to. host: Optional\[str] A resolved host to route to. minLength1 Link to this property port: Optional\[int] A destination port to route to. maximum65535 minimum1 Link to this property
Link to this property
sni: Optional\[ActionParametersSNI] A Server Name Indication (SNI) override. value: str A value to override the SNI to. minLength1 Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20route_rule%20%3E%20(schema)>)
class RulesetRule: … last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[str] The action to perform when the rule matches. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Whether the rule should be executed. Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20ruleset_rule%20%3E%20(schema)>)
class ScoreRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["score"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. increment: int A delta to change the score by, which can be either positive or negative. Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20score_rule%20%3E%20(schema)>)
class ServeErrorRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["serve\_error"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. One of the following:
class ActionParametersActionParametersContent: … content: str The response content. minLength1 Link to this property
content\_type: Optional\[Literal\["application/json", "text/html", "text/plain", "text/xml"]] The content type header to set with the error response. One of the following: "application/json" Link to this property "text/html" Link to this property "text/plain" Link to this property "text/xml" Link to this property
Link to this property status\_code: Optional\[int] The status code to use for the error. maximum999 minimum400 Link to this property
Link to this property
class ActionParametersActionParametersAsset: … asset\_name: str The name of a custom asset to serve as the error response. minLength1 Link to this property
content\_type: Optional\[Literal\["application/json", "text/html", "text/plain", "text/xml"]] The content type header to set with the error response. One of the following: "application/json" Link to this property "text/html" Link to this property "text/plain" Link to this property "text/xml" Link to this property
Link to this property status\_code: Optional\[int] The status code to use for the error. maximum999 minimum400 Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20serve_error_rule%20%3E%20(schema)>)
class SetCacheSettingsRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["set\_cache\_settings"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. additional\_cacheable\_ports: Optional\[Iterable\[int]] A list of additional ports that caching should be enabled on. Link to this property
browser\_ttl: Optional\[ActionParametersBrowserTTL] How long client browsers should cache the response. Cloudflare cache purge will not purge content cached on client browsers, so high browser TTLs may lead to stale content.
mode: Literal\["respect\_origin", "bypass\_by\_default", "override\_origin", "bypass"] The browser TTL mode. One of the following: "respect\_origin" Link to this property "bypass\_by\_default" Link to this property "override\_origin" Link to this property "bypass" Link to this property
Link to this property default: Optional\[int] The browser TTL (in seconds) if you choose the “override\_origin” mode. minimum0 Link to this property
Link to this property cache: Optional\[bool] Whether the request’s response from the origin is eligible for caching. Caching itself will still depend on the cache control header and your other caching configurations. Link to this property
cache\_key: Optional\[ActionParametersCacheKey] Which components of the request are included in or excluded from the cache key Cloudflare uses to store the response in cache. cache\_by\_device\_type: Optional\[bool] Whether to separate cached content based on the visitor’s device type. Link to this property cache\_deception\_armor: Optional\[bool] Whether to protect from web cache deception attacks, while allowing static assets to be cached. Link to this property
custom\_key: Optional\[ActionParametersCacheKeyCustomKey] Which components of the request are included or excluded from the cache key.
cookie: Optional\[ActionParametersCacheKeyCustomKeyCookie] Which cookies to include in the cache key. check\_presence: Optional\[Sequence\[str]] A list of cookies to check for the presence of. The presence of these cookies is included in the cache key. Link to this property include: Optional\[Sequence\[str]] A list of cookies to include in the cache key. Link to this property
Link to this property
header: Optional\[ActionParametersCacheKeyCustomKeyHeader] Which headers to include in the cache key. check\_presence: Optional\[Sequence\[str]] A list of headers to check for the presence of. The presence of these headers is included in the cache key. Link to this property contains: Optional\[Dict\[str, Sequence\[str]]] A mapping of header names to a list of values. If a header is present in the request and contains any of the values provided, its value is included in the cache key. Link to this property exclude\_origin: Optional\[bool] Whether to exclude the origin header in the cache key. Link to this property include: Optional\[Sequence\[str]] A list of headers to include in the cache key. Link to this property
Link to this property
host: Optional\[ActionParametersCacheKeyCustomKeyHost] How to use the host in the cache key. resolved: Optional\[bool] Whether to use the resolved host in the cache key. Link to this property
Link to this property
query\_string: Optional\[ActionParametersCacheKeyCustomKeyQueryString] Which query string parameters to include in or exclude from the cache key.
exclude: Optional\[ActionParametersCacheKeyCustomKeyQueryStringExclude] Which query string parameters to exclude from the cache key. all: Optional\[Literal\[true]] Whether to exclude all query string parameters from the cache key. Link to this property list: Optional\[Sequence\[str]] A list of query string parameters to exclude from the cache key. Link to this property
Link to this property
include: Optional\[ActionParametersCacheKeyCustomKeyQueryStringInclude] Which query string parameters to include in the cache key. all: Optional\[Literal\[true]] Whether to include all query string parameters in the cache key. Link to this property list: Optional\[Sequence\[str]] A list of query string parameters to include in the cache key. Link to this property
Link to this property
Link to this property
user: Optional\[ActionParametersCacheKeyCustomKeyUser] How to use characteristics of the request user agent in the cache key. device\_type: Optional\[bool] Whether to use the user agent’s device type in the cache key. Link to this property geo: Optional\[bool] Whether to use the user agents’s country in the cache key. Link to this property lang: Optional\[bool] Whether to use the user agent’s language in the cache key. Link to this property
Link to this property
Link to this property ignore\_query\_strings\_order: Optional\[bool] Whether to treat requests with the same query parameters the same, regardless of the order those query parameters are in. Link to this property
Link to this property
cache\_reserve: Optional\[ActionParametersCacheReserve] Settings to determine whether the request’s response from origin is eligible for Cache Reserve (requires a Cache Reserve add-on plan). eligible: bool Whether Cache Reserve is enabled. If this is true and a request meets eligibility criteria, Cloudflare will write the resource to Cache Reserve. Link to this property minimum\_file\_size: Optional\[int] The minimum file size eligible for storage in Cache Reserve. minimum0 Link to this property
Link to this property
edge\_ttl: Optional\[ActionParametersEdgeTTL] How long the Cloudflare edge network should cache the response.
mode: Literal\["respect\_origin", "bypass\_by\_default", "override\_origin"] The edge TTL mode. One of the following: "respect\_origin" Link to this property "bypass\_by\_default" Link to this property "override\_origin" Link to this property
Link to this property default: Optional\[int] The edge TTL (in seconds) if you choose the “override\_origin” mode. minimum0 Link to this property
status\_code\_ttl: Optional\[Iterable\[ActionParametersEdgeTTLStatusCodeTTL]] A list of TTLs to apply to specific status codes or status code ranges. value: int The time to cache the response for (in seconds). A value of 0 is equivalent to setting the cache control header with the value “no-cache”. A value of -1 is equivalent to setting the cache control header with the value of “no-store”. Link to this property status\_code: Optional\[int] A single status code to apply the TTL to. maximum999 minimum100 Link to this property
status\_code\_range: Optional\[ActionParametersEdgeTTLStatusCodeTTLStatusCodeRange] A range of status codes to apply the TTL to. from\_: Optional\[int] The lower bound of the range. maximum999 minimum100 Link to this property to: Optional\[int] The upper bound of the range. maximum999 minimum100 Link to this property
Link to this property
Link to this property
Link to this property origin\_cache\_control: Optional\[bool] Whether Cloudflare will aim to strictly adhere to RFC 7234. Link to this property origin\_error\_page\_passthru: Optional\[bool] Whether to generate Cloudflare error pages for issues from the origin server. Link to this property
origin\_range\_requests: Optional\[ActionParametersOriginRangeRequests] Controls whether Cloudflare fetches a large asset from the origin as a series of range requests instead of one whole-body request.
mode: Literal\["on", "off", "default"] Whether to use range requests. default is the behaviour the zone gets without this rule. One of the following: "on" Link to this property "off" Link to this property "default" Link to this property
Link to this property
Link to this property read\_timeout: Optional\[int] A timeout value between two successive read operations to use for your origin server. Historically, the timeout value between two read options from Cloudflare to an origin server is 100 seconds. If you are attempting to reduce HTTP 524 errors because of timeouts from an origin server, try increasing this timeout value. maximum6000 minimum100 Link to this property respect\_strong\_etags: Optional\[bool] Whether Cloudflare should respect strong ETag (entity tag) headers. If false, Cloudflare converts strong ETag headers to weak ETag headers. Link to this property
serve\_stale: Optional\[ActionParametersServeStale] When to serve stale content from cache. disable\_stale\_while\_updating: Optional\[bool] Whether Cloudflare should disable serving stale content while getting the latest content from the origin. Link to this property
Link to this property
shared\_dictionary: Optional\[ActionParametersSharedDictionary] Configuration for shared dictionary compression. When set, Cloudflare injects Use-As-Dictionary headers on matching cacheable responses. match\_pattern: str URL pattern for the Use-As-Dictionary match field. This pattern specifies which URLs can use this response as a dictionary. maxLength1024 minLength1 Link to this property
Link to this property strip\_etags: Optional\[bool] Whether to strip ETag headers from the origin response before caching. Link to this property strip\_last\_modified: Optional\[bool] Whether to strip Last-Modified headers from the origin response before caching. Link to this property strip\_set\_cookie: Optional\[bool] Whether to strip Set-Cookie headers from the origin response before caching. Link to this property
vary: Optional\[ActionParametersVary] Controls how cached responses vary based on request headers. default is required by the API and applies to any Vary response header that does not have a per-header override.
default: Optional\[ActionParametersVaryDefault] Controls how response Vary headers without a per-header override contribute to the cache key.
action: Literal\["bypass", "passthrough", "normalize"] How the header value is treated when building the cache key. One of the following: "bypass" Link to this property "passthrough" Link to this property "normalize" Link to this property
Link to this property
Link to this property
headers: Optional\[Dict\[str, ActionParametersVaryHeaders]] A mapping of lowercase request header names to their vary configuration.
action: Literal\["bypass", "passthrough", "normalize"] How the header value is treated when building the cache key. One of the following: "bypass" Link to this property "passthrough" Link to this property "normalize" Link to this property
Link to this property languages: Optional\[Sequence\[str]] The set of languages to normalize against. Only valid for the accept-language header. Link to this property media\_types: Optional\[Sequence\[str]] The set of media types to normalize against. Only valid for the accept header. Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20set_cache_settings_rule%20%3E%20(schema)>)
class SetConfigRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["set\_config"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. automatic\_https\_rewrites: Optional\[bool] Whether to enable Automatic HTTPS Rewrites. Link to this property
autominify: Optional\[ActionParametersAutominify] Which file extensions to minify automatically. css: Optional\[bool] Whether to minify CSS files. Link to this property html: Optional\[bool] Whether to minify HTML files. Link to this property js: Optional\[bool] Whether to minify JavaScript files. Link to this property
Link to this property bic: Optional\[bool] Whether to enable Browser Integrity Check (BIC). Link to this property content\_converter: Optional\[bool] Whether to enable content conversion (e.g., HTML to Markdown). Link to this property Deprecateddisable\_apps: Optional\[Literal\[true]] Cloudflare Apps are deprected. Whether to disable Cloudflare Apps. Link to this property disable\_pay\_per\_crawl: Optional\[Literal\[true]] Whether to disable Pay Per Crawl. Link to this property disable\_rum: Optional\[Literal\[true]] Whether to disable Real User Monitoring (RUM). Link to this property disable\_zaraz: Optional\[Literal\[true]] Whether to disable Zaraz. Link to this property email\_obfuscation: Optional\[bool] Whether to enable Email Obfuscation. Link to this property fonts: Optional\[bool] Whether to enable Cloudflare Fonts. Link to this property hotlink\_protection: Optional\[bool] Whether to enable Hotlink Protection. Link to this property Deprecatedmirage: Optional\[bool] Mirage is deprecated. More information at https://developers.cloudflare.com/speed/optimization/images/mirage/. Whether to enable Mirage. Link to this property opportunistic\_encryption: Optional\[bool] Whether to enable Opportunistic Encryption. Link to this property
polish: Optional\[Literal\["off", "lossless", "lossy", "webp"]] The Polish level to configure. One of the following: "off" Link to this property "lossless" Link to this property "lossy" Link to this property "webp" Link to this property
Link to this property redirects\_for\_ai\_training: Optional\[bool] Whether to redirect verified AI training crawlers to canonical URLs found in the HTML response. Link to this property
request\_body\_buffering: Optional\[Literal\["none", "standard", "full"]] The request body buffering mode. One of the following: "none" Link to this property "standard" Link to this property "full" Link to this property
Link to this property
response\_body\_buffering: Optional\[Literal\["none", "standard"]] The response body buffering mode. One of the following: "none" Link to this property "standard" Link to this property
Link to this property rocket\_loader: Optional\[bool] Whether to enable Rocket Loader. Link to this property
security\_level: Optional\[Literal\["off", "essentially\_off", "low", 3 more]] The Security Level to configure. One of the following: "off" Link to this property "essentially\_off" Link to this property "low" Link to this property "medium" Link to this property "high" Link to this property "under\_attack" Link to this property
Link to this property server\_side\_excludes: Optional\[bool] Whether to enable Server-Side Excludes. Link to this property
ssl: Optional\[Literal\["off", "flexible", "full", 2 more]] The SSL level to configure. One of the following: "off" Link to this property "flexible" Link to this property "full" Link to this property "strict" Link to this property "origin\_pull" Link to this property
Link to this property Deprecatedsxg: Optional\[bool] Signed Exchanges (SXG) is deprecated. Whether to enable Signed Exchanges (SXG). Link to this property webmcp\_enabled: Optional\[bool] Whether to serve the WebMCP bridge script, which exposes the page’s tools to browser AI agents. Link to this property webmcp\_packs: Optional\[Sequence\[str]] Bundled WebMCP tool packs to activate for matching requests. An empty array disables all packs. Omitting this parameter leaves the pack selection unchanged. Does not enable the WebMCP bridge itself. Non-empty selections require the WebMCP Configuration Rules entitlement. Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20set_config_rule%20%3E%20(schema)>)
class SkipRule: … last\_updated: Union\[str, datetime] The timestamp of when the rule was last modified. formatdate-time Link to this property version: str The version of the rule. Link to this property id: Optional\[str] The unique ID of the rule. Link to this property action: Optional\[Literal\["skip"]] The action to perform when the rule matches. Link to this property
action\_parameters: Optional\[ActionParameters] The parameters configuring the rule’s action. phase: Optional\[Literal\["current"]] A phase to skip the execution of. This option is only compatible with the products option. Link to this property
phases: Optional\[List\[Phase]] A list of phases to skip the execution of. This option is incompatible with the rulesets option. One of the following: "ddos\_l4" Link to this property "ddos\_l7" Link to this property "http\_config\_settings" Link to this property "http\_custom\_errors" Link to this property "http\_log\_custom\_fields" Link to this property "http\_ratelimit" Link to this property "http\_request\_cache\_settings" Link to this property "http\_request\_dynamic\_redirect" Link to this property "http\_request\_firewall\_custom" Link to this property "http\_request\_firewall\_managed" Link to this property "http\_request\_late\_transform" Link to this property "http\_request\_origin" Link to this property "http\_request\_redirect" Link to this property "http\_request\_sanitize" Link to this property "http\_request\_sbfm" Link to this property "http\_request\_transform" Link to this property "http\_response\_cache\_settings" Link to this property "http\_response\_compression" Link to this property "http\_response\_firewall\_managed" Link to this property "http\_response\_headers\_transform" Link to this property "magic\_transit" Link to this property "magic\_transit\_ids\_managed" Link to this property "magic\_transit\_managed" Link to this property "magic\_transit\_ratelimit" Link to this property
Link to this property
products: Optional\[List\[Literal\["bic", "hot", "rateLimit", 4 more]]] A list of legacy security products to skip the execution of. One of the following: "bic" Link to this property "hot" Link to this property "rateLimit" Link to this property "securityLevel" Link to this property "uaBlock" Link to this property "waf" Link to this property "zoneLockdown" Link to this property
Link to this property rules: Optional\[Dict\[str, Sequence\[str]]] A mapping of ruleset IDs to a list of rule IDs in that ruleset to skip the execution of. This option is incompatible with the ruleset option. Link to this property ruleset: Optional\[Literal\["current"]] A ruleset to skip the execution of. This option is incompatible with the rulesets option. Link to this property rulesets: Optional\[Sequence\[str]] A list of ruleset IDs to skip the execution of. This option is incompatible with the ruleset and phases options. Link to this property
Link to this property categories: Optional\[Sequence\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property enabled: Optional\[bool] Link to this property
exposed\_credential\_check: Optional\[ExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property expression: Optional\[str] The expression defining which traffic will match the rule. minLength1 Link to this property logging: Optional\[LoggingParam] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[Ratelimit] An object configuring the rule’s rate limit behavior. characteristics: Sequence\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property ref: Optional\[str] The reference of the rule (the rule’s ID by default). minLength1 Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20skip_rule%20%3E%20(schema)>)
RuleCreateResponse A result. One of the following:
class Ruleset: … A ruleset object. id: str The unique ID of the ruleset. Link to this property kind: Kind The kind of the ruleset. Link to this property last\_updated: datetime The timestamp of when the ruleset was last modified. formatdate-time Link to this property name: str The human-readable name of the ruleset. minLength1 Link to this property phase: Phase The phase of the ruleset. Link to this property
rules: List\[RulesetRule] The list of rules in the ruleset. One of the following:
class RulesetRuleBlockRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleResponseCompressionRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleDDoSDynamicRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleExecuteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleForceConnectionCloseRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleJavaScriptChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["js\_challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleJavaScriptChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleJavaScriptChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleLogRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleLogCustomFieldRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleManagedChallengeRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRedirectRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRewriteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRouteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleScoreRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleServeErrorRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheControlRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_control"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheControlRuleActionParameters] The parameters configuring the rule’s action.
immutable: Optional\[RulesetRuleSetCacheControlRuleActionParametersImmutable] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersImmutableSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersImmutableRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
max\_age: Optional\[RulesetRuleSetCacheControlRuleActionParametersMaxAge] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_understand: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustUnderstand] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_cache: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoCache] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoCacheSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoCacheRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_store: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoStore] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoStoreSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoStoreRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_transform: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoTransform] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoTransformSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoTransformRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
private: Optional\[RulesetRuleSetCacheControlRuleActionParametersPrivate] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPrivateSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPrivateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
proxy\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersProxyRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
public: Optional\[RulesetRuleSetCacheControlRuleActionParametersPublic] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPublicSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPublicRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
s\_maxage: Optional\[RulesetRuleSetCacheControlRuleActionParametersSMaxage] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersSMaxageSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersSMaxageRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_if\_error: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleIfError] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_while\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidate] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheControlRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheControlRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheSettingsRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheTagsRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_tags"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheTagsRuleActionParameters] The parameters configuring the rule’s action. One of the following:
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsValues: … Add cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsExpression: … Add cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsValues: … Remove cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsExpression: … Remove cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsValues: … Set cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsExpression: … Set cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheTagsRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheTagsRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetConfigurationRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSkipRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleTransformResponseHTMLRule: … id: str The unique ID of the rule. Link to this property action: Literal\["transform\_response\_html"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleTransformResponseHTMLRuleActionParameters] The parameters configuring the rule’s action. link\_maze: object Enables the link maze transformation on the response. Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleTransformResponseHTMLRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleTransformResponseHTMLRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
Link to this property version: str The version of the ruleset. Link to this property description: Optional\[str] An informative description of the ruleset. Link to this property
Link to this property Optional\[object] Returned when dry\_run is true. Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20rule_create_response%20%3E%20(schema)>)
RuleEditResponse A result. One of the following:
class Ruleset: … A ruleset object. id: str The unique ID of the ruleset. Link to this property kind: Kind The kind of the ruleset. Link to this property last\_updated: datetime The timestamp of when the ruleset was last modified. formatdate-time Link to this property name: str The human-readable name of the ruleset. minLength1 Link to this property phase: Phase The phase of the ruleset. Link to this property
rules: List\[RulesetRule] The list of rules in the ruleset. One of the following:
class RulesetRuleBlockRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleResponseCompressionRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleDDoSDynamicRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleExecuteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleForceConnectionCloseRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleJavaScriptChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["js\_challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleJavaScriptChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleJavaScriptChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleLogRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleLogCustomFieldRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleManagedChallengeRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRedirectRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRewriteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRouteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleScoreRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleServeErrorRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheControlRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_control"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheControlRuleActionParameters] The parameters configuring the rule’s action.
immutable: Optional\[RulesetRuleSetCacheControlRuleActionParametersImmutable] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersImmutableSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersImmutableRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
max\_age: Optional\[RulesetRuleSetCacheControlRuleActionParametersMaxAge] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_understand: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustUnderstand] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_cache: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoCache] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoCacheSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoCacheRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_store: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoStore] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoStoreSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoStoreRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_transform: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoTransform] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoTransformSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoTransformRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
private: Optional\[RulesetRuleSetCacheControlRuleActionParametersPrivate] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPrivateSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPrivateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
proxy\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersProxyRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
public: Optional\[RulesetRuleSetCacheControlRuleActionParametersPublic] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPublicSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPublicRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
s\_maxage: Optional\[RulesetRuleSetCacheControlRuleActionParametersSMaxage] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersSMaxageSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersSMaxageRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_if\_error: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleIfError] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_while\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidate] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheControlRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheControlRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheSettingsRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheTagsRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_tags"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheTagsRuleActionParameters] The parameters configuring the rule’s action. One of the following:
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsValues: … Add cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsExpression: … Add cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsValues: … Remove cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsExpression: … Remove cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsValues: … Set cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsExpression: … Set cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheTagsRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheTagsRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetConfigurationRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSkipRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleTransformResponseHTMLRule: … id: str The unique ID of the rule. Link to this property action: Literal\["transform\_response\_html"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleTransformResponseHTMLRuleActionParameters] The parameters configuring the rule’s action. link\_maze: object Enables the link maze transformation on the response. Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleTransformResponseHTMLRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleTransformResponseHTMLRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
Link to this property version: str The version of the ruleset. Link to this property description: Optional\[str] An informative description of the ruleset. Link to this property
Link to this property Optional\[object] Returned when dry\_run is true. Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20rule_edit_response%20%3E%20(schema)>)
RuleDeleteResponse A result. One of the following:
class Ruleset: … A ruleset object. id: str The unique ID of the ruleset. Link to this property kind: Kind The kind of the ruleset. Link to this property last\_updated: datetime The timestamp of when the ruleset was last modified. formatdate-time Link to this property name: str The human-readable name of the ruleset. minLength1 Link to this property phase: Phase The phase of the ruleset. Link to this property
rules: List\[RulesetRule] The list of rules in the ruleset. One of the following:
class RulesetRuleBlockRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleResponseCompressionRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleDDoSDynamicRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleExecuteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleForceConnectionCloseRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleJavaScriptChallengeRule: … id: str The unique ID of the rule. Link to this property action: Literal\["js\_challenge"] The action to perform when the rule matches. Link to this property enabled: bool Whether the rule should be executed. Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property action\_parameters: Optional\[object] The parameters configuring the rule’s action. Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleJavaScriptChallengeRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleJavaScriptChallengeRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleLogRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleLogCustomFieldRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleManagedChallengeRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRedirectRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRewriteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleRouteRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleScoreRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleServeErrorRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheControlRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_control"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheControlRuleActionParameters] The parameters configuring the rule’s action.
immutable: Optional\[RulesetRuleSetCacheControlRuleActionParametersImmutable] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersImmutableSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersImmutableRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
max\_age: Optional\[RulesetRuleSetCacheControlRuleActionParametersMaxAge] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMaxAgeRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
must\_understand: Optional\[RulesetRuleSetCacheControlRuleActionParametersMustUnderstand] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersMustUnderstandRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_cache: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoCache] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoCacheSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoCacheRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_store: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoStore] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoStoreSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoStoreRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
no\_transform: Optional\[RulesetRuleSetCacheControlRuleActionParametersNoTransform] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersNoTransformSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersNoTransformRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
private: Optional\[RulesetRuleSetCacheControlRuleActionParametersPrivate] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPrivateSetDirective: … Set the directive with optional qualifiers.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property qualifiers: Optional\[List\[str]] Optional list of header names to qualify the directive (e.g., for “private” or “no-cache” directives). Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPrivateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
proxy\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersProxyRevalidate] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersProxyRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
public: Optional\[RulesetRuleSetCacheControlRuleActionParametersPublic] A cache-control directive configuration. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersPublicSetDirective: … Set the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersPublicRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
s\_maxage: Optional\[RulesetRuleSetCacheControlRuleActionParametersSMaxage] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersSMaxageSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersSMaxageRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_if\_error: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleIfError] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleIfErrorRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
stale\_while\_revalidate: Optional\[RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidate] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateSetDirective: … Set the directive with a duration value in seconds.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property value: int The duration value in seconds for the directive. minimum0 Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
class RulesetRuleSetCacheControlRuleActionParametersStaleWhileRevalidateRemoveDirective: … Remove the directive.
operation: Literal\["set", "remove"] The operation to perform on the cache-control directive. One of the following: "set" Link to this property "remove" Link to this property
Link to this property cloudflare\_only: Optional\[bool] Whether the directive should only be applied to the Cloudflare CDN cache. Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheControlRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheControlRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheSettingsRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSetCacheTagsRule: … id: str The unique ID of the rule. Link to this property action: Literal\["set\_cache\_tags"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleSetCacheTagsRuleActionParameters] The parameters configuring the rule’s action. One of the following:
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsValues: … Add cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersAddCacheTagsExpression: … Add cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsValues: … Remove cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersRemoveCacheTagsExpression: … Remove cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsValues: … Set cache tags using a list of values.
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property values: List\[str] A list of cache tag values. Link to this property
Link to this property
class RulesetRuleSetCacheTagsRuleActionParametersSetCacheTagsExpression: … Set cache tags using an expression. expression: str An expression that evaluates to an array of cache tag values. minLength1 Link to this property
operation: Literal\["add", "remove", "set"] The operation to perform on the cache tags. One of the following: "add" Link to this property "remove" Link to this property "set" Link to this property
Link to this property
Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleSetCacheTagsRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleSetCacheTagsRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
class RulesetRuleSetConfigurationRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleSkipRule: … id: str Link to this property action: str Link to this property enabled: bool Link to this property expression: str Link to this property ref: str Link to this property
Link to this property
class RulesetRuleTransformResponseHTMLRule: … id: str The unique ID of the rule. Link to this property action: Literal\["transform\_response\_html"] The action to perform when the rule matches. Link to this property enabled: bool Link to this property expression: str The expression defining which traffic will match the rule. minLength1 Link to this property last\_updated: datetime The timestamp of when the rule was last modified. formatdate-time Link to this property ref: str The reference of the rule (the rule’s ID by default). minLength1 Link to this property version: str The version of the rule. Link to this property
action\_parameters: Optional\[RulesetRuleTransformResponseHTMLRuleActionParameters] The parameters configuring the rule’s action. link\_maze: object Enables the link maze transformation on the response. Link to this property
Link to this property categories: Optional\[List\[str]] The categories of the rule. Link to this property description: Optional\[str] An informative description of the rule. Link to this property
exposed\_credential\_check: Optional\[RulesetRuleTransformResponseHTMLRuleExposedCredentialCheck] Configuration for exposed credential checking. password\_expression: str An expression that selects the password used in the credentials check. minLength1 Link to this property username\_expression: str An expression that selects the user ID used in the credentials check. minLength1 Link to this property
Link to this property logging: Optional\[Logging] An object configuring the rule’s logging behavior. Link to this property
ratelimit: Optional\[RulesetRuleTransformResponseHTMLRuleRatelimit] An object configuring the rule’s rate limit behavior. characteristics: List\[str] Characteristics of the request on which the rate limit counter will be incremented. Link to this property period: int Period in seconds over which the counter is being incremented. minimum0 Link to this property counting\_expression: Optional\[str] An expression that defines when the rate limit counter should be incremented. It defaults to the same as the rule’s expression. minLength1 Link to this property mitigation\_timeout: Optional\[int] Period of time in seconds after which the action will be disabled following its first execution. Link to this property requests\_per\_period: Optional\[int] The threshold of requests per period after which the action will be executed for the first time. minimum1 Link to this property requests\_to\_origin: Optional\[bool] Whether counting is only performed when an origin is reached. Link to this property score\_per\_period: Optional\[int] The score threshold per period for which the action will be executed the first time. Link to this property score\_response\_header\_name: Optional\[str] A response header name provided by the origin, which contains the score to increment rate limit counter with. minLength1 Link to this property
Link to this property
Link to this property
Link to this property version: str The version of the ruleset. Link to this property description: Optional\[str] An informative description of the ruleset. Link to this property
Link to this property Optional\[object] Returned when dry\_run is true. Link to this property
[Link to this property](<#(resource)%20rulesets.rules%20%3E%20(model)%20rule_delete_response%20%3E%20(schema)>)