--- title: Phases --- [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** # Phases ##### [Get an account or zone entry point ruleset](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/phases/methods/get) rulesets.phases.get([Phase]()ruleset\_phase, PhaseGetParams\*\*kwargs) -> [PhaseGetResponse]() GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/phases/{ruleset\_phase}/entrypoint ##### [Update an account or zone entry point ruleset](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/phases/methods/update) rulesets.phases.update([Phase]()ruleset\_phase, PhaseUpdateParams\*\*kwargs) -> [PhaseUpdateResponse]() PUT/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/phases/{ruleset\_phase}/entrypoint ##### ModelsExpand Collapse
class PhaseGetResponse: … 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\[Rule] The list of rules in the ruleset. One of the following:
class RuleBlockRule: … 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 RuleChallengeRule: … 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\[RuleChallengeRuleExposedCredentialCheck] 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\[RuleChallengeRuleRatelimit] 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 RuleResponseCompressionRule: … 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 RuleDDoSDynamicRule: … 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 RuleExecuteRule: … 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 RuleForceConnectionCloseRule: … 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 RuleJavaScriptChallengeRule: … 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\[RuleJavaScriptChallengeRuleExposedCredentialCheck] 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\[RuleJavaScriptChallengeRuleRatelimit] 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 RuleLogRule: … 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 RuleLogCustomFieldRule: … 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 RuleManagedChallengeRule: … 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 RuleRedirectRule: … 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 RuleRewriteRule: … 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 RuleRouteRule: … 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 RuleScoreRule: … 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 RuleServeErrorRule: … 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 RuleSetCacheControlRule: … 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\[RuleSetCacheControlRuleActionParameters] The parameters configuring the rule’s action.
immutable: Optional\[RuleSetCacheControlRuleActionParametersImmutable] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersImmutableSetDirective: … 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 RuleSetCacheControlRuleActionParametersImmutableRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMaxAge] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersMaxAgeSetDirective: … 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 RuleSetCacheControlRuleActionParametersMaxAgeRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMustRevalidate] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersMustRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersMustRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMustUnderstand] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersMustUnderstandSetDirective: … 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 RuleSetCacheControlRuleActionParametersMustUnderstandRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoCache] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RuleSetCacheControlRuleActionParametersNoCacheSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoCacheRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoStore] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersNoStoreSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoStoreRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoTransform] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersNoTransformSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoTransformRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersPrivate] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RuleSetCacheControlRuleActionParametersPrivateSetDirective: … 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 RuleSetCacheControlRuleActionParametersPrivateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersProxyRevalidate] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersProxyRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersProxyRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersPublic] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersPublicSetDirective: … 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 RuleSetCacheControlRuleActionParametersPublicRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersSMaxage] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersSMaxageSetDirective: … 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 RuleSetCacheControlRuleActionParametersSMaxageRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersStaleIfError] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersStaleIfErrorSetDirective: … 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 RuleSetCacheControlRuleActionParametersStaleIfErrorRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersStaleWhileRevalidate] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersStaleWhileRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersStaleWhileRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleExposedCredentialCheck] 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\[RuleSetCacheControlRuleRatelimit] 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 RuleSetCacheSettingsRule: … 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 RuleSetCacheTagsRule: … 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\[RuleSetCacheTagsRuleActionParameters] The parameters configuring the rule’s action. One of the following:
class RuleSetCacheTagsRuleActionParametersAddCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersAddCacheTagsExpression: … 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 RuleSetCacheTagsRuleActionParametersRemoveCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersRemoveCacheTagsExpression: … 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 RuleSetCacheTagsRuleActionParametersSetCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersSetCacheTagsExpression: … 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\[RuleSetCacheTagsRuleExposedCredentialCheck] 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\[RuleSetCacheTagsRuleRatelimit] 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 RuleSetConfigurationRule: … 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 RuleSkipRule: … 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 RuleTransformResponseHTMLRule: … 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\[RuleTransformResponseHTMLRuleActionParameters] 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\[RuleTransformResponseHTMLRuleExposedCredentialCheck] 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\[RuleTransformResponseHTMLRuleRatelimit] 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](<#(resource)%20rulesets.phases%20%3E%20(model)%20phase_get_response%20%3E%20(schema)>)
PhaseUpdateResponse 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.phases%20%3E%20(model)%20phase_update_response%20%3E%20(schema)>) #### PhasesVersions ##### [List an account or zone entry point ruleset's versions](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/phases/subresources/versions/methods/list) rulesets.phases.versions.list([Phase]()ruleset\_phase, VersionListParams\*\*kwargs) -> SyncSinglePage\[[VersionListResponse]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/phases/{ruleset\_phase}/entrypoint/versions ##### [Get an account or zone entry point ruleset version](https://developers.cloudflare.com/api/python/resources/rulesets/subresources/phases/subresources/versions/methods/get) rulesets.phases.versions.get(strruleset\_version, VersionGetParams\*\*kwargs) -> [VersionGetResponse]() GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/rulesets/phases/{ruleset\_phase}/entrypoint/versions/{ruleset\_version} ##### ModelsExpand Collapse
class VersionListResponse: … 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 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](<#(resource)%20rulesets.phases.versions%20%3E%20(model)%20version_list_response%20%3E%20(schema)>)
class VersionGetResponse: … 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\[Rule] The list of rules in the ruleset. One of the following:
class RuleBlockRule: … 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 RuleChallengeRule: … 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\[RuleChallengeRuleExposedCredentialCheck] 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\[RuleChallengeRuleRatelimit] 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 RuleResponseCompressionRule: … 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 RuleDDoSDynamicRule: … 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 RuleExecuteRule: … 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 RuleForceConnectionCloseRule: … 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 RuleJavaScriptChallengeRule: … 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\[RuleJavaScriptChallengeRuleExposedCredentialCheck] 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\[RuleJavaScriptChallengeRuleRatelimit] 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 RuleLogRule: … 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 RuleLogCustomFieldRule: … 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 RuleManagedChallengeRule: … 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 RuleRedirectRule: … 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 RuleRewriteRule: … 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 RuleRouteRule: … 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 RuleScoreRule: … 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 RuleServeErrorRule: … 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 RuleSetCacheControlRule: … 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\[RuleSetCacheControlRuleActionParameters] The parameters configuring the rule’s action.
immutable: Optional\[RuleSetCacheControlRuleActionParametersImmutable] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersImmutableSetDirective: … 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 RuleSetCacheControlRuleActionParametersImmutableRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMaxAge] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersMaxAgeSetDirective: … 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 RuleSetCacheControlRuleActionParametersMaxAgeRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMustRevalidate] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersMustRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersMustRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersMustUnderstand] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersMustUnderstandSetDirective: … 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 RuleSetCacheControlRuleActionParametersMustUnderstandRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoCache] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RuleSetCacheControlRuleActionParametersNoCacheSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoCacheRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoStore] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersNoStoreSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoStoreRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersNoTransform] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersNoTransformSetDirective: … 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 RuleSetCacheControlRuleActionParametersNoTransformRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersPrivate] A cache-control directive configuration that accepts optional qualifiers (header names). One of the following:
class RuleSetCacheControlRuleActionParametersPrivateSetDirective: … 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 RuleSetCacheControlRuleActionParametersPrivateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersProxyRevalidate] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersProxyRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersProxyRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersPublic] A cache-control directive configuration. One of the following:
class RuleSetCacheControlRuleActionParametersPublicSetDirective: … 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 RuleSetCacheControlRuleActionParametersPublicRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersSMaxage] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersSMaxageSetDirective: … 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 RuleSetCacheControlRuleActionParametersSMaxageRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersStaleIfError] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersStaleIfErrorSetDirective: … 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 RuleSetCacheControlRuleActionParametersStaleIfErrorRemoveDirective: … 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\[RuleSetCacheControlRuleActionParametersStaleWhileRevalidate] A cache-control directive configuration that accepts a duration value in seconds. One of the following:
class RuleSetCacheControlRuleActionParametersStaleWhileRevalidateSetDirective: … 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 RuleSetCacheControlRuleActionParametersStaleWhileRevalidateRemoveDirective: … 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\[RuleSetCacheControlRuleExposedCredentialCheck] 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\[RuleSetCacheControlRuleRatelimit] 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 RuleSetCacheSettingsRule: … 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 RuleSetCacheTagsRule: … 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\[RuleSetCacheTagsRuleActionParameters] The parameters configuring the rule’s action. One of the following:
class RuleSetCacheTagsRuleActionParametersAddCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersAddCacheTagsExpression: … 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 RuleSetCacheTagsRuleActionParametersRemoveCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersRemoveCacheTagsExpression: … 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 RuleSetCacheTagsRuleActionParametersSetCacheTagsValues: … 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 RuleSetCacheTagsRuleActionParametersSetCacheTagsExpression: … 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\[RuleSetCacheTagsRuleExposedCredentialCheck] 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\[RuleSetCacheTagsRuleRatelimit] 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 RuleSetConfigurationRule: … 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 RuleSkipRule: … 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 RuleTransformResponseHTMLRule: … 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\[RuleTransformResponseHTMLRuleActionParameters] 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\[RuleTransformResponseHTMLRuleExposedCredentialCheck] 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\[RuleTransformResponseHTMLRuleRatelimit] 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](<#(resource)%20rulesets.phases.versions%20%3E%20(model)%20version_get_response%20%3E%20(schema)>)