ジョブ・リクエストの問合せ

get

ess/rest/scheduler/v1/requests

ジョブ・リクエストは、ジョブ定義またはジョブ・セットの実行可能インスタンスを表します。

リクエスト

問合せパラメータ
  • 返される情報で除外するフィールドのカンマ区切りリスト。例: ?excludeFields="jobDefinitionId"
  • 返されるフィールドのカンマ区切りリスト。例: ?fields="requestId"
  • リクエスト情報を返すリクエストIDのカンマ区切りリスト。
  • 結果の順序付けに使用する問合せフィールドを指定します。この問合せパラメータの値は、fieldName[:(asc/desc)]の形式に従う必要があります。たとえば、?orderBy=name:ascのようになります。複数のフィールドがリストされている場合は、最初のフィールドのみが使用されます。
  • SCIMフィルタリング形式の問合せ文字列。問合せ可能なフィールドには次のものが含まれます: [requestId、absParentRequestId、description、application、product、requestCategory、runAsUser、executionType、jobDefinitionId、state、scheduleDefinition、priority、processStartTime、processEndTime、requestedStartTime、requestedEndTime、submissionTime、parentRequestId、elapsedTime、waitTime、scheduledTime、processor、submitter、submitterGUID、instanceParentId、requestType、errorType、processPhase、completedTime、retriedCount、readyWaitTime、enterpriseId、isTimedOut、isAsynchronous、logicalClusterName、submitterDmsECID、submitterFlowId、requestDmsECID、requestFlowId、elapsedTime、className、jobType、externalJobType、externalId]

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされるメディア・タイプ

200レスポンス

OK
本文()
ルート・スキーマ : RequestQueryResponse
型: object
ソースの表示
ネストされたスキーマ: batch
型: array
複数選択で返されるアイテム。この要素は、通常の問合せでは返されません。
ソースの表示
ネストしたスキーマ: items
型: array
通常の問合せに対して返されるリソース・アイテム。複数選択を使用すると、この要素は返されません。
ソースの表示
ネストされたスキーマ: RequestBatchItem
型: object
ソースの表示
ネストされたスキーマ: RequestDetails
型: object
ソースの表示
  • 発行されたリクエストID。そのリクエストにかわって作成されたすべての子リクエストは、同じ絶対親を持ちます。
  • このリクエストに関連付けられたアプリケーション名
  • 指定できる値: [ "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" ]
    リクエストが終了状態になった原因。
  • ジョブ・リクエストの状態の一般的な原因を説明するローカライズされた文字列
  • ESSがこのリクエストに関連付けられているすべてのタスクを終了した時刻(ISO 8601日時書式)。これは、リクエスト・プロセス・フェーズがProcessPhase.Completeに設定された時刻を表します。この値は、なんらかの理由でリクエストが実行されなかった場合でも、リクエストのすべてのタスクが終了すると常に設定されます。ESSがこのリクエストのすべてのタスクをまだ完了していない場合、NULLが返されます。
  • このリクエストに関連付けられたdeployedApplicationName名
  • このリクエストの説明
  • リクエストをディスパッチした中間層インスタンス名。
  • このリクエストの処理に関連付けられたDMS ExecutionContextのECID
  • リクエストの処理に要した経過時間(ミリ秒)。リクエスト処理が開始されていない場合は、0 (ゼロ)になります。
  • 指定できる値: [ "SYSTEM", "BUSINESS", "TIMEOUT", "MIXED_NON_BUSINESS", "MIXED_BUSINESS" ]
    リクエストのエラー・タイプ
  • ローカライズされたエラー・タイプ・メッセージ
  • このリクエストの処理中に発生したエラーまたは警告の詳細(スタック・トレースなど)。
  • このリクエストの処理中に発生したエラーまたは警告に関連付けられたメッセージ
  • このリクエストの処理中に発生したエラーまたは警告の時刻(ISO 8601日時形式)
  • このリクエストの現在の実行試行。最初の実行試行は1になります。
  • リクエストの実行タイプ。現在サポートされているタイプはRESTのみです。
  • リクエストが期限切れになる時刻(ISO 8601日時形式)。リクエストは期限切れにならない場合があります。
  • このリクエストが作成されたときのインスタンスの親リクエストの実行試行の値。このリクエストにインスタンスの親がない場合、この値はゼロになります
  • このリクエストのインスタンスの親のリクエストID。インスタンスの親リクエストのリクエスト・ツリーのすべての子リクエストには、同じインスタンスの親IDがあります。たとえば、サブリクエストまたはJobSetステップ・リクエストとその子はすべて、同じインスタンスの親IDを持ちます。スケジュールなしでリクエストが発行された場合、発行されたリクエストはインスタンスの親とみなされます。インスタンスの親ID値は、絶対親ID値と同じです。スケジュールを使用してリクエストが発行されると、スケジュールが発生するたびに新しい子リクエストが作成され、各子リクエストはインスタンスの親リクエストを表します。
  • リクエストが非同期かどうかを示します。値'true'は、これが非同期リクエストであることを示します。
  • リクエストが取消し可能かどうかを示します。これは、このリクエストのリクエスト・タイプおよび現在の状態に基づきます。このリクエストを取り消すことができるかどうかについては、これは単なるヒントであり、保証されるものではありません。
  • forceCancelAsyncRequestを使用してリクエストを強制的に取り消すための前提条件が満たされているかどうかを確認します。このチェックには、ジョブ・リクエストが実行されていないことの検証は含まれません。このチェックは手動で行う必要があります。
  • リクエストが保留可能かどうかを示します。これは、このリクエストのリクエスト・タイプおよび現在の状態に基づきます。このリクエストを保留できるかどうかについては、これは単なるヒントであり、保証されるものではありません。
  • リクエストがタイムアウトしたかどうかを示します。
  • このリクエストに関連付けられているジョブまたはジョブ・セット定義
  • このリクエストに指定されたジョブ定義またはジョブ・セットの説明
  • このリクエストのジョブ定義/ジョブ・セットの表示名
  • このリクエストに関連付けられたジョブ・タイプ識別子。
  • このリクエストに関連付けられている最後のスケジュール・インスタンス・リクエストID。この値は、特定のリクエスト・タイプに対してのみ意味があります。その他のリクエスト・タイプでは、意味がなく、ゼロ(0)になります。RequestType.RECUR_PARENTまたはRequestType.JOBSET_RECUR_PARENTリクエストの場合、この値は、最後に作成されたインスタンスの親リクエストのIDを表します。スケジュールが終了したか、取り消された場合、これはスケジュールに対して最後に作成されたインスタンス・リクエストのIDです。RequestType.RECUR_CHILDまたはRequestType.JOBSET_RECUR_CHILDリクエストの場合、この値はスケジュールの前のインスタンスに対するリクエストのIDを表します。スケジュールの最初のインスタンス・リクエストの値はゼロ(0)です。
  • 現在の実行試行中にこのリクエストによって発行された最後のサブリクエストに割り当てられたセット番号。このリクエストによってサブリクエストが発行されていない場合、この値はゼロになります。pausedCountがlastSubrequestSetと等しい場合、最後のサブリクエストが発行されてから、このリクエストは一時停止しています。この値は、これらのサブリクエストに割り当てられたセット番号を表します。pausedCountがlastSubrequestSetと等しくない場合、このリクエストが最後に一時停止されてから1つ以上のサブリクエストが発行されています。この値は、このリクエストの一時停止を待機しているサブリクエストに割り当てられているセット番号を表します。
  • RequestLinks
  • リクエストを発行したユーザーとしてリクエストの作成が完了したときのオプションの通知コールバックのURL
  • このリクエストが作成されたときの直接の親リクエストの実行試行の値。このリクエストに直接の親がない場合、この値はゼロになります。
  • このリクエストの直接の親のリクエストID。リクエストに直接の親がない場合、このメソッドによって意味がないとして返される値
  • このリクエストが現在の実行試行中に一時停止された回数。この値は、サブリクエストを実行できるようにリクエストが一時停止されると増分されます。このリクエストが一時停止されていない場合、この値はゼロになります。
  • このリクエストの前の状態。リクエストの状態が変更されていない場合、空になることがあります。
  • リクエスト優先度。優先度の範囲は[0..9]であり、0が最も低い優先度で9が最も高い優先度です。
  • リクエストの処理が終了した時刻(ISO 8601日時形式)
  • リクエストのプロセス・グループ
  • リクエストを処理した中間層インスタンスの名前。
  • このリクエストのプロセス・フェーズ
  • プロセス・フェーズのローカライズされた説明
  • リクエストの処理が開始された時刻(ISO 8601日時形式)
  • リクエストに関連付けられた製品。これは、SYS_productシステム・プロパティの値に対応します。
  • このリクエストのリクエスト・カテゴリ・プロパティ
  • これは、リクエストのリクエストされた終了時間を表します。文字列はISO 8601日時形式です。
  • リクエストの実行がリクエストされた時刻。文字列はISO 8601日時形式です。
  • requestParameters
    このリクエストに関連付けられたすべてのリクエスト・パラメータ(システム・プロパティを含む)
  • 指定できる値: [ "SINGLETON", "RECUR_PARENT", "RECUR_CHILD", "JOBSET_SINGLETON", "JOBSET_STEP", "JOBSET_RECUR_PARENT", "JOBSET_RECUR_CHILD", "SUB_REQUEST", "UNKNOWN" ]
    リクエストの不変タイプ
  • このリクエストが再試行された回数。
  • リクエストのRunAsユーザー
  • ScheduleOut
  • スケジュールが別のリソースの場合にのみ、このリクエストに関連付けられているスケジュールを識別します。リクエスト発行時にインラインで指定されたスケジュール(アドホック・スケジュール)については、「スケジュール」フィールドを参照してください。
  • リクエストのスケジュール済開始時間。文字列はISO 8601日時形式です。
  • リクエストの状態
  • リクエスト状態が最後に変更された時刻(ISO 8601日時形式)。リクエストの状態が変更されていない場合、空になることがあります。
  • ジョブ・リクエストの状態を説明するローカライズされた文字列
  • このリクエストのJobSet stepID。リクエストは、stepID値で示すことができる、JobSet内のステップである場合とそうでない場合があります。
  • リクエスト発行時刻(ISO8601日時形式)。
  • リクエストを発行したユーザーの名前
  • リクエストを発行したユーザーのGUID。
  • サブリクエストの発行時に割り当てられたセット番号。親が複数のサブリクエストを発行してから一時停止すると、それらのサブリクエストはすべて同じセット番号になります。これはサブリクエストに対してのみ意味があり、この場合、この値はゼロより大きい値になります。サブリクエストではないリクエストの値はゼロです。
ネストされたスキーマ: requestParameters
型: array
このリクエストに関連付けられたすべてのリクエスト・パラメータ(システム・プロパティを含む)
ソースの表示
ネストされたスキーマ: ScheduleOut
すべてに一致
ソースの表示
ネストされたスキーマ: RequestParameter
型: object
リクエスト・パラメータ
ソースの表示
ネストされたスキーマ: ScheduleBase
型: object
ソースの表示
ネストされたスキーマ: ScheduleOut-allOf[1]
型: object
ソースの表示
ネストされたスキーマ: exclusions
型: array
ソースの表示
ネストされたスキーマ: inclusions
型: array
ソースの表示
ネストされたスキーマ: recurrences
型: array
一連の繰返し。スケジュールの出現回数は、個々の繰返しによって生成された出現の和集合になります。
ソースの表示
ネストされたスキーマ: Recurrence
型: object
ソースの表示
  • この繰返しオブジェクトの終了日時を設定します。オブジェクトは秒までの時間のみを抽出します。ミリ秒精度はサポートされていません。値は、ISO 8601形式の文字列です。
  • スケジュールで使用する繰返しパターンを定義します。文字列は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式に存在できません。
  • この繰返しオブジェクトの開始日時を設定します。オブジェクトは秒までの時間のみを抽出します。ミリ秒精度はサポートされていません。値は、ISO 8601形式の文字列です。
ネストされたスキーマ: permissions
型: array
このAPIの現在のユーザーがこのリソースに対して持つ権限のセット
ソースの表示
  • 指定できる値: [ "READ", "CREATE", "UPDATE", "DELETE", "EXECUTE" ]
ネストされたスキーマ: resourceBundles
型: array
このジョブに関連付けられたJavaリソース・バンドル
ソースの表示

400レスポンス

入力が無効です
本文()
ルート・スキーマ: SimpleExceptionDetail
型: object
ソースの表示
  • 詳細エラー・メッセージ
  • ESS固有のエラー・コード。たとえば、ESS-00500などです。
  • HTTPステータス・コード
  • 要約エラー・メッセージ
  • URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。

403レスポンス

この操作では許可されません
本文()
ルート・スキーマ: SimpleExceptionDetail
型: object
ソースの表示
  • 詳細エラー・メッセージ
  • ESS固有のエラー・コード。たとえば、ESS-00500などです。
  • HTTPステータス・コード
  • 要約エラー・メッセージ
  • URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。

404レスポンス

見つかりません
本文()
ルート・スキーマ: SimpleExceptionDetail
型: object
ソースの表示
  • 詳細エラー・メッセージ
  • ESS固有のエラー・コード。たとえば、ESS-00500などです。
  • HTTPステータス・コード
  • 要約エラー・メッセージ
  • URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。

500レスポンス

スケジューリング・サブシステム・エラーが発生しました
本文()
ルート・スキーマ: SimpleExceptionDetail
型: object
ソースの表示
  • 詳細エラー・メッセージ
  • ESS固有のエラー・コード。たとえば、ESS-00500などです。
  • HTTPステータス・コード
  • 要約エラー・メッセージ
  • URI。チームがアプリケーション固有の問題タイプを提供できる場合に役立ちます。そうでない場合は、少なくともHTTPエラー・コード・ページにリンクする必要があります。
先頭に戻る