リクエストルール要素。 1 つ以上のルールがオプションで <ruleset>
要素。
OnMatch = "break" | "continue" | "error"
: オプション. 初期設定は「break」です。
Replace = "first" | "all"
: オプション. デフォルトは「first」です。
RequestType
= "types
":オプション。 ルールを適用する入力コンテキストを指定します。 types
はコンマ区切りのリストで、次の表に示す 1 つ以上のトークンを含めることができます。 If RequestType
が指定されていない場合、ルールはサポートされているすべてのコンテキストで受信したリクエストに適用されます。
トークン |
コンテキスト |
説明 |
---|---|---|
is |
/is/image/ |
画像サービング要求に適用 |
ir |
/ir/render/ |
画像レンダリング要求に適用 |
静的 |
/is/content/ |
静的コンテンツリクエストに適用済み |
Name = "text"
: オプション. を識別するために使用されます。 <rule>
デバッグログとエラーメッセージの要素
*
属性* ="value"
:オプション。 <rule>
要素は、任意の組み合わせで次の属性を定義できます。 指定した場合、ルールが正しく一致すると、このリクエストに対応するカタログ属性が上書きされます。 初期設定は RequestType="is"
.
属性 | 対応する画像カタログ属性 |
---|---|
DefaultImageMode |
|
ErrorImage |
|
有効期限 |
|
MaxPix |
|
RequestLock |
|
RequestObfuscation |
|
RootUrl |
|
SavePath |
|
ウォーターマーク |
詳しくは、対応する画像カタログ属性の説明を参照してください。
有効期限属性は、デフォルトの属性値のみを上書きします。 このオーバーライドは、 catalog::Expiration
の値がリクエストに適用されます。
<expression> |
オプション |
<substitution> |
オプション |
<addressfilter> |
オプション |
<ヘッダ> |
オプション |
両方の <expression>
および <substitution>
が指定され、取り込まれた部分文字列は使用されません。最初の一致した部分文字列は、 <substitution>
.
If <expression>
が指定されていない場合、パスは <substitution>
はパスの末尾に追加されます。
If <substitution>
が指定されていない場合、パスやクエリの変換は行われませんが、指定されたカタログ属性は上書きされます。 If <substitution>
が空の場合、一致した部分文字列は削除されます。
この <addressfilter>
は、一致が発生した場合、およびクエリルールが適用される前にのみ適用されます。