機械翻訳について

実行時の外部REST APIのエンドポイントURI/ホスト名のオーバーライド

実行時にエンドポイントURIを指定して外部REST APIを起動するOracle Integrationで統合を設計できます。 この機能は、外部REST APIのエンドポイントが設計時に認識されないか、実行時に複数のRESTサービスのどれを起動しなければならないかをディシジョンするディシジョンを行う必要がある場合に役立ちます。

次のステップを実行して、Oracle Integrationを使用してRESTエンドポイントを動的に起動するように統合を構成します。

統合は通常、起動接続として「RESTアダプタ」を使用して設計されています。 接続には、Swagger文書で指定されたベースURIまたは絶対エンドポイントURIがあります。 どちらの場合でも、外部APIのエンドポイントURIは設計時に導出され、静的です。

実行時にエンドポイントがオーバーライドされるシナリオでは、これらのエンドポイントでホストされるAPIは、設計時にAPI用に定義されたインタフェースに準拠していると見なされます。

  1. 「RESTアダプタ」を起動接続として作成し、構成します。

    設計時の構成時に、外部APIのインタフェースが宣言的に指定されています: リクエストとレスポンス・メッセージ(存在する場合)のシェイプ、使用されるHTTPメソッド、およびメッセージ交換パターン(リクエスト、レスポンス、または一方向)。

  2. マッパーの「ターゲット」セクションで、ConnectivityPropertiesの下のRestApiを展開します。

  3. 「ソース」スキーマから、AbsoluteEndpointUriのマッピングを指定します。 AbsoluteEndpointUriには、パス/テンプレート・パラメータの具体的な値と値を持つ問合せパラメータを持つエンドポイントURIを割り当てる必要があります。 「RESTアダプタ」は、このプロパティに格納されているアドレスにリクエストを送信します。 あるいは、静的マッピングを提供することもできます。

  4. 統合をアクティブ化して起動します。 「RESTアダプタ」は、このマッピングによって提供されるランタイム値を使用して、このリクエストをルーティングするRESTエンドポイントを決定します。

  5. または、ステップ4で、AbsoluteEndpointUriの他の兄弟をマップできます。 より細かい制御のために、URIを拡張することによって、URIの個々のコンポーネントにマッピングを提供することもできます。

    • スキーム: エンドポイントURLのスキームのみを変更する場合は、マッピングを提供します。 サポートされている値はHTTPとHTTPSのみです。

    • ホスト: エンドポイントURLのホスト部分のみを変更する場合は、マッピングを提供します。

    • ポート: エンドポイントURLのポートのみを変更する場合は、マッピングを提供します。

    • 問合せ: エンドポイントURLの問合せ部分のみを変更する場合は、マッピングを提供します。 問合せ部分は、?文字に続く部分です。

    • パス: エンドポイントURLのパス部分のみを変更する場合は、マッピングを提供します。 パスは、ホスト名と?文字の間のURIの一部です。