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

Consulta todas las tareas programadas o tareas específicas en PolarClaw y sus detalles.

Descripción de la operación

Descripción de la solicitud

Puede utilizar esta API para obtener todas las tareas programadas en una aplicación de PolarClaw o filtrar tareas específicas mediante el parámetro JobIdList.
Si no especifica el parámetro JobIdList, la API devuelve todas las tareas programadas en la aplicación.

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

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:DescribePolarClawCronJobs

none

*Application

acs:polardb:{#regionId}:{#accountId}:application/{#ApplicationId}

Ninguna

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-**************
JobIdList	array	No	Filtra por una lista de ID de trabajos.	0ee00f56-f467-4d41-858c-ca4ede2c770e,1ee00f56-f467-4d41-858c-ca4ede2c770f
	string	No	El ID del trabajo.	0ee00f56-f467-4d41-858c-ca4ede2c770e
IncludeDisabled	boolean	No	Incluye las tareas deshabilitadas. El valor predeterminado es true.	true
IncludeRuns	boolean	No	Incluye el historial de ejecuciones. El valor predeterminado es false.	true
RunLimit	integer	No	El número máximo de entradas del historial de ejecuciones por tarea. El valor predeterminado es 10.	10

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
Message	string	El mensaje de respuesta.	successful
Code	integer	El código de estado.	200
ApplicationId	string	El ID de la aplicación.	pa-**************
Jobs	array<object>	La lista de tareas programadas.
	array<object>	La tarea programada.
Id	string	El ID de la tarea (UUID).	0ee00f56-f467-4d41-858c-ca4ede2c770e
Name	string	El nombre de la tarea.	test
Enabled	boolean	Indica si está habilitada.	true
DeleteAfterRun	boolean	Eliminar después de la primera ejecución.	false
CreatedAtMs	integer	La marca de tiempo de creación (milisegundos).	1777370572517
UpdatedAtMs	integer	La marca de tiempo de actualización (milisegundos).	1777368967284
Schedule	object	La configuración de programación.
Kind	string	El tipo de programación: cron/every/at.	cron
Expr	string	La expresión cron.	0 9 * * *
Tz	string	La zona horaria IANA.	Asia/Shanghai
EveryMs	integer	El intervalo en milisegundos.	100000
AnchorMs	integer	La marca de tiempo de anclaje de alineación para el intervalo.	1777370572518
At	string	La marca de tiempo ISO 8601.	2026-04-10T09:00:00+08:00
SessionTarget	string	El destino de sesión: main/isolated/current.	main
WakeMode	string	El modo de activación: now/next-heartbeat.	now
Payload	object	El payload de ejecución.
Kind	string	El tipo de payload: agentTurn/systemEvent.	systemEvent
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.	bailian/qwen3.5-plus
TimeoutSeconds	integer	El tiempo de espera de ejecución en segundos.	10
LightContext	boolean	Indica si se utiliza contexto ligero.	false
Deliver	boolean	Entregar salida al canal.	true
Channel	string	El ID del canal de entrega.	feishu
To	string	El destino de entrega.	ou_***
BestEffortDeliver	boolean	Ignorar fallos de entrega.	false
AgentId	string	El ID del agente de ejecución.	main
SessionKey	string	La clave de enrutamiento de sesión.	agent:main:feishu:direct:***
Description	string	La descripción de la tarea.	Generación de informe diario
Delivery	object	La configuración de entrega de resultados.
Mode	string	El modo de entrega: none/announce/webhook.	announce
Channel	string	El canal de entrega.	feishu
AccountId	string	El ID de cuenta del canal.	default
To	string	El destino de entrega.	ou_***
BestEffort	boolean	Ignorar fallos de entrega.	false
State	object	El estado de ejecución.
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución (milisegundos).	1777424400000
LastRunAtMs	integer	La marca de tiempo de la última ejecución (milisegundos).	1777370544931
LastRunStatus	string	El estado de la última ejecución.	ok
ConsecutiveErrors	integer	El número de fallos consecutivos.	0
Runs	array<object>	El historial de ejecuciones.
	array<object>	El historial de ejecuciones.
Ts	integer	La marca de tiempo de ejecución (milisegundos).	1777370572518
JobId	string	El ID de la tarea asociada.	f83f5278-1abe-40a6-b10e-ad3ecdc05de2
Action	string	La acción: finished/error/skipped.	finished
Status	string	El estado: ok/error/skipped.	ok
Summary	string	El texto de resumen de ejecución.	Genere el informe diario
Delivered	boolean	Indica si la tarea ha sido entregada.	false
DeliveryStatus	string	El estado de entrega.	not-requested
SessionId	string	El ID de sesión asociado.	***
RunAtMs	integer	La marca de tiempo de ejecución real (milisegundos).	1777370544931
DurationMs	integer	La duración de la ejecución (milisegundos).	27586
NextRunAtMs	integer	La marca de tiempo de la próxima ejecución (milisegundos).	1777424400000
Model	string	El modelo utilizado.	bailian/qwen3.5-plus
Provider	string	El proveedor del modelo.	bailian
Usage	object	Los detalles de 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 de la tarea.	test
Total	integer	El número total de tareas.	1

Ejemplos

Respuesta exitosa

JSON Formato

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

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.