すべてのプロダクト
Search
ドキュメントセンター

Qoder CN シリーズ:List schedule runs

最終更新日:Jul 04, 2026

ページネーションを使用して、スケジュール実行の記録を一覧表示します。

リクエストヘッダー

ヘッダー

必須

説明

Authorization

はい

Bearer <PAT>

クエリパラメーター

パラメーター

タイプ

必須

デフォルト

説明

identity_id

文字列

はい

-

実行の所有者である Forward Identity の ID。

schedule_id

文字列

いいえ

-

スケジュール ID でフィルターします。

status

文字列

いいえ

-

pendingrunningcompletedfailed、または skipped でフィルタリングします。

trigger_type

文字列

いいえ

-

スケジュールまたは手動で絞り込みます。

has_error

ブール値

いいえ

-

エラーが含まれる、または含まれない実行のみを返します。

limit

整数

いいえ

20

ページサイズ。最大 100 です。

after_id

文字列

いいえ

-

次のページのカーソル。

before_id

文字列

いいえ

-

前のページのカーソル。

リクエスト例

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/schedule_runs' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "srun_019f00112233445566778899aabbccdd",
      "schedule_id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "session_id": "sess_019ec55a68b37e1e8d660691af161ab4",
      "status": "completed",
      "trigger_context": {
        "type": "schedule",
        "scheduled_at": "2026-06-22T01:00:00Z"
      },
      "result_payload": "Today's technology highlights: ...",
      "push_sink": "im_channel",
      "push_status": "succeeded",
      "push_finished_at": "2026-06-22T01:00:21Z",
      "attempt": 1,
      "triggered_at": "2026-06-22T01:00:00Z",
      "started_at": "2026-06-22T01:00:03Z",
      "completed_at": "2026-06-22T01:00:20Z",
      "duration_ms": 17000,
      "created_at": "2026-06-22T01:00:00Z"
    }
  ],
  "first_id": "srun_019f00112233445566778899aabbccdd",
  "last_id": "srun_019f00112233445566778899aabbccdd",
  "has_more": false
}

レスポンスフィールド

フィールド

タイプ

説明

data

配列

現在のページにあるスケジュール実行オブジェクトの配列。

first_id

文字列 | null

現在のページの最初の実行の ID。

last_id

文字列 | null

現在のページの最後の実行の ID。

has_more

ブール値

続きのレコードがあるかどうか。

data[] の各項目は、「スケジュール実行の取得」と同じフィールドを持つスケジュール実行オブジェクトで、trigger_contexterrorpush_sinkpush_status、および実行タイミングのフィールドを含みます。

エラー

HTTP

タイプ

コード

トリガー

400

invalid_request_error

invalid_identity

identity_id が欠落しているか、無効です。

400

invalid_request_error

invalid_pagination

ページネーションのパラメーターが無効です。

401

authentication_error

authentication_required

PAT が無効か、期限切れです。

注記

  • スケジュール実行は独立したリソースです。

  • completedfailed、および skipped は終了状態です。

  • push_status は IM ストリーミングの配信ステータスを追跡し、メインの status とは独立しています。