UpdatePolarClawCronJob - PolarDB - Alibaba Cloud Documentation Center

Memperbarui konfigurasi tugas terjadwal PolarClaw, memungkinkan pembaruan field secara parsial.

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-xxx
JobId	string	Yes	ID tugas terjadwal yang akan diperbarui.	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	No	Nama baru untuk tugas tersebut.	afternoon-report
Schedule	object	No	Konfigurasi penjadwalan.	{"Kind":"cron","Expr":"0 12 * * *","Tz":"America/New_York"}
Kind	string	No	Tipe jadwal.	cron
Expr	string	No	Ekspresi cron.	0 9 * * *
Tz	string	No	Zona waktu.	Asia/Shanghai
StaggerMs	integer	No	Jendela jitter deterministik, dalam milidetik.	0
EveryMs	integer	No	Interval dalam milidetik. Parameter ini diperlukan jika `Schedule.Kind` adalah `every`.	100000
AnchorMs	integer	No	Stempel waktu anchor untuk penyelarasan interval, dalam milidetik.	1777370572518
At	string	No	Stempel waktu ISO 8601. Parameter ini diperlukan jika `Schedule.Kind` adalah `at`. Contoh: `2026-04-10T09:00:00+08:00`.	2026-04-10T09:00:00+08:00
SessionTarget	string	No	Target sesi baru.	isolated
WakeMode	string	No	Mode bangun baru.	now
Payload	object	No	Konfigurasi payload baru.	{"Kind":"agentTurn","Message":"Updated: Generate afternoon report."}
Kind	string	No	Tipe payload. Nilai yang valid adalah `agentTurn` (untuk percakapan Agent) atau `systemEvent` (untuk event sistem).	agentTurn
Message	string	No	Prompt untuk percakapan Agent. Parameter ini diperlukan jika `Payload.Kind` adalah `agentTurn`.	Generate the daily report and send it to the team.
Text	string	No	Teks untuk event sistem. Parameter ini diperlukan jika `Payload.Kind` adalah `systemEvent`.	Send a reminder to the user.
Model	string	No	Penggantian model.	anthropic/sonnet-4.6
Fallbacks	array	No	Daftar model fallback.
	string	No	Model fallback.	modelA
Thinking	string	No	Tingkat thinking. Nilai yang valid: `off`, `minimal`, `low`, `medium`, `high`, dan `xhigh`.	medium
TimeoutSeconds	integer	No	Batas waktu eksekusi dalam detik.	10
LightContext	boolean	No	Menentukan apakah akan menggunakan konteks ringan.	false
Deliver	boolean	No	Menentukan apakah akan mengirimkan output ke channel.	false
Channel	string	No	ID channel pengiriman.	telegram
To	string	No	Target pengiriman.	team
BestEffortDeliver	boolean	No	Menentukan apakah akan mengabaikan kegagalan pengiriman.
AgentId	string	No	ID Agent yang menjalankan tugas.	work
SessionKey	string	No	Kunci routing sesi.	agent:main:feishu:direct:***
Description	string	No	Deskripsi baru untuk tugas tersebut.	Daily report generation
Enabled	boolean	No	Menentukan apakah tugas diaktifkan.	false
DeleteAfterRun	boolean	No	Menentukan apakah akan menghapus tugas setelah eksekusi pertamanya.	true
Delivery	object	No	Konfigurasi pengiriman hasil.	{"Mode":"announce","Channel":"telegram"}
Mode	string	No	Mode pengiriman. Nilai yang valid: `none`, `announce`, dan `webhook`.	announce
Channel	string	No	Channel pengiriman.	telegram
AccountId	string	No	ID akun untuk channel.	accountId123
To	string	No	Target pengiriman. Parameter ini diperlukan dan harus berupa URL jika `Delivery.Mode` adalah `webhook`.	https://example.com/webhook
BestEffort	boolean	No	Menentukan apakah akan mengabaikan kegagalan pengiriman.	false
FailureAlert	object	No	Konfigurasi untuk alert kegagalan. Atur ini ke `false` untuk menonaktifkan alert.	{"After":3,"Channel":"telegram"}
After	integer	No	Jumlah kegagalan berturut-turut setelah itu alert akan dikirim.	3
Channel	string	No	Channel alert.	email
AccountId	string	No	ID akun untuk channel.	accountId123
To	string	No	Target alert.	user@example.com
CooldownMs	integer	No	Interval minimum antara dua alert, dalam milidetik.	5000
Mode	string	No	Mode alert. Nilai yang valid: `announce` dan `webhook`.	announce
Restart	boolean	No	Menentukan apakah akan me-restart gateway setelah pembaruan. Nilai default: `true`.	true

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
Message	string	Pesan sukses.	successful
Code	integer	Kode status HTTP.	200
ApplicationId	string	ID aplikasi.	pa-**************
Ok	boolean	Menunjukkan apakah operasi berhasil.	true
Job	object	Detail dari job yang diperbarui.
Id	string	ID job (UUID).	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	Nama job.	daily-report
Enabled	boolean	Menunjukkan apakah job diaktifkan.	false
DeleteAfterRun	boolean	Menunjukkan apakah job dihapus setelah eksekusi pertamanya.	false
CreatedAtMs	integer	Stempel waktu pembuatan, dalam milidetik.	1777368967284
UpdatedAtMs	integer	Stempel waktu pembaruan terakhir, dalam milidetik.	1777370572517
Schedule	object	Konfigurasi jadwal.
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. Nilai yang valid: `main`, `isolated`, atau `current`.	main
WakeMode	string	Mode bangun. Nilai yang valid: `now` atau `next-heartbeat`.	now
Payload	object	Konfigurasi payload eksekusi.
Kind	string		agentTurn
Message	string		Generate the daily report.
Text	string		Generate the daily report.
Model	string		anthropic/sonnet-4.6
TimeoutSeconds	integer		10
LightContext	boolean		false
Deliver	boolean		false
Channel	string		telegram
To	string		team
BestEffortDeliver	boolean		false
AgentId	string	ID opsional Agent yang menjalankan job.	work
SessionKey	string	Kunci routing sesi opsional.	abc123
Description	string	Deskripsi job opsional.	Daily report generation
Delivery	object	Konfigurasi pengiriman hasil opsional.
Mode	string		announce
Channel	string		telegram
AccountId	string		default
To	string		https://example.com/webhook
BestEffort	boolean
State	object	Status berjalan dari job.
NextRunAtMs	integer		1777424400000
LastRunAtMs	integer		1777370544931
LastRunStatus	string		ok
ConsecutiveErrors	integer		0
Runs	array<object>	Riwayat eksekusi. Dikembalikan hanya jika `IncludeRuns` adalah `true`.
	array<object>	Detail dari satu eksekusi job.
Ts	integer		1777370572518
JobId	string		0ee00f56-f467-4d41-858c-ca4ede2c770e
Action	string		finished
Status	string		ok
Summary	string		Report generated successfully.
Delivered	boolean		true
DeliveryStatus	string		delivered
SessionId	string		abc123
RunAtMs	integer		1777370544931
DurationMs	integer		27586
NextRunAtMs	integer		1777424400000
Model	string		anthropic/sonnet-4.6
Provider	string		anthropic
Usage	object
InputTokens	integer		30250
OutputTokens	integer		30250
TotalTokens	integer		60500
JobName	string		daily-report

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2281C6C9-CBAB-1AFD-8400-670750CF6025_2212",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "Ok": true,
  "Job": {
    "Id": "0ee00f56-f467-4d41-858c-ca4ede2c770e",
    "Name": "daily-report",
    "Enabled": false,
    "DeleteAfterRun": false,
    "CreatedAtMs": 1777368967284,
    "UpdatedAtMs": 1777370572517,
    "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": "agentTurn",
      "Message": "Generate the daily report.",
      "Text": "Generate the daily report.",
      "Model": "anthropic/sonnet-4.6",
      "TimeoutSeconds": 10,
      "LightContext": false,
      "Deliver": false,
      "Channel": "telegram",
      "To": "team",
      "BestEffortDeliver": false
    },
    "AgentId": "work",
    "SessionKey": "abc123",
    "Description": "Daily report generation",
    "Delivery": {
      "Mode": "announce",
      "Channel": "telegram",
      "AccountId": "default",
      "To": "https://example.com/webhook",
      "BestEffort": false
    },
    "State": {
      "NextRunAtMs": 1777424400000,
      "LastRunAtMs": 1777370544931,
      "LastRunStatus": "ok",
      "ConsecutiveErrors": 0
    },
    "Runs": [
      {
        "Ts": 1777370572518,
        "JobId": "0ee00f56-f467-4d41-858c-ca4ede2c770e",
        "Action": "finished",
        "Status": "ok",
        "Summary": "Report generated successfully.",
        "Delivered": true,
        "DeliveryStatus": "delivered",
        "SessionId": "abc123",
        "RunAtMs": 1777370544931,
        "DurationMs": 27586,
        "NextRunAtMs": 1777424400000,
        "Model": "anthropic/sonnet-4.6",
        "Provider": "anthropic",
        "Usage": {
          "InputTokens": 30250,
          "OutputTokens": 30250,
          "TotalTokens": 60500
        },
        "JobName": "daily-report"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.