HTTPRequestRule

HTTPRequestRule
HTTPRequestRule
JSON Example
{
    "all_headers": false,
    "enable": false,
    "hdr_action": [
        {
            "action": "string",
            "cookie": {
                "name": "string",
                "value": "string"
            },
            "hdr": {
                "name": "string",
                "value": {
                    "is_sensitive": false,
                    "val": "string",
                    "var": "string"
                }
            },
            "hdr_index": 0
        }
    ],
    "index": 0,
    "log": false,
    "match": {
        "bot_detection_result": {
            "classifications": [
                {
                    "type": "string",
                    "user_defined_type": "string"
                }
            ],
            "match_operation": "string"
        },
        "client_ip": {
            "addrs": [
                {
                    "addr": "string",
                    "type": "string"
                }
            ],
            "group_refs": [
                "string"
            ],
            "match_criteria": "string",
            "prefixes": [
                {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                }
            ],
            "ranges": [
                {
                    "begin": {
                        "addr": "string",
                        "type": "string"
                    },
                    "end": {
                        "addr": "string",
                        "type": "string"
                    }
                }
            ]
        },
        "cookie": {
            "match_case": "string",
            "match_criteria": "string",
            "name": "string",
            "value": "string"
        },
        "geo_matches": [
            {
                "attribute": "string",
                "match_operation": "string",
                "values": [
                    "string"
                ]
            }
        ],
        "hdrs": [
            {
                "hdr": "string",
                "match_case": "string",
                "match_criteria": "string",
                "string_group_refs": [
                    "string"
                ],
                "value": [
                    "string"
                ]
            }
        ],
        "host_hdr": {
            "match_case": "string",
            "match_criteria": "string",
            "value": [
                "string"
            ]
        },
        "ip_reputation_type": {
            "match_operation": "string",
            "reputation_types": [
                "string"
            ]
        },
        "method": {
            "match_criteria": "string",
            "methods": [
                "string"
            ]
        },
        "path": {
            "match_case": "string",
            "match_criteria": "string",
            "match_decoded_string": false,
            "match_str": [
                "string"
            ],
            "string_group_refs": [
                "string"
            ]
        },
        "protocol": {
            "match_criteria": "string",
            "protocols": "string"
        },
        "query": {
            "match_case": "string",
            "match_criteria": "string",
            "match_decoded_string": false,
            "match_str": [
                "string"
            ],
            "string_group_refs": [
                "string"
            ]
        },
        "source_ip": {
            "addrs": [
                {
                    "addr": "string",
                    "type": "string"
                }
            ],
            "group_refs": [
                "string"
            ],
            "match_criteria": "string",
            "prefixes": [
                {
                    "ip_addr": {
                        "addr": "string",
                        "type": "string"
                    },
                    "mask": 0
                }
            ],
            "ranges": [
                {
                    "begin": {
                        "addr": "string",
                        "type": "string"
                    },
                    "end": {
                        "addr": "string",
                        "type": "string"
                    }
                }
            ]
        },
        "tls_fingerprint_match": {
            "fingerprints": [
                "string"
            ],
            "match_operation": "string",
            "string_group_refs": [
                "string"
            ]
        },
        "version": {
            "match_criteria": "string",
            "versions": [
                "string"
            ]
        },
        "vs_port": {
            "match_criteria": "string",
            "ports": [
                0
            ]
        }
    },
    "name": "string",
    "redirect_action": {
        "add_string": "string",
        "host": {
            "tokens": [
                {
                    "end_index": 0,
                    "start_index": 0,
                    "str_value": "string",
                    "type": "string"
                }
            ],
            "type": "string"
        },
        "keep_query": false,
        "path": {
            "tokens": [
                {
                    "end_index": 0,
                    "start_index": 0,
                    "str_value": "string",
                    "type": "string"
                }
            ],
            "type": "string"
        },
        "port": 0,
        "protocol": "string",
        "status_code": "string"
    },
    "rewrite_url_action": {
        "host_hdr": {
            "tokens": [
                {
                    "end_index": 0,
                    "start_index": 0,
                    "str_value": "string",
                    "type": "string"
                }
            ],
            "type": "string"
        },
        "path": {
            "tokens": [
                {
                    "end_index": 0,
                    "start_index": 0,
                    "str_value": "string",
                    "type": "string"
                }
            ],
            "type": "string"
        },
        "query": {
            "add_string": "string",
            "keep_query": false
        }
    },
    "switching_action": {
        "action": "string",
        "file": {
            "content_type": "string",
            "file_content": "string",
            "file_length": 0
        },
        "other_status_code": 0,
        "pool_group_ref": "string",
        "pool_ref": "string",
        "server": {
            "hostname": "string",
            "ip": {
                "addr": "string",
                "type": "string"
            },
            "port": 0
        },
        "status_code": "string"
    }
}
boolean
all_headers
Optional

Log all HTTP headers upon rule match. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.

boolean
enable
Required
Constraints: default: true

Enable or disable the rule. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

hdr_action
Optional

HTTP header rewrite action. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

integer As int32 As int32
index
Required

Index of the rule. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
log
Optional

Log HTTP request upon rule match. Allowed with any value in Enterprise, Enterprise with Cloud Services edition.

match
Optional

match

string
name
Required

Name of the rule. Allowed with any value in Enterprise, Essentials, Basic, Enterprise with Cloud Services edition.

redirect_action
Optional

redirect_action

rewrite_url_action
Optional

rewrite_url_action

switching_action
Optional

switching_action