Function Compute:書き換えポリシーの設定 (パブリックレビュー)

パターンの書き換え

Function Computeでは、ルートレベルでカスタムドメイン名の書き換えポリシーを設定でき、完全書き換え、ワイルドカード書き換え、正規表現書き換えの書き換えパターンをサポートしています。

正確な書き換え

厳密な書き換えパターンとは、要求内のpathパラメータが一致ルールと完全に一致する場合、path文字列が置換ルール内の文字列に置き換えられることを意味します。 たとえば、一致するルールに文字列 /oldが含まれ、置換ルールに文字列 /newが含まれている場合、リクエストの /oldは書き換えられ、/newに置き換えられます。 次の表は、特定の置換ルールに基づく一致例を示しています。

ワイルドカードの書き直し

ワイルドカード書き換えパターンは、ほとんどのシナリオに適用できる単純なマッチング方法を提供します。

ワイルドカードパターンを使用するには、アスタリスクのワイルドカード文字 (*) を使用して文字列を照合します。 一致した文字列は、ワイルドカード文字の位置に基づいて置換ルールで参照できます。 たとえば、一致するルールが /api/* で、置換ルールが /$1の場合、リクエスト内の一致した文字列 /api/getFunctionNameは書き換えられ、/getFunctionNameに置き換えられます。 次の表は、特定の置換ルールに基づく一致例を示しています。

正規表現の書き直し

正規表現の書き換えパターンでは、照合ルールと置換ルールは標準の正規表現に準拠しています。 正規表現の構文については、「RE2正規表現構文」をご参照ください。 次の表に、正規表現書き込みパターンを使用する一致例を示します。

順序と優先度の一致

3つの書き換えパターンの優先度は、exact rewrite、wildcard rewrite、regex rewriteの順に並べられています。

Function Computeでは、ルーティングルールで複数の書き換えポリシーを設定できます。 要求は、複数の書き換えポリシーに一致させることができる。 リクエストが書き換えパターン内の複数の書き換えポリシーと一致する場合、Function Computeは、ポリシーを作成した時点に基づいて、リクエストをポリシーと照合します。 リクエストが最初にポリシーと一致すると、一致が停止し、リクエスト内の文字列が書き換えられて置き換えられます。

var rule1 = &WildcardRules{
    Match:       "/api/v1/*",
    Replacement: "/api/v2/$1",
}

var rule2 = &WildcardRules{
    Match:       "/api/*/*",
    Replacement: "/api/v3/$2",
}

• 書き換えポリシー [rule1, rule2] がユーザーに設定されている場合、リクエスト内の文字列 /api/v1/getFunctionNameが書き換えられ、/api/v2/getFunctionNameに置き換えられます。

• 書き換えポリシー [rule2, rule1] がユーザーに設定されている場合、リクエスト内の文字列 /api/v1/getFunctionNameが書き換えられ、/api/v3/getFunctionNameに置き換えられます。

前提条件

関数が作成されます。 詳細については、「関数の管理」トピックの「関数の作成」セクションをご参照ください。

手順

カスタムドメイン名を作成するときに、書き換えポリシーを設定できます。 既存のカスタムドメイン名の書き換えポリシーを設定することもできます。