イベントのインスタンス・サマリーの取得
get
/mftapp/rest/v1/events/{eventSessionId}
イベント・ステータスと様々なステータスのインスタンス数を取得します。パス・パラメータとして
12.2.1.4のパッチ31208256および31177230 (以上)を適用した場合、リクエストではオプションのブール・パラメータ
eventSessionId
を送信する必要があります。12.2.1.4のパッチ31208256および31177230 (以上)を適用した場合、リクエストではオプションのブール・パラメータ
fileCount
がサポートされます。デフォルト値は、false
です。true
に設定した場合、レスポンスにはdownloadableFileCount
、stagedFileCount
およびsourceFileCount
が含まれます。My Oracle Supportにサインインし、パッチ番号を検索してパッチを見つけてダウンロードします。リクエスト
パス・パラメータ
- eventSessionId: string
イベント・セッションのID
- fileCount(optional): boolean
(12.2.1.4のパッチ31208256および31177230を適用して)
true
に設定した場合、レスポンスにはdownLoadableFileCount
、stagedFileCount
およびsourceFileCount
が含まれます。
レスポンス
サポートされるメディア・タイプ
- application/json
200レスポンス
イベント・ステータス。
ルート・スキーマ: eventStatus
型:
object
タイトル:
ソースを表示
eventStatus
- activeInstanceCount(optional): integer
アクティブなインスタンスの数。
- comments(optional): string
イベントの成功または失敗の理由を説明する文字列値。
- completedInstanceCount(optional): integer
完了したインスタンスの数。
- downloadableFileCount(optional): integer
(12.2.1.4のパッチ31208256および31177230を適用して)
fileCount
をtrue
にした場合に、ファイル・フィルタの適用後にソース・ロケーションにあるダウンロード可能な候補ファイルであるファイルの数。ソース・タイプがファイル、FTPおよびSFTPソースの場合のみ適用可能です。 - failedInstanceCount(optional): integer
失敗したインスタンスの数。
- sourceFileCount(optional): integer
(12.2.1.4のパッチ31208256および31177230を適用して)
fileCount
をtrue
にした場合に、ファイル・フィルタの適用後にソースにあるファイルの数。ソース・タイプがファイル、FTPおよびSFTPソースの場合のみ適用可能です。 - stagedFileCount(optional): integer
(12.2.1.4のパッチ31208256および31177230を適用して)
fileCount
をtrue
にした場合に、Managed File Transferに正常にステージングされたファイルの数。 - status(optional): string
インスタンスのステータスを示す文字列値。
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から返されるエラーを説明するメッセージ。
例
次のcURLの例は、cURLを使用してRESTリソースにGETリクエストを発行して、イベント・サマリーを取得する方法を示しています。
curl -i -X GET -u <username>:<password> -H "Content-Type: application/json" http://<host>:<port>/mftapp/rest/v1/events/77990703-A512-4469-924C-891170EC0EAA
レスポンス本文の例: 200レスポンス
次の例では、正常終了したリクエストのレスポンス本文のコンテンツを示しています(JSON形式)。
{ "activeInstanceCount":"0" "completedInstanceCount":"5" "failedInstanceCount":"0" "status":"DONE" }
例 - レスポンス本文の例: 500レスポンス
次の例では、正常終了したリクエストのレスポンス本文のコンテンツを示しています(JSON形式):
{ "errorCode":"MFT-5436" "errorKey":"MFT_WS_EVENT_SERVICE_NO_EVENT_FOUND" "errorMessage":"Error in processing EventService request. No Event found with provided Event Session Id {id}." }