DescribePolarClawCronJobs - PolarDB - Alibaba Cloud Documentation Center

Mengambil semua atau tugas terjadwal tertentu di PolarClaw beserta detailnya.

Deskripsi operasi

Deskripsi permintaan

Anda dapat menggunakan API ini untuk mengambil semua tugas terjadwal di aplikasi PolarClaw atau memfilter tugas tertentu menggunakan parameter JobIdList.
Jika Anda tidak menentukan parameter JobIdList, API akan mengembalikan semua tugas terjadwal dalam aplikasi.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
ApplicationId	string	Yes	ID Aplikasi	pa-**************
JobIdList	array	No	Memfilter berdasarkan daftar ID Tugas	0ee00f56-f467-4d41-858c-ca4ede2c770e,1ee00f56-f467-4d41-858c-ca4ede2c770f
	string	No	ID Tugas	0ee00f56-f467-4d41-858c-ca4ede2c770e
IncludeDisabled	boolean	No	Sertakan tugas yang dinonaktifkan. Default adalah true.	true
IncludeRuns	boolean	No	Sertakan riwayat eksekusi. Default adalah false.	true
RunLimit	integer	No	Jumlah maksimum entri riwayat eksekusi per tugas. Default adalah 10.	10

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
RequestId	string	ID Permintaan	2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
Message	string	Pesan respons	successful
Code	integer	Kode status	200
ApplicationId	string	ID Aplikasi	pa-**************
Jobs	array<object>	Daftar tugas terjadwal
	array<object>	Tugas terjadwal
Id	string	ID Tugas (UUID)	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	Nama tugas	test
Enabled	boolean	Apakah diaktifkan	true
DeleteAfterRun	boolean	Hapus setelah eksekusi pertama	false
CreatedAtMs	integer	Stempel waktu pembuatan (milidetik)	1777370572517
UpdatedAtMs	integer	Stempel waktu pembaruan (milidetik)	1777368967284
Schedule	object	Konfigurasi Penjadwalan
Kind	string		cron
Expr	string		0 9 * * *
Tz	string		Asia/Shanghai
EveryMs	integer		100000
AnchorMs	integer		1777370572518
At	string		2026-04-10T09:00:00+08:00
SessionTarget	string	Target sesi: main/isolated/current	main
WakeMode	string	Mode bangun: now/next-heartbeat	now
Payload	object	Payload eksekusi
Kind	string		systemEvent
Message	string		Generate the daily report.
Text	string		Generate the daily report.
Model	string		bailian/qwen3.5-plus
TimeoutSeconds	integer		10
LightContext	boolean		false
Deliver	boolean		true
Channel	string		feishu
To	string		ou_***
BestEffortDeliver	boolean		false
AgentId	string	ID Agent eksekusi	main
SessionKey	string	Kunci routing sesi	agent:main:feishu:direct:***
Description	string	Deskripsi tugas	Daily report generation
Delivery	object	Konfigurasi pengiriman hasil
Mode	string		announce
Channel	string		feishu
AccountId	string		default
To	string		ou_***
BestEffort	boolean		false
State	object	Status eksekusi
NextRunAtMs	integer		1777424400000
LastRunAtMs	integer		1777370544931
LastRunStatus	string		ok
ConsecutiveErrors	integer		0
Runs	array<object>	Riwayat eksekusi
	array<object>	Riwayat eksekusi
Ts	integer		1777370572518
JobId	string		f83f5278-1abe-40a6-b10e-ad3ecdc05de2
Action	string		finished
Status	string		ok
Summary	string		Generate the daily report.
Delivered	boolean		false
DeliveryStatus	string		not-requested
SessionId	string		***
RunAtMs	integer		1777370544931
DurationMs	integer		27586
NextRunAtMs	integer		1777424400000
Model	string		bailian/qwen3.5-plus
Provider	string		bailian
Usage	object
InputTokens	integer		30250
OutputTokens	integer		30250
TotalTokens	integer		60500
JobName	string		test
Total	integer	Jumlah total tugas	1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2281C6C9-CBAB-1AFD-8400-670750CF6025_2212",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "Jobs": [
    {
      "Id": "0ee00f56-f467-4d41-858c-ca4ede2c770e",
      "Name": "test",
      "Enabled": true,
      "DeleteAfterRun": false,
      "CreatedAtMs": 1777370572517,
      "UpdatedAtMs": 1777368967284,
      "Schedule": {
        "Kind": "cron",
        "Expr": "0 9 * * *",
        "Tz": "Asia/Shanghai",
        "EveryMs": 100000,
        "AnchorMs": 1777370572518,
        "At": "2026-04-10T09:00:00+08:00"
      },
      "SessionTarget": "main",
      "WakeMode": "now",
      "Payload": {
        "Kind": "systemEvent",
        "Message": "Generate the daily report.",
        "Text": "Generate the daily report.",
        "Model": "bailian/qwen3.5-plus",
        "TimeoutSeconds": 10,
        "LightContext": false,
        "Deliver": true,
        "Channel": "feishu",
        "To": "ou_***",
        "BestEffortDeliver": false
      },
      "AgentId": "main",
      "SessionKey": "agent:main:feishu:direct:***",
      "Description": "Daily report generation",
      "Delivery": {
        "Mode": "announce",
        "Channel": "feishu",
        "AccountId": "default",
        "To": "ou_***",
        "BestEffort": false
      },
      "State": {
        "NextRunAtMs": 1777424400000,
        "LastRunAtMs": 1777370544931,
        "LastRunStatus": "ok",
        "ConsecutiveErrors": 0
      },
      "Runs": [
        {
          "Ts": 1777370572518,
          "JobId": "f83f5278-1abe-40a6-b10e-ad3ecdc05de2",
          "Action": "finished",
          "Status": "ok",
          "Summary": "Generate the daily report.",
          "Delivered": false,
          "DeliveryStatus": "not-requested",
          "SessionId": "***",
          "RunAtMs": 1777370544931,
          "DurationMs": 27586,
          "NextRunAtMs": 1777424400000,
          "Model": "bailian/qwen3.5-plus",
          "Provider": "bailian",
          "Usage": {
            "InputTokens": 30250,
            "OutputTokens": 30250,
            "TotalTokens": 60500
          },
          "JobName": "test"
        }
      ]
    }
  ],
  "Total": 1
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.