Saltar al contenido principal

kobana kadu schedules

Comandos de kobana kadu schedules. Toda opción global (Opciones globales) vale aquí.

ComandoHTTPDescripción
schedules listGET /v1/schedulesLista programaciones
schedules createPOST /v1/schedulesPrograma una Task en un entorno
schedules getGET /v1/schedules/{id}Detalla la programación
schedules updatePATCH /v1/schedules/{id}Modifica, pausa o reanuda una programación
schedules deleteDELETE /v1/schedules/{id}Cancela la programación (soft delete)

schedules list​

Lista programaciones

kobana kadu schedules list [OPCIONES]

GET /v1/schedules

Parámetros de consulta

NombreTipoObligatorioDescripción
cursorstringno
limitnumberno
sort_bystringnoCampo en snake_case: created_at (predeterminado), updated_at o un campo filtrable.
sort_orderstringnoPredeterminado: desc. Valores: asc, desc.

Respuestas

HTTPDescripción
200OK
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

schedules create​

Programa una Task en un entorno

kobana kadu schedules create [OPCIONES]

POST /v1/schedules

Una programación por Task y entorno. La programación no se apila: el lanzamiento se omite si la Task ya tiene una ejecución activa o en cola.

Cuerpo de la solicitud

NombreTipoObligatorioDescripción
task_idstring (uuid)sí
environment_idstring (uuid)sí
cronstringsí
timezonestringno
pausedbooleanno

Otros campos y objetos anidados: kobana schema kadu.schedules.create.

Respuestas

HTTPDescripción
201created
409CONFLICT — la Task ya tiene una programación en el entorno (details.schedule_id) / IDEMPOTENCY_KEY_REUSED
422INVALID_CRON / VALIDATION_ERROR — Task o entorno fuera de la organización
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

schedules get​

Detalla la programación

kobana kadu schedules get [ID] [OPCIONES]

GET /v1/schedules/{id}

Argumentos de la ruta: id

Respuestas

HTTPDescripción
200OK
404not found
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

schedules update​

Modifica, pausa o reanuda una programación

kobana kadu schedules update [ID] [OPCIONES]

PATCH /v1/schedules/{id}

paused: true mantiene el cron y hace que el dispatcher omita la programación.

Argumentos de la ruta: id

Cuerpo de la solicitud

NombreTipoObligatorioDescripción
cronstringno
timezonestringno
pausedbooleanno

Otros campos y objetos anidados: kobana schema kadu.schedules.update.

Respuestas

HTTPDescripción
200OK
404NOT_FOUND
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (o CONFLICT de la ruta)
422INVALID_CRON
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

schedules delete​

Cancela la programación (soft delete)

kobana kadu schedules delete [ID] [OPCIONES]

DELETE /v1/schedules/{id}

Un nuevo POST para la misma Task y entorno reactiva la programación.

Argumentos de la ruta: id

Respuestas

HTTPDescripción
200OK
404NOT_FOUND
409REPO_MANAGED — declarado en el schedules del frontmatter de la skill: quítalo de allí
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).