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

書き換え方法

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

正確な書き換え

正確な書き換え方法では、リクエストのURIのpathパラメーターの値を置換ルールの文字列に置き換えることができるのは、pathパラメーターの値が一致するルールの文字列と完全に一致する場合のみです。 たとえば、一致するルールが /oldで、置換ルールが /newの場合、URI /oldはリクエスト内の /newに書き換えられます。 次の表は、完全書き換え方法を使用した照合の例を示しています。

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

ワイルドカード書き換えメソッドは、ほとんどのビジネス要件を満たすことができる単純なマッチングメソッドを提供します。

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

正規表現の書き直し

正規表現の書き換え方法では、一致ルールと置換ルールは標準の正規表現を使用します。 正規表現構文の詳細については、「RE2正規表現構文」をご参照ください。 次の表に、regex writeメソッドを使用したマッチングの例を示します。

順序と優先度の一致

ルーティングルールでポリシーの書き換えに前述のすべての方法を使用すると、リクエストは次の順序でポリシーと一致します。ポリシーは厳密な書き換え方法を使用し、ポリシーはワイルドカード書き換え方法を使用し、ポリシーはregex書き込み方法を使用します。

Function Computeでは、ルーティングルールで複数の書き換えポリシーを設定できます。 したがって、要求は、複数の書き換えポリシーと照合され得る。 リクエストが同じ書き換え方法を使用する複数の書き換えポリシーと一致する場合、Function Computeはポリシーの構成順序に基づいてリクエストをこれらのポリシーと照合します。 マッチングは停止し、リクエストがポリシーと最初に正常にマッチングされるまでリクエストのURIが置き換えられます。

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

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

• 書き換えポリシーが [rule1, rule2] の場合、リクエスト内でURI /api/v1/getFunctionNameが /api/v2/getFunctionNameに書き換えられます。

• 書き換えポリシーが [rule2, rule1] の場合、リクエスト内でURI /api/v1/getFunctionNameが /api/v3/getFunctionNameに書き換えられます。

前提条件

サービスと関数が作成されます。 詳細については、「サービスの作成」および「関数の作成」をご参照ください。

手順

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