ジョブ・リクエスト情報の取得
get
ess/rest/scheduler/v1/requests/{requestId}
指定したリクエストのランタイム詳細を取得します。
リクエスト
パス・パラメータ
- requestId(required): integer(int64)
ジョブ・リクエストID
問合せパラメータ
- excludeFields: string
返される情報で除外するフィールドの共通区切りのリスト。 例: ?excludeFields="jobDefinitionId"
- fields: string
返されるフィールドの共通区切りのリスト。 たとえば、?fields="requestId"
- links: string
返されるリンクの共通区切りのリスト。 例: ?links=cancel
この操作にはリクエスト本文がありません。
トップに戻るレスポンス
サポートされているメディア・タイプ
- application/vnd.oracle.resource+json;type=singular
- application/json;charset=utf-8
200 レスポンス
OK
ルート・スキーマ : RequestDetails
タイプ:
Show Source
object
-
absParentRequestId: integer (int64)
送信済リクエストID。 そのリクエストにかわって作成されたすべての子リクエストには、同じ絶対親があります。
-
application: string
このリクエストに関連付けられたアプリケーション名。
-
cause: string
許可された値:
[ "NON_TERMINAL", "REQUEST_EXPIRED", "REQUEST_LOGIN_ERROR", "REQUEST_AUTHORIZATION_FAILED", "SYSTEM_ERROR", "VALIDATION_ERROR", "METADATA_NOT_FOUND", "OPERATOR_CANCEL", "RECOVER_CANCEL", "RECOVER_GROUP_CANCEL", "PARENT_NOT_PAUSED", "PROCESS_WARNING", "PROCESS_ERROR", "PROCESS_CANCEL", "PROCESS_SUCCESS", "PROCESS_SYSTEM_ERROR", "PROCESS_BIZ_ERROR", "PROCESS_TIMED_OUT", "PROCESS_UNKNOWN_STATUS", "PROCESS_RECOVER", "PROCESS_MANUAL_RECOVER_ERROR", "PROCESS_MANUAL_RECOVER_ERROR_FINALIZE", "PROCESS_SUSPEND", "PROCESS_KILLED", "POSTPROCESS_SYSTEM_ERROR", "POSTPROCESS_CANCEL", "POSTPROCESS_WARNING", "POSTPROCESS_ERROR", "POSTPROCESS_BIZ_ERROR", "PROCESS_UPDATE_WARNING", "PROCESS_UPDATE_ERROR", "PROCESS_UPDATE_CANCEL", "PROCESS_UPDATE_BIZ_ERROR", "MANUAL_RECOVER_ERROR", "PREPROCESS_SYSTEM_ERROR", "PREPROCESS_CANCEL", "PREPROCESS_INITIATE_CANCEL", "PREPROCESS_ERROR", "PREPROCESS_BIZ_ERROR" ]
リクエストが終端状態になる原因。 -
causeDescription: string
ジョブ・リクエストの状態の一般的な原因を説明するローカライズされた文字列。
-
completedTime: string
ISO 8601日時書式の、このリクエストに関連付けられたすべてのタスクがESSによって終了した時間。 これは、リクエスト・プロセス・フェーズがProcessPhase.Completeに設定された時間を表します。 この値は、なんらかの理由でリクエストが実行されなかった場合でも、リクエストのすべてのタスクが完了すると常に設定されます。 ESSがこのリクエストのすべての作業をまだ終了していない場合は、Nullが返されます。
-
deployedApplicationName: string
このリクエストに関連付けられたdeployedApplicationName名。
-
description: string
このリクエストの説明。
-
dispatcher: string
リクエストをディスパッチした中間層インスタンス名。
-
dmsRID: string
-
ecid: string
このリクエストの処理に関連付けられたDMS ExecutionContextのECID。
-
elapsedTime: integer (int64)
リクエストの処理に費やされた経過時間(ミリ秒)。 リクエスト処理が開始されていない場合は、0(ゼロ)になります。
-
enterpriseId: integer (int64)
-
errorType: string
許可された値:
[ "SYSTEM", "BUSINESS", "TIMEOUT", "MIXED_NON_BUSINESS", "MIXED_BUSINESS" ]
リクエストのエラー・タイプ。 -
errorTypeDescription: string
ローカライズされたエラー・タイプ・メッセージ。
-
errorWarningDetail: string
このリクエストの処理中に発生したエラーまたは警告の詳細(スタック・トレースなど)。
-
errorWarningMessage: string
このリクエストの処理中に発生したエラーまたは警告に関連付けられたメッセージ。
-
errorWarningTime: string
このリクエストの処理中にエラーが発生した場合のエラーまたは警告の、ISO 8601日時書式の時間。
-
executableState: string
-
executionAttempt: integer
このリクエストに対する現在の実行の試行。 最初の実行試行は1です。
-
executionMode: string
-
executionType: string
リクエストの実行タイプ。 現在サポートされているタイプはRESTのみです。
-
expiration: string
リクエストが期限切れになるISO 8601日時書式の時間。 リクエストが失効しない可能性があります。
-
flowId: string
-
instanceParentExecAttempt: integer
このリクエストが作成されたときのインスタンスの親リクエストの実行試行の値。 このリクエストにインスタンスの親がない場合、この値はゼロになります
-
instanceParentId: integer (int64)
このリクエストのインスタンスの親のリクエストID。 インスタンス親リクエストのリクエスト・ツリーの子リクエストには、同じインスタンスの親IDがあります。 たとえば、サブリクエストやJobSetステップ・リクエストとその子リクエストは、同じインスタンスの親IDを持ちます。 スケジュールなしでリクエストが送信された場合、送信されたリクエストはインスタンスの親とみなされます。 インスタンスの親ID値は、絶対親IDの値と同じです。 スケジュールを使用してリクエストが送信されると、スケジュールが発生するたびに新しい子リクエストが作成され、各子リクエストはインスタンスの親リクエストを表します。
-
isAsynchronous: boolean
リクエストが非同期かどうかを示します。 'true'の値は、これが非同期リクエストであることを示します。
-
isAsyncRecoverable: boolean
-
isCancellable: boolean
リクエストが取消可能かどうかを示します。 これは、このリクエストのリクエスト・タイプと現在の状態に基づいています。 これは、このリクエストを取り消すことができるかどうかに関する保証ではなく、単なるヒントです。
-
isForceCancelAllowed: boolean
forceCancelAsyncRequestを使用してリクエストをCANCELLEDに強制するための前提条件が満たされているかどうかを確認します。 チェックには、ジョブ・リクエストが実行されていないことの確認は含まれません。 このチェックは手動で行う必要があります。
-
isHoldable: boolean
リクエストが保留可能かどうかを示します。 これは、このリクエストのリクエスト・タイプと現在の状態に基づいています。 これは、このリクエストを保留できるかどうかに関する保証ではなく、単なるヒントです。
-
isRecoverable: boolean
-
isTimedOut: boolean
リクエストがタイムアウトしたかどうかを示します。
-
jobDefinitionId: string
このリクエストに関連付けられているジョブまたはジョブ・セット定義。
-
jobDescription: string
このリクエストに指定されたジョブ定義またはジョブ・セットの摘要
-
jobDisplayName: string
このリクエストのジョブ定義/ ジョブ・セットの表示名。
-
jobType: string
このリクエストに関連付けられているジョブ・タイプ識別子。
-
lastScheduleInstanceId: integer (int64)
このリクエストに関連付けられた最後のスケジュール・インスタンス・リクエストID。 この値は、特定のリクエスト・タイプに対してのみ有効です。 その他のリクエスト・タイプでは意味がなく、ゼロ(0)になります。 RequestType.RECUR_PARENTまたはRequestType.JOBSET_RECUR_PARENTリクエストの場合、この値は最近作成されたインスタンスの親リクエストのIDを表します。 スケジュールが終了した場合または取り消された場合、これはスケジュールに対して最後に作成されたインスタンス・リクエストのIDです。 RequestType.RECUR_CHILDまたはRequestType.JOBSET_RECUR_CHILDリクエストの場合、この値はスケジュールの前のインスタンスのリクエストのIDを表します。 スケジュールの最初のインスタンス・リクエストの値はゼロ(0)です。
-
lastSubRequestSet: integer
現在の実行試行中にこのリクエストによって送信された最後のサブリクエストに割り当てられたセット番号。 このリクエストによってサブリクエストが送信されていない場合、この値はゼロになります。 pausedCountがlastSubrequestSetの場合、このリクエストは最後のサブリクエストが送信されてから一時停止しています。 この値は、それらのサブリクエストに割り当てられたセット番号を表します。 pausedCountがlastSubrequestSetと等しくない場合、このリクエストが最後に一時停止してから1つ以上のサブリクエストが送信されています。 この値は、このリクエストの一時停止を待機しているサブリクエストに割り当てられたセット番号を表します。
-
links: array RequestLinks
-
logicalClusterName: string
-
notificationUrl: string
リクエストが完了したときのオプションの通知コールバックのURLで、リクエストを送信したユーザーとして作成されます。
-
parentExecAttempt: integer
このリクエストが作成されたときの直接の親リクエストの実行試行の値。 このリクエストに即時親がない場合、この値はゼロになります。
-
parentRequestId: integer (int64)
このリクエストの直接の親のリクエストID。 リクエストに即時親がない場合、このメソッドによって返される値は意味がありません。
-
pausedCount: integer
このリクエストが現在の実行試行中に一時停止された回数。 この値は、サブリクエストの実行を許可するためにリクエストが一時停止されると増分されます。 このリクエストが一時停止されなかった場合、この値はゼロになります。
-
postProcessMessage: string
-
postProcessStatus: string
-
preProcessMessage: string
-
preprocessStatus: string
-
previousState: string
このリクエストの以前の状態。 リクエストの状態が変更されていない場合、空である可能性があります。
-
priority: integer
リクエスト優先度。 賞品の範囲は[0..9]で、最も低い優先度は0、最も高い優先度は9です。
-
processEndTime: string
リクエストの時間処理がISO 8601日時書式で終了しました。
-
processGroup: string
リクエストのプロセス・グループ。
-
processor: string
リクエストを処理した中間層インスタンス名。
-
processPhase: string
このリクエストの処理フェーズ。
-
processPhaseDescription: string
プロセス・フェーズのローカライズされた摘要。
-
processStartTime: string
リクエストの処理がISO 8601日時形式で開始されました。
-
product: string
リクエストに関連付けられている製品。 これは、SYS_productシステム・プロパティの値に対応します。
-
requestCategory: string
このリクエストのリクエスト・カテゴリ・プロパティ。
-
requestedEndTime: string
リクエストのリクエストされた終了時間を表します。 文字列はISO 8601日時書式です。
-
requestedStartTime: string
リクエストの実行がリクエストされた時間。 文字列はISO 8601日時書式です。
-
requestId: integer (int64)
-
requestMode: string
-
requestParameters: array requestParameters
このリクエストに関連付けられているすべてのリクエスト・パラメータ(システム・プロパティを含む)。
-
requestType: string
許可された値:
[ "SINGLETON", "RECUR_PARENT", "RECUR_CHILD", "JOBSET_SINGLETON", "JOBSET_STEP", "JOBSET_RECUR_PARENT", "JOBSET_RECUR_CHILD", "SUB_REQUEST", "UNKNOWN" ]
リクエストの不変タイプ。 -
retriedCount: integer
このリクエストが再試行された回数。
-
runAsUser: string
リクエストのRunAsユーザー。
-
スケジュール: ScheduleOut
-
scheduleDefinition: string
スケジュールが個別のリソースの場合にのみ、このリクエストに関連付けられたスケジュールを識別します。 リクエスト送信中にインラインで指定したスケジュール(アドホック・スケジュール)については、スケジュール・フィールドを参照してください。
-
scheduledTime: string
リクエストのスケジュールされた開始時間。 文字列はISO 8601日時書式です。
-
state: string
リクエストの状態。
-
stateChangeTime: string
リクエスト状態が最後にISO 8601日時形式で変更された時間。 リクエストの状態が変更されていない場合、空である可能性があります。
-
stateDescription: string
ジョブ・リクエストの状態を記述するローカライズされた文字列。
-
stepId: string
このリクエストのJobSet stepID。 リクエストは、stepID値で示されるJobSet内のステップである場合とない場合があります。
-
submissionTime: string
ISO8601日時書式でのリクエスト送信時間。
-
submitter: string
リクエストを発行したユーザー名。
-
submitterDmsECID: string
-
submitterDmsRID: string
-
submitterFlowId: string
-
submitterGUID: string
リクエストを送信したユーザーのGUID。
-
subRequestSet: integer
サブ要求が送信されたときに割り当てられたセット番号。 親が複数のサブリクエストを送信してから一時停止すると、それらのサブリクエストはすべて同じセット番号になります。 これはサブリクエストに対してのみ意味があり、その場合はこの値がゼロより大きくなります。 サブリクエストではないリクエストの値はゼロです。
ネストされたスキーマ : requestParameters
タイプ:
array
このリクエストに関連付けられているすべてのリクエスト・パラメータ(システム・プロパティを含む)。
Show Source
- Array of: object RequestParameter
リクエスト・パラメータ。
ネストされたスキーマ : RequestLink
タイプ:
Show Source
object
-
href(required): string
-
rel(required): string
許可された値:
[ "self", "parentRequest", "cancel", "forceCancel", "hold", "release", "subscribe", "permissions", "executionStatus", "absParentRequest", "instanceParent" ]
ネストされたスキーマ : RequestParameter
タイプ:
object
リクエスト・パラメータ。
Show Source
-
name(required): string
パラメータ名。
-
paramType(required): string
許可された値:
[ "BOOLEAN", "LONG", "INTEGER", "DATETIME", "STRING" ]
-
scope: string
-
value: string
ネストされたスキーマ : ScheduleBase
タイプ:
Show Source
object
-
exclusions: array exclusions
-
inclusions: array inclusions
-
recurrences: array recurrences
一連の繰返し。 生成されるスケジュールのオカレンスは、個々の繰り返しによって生成されるオカレンスの和になります。
-
timezone: string
Olsonデータベース形式のタイムゾーンです。
ネストされたスキーマ : ScheduleOut-allOf[1]
タイプ:
Show Source
object
-
description: string
-
displayName: string
-
id: string
リソースID
-
name: string
このリソースに指定する一意の名前。 nullにできません。 特に指定のないかぎり、この名前はデフォルトの表示名としても使用されます。
-
packageName: string
このメタデータ・オブジェクトのネームスペース。
-
permissions: array permissions
このAPIの現在のユーザーにこのリソースに対する権限のセット。
-
resourceBundles: array resourceBundles
このジョブに関連付けられたJavaリソース・バンドル。
ネストされたスキーマ : 繰返し
タイプ:
Show Source
object
-
endDate: string
この繰り返しオブジェクトの終了日時を設定します。 オブジェクトは、秒までの時間のみを抽出します。 ミリ秒精度はサポートされていません。 値はISO 8601形式の文字列です。
-
icalString(required): string
スケジュールで使用する繰返しパターンを定義します。 文字列はRFC 5445 RRULEに準拠している必要があります。 UNTIL、COUNT、BYSETPOS、WKSTなどの制限はサポートされていません。 RRULEのBY*句(Rotors)には、最小値 -1を指定できます。たとえば、BYDAY=-2MO(second to last monday)はサポートされていません。 BYMONTHおよびBYWEEKNOは、1つのRECUR式に存在できません。 BYDAY、BYMONTHDAYおよびBYYEARDAYは、1つのRECUR式に存在できません。
-
startDate: string
この繰り返しオブジェクトの開始日時を設定します。 オブジェクトは、秒までの時間のみを抽出します。 ミリ秒精度はサポートされていません。 値はISO 8601形式の文字列です。
ネストされたスキーマ : 権限
タイプ:
array
このAPIの現在のユーザーにこのリソースに対する権限のセット。
Show Source
- Array of: string
許可された値:
[ "READ", "CREATE", "UPDATE", "DELETE", "EXECUTE" ]
400 レスポンス
入力が無効です
ルート・スキーマ : SimpleExceptionDetail
タイプ:
Show Source
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。 たとえば、ESS-00500です。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。 そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
403 レスポンス
この操作には使用できません
ルート・スキーマ : SimpleExceptionDetail
タイプ:
Show Source
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。 たとえば、ESS-00500です。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。 そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
404 レスポンス
リクエストIDが見つかりません
ルート・スキーマ : SimpleExceptionDetail
タイプ:
Show Source
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。 たとえば、ESS-00500です。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。 そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
500 レスポンス
サーバー・エラー
ルート・スキーマ : SimpleExceptionDetail
タイプ:
Show Source
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。 たとえば、ESS-00500です。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。 そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。