Dapatkan run jadwal - Seri Qoder CN - Alibaba Cloud Documentation Center

Mengambil satu Schedule Run berdasarkan ID-nya.

GET /api/v1/forward/schedule_runs/{run_id}

Menampilkan satu catatan Schedule Run. Anda dapat menambahkan identity_id sebagai batasan kepemilikan tambahan.

Header permintaan

Header	Wajib	Deskripsi
Authorization	Ya	`Bearer <PAT>`

Parameter path

Parameter	Tipe	Wajib	Deskripsi
run_id	string	Ya	Schedule Run ID.

Parameter kueri

Parameter	Tipe	Wajib	Bawaan	Deskripsi
identity_id	string	Tidak	-	Batasan kepemilikan tambahan.

Contoh permintaan

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

Contoh respons

HTTP 200 OK

{
  "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"
}

Bidang respons

Field	Tipe	Deskripsi
id	string	Schedule Run ID.
schedule_id	string	Parent Schedule ID.
identity_id	string	Forward Identity ID.
template_id	string	Forward Template ID.
session_id	string \| null	Session yang dibuat atau digunakan oleh run ini.
status	string	`pending`, `running`, `completed`, `failed`, atau `skipped`.
trigger_context	object	Sumber pemicu.
error	object \| null	Error terstruktur untuk run yang gagal atau dilewati.
result_payload	string \| null	Hasil teks dari alur eksekusi utama.
error_message	string \| null	Pesan error yang dapat dibaca manusia; detail terstruktur ada di `error`.
push_sink	string \| null	Jenis sink yang digunakan untuk pengiriman IM; `null` jika pengiriman tidak dikonfigurasi.
push_status	string	Status pengiriman IM: `pending`, `succeeded`, `failed`, atau `skipped`. Status alur utama dan status pengiriman bersifat independen.
push_finished_at	string \| null	Waktu penyelesaian pengiriman IM.
attempt	integer	Nomor urutan percobaan; saat ini `1`.
triggered_at	string	Waktu pemicu.
started_at	string \| null	Waktu mulai eksekusi.
completed_at	string \| null	Waktu penyelesaian.
duration_ms	integer \| null	Durasi eksekusi dalam milidetik.
created_at	string	Waktu pembuatan catatan.

Objek Trigger Context

type	Deskripsi
`schedule`	Dipicu secara otomatis oleh `trigger_policy` Schedule, seperti `cron`, `once`, atau `interval`. Mengembalikan `scheduled_at` untuk pemicu otomatis.
`manual`	Dipicu secara manual melalui `POST /api/v1/forward/schedules/{schedule_id}/run`.

Objek Run Error

Objek error merepresentasikan alasan kegagalan atau pelewatkan dalam bentuk terstruktur. Objek ini dikembalikan ketika status=failed atau status=skipped, dan bernilai null jika status=completed.

error.type	Deskripsi
`concurrency_limit_reached`	Schedule yang sama telah mencapai `execution.max_concurrent_runs`. Pemicu telah dicatat tetapi tidak akan dieksekusi.
`session_creation_failed`	Gagal membuat atau mengikat Forward Session.
`execution_failed`	Eksekusi templat gagal.

Kesalahan

HTTP	Tipe	Kode	Kondisi pemicu
404	`not_found_error`	`schedule_run_not_found`	Run tidak ada, lintas penyewa, atau tidak memenuhi batasan `identity_id`.
401	`authentication_error`	`authentication_required`	PAT tidak valid atau kedaluwarsa.

Catatan

error.type=concurrency_limit_reached menunjukkan bahwa pemicu telah dicatat tetapi dilewati karena mencapai batas konkurensi.
Anda dapat melakukan polling pada endpoint ini hingga status mencapai keadaan terminal.