Rule syntax

When you upload Cloudlets rules using a CSV file, you use a special syntax. This syntax is also in the CSV rule you receive when you download rules.

Valid delimiter

When entering multiple values for a data type, use a space as a delimiter.

Literal usage of spaces

If you want to use a space in your CSV file, you need to type a backslash (\) first. For example, to upload a rule named “Q1 Sales Site”, you would enter it this way: Q1\ Sales\ Site.

Basic CSV file syntax

Category Usage Examples
Pattern Matching
Case Sensitivity : <value1> <value2>
Note: Applies to match type values, not the whole rule.
ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, https://example.com, :product=ER VP, https://cloudlets.com, 302
Wildcards * or ? ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, https://example.com, product=E* FR, https://cloudlets.com, 302
Operators
Is one of (equals) <value1> <value2>... ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, http://example.com, product=ER FR, http://example2.com, 302
Is not one of (does not equal) !<value1> <value2>…
Note: Applies to match type values, not the whole rule.
ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, http://example.com, !product=ER FR, http://example2.com, 302
Contains any of *<value1>* *<value2>*…
Note: Applies to match type values, not the whole rule.
ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, http://example.com, product=*ER* *FR*, http://example2.com, 302
Does not Contain any of !*<value1>* *<value2>*…
Note: Applies to match type values, not the whole rule.
ruleName,matchURL,query,result.redirectURL,result.statusCode rule 1, http://example.com, !product=*ER* *FR*, http://example2.com, 302
And <value1> & <value2>…
Important: Only applies to these match types: cookie, extension, header, hostname, path, and query.