UpdatePolarClawCronJob - PolarDB - Centro de documentación de Alibaba Cloud

Actualiza la configuración de una tarea programada de PolarClaw, lo que permite actualizaciones parciales de campos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ApplicationId	string	Sí	El ID de la aplicación.	pa-xxx
JobId	string	Sí	El ID de la tarea programada que se va a actualizar.	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	No	El nuevo nombre para la tarea.	afternoon-report
Schedule	object	No	La configuración de programación.	{"Kind":"cron","Expr":"0 12 * * *","Tz":"America/New_York"}
Kind	string	No	El tipo de programación.	cron
Expr	string	No	La expresión cron.	0 9 * * *
Tz	string	No	La zona horaria.	Asia/Shanghai
StaggerMs	integer	No	La ventana de variación determinista, en milisegundos.	0
EveryMs	integer	No	El intervalo en milisegundos. Este parámetro es obligatorio si `Schedule.Kind` es `every`.	100000
AnchorMs	integer	No	La marca de tiempo de anclaje para la alineación de intervalos, en milisegundos.	1777370572518
At	string	No	Una marca de tiempo ISO 8601. Este parámetro es obligatorio si `Schedule.Kind` es `at`. Por ejemplo: `2026-04-10T09:00:00+08:00`.	2026-04-10T09:00:00+08:00
SessionTarget	string	No	El nuevo destino de sesión.	isolated
WakeMode	string	No	El nuevo modo de activación.	now
Payload	object	No	La nueva configuración de carga útil.	{"Kind":"agentTurn","Message":"Actualizado: Generar informe vespertino."}
Kind	string	No	El tipo de carga útil. Los valores válidos son `agentTurn` (para una conversación de agente) o `systemEvent` (para un evento del sistema).	agentTurn
Message	string	No	El prompt para la conversación del agente. Este parámetro es obligatorio si `Payload.Kind` es `agentTurn`.	Genere el informe diario y envíelo al equipo
Text	string	No	El texto para el evento del sistema. Este parámetro es obligatorio si `Payload.Kind` es `systemEvent`.	Envíe un recordatorio al usuario
Model	string	No	La anulación de modelo.	anthropic/sonnet-4.6
Fallbacks	array	No	Una lista de modelos alternativos.
	string	No	Un modelo alternativo.	modelA
Thinking	string	No	El nivel de razonamiento. Valores válidos: `off`, `minimal`, `low`, `medium`, `high` y `xhigh`.	medium
TimeoutSeconds	integer	No	El tiempo de espera de ejecución en segundos.	10
LightContext	boolean	No	Especifica si se debe usar un contexto ligero.	false
Deliver	boolean	No	Especifica si se debe entregar la salida a un canal.	false
Channel	string	No	El ID del canal de entrega.	telegram
To	string	No	El destino de entrega.	team
BestEffortDeliver	boolean	No	Especifica si se deben ignorar los fallos de entrega.
AgentId	string	No	El ID del agente que ejecuta la tarea.	work
SessionKey	string	No	La clave de enrutamiento de sesión.	agent:main:feishu:direct:***
Description	string	No	La nueva descripción para la tarea.	Generación de informe diario
Enabled	boolean	No	Especifica si la tarea está habilitada.	false
DeleteAfterRun	boolean	No	Especifica si se debe eliminar la tarea después de su primera ejecución.	true
Delivery	object	No	La configuración de entrega de resultados.	{"Mode":"announce","Channel":"telegram"}
Mode	string	No	El modo de entrega. Valores válidos: `none`, `announce` y `webhook`.	announce
Channel	string	No	El canal de entrega.	telegram
AccountId	string	No	El ID de cuenta para el canal.	accountId123
To	string	No	El destino de entrega. Este parámetro es obligatorio y debe ser una URL si `Delivery.Mode` es `webhook`.	https://example.com/webhook
BestEffort	boolean	No	Especifica si se deben ignorar los fallos de entrega.	false
FailureAlert	object	No	La configuración para las alertas de fallo. Establezca este valor en `false` para deshabilitar las alertas.	{"After":3,"Channel":"telegram"}
After	integer	No	El número de fallos consecutivos tras los cuales se envía una alerta.	3
Channel	string	No	El canal de alerta.	email
AccountId	string	No	El ID de cuenta para el canal.	accountId123
To	string	No	El destino de la alerta.	user@example.com
CooldownMs	integer	No	El intervalo mínimo entre dos alertas, en milisegundos.	5000
Mode	string	No	El modo de alerta. Valores válidos: `announce` y `webhook`.	announce
Restart	boolean	No	Especifica si se debe reiniciar la puerta de enlace después de la actualización. Valor predeterminado: `true`.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de la respuesta.
RequestId	string	El ID de la solicitud.	2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
Message	string	El mensaje de éxito.	successful
Code	integer	El código de estado HTTP.	200
ApplicationId	string	El ID de la aplicación.	pa-**************
Ok	boolean	Indica si la operación se realizó correctamente.	true
Job	object	Detalles del trabajo actualizado.
Id	string	El ID del trabajo (UUID).	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	El nombre del trabajo.	daily-report
Enabled	boolean	Indica si el trabajo está habilitado.	false
DeleteAfterRun	boolean	Indica si el trabajo se elimina después de su primera ejecución.	false
CreatedAtMs	integer	La marca de tiempo de creación, en milisegundos.	1777368967284
UpdatedAtMs	integer	La marca de tiempo de la última actualización, en milisegundos.	1777370572517
Schedule	object	La configuración de programación.
Kind	string	El tipo de programación. Valores válidos: `cron` (expresión cron), `every` (intervalo fijo) o `at` (una sola vez).	cron
Expr	string	La expresión cron. Obligatorio si `Kind` es `cron`.	0 9 * * *
Tz	string	La zona horaria IANA, como `Asia/Shanghai`.	Asia/Shanghai
EveryMs	integer	El intervalo en milisegundos. Obligatorio si `Kind` es `every`.	100000
AnchorMs	integer	La marca de tiempo base para la alineación del intervalo, en milisegundos.	1777370572518
At	string	La marca de tiempo ISO 8601. Obligatorio si `Kind` es `at`.	2026-04-10T09:00:00+08:00
SessionTarget	string	El destino de la sesión. Valores válidos: `main`, `isolated` o `current`.	main
WakeMode	string	El modo de activación. Valores válidos: `now` o `next-heartbeat`.	now
Payload	object	La configuración de carga útil de ejecución.
Kind	string	El tipo de carga útil. Valores válidos: `agentTurn` (conversación de agente) o `systemEvent` (evento del sistema).	agentTurn
Message	string	El prompt de conversación del agente.	Genere el informe diario
Text	string	El texto del evento del sistema.	Genere el informe diario
Model	string	La anulación de modelo.	anthropic/sonnet-4.6
TimeoutSeconds	integer	El tiempo de espera de ejecución opcional, en segundos.	10
LightContext	boolean	Indica si se debe usar un contexto ligero.	false
Deliver	boolean	Indica si se debe entregar la salida a un canal.	false
Channel	string	El ID del canal de entrega opcional.	telegram
To	string	El destino de entrega opcional.	team
BestEffortDeliver	boolean	Indica si se deben ignorar los fallos de entrega.	false
AgentId	string	El ID opcional del agente que ejecuta el trabajo.	work
SessionKey	string	La clave de enrutamiento de sesión opcional.	abc123
Description	string	La descripción opcional del trabajo.	Generación de informe diario
Delivery	object	La configuración opcional de entrega de resultados.
Mode	string	El modo de entrega. Valores válidos: `none`, `announce` o `webhook`.	announce
Channel	string	El canal de entrega.	telegram
AccountId	string	El ID de cuenta del canal opcional.	default
To	string	El destino de entrega. Obligatorio y debe ser una URL si `Mode` es `webhook`.	https://example.com/webhook
BestEffort	boolean	Indica si se deben ignorar los fallos de entrega.
State	object	El estado de ejecución del trabajo.
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución, en milisegundos.	1777424400000
LastRunAtMs	integer	La marca de tiempo opcional de la última ejecución, en milisegundos.	1777370544931
LastRunStatus	string	El estado opcional de la última ejecución.	ok
ConsecutiveErrors	integer	El número de fallos consecutivos.	0
Runs	array<object>	El historial de ejecuciones. Se devuelve solo si `IncludeRuns` es `true`.
	array<object>	Detalles de una sola ejecución del trabajo.
Ts	integer	La marca de tiempo de la ejecución, en milisegundos.	1777370572518
JobId	string	El ID del trabajo asociado.	0ee00f56-f467-4d41-858c-ca4ede2c770e
Action	string	La acción realizada. Valores válidos: `finished`, `error` o `skipped`.	finished
Status	string	El estado de la ejecución. Valores válidos: `ok`, `error` o `skipped`.	ok
Summary	string	El texto de resumen de la ejecución.	Informe generado correctamente
Delivered	boolean	Indica si el resultado se entregó.	true
DeliveryStatus	string	El estado de la entrega.	delivered
SessionId	string	El ID de la sesión asociada.	abc123
RunAtMs	integer	La marca de tiempo real de ejecución, en milisegundos.	1777370544931
DurationMs	integer	La duración de la ejecución, en milisegundos.	27586
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución programada, en milisegundos.	1777424400000
Model	string	El modelo utilizado para la ejecución.	anthropic/sonnet-4.6
Provider	string	El proveedor del modelo.	anthropic
Usage	object	Detalles opcionales del uso de tokens.
InputTokens	integer	El número de tokens de entrada.	30250
OutputTokens	integer	El número de tokens de salida.	30250
TotalTokens	integer	El número total de tokens.	60500
JobName	string	El nombre del trabajo.	daily-report

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.