規則

要求規則元素。 <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".

屬性

對應的影像目錄屬性

DefaultImageMode

屬性::DefaultImageMode

ErrorImage

屬性::ErrorImage

過期

屬性::過期

MaxPix

屬性::MaxPix

RequestLock

屬性::RequestLock

RequestObfuscation

屬性::RequestObfuscation

RootUrl

屬性::RootUrl

SavePath

屬性::SavePath

水標籤

屬性::WaterMark

如需詳細資訊,請參閱對應影像目錄屬性的說明。

過期屬性只會覆寫預設屬性值。 如果特定catalog::Expiration值套用至請求,則會忽略覆寫。

資料

<expression>

選擇性

<substitution>

選擇性

<addressfilter>

選擇性

<header>

選擇性

附註

如果同時指定了<expression><substitution>,並且未使用捕獲的子字串,則第一個匹配的子字串將替換為<substitution>

如果未指定<expression>,則任何路徑都匹配,並且<substitution>將附加到路徑的結尾。

如果未指定<substitution>,則不會發生路徑或查詢轉換,但會覆蓋任何指定的目錄屬性。 如果<substitution>為空,則會移除相符的子字串。

<addressfilter>僅在發生匹配時應用,並在應用查詢規則之前應用。

本頁內容