実行
アセンブリーの execute フィールドの構造は以下のとおりです。
execute:
- Policy_1
- Policy_2注: 一部の組み込みポリシーは DataPower® Gateway (v5 compatible) と DataPower API Gatewayの両方で使用できますが、一部のポリシーは特定のゲートウェイに制限されています。 以下のアイコンは、どちらのゲートウェイで各ポリシーが使用できるかを示します。
DataPower Gateway (v5 compatible) でポリシーを実行できることを示す。
このポリシーは.上で実行可能であることを DataPower API Gateway示します。
2種類のゲートウェイの詳細については、を参照してください API Connect ゲートウェイの種類。
以下の表で、execute フィールドに含めることができる、予想されるポリシーおよびロジック構成体について説明します。
| プロパティー | 必須 | 説明 | データ・タイプ | |
|
|---|---|---|---|---|---|
| activity-log | いいえ | activity-log ポリシーを使用して、API 操作の呼び出しに関連する情報をログに記録します。 | オブジェクト（ アクティビティログ ） |  |
アクティビティログ拡張機能によって提供される機能 |
| client-security | いいえ | API に対するクライアント・アクセスをさまざまな方法で認証できるようにして、OpenAPI 仕様の機能を拡張します。 | オブジェクト（ クライアント・セキュリティ ） |  |
|
| gatewayscript | いいえ | GatewayScript プログラムを組み込みます。「 GatewayScript 」ポリシーは、 Premium subscription. でのみ利用可能です。 | オブジェクト ( gatewayscript ) | |
|
| graphql-cost-analysis | いいえ | この graphql-cost-analysis ポリシーを使用して、対象クエリのコスト分析を取得します。 | オブジェクト ( graphql-cost-analysis ) | |
|
| graphql-execute | いいえ | この graphql-execute ポリシーを使用して、サブクエリを用いた GraphQL クエリを実行します。 | オブジェクト ( graphql-execute ) | |
|
| graphql-introspect | いいえ | graphql-introspect ポリシーを使用して、 GraphQL スキーマをイントロスペクトします。 | オブジェクト ( graphql-introspect ) | |
|
| if | いいえ | if ポリシーを使用して、条件が満たされている場合にのみアセンブリーの一部分を実行します。 | オブジェクト（ if ） | |
スイッチが提供する機能 |
| invoke | いいえ | invoke ポリシーを使用して API を呼び出します。 パフォーマンスを向上させるために、ポリシー内の最後の呼び出しがプロキシーによって自動的に置き換えられる場合があります。 これを無効にするには、 APIのプロパティを参照してください。 |
オブジェクト（ 呼び出し ） | |
|
| json-to-xml | いいえ | ペイロードを JSON から XML に変換します。 | オブジェクト ( JSONからXMLへ ) | |
|
| jwt-generate | いいえ | JSON Web トークン (JWT) を生成します。 | オブジェクト ( jwt-generate ) | |
|
| jwt-validate | いいえ | JSON Web トークン (JWT) を検証します。 | オブジェクト ( jwt-validate ) | |
|
| map | いいえ | map ポリシーを使用して変数を変換します。 | オブジェクト（ マップ ） | |
|
| message-template | いいえ | メッセージテンプレートポリシーを使用して、. DataPower API Gateway用の模擬APIレスポンスを作成します。 | オブジェクト ( メッセージテンプレート ) | |
|
| operation-switch | いいえ | 呼び出される操作を条件とする代替ポリシー・アセンブリーを実行する際は、operation-switch ポリシーを使用します。 | オブジェクト（ 操作切り替え ） | |
|
| oauth | いいえ | この oauth ポリシーを使用して、定義された OAuth プロバイダーの設定に基づいて OAuth の処理を実行します。 | オブジェクト ( oauth ) | |
|
| parse | いいえ | parse ポリシーを使用して、入力文書の構文解析を制御します。 入力文書が JSON ストリングである場合、そのストリングは上書きコピーされるのではなく構文解析されます。 | オブジェクト（ 解析 ） | |
|
| proxy | いいえ | サービスをプロキシー化します。 | オブジェクト（ プロキシ ） | |
invoke が提供する機能 |
| ratelimit | いいえ | API アセンブリー・フローの任意の時点で 1 つ以上のレート制限またはバースト制限を適用するには、 ratelimit ポリシーを使用します。 レート制限およびバースト制限は、指定した期間内にアプリケーションが API に対して実行できる呼び出しの数を制限します。 | オブジェクト ( ratelimit ) | |
|
| redact | いいえ | redact ポリシーを使用して、要求の本文、応答の本文、およびアクティビティー・ログから、指定されたフィールドを完全に削除するか、それらのフィールドを編集します。 法律、 セキュリティー、その他の理由により、機密データ (例えば、 クレジット・カードの詳細) を削除またはブロックするためにこのポリシーは役立ちます。 | オブジェクト ( redact - DataPower API Gateway redact - DataPower Gateway ( v5 互換) ) | |
|
| set-variable | いいえ | set-variable ポリシーを使用して、ランタイム変数をストリング値に設定したり、ランタイム変数の追加やクリアを行ったりします。 | オブジェクト ( 変数設定 ) | |
|
| switch | いいえ | switch ポリシーを使用して、指定したどの条件が満たされているかに基づいて、アセンブリーの多数のセクションのうちの 1 つを実行します。 | オブジェクト（ スイッチ ） | |
|
| throw | いいえ | throw ポリシーを使用して、エラーをスローするポイントを指定します。 | オブジェクト（ スロー ） | |
|
| user-security | いいえ | ユーザーの資格情報を抽出し、それらの資格情報を認証して、ユーザーから許可を取得します。 | オブジェクト ( ユーザーセキュリティ ) | |
|
| validate | いいえ | 「検証」 ポリシーを使用して、アセンブリー・フロー内のペイロードを JSON または XML スキーマに照らして検証します。 | オブジェクト ( validate - DataPower API Gateway, validate - DataPower Gateway ( v5 互換) ) | |
|
| validate-usernametoken | いいえ | WS-Security UsernameToken を検証します。 | オブジェクト ( validate-usernametoken ) | |
|
| xml-to-json | いいえ | ペイロードを XML から JSON に変換します。 | オブジェクト ( XMLからJSONへ ) | |
|
| xslt | いいえ | XSLT 変換をペイロードに適用します。XSLTポリシーは、 Premium subscription. でのみ利用可能です。 | オブジェクト ( XSLT ) | |
|
以下の例に示すアセンブリーの execute フィールドは、URL を呼び出して、要求または応答のフィールドを編集します。
execute:
- invoke:
title: Example Invoke
target-url: 'https://example.com/api'
description: Example description
- redact:
actions:
- action: redact
from:
- request
- response
path: //*[@name='secondaryAddress']/*[@name='streetAddress']