Update Cache Rules

PUT

https://api.cloudflare.com/client/v4/zones/{zone_id}/rulesets/phases/http_request_cache_settings/entrypoint

Last modified:2022-12-16 13:48:32

Updates the Cache Rules of a zone.

Request

Path Params

zone_id

string

required

Body Params application/json

A ruleset object.

description

string

optional

An informative description of the ruleset.

Default:

Example:

My ruleset to execute managed rulesets

rules

array [anyOf]

required

The list of rules in the ruleset.

object (create_update_rule)

optional

A rule object.

optional

The unique ID of a rule.

Example

{
    "description": "My ruleset to execute managed rulesets",
    "rules": [
        {
            "action": "execute",
            "action_parameters": {
                "id": "4814384a9e5d4991b9815dcfc25d2f1f"
            },
            "description": "Execute the OWASP ruleset when the IP address is not 1.1.1.1",
            "enabled": true,
            "expression": "ip.src ne 1.1.1.1",
            "logging": {
                "enabled": true
            },
            "ref": "my_ref"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.cloudflare.com/client/v4/zones//rulesets/phases/http_request_cache_settings/entrypoint' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "My ruleset to execute managed rulesets",
    "rules": [
        {
            "action": "execute",
            "action_parameters": {
                "id": "4814384a9e5d4991b9815dcfc25d2f1f"
            },
            "description": "Execute the OWASP ruleset when the IP address is not 1.1.1.1",
            "enabled": true,
            "expression": "ip.src ne 1.1.1.1",
            "logging": {
                "enabled": true
            },
            "ref": "my_ref"
        }
    ]
}'

Responses

🟢200Update Cache Rules response

application/json

Body

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

result

required

Any of

allOf {2}

One of

null

object

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

Example

{
    "errors": [],
    "messages": [],
    "result": {},
    "success": true
}

🟢200Update Cache Rules response failure

Modified at 2022-12-16 13:48:32

List Cache Rules

List Certificate Packs