実行する一致条件と拡張機能を含む単一の拡張チェーン ラッパー。
JSON 表現 |
---|
{ "name": string, "matchCondition": { object ( |
フィールド | |
---|---|
name |
必須。この拡張機能チェーンの名前。この名前は HTTP リクエストログの一部として記録されます。名前は RFC-1034 に準拠している必要があります。英小文字、数字、ハイフンのみを使用できます。最大長は 63 文字です。また、最初の文字は英字で、最後の文字は英字または数字である必要があります。 |
matchCondition |
必須。リクエストに対してこのチェーンが呼び出される条件。 |
extensions[] |
必須。一致するリクエストに対して実行される拡張機能のセット。拡張機能を 1 つ以上指定してください。 |
一致条件
リクエストに対してこのチェーンが呼び出される条件。
JSON 表現 |
---|
{ "celExpression": string } |
フィールド | |
---|---|
celExpression |
必須。拡張機能チェーンが実行されるリクエストの照合に使用される Common Expression Language(CEL)式。 詳細については、CEL マッチャーの言語リファレンスをご覧ください。 |
延長
一致するリクエストに対して実行されるチェーン内の 1 つの拡張機能。
JSON 表現 |
---|
{
"name": string,
"authority": string,
"service": string,
"supportedEvents": [
enum ( |
フィールド | |
---|---|
name |
必須。この拡張機能の名前。この名前は HTTP リクエストログの一部として記録されます。名前は RFC-1034 に準拠している必要があります。小文字、数字、ハイフンのみ使用できます。長さは 63 文字以下にする必要があります。また、最初の文字は英字で、最後の文字は英字または数字である必要があります。 |
authority |
省略可。Envoy から拡張機能サービスに送信される gRPC リクエストの |
service |
必須。拡張機能を実行するサービスへの参照。 現在のところ、コールアウト表示はサポートされていません。 コールアウト表示オプションを構成するには、 |
supportedEvents[] |
省略可。この拡張機能が呼び出されるリクエストまたはレスポンス処理中のイベントのセット。 |
timeout |
省略可。ストリーム内の各メッセージのタイムアウトを指定します。タイムアウトは 10~1,000 ミリ秒の範囲で指定する必要があります。コールアウト表示オプションに必須です。
|
failOpen |
省略可。拡張機能の呼び出しが失敗するかタイムアウトした場合のプロキシの動作を指定します。
|
forwardHeaders[] |
省略可。拡張機能に転送する(クライアントまたはバックエンドから) HTTP ヘッダーのリスト。省略した場合は、すべてのヘッダーが送信されます。各要素は、ヘッダー名を示す文字列です。 |
EventType
拡張機能が呼び出されるリクエストまたはレスポンスの部分。
列挙型 | |
---|---|
EVENT_TYPE_UNSPECIFIED |
値が指定されていません。使用禁止。 |
REQUEST_HEADERS |
supportedEvents に含まれている場合、HTTP リクエスト ヘッダーが到着すると、拡張機能が呼び出されます。 |
REQUEST_BODY |
この拡張機能が supportedEvents に含まれている場合、HTTP リクエスト本文が到着したときにこの拡張機能が呼び出されます。 |
RESPONSE_HEADERS |
この拡張機能が supportedEvents に含まれている場合、HTTP レスポンス ヘッダーが到着したときにこの拡張機能が呼び出されます。 |
RESPONSE_BODY |
この拡張機能が supportedEvents に含まれている場合、HTTP レスポンスの本文が到着したときにこの拡張機能が呼び出されます。 |
REQUEST_TRAILERS |
supportedEvents に含まれている場合、HTTP リクエストのトレーラが到着したときにこの拡張機能が呼び出されます。 |
RESPONSE_TRAILERS |
この拡張機能は、supportedEvents に含まれている場合、HTTP レスポンスのトレーラが到着したときに呼び出されます。 |