使用可能なアクティブ・ソースの取得
get
/mftapp/rest/v1/sources
アプリケーション・タイプやバインディング・タイプなどの条件に基づいて、MFTでアクティブなソースのリストを取得します。レスポンスには、URLを含むソースのリストが含まれます。問合せパラメータを指定せずにこのAPIを起動すると、
bindingType
を含むソースのみがSOA、SOAP、ODIおよびOSBなどのWebサービスとして取得されます。他のソースを取得するには、bindingType
またはアプリケーション・パラメータ(あるいはその両方)を問合せに渡します。アプリケーション・パラメータおよびbindingType
パラメータを指定しない場合、searchFilter
フィルタおよびonlyEventEnabled
フィルタは無視されます。サポートされるアプリケーション・タイプには、B2B、Healthcare、OSB、SOAおよびODIがあります。サポートされるバインディング・タイプには、Embedded-FTP、Embedded-SSH-FTP、ファイル、FTP、SSH-FTP、WS、B2B、Healthcare、OCSS、およびRIDCがあります。リクエスト
問合せのパラメータ
- application(optional): string
検出しようとするアプリケーション・バインディングのタイプ
- bindingType(optional): string
検出しようとするソースのバインディング・タイプ
- onlyEventEnabled(optional): boolean
イベントに対応するソースのみを検出
- searchFilter(optional): string
検出するソースの完全な名前または名前の一部
レスポンス
サポートされるメディア・タイプ
- application/json
200レスポンス
アクティブ・ソースを説明します。
ルート・スキーマ : activeSources
型:
object
タイトル:
ソースを表示
activeSources
- sources(optional): array sources
タイトル:
sources
検出されたソース
ネストされたスキーマ: items
型:
object
タイトル:
ソースを表示
items
- bindingType(optional): string
ソースのバインディング・タイプ。
- eventInvokeUrl(optional): string
起動するイベントのURL。
- name(optional): string
ソースの名前。
- url(optional): string
ソースのURL。
500レスポンス
エラー情報。
ルート・スキーマ : errors
型:
object
タイトル:
ソースを表示
errors
- errorCode(optional): string
Oracle Managed File Transferから返されるエラー・コード。
- errorKey(optional): string
Oracle Managed File Transferから返されるエラー・キー。
- errorMessage(optional): string
Oracle Managed File Transferから返されるエラーを説明するメッセージ。
例
レスポンス本文の例: 200レスポンス
次のcURLコマンドは、RESTリソースにGETリクエストを発行して、様々な問合せパラメータに基づいてソースの詳細を取得する方法を示しています:
すべてのファイル・ソースをリストするには:
curl -I -X GET -u <username>:<password> -H "Content-Type: application/json" 'http://<host>:<port>/mftapp/rest/v1/sources?bindingType=file'
名前に文字列abcが含まれるすべてのファイル・ソースをリストするには:
curl -I -X GET -u <username>:<password> -H "Content-Type: application/json" http://host:port/mftapp/rest/v1/sources?bindingType=File&&searchFilter=abc
イベント対応FTPソースをすべて表示するには:
curl -I -X GET -u <username>:<password> -H "Content-Type: application/json" http://host:port/mftapp/rest/v1/sources?bindingType=FTP&onlyEventEnabled=true
すべてのSOAソースをリストするには:
curl -I -X GET -u <username>:<password> -H "Content-Type: application/json" http://host:port/mftapp/rest/v1/sources?application=soa
次の例では、正常終了したリクエストのレスポンス本文のコンテンツを示しています(JSON形式)。
{ "sources": [ { "name": "src1", "url": "/scratch/demo", "bindingType": "File", "eventInvokeUrl": "/mftapp/rest/v1/events" }, { "name": "src2", "url": "/scratch/username", "bindingType": "File", "eventInvokeUrl": "/mftapp/rest/v1/events" } ] }
例 - レスポンス本文の例: 500レスポンス
次の例では、正常終了したリクエストのレスポンス本文のコンテンツを示しています(JSON形式):
{ "errorCode":"MFT-5403" "errorKey":"MFT_WS_DISCOVERY_COULD_NOT_QUERY_MFT_SOURCES" "errorMessage":"Discovery service is unable to query MFT Sources for the given application {application} and search Filter {search filter}." }