Skip to content

Commit 72b86db

Browse files
committed
updated
1 parent 118ac2e commit 72b86db

File tree

1 file changed

+41
-41
lines changed

1 file changed

+41
-41
lines changed

articles/cdn/cdn-verizon-premium-rules-engine-reference.md

Lines changed: 41 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -22,47 +22,6 @@ The rules engine is designed to be the final authority on how specific types of
2222
- Secure or deny requests for sensitive content.
2323
- Redirect requests.
2424
- Store custom log data.
25-
26-
## Syntax
27-
28-
The manner in which special characters are treated varies according to how a match condition or feature handles text values. A match condition or feature may interpret text in one of the following ways:
29-
30-
- [**Literal values**](#literal-values)
31-
- [**Wildcard values**](#wildcard-values)
32-
- [**Regular expressions**](#regular-expressions)
33-
34-
### Literal values
35-
36-
Text that is interpreted as a literal value treats all special characters, with the exception of the % symbol, as a part of the value that must be matched. In other words, a literal match condition set to `\'*'\` is only satisfied when that exact value (that is, `\'*'\`) is found.
37-
38-
A percentage symbol is used to indicate URL encoding (for example, `%20`).
39-
40-
### Wildcard values
41-
42-
Text that is interpreted as a wildcard value assigns additional meaning to special characters. The following table describes how the following set of characters is interpreted:
43-
44-
Character | Description
45-
----------|------------
46-
\ | A backslash is used to escape any of the characters specified in this table. A backslash must be specified directly before the special character that should be escaped.<br/>For example, the following syntax escapes an asterisk: `\*`
47-
% | A percentage symbol is used to indicate URL encoding (for example, `%20`).
48-
\* | An asterisk is a wildcard that represents one or more characters.
49-
Space | A space character indicates that a match condition may be satisfied by either of the specified values or patterns.
50-
'value' | A single quote does not have special meaning. However, a set of single quotes is used to indicate that a value should be treated as a literal value. It can be used in the following ways:<br><br/>- It allows a match condition to be satisfied whenever the specified value matches any portion of the comparison value. For example, `'ma'` would match any of the following strings: <br/><br/>/business/**ma**rathon/asset.htm<br/>**ma**p.gif<br/>/business/template.**ma**p<br /><br />- It allows a special character to be specified as a literal character. For example, you may specify a literal space character by enclosing a space character within a set of single quotes (that is, `' '` or `'sample value'`).<br/>- It allows a blank value to be specified. Specify a blank value by specifying a set of single quotes (that is, '').<br /><br/>**Important:**<br/>- If the specified value does not contain a wildcard, then it is automatically considered a literal value, which means that it is not necessary to specify a set of single quotes.<br/>- If a backslash does not escape another character in this table, it is ignored when it is specified within a set of single quotes.<br/>- Another way to specify a special character as a literal character is to escape it using a backslash (that is, `\`).
51-
52-
### Regular expressions
53-
54-
Regular expressions define a pattern that is searched for within a text value. Regular expression notation defines specific meanings to a variety of symbols. The following table indicates how special characters are treated by match conditions and features that support regular expressions.
55-
56-
Special Character | Description
57-
------------------|------------
58-
\ | A backslash escapes the character the follows it, which causes that character to be treated as a literal value instead of taking on its regular expression meaning. For example, the following syntax escapes an asterisk: `\*`
59-
% | The meaning of a percentage symbol depends on its usage.<br/><br/> `%{HTTPVariable}`: This syntax identifies an HTTP variable.<br/>`%{HTTPVariable%Pattern}`: This syntax uses a percentage symbol to identify an HTTP variable and as a delimiter.<br />`\%`: Escaping a percentage symbol allows it to be used as a literal value or to indicate URL encoding (for example, `\%20`).
60-
\* | An asterisk allows the preceding character to be matched zero or more times.
61-
Space | A space character is typically treated as a literal character.
62-
'value' | Single quotes are treated as literal characters. A set of single quotes does not have special meaning.
63-
64-
Match conditions and features that support regular expressions accept patterns defined by Perl Compatible Regular Expressions (PCRE).
65-
6625
## Key concepts
6726
Key concepts for setting up Rules Engine are described below.
6827
### Draft
@@ -112,6 +71,47 @@ The workflow through which a policy may be applied to either the Production or S
11271
|Deploy Request Review | <br>A deploy request undergoes automated validation and error detection.</br><br>Although the majority of deploy requests are automatically approved, manual review is required for more complex policies.</br> |
11372
|Policy Deployment ([Staging](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Staging)) | <br> Upon approval of a deploy request to the Staging environment, a policy will be applied to the Staging environment. This environment allows a policy to be tested against mock site traffic.</br><br>Once the policy is ready to be applied to live site traffic, a new deploy request for the Production environment should be submitted.</br> |
11473
|Policy Deployment ([Production](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Producti)) | Upon approval of a deploy request to the Production environment, a policy will be applied to the Production environment. This environment allows a policy to act as the final authority for determining how the CDN should handle live traffic. |
74+
## Syntax
75+
76+
The manner in which special characters are treated varies according to how a match condition or feature handles text values. A match condition or feature may interpret text in one of the following ways:
77+
78+
- [**Literal values**](#literal-values)
79+
- [**Wildcard values**](#wildcard-values)
80+
- [**Regular expressions**](#regular-expressions)
81+
82+
### Literal values
83+
84+
Text that is interpreted as a literal value treats all special characters, with the exception of the % symbol, as a part of the value that must be matched. In other words, a literal match condition set to `\'*'\` is only satisfied when that exact value (that is, `\'*'\`) is found.
85+
86+
A percentage symbol is used to indicate URL encoding (for example, `%20`).
87+
88+
### Wildcard values
89+
90+
Text that is interpreted as a wildcard value assigns additional meaning to special characters. The following table describes how the following set of characters is interpreted:
91+
92+
Character | Description
93+
----------|------------
94+
\ | A backslash is used to escape any of the characters specified in this table. A backslash must be specified directly before the special character that should be escaped.<br/>For example, the following syntax escapes an asterisk: `\*`
95+
% | A percentage symbol is used to indicate URL encoding (for example, `%20`).
96+
\* | An asterisk is a wildcard that represents one or more characters.
97+
Space | A space character indicates that a match condition may be satisfied by either of the specified values or patterns.
98+
'value' | A single quote does not have special meaning. However, a set of single quotes is used to indicate that a value should be treated as a literal value. It can be used in the following ways:<br><br/>- It allows a match condition to be satisfied whenever the specified value matches any portion of the comparison value. For example, `'ma'` would match any of the following strings: <br/><br/>/business/**ma**rathon/asset.htm<br/>**ma**p.gif<br/>/business/template.**ma**p<br /><br />- It allows a special character to be specified as a literal character. For example, you may specify a literal space character by enclosing a space character within a set of single quotes (that is, `' '` or `'sample value'`).<br/>- It allows a blank value to be specified. Specify a blank value by specifying a set of single quotes (that is, '').<br /><br/>**Important:**<br/>- If the specified value does not contain a wildcard, then it is automatically considered a literal value, which means that it is not necessary to specify a set of single quotes.<br/>- If a backslash does not escape another character in this table, it is ignored when it is specified within a set of single quotes.<br/>- Another way to specify a special character as a literal character is to escape it using a backslash (that is, `\`).
99+
100+
### Regular expressions
101+
102+
Regular expressions define a pattern that is searched for within a text value. Regular expression notation defines specific meanings to a variety of symbols. The following table indicates how special characters are treated by match conditions and features that support regular expressions.
103+
104+
Special Character | Description
105+
------------------|------------
106+
\ | A backslash escapes the character the follows it, which causes that character to be treated as a literal value instead of taking on its regular expression meaning. For example, the following syntax escapes an asterisk: `\*`
107+
% | The meaning of a percentage symbol depends on its usage.<br/><br/> `%{HTTPVariable}`: This syntax identifies an HTTP variable.<br/>`%{HTTPVariable%Pattern}`: This syntax uses a percentage symbol to identify an HTTP variable and as a delimiter.<br />`\%`: Escaping a percentage symbol allows it to be used as a literal value or to indicate URL encoding (for example, `\%20`).
108+
\* | An asterisk allows the preceding character to be matched zero or more times.
109+
Space | A space character is typically treated as a literal character.
110+
'value' | Single quotes are treated as literal characters. A set of single quotes does not have special meaning.
111+
112+
Match conditions and features that support regular expressions accept patterns defined by Perl Compatible Regular Expressions (PCRE).
113+
114+
115115

116116
## Next steps
117117

0 commit comments

Comments
 (0)