要求規則元素。 一或多個規則是選用的, <ruleset>
元素。
OnMatch = "break" | "continue" | "error"
: 選擇性. 預設值為「break」。
Replace = "first" | "all"
: 選擇性. 預設值為「first」。
RequestType
= "types
":選擇性。 指定套用規則的輸入內容。 types
是以逗號分隔的清單,可能包含下表所列的一或多個代號。 若 RequestType
未指定,則規則會套用至在所有支援的內容上收到的請求。
代號 |
內容 |
說明 |
---|---|---|
是 |
/is/image/ |
套用至影像伺服請求 |
ir |
/ir/render/ |
已套用至影像演算要求 |
靜態 |
/is/content/ |
套用至靜態內容請求 |
Name = "text"
: 選擇性. 用於識別 <rule>
偵錯記錄檔和錯誤訊息中的元素。
*
屬性* ="value"
:選擇性。 <rule>
元素可以任意組合來定義下列任何屬性。 如果已指定,且規則已成功比對,則將覆寫此請求的對應目錄屬性。 預設為 RequestType="is"
.
屬性 | 對應的影像目錄屬性 |
---|---|
預設影像模式 |
|
ErrorImage |
|
過期 |
|
MaxPix |
|
RequestLock |
|
要求模糊化 |
|
RootUrl |
|
儲存路徑 |
|
水印 |
如需詳細資訊,請參閱對應影像目錄屬性的說明。
到期屬性只會覆寫預設屬性值。 如果特定的 catalog::Expiration
值會套用至要求。
<expression> |
選擇性 |
<substitution> |
選擇性 |
<addressfilter> |
選擇性 |
<header> |
選擇性 |
若兩者皆有 <expression>
和 <substitution>
中指定的子字串,且不會使用擷取的子字串,則第一個相符的子字串會取代為 <substitution>
.
若 <expression>
未指定,任何路徑皆符合和 <substitution>
會附加至路徑的結尾。
若 <substitution>
未指定,不會發生路徑或查詢轉換,但會覆寫任何指定的目錄屬性。 若 <substitution>
空白,則會移除相符的子字串。
此 <addressfilter>
只會在符合發生時套用,並在套用查詢規則之前套用。