ジョブ・リクエストに関する情報
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
型:
ソースの表示
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
ESSがこのリクエストに関連付けられているすべてのタスクを終了した時刻(ISO 8601日時書式)。これは、リクエスト・プロセス・フェーズが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を使用してリクエストを強制的に取り消すための前提条件が満たされているかどうかを確認します。このチェックには、ジョブ・リクエストが実行されていないことの検証は含まれません。このチェックは手動で行う必要があります。
-
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ユーザー
-
schedule: 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
このリクエストに関連付けられたすべてのリクエスト・パラメータ(システム・プロパティを含む)
ソースの表示
- 配列: object RequestParameter
リクエスト・パラメータ
ネストされたスキーマ: RequestLink
型:
ソースの表示
object
-
href(required): string
-
rel(required): string
指定できる値:
[ "self", "parentRequest", "cancel", "forceCancel", "hold", "release", "subscribe", "permissions", "executionStatus", "absParentRequest", "instanceParent" ]
ネストされたスキーマ: RequestParameter
型:
object
リクエスト・パラメータ
ソースの表示
-
name(required): string
パラメータの名前
-
paramType(required): string
指定できる値:
[ "BOOLEAN", "LONG", "INTEGER", "DATETIME", "STRING" ]
-
value: string
ネストされたスキーマ: ScheduleBase
型:
ソースの表示
object
-
exclusions: array exclusions
-
inclusions: array inclusions
-
recurrences: array recurrences
一連の繰返し。スケジュールの出現回数は、個々の繰返しによって生成された出現の和集合になります。
-
timezone: string
Olsonデータベース形式のタイムゾーン
ネストされたスキーマ: ScheduleOut-allOf[1]
型:
ソースの表示
object
-
description: string
-
displayName: string
-
id: string
リソースID
-
name: string
このリソースに与えられる一意の名前。nullは指定不可。特に指定のないかぎり、この名前はデフォルトの表示名としても使用されます。
-
packageName: string
このメタデータ・オブジェクトのネームスペース
-
permissions: array permissions
このAPIの現在のユーザーがこのリソースに対して持つ権限のセット
-
resourceBundles: array resourceBundles
このジョブに関連付けられたJavaリソース・バンドル
ネストされたスキーマ: Recurrence
型:
ソースの表示
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形式の文字列です。
ネストされたスキーマ: permissions
型:
array
このAPIの現在のユーザーがこのリソースに対して持つ権限のセット
ソースの表示
- 配列: string
指定できる値:
[ "READ", "CREATE", "UPDATE", "DELETE", "EXECUTE" ]
400レスポンス
入力が無効です
ルート・スキーマ: SimpleExceptionDetail
型:
ソースの表示
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。たとえば、ESS-00500などです。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
403レスポンス
この操作では許可されません
ルート・スキーマ: SimpleExceptionDetail
型:
ソースの表示
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。たとえば、ESS-00500などです。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
404レスポンス
リクエストIDが見つかりません
ルート・スキーマ: SimpleExceptionDetail
型:
ソースの表示
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。たとえば、ESS-00500などです。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
500レスポンス
サーバー・エラー
ルート・スキーマ: SimpleExceptionDetail
型:
ソースの表示
object
-
detail: string
詳細エラー・メッセージ
-
errorCode: string
ESS固有のエラー・コード。たとえば、ESS-00500などです。
-
status: integer
HTTPステータス・コード
-
title(required): string
要約エラー・メッセージ
-
type(required): string
URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。