Pular para o conteúdo principal

kobana kadu schedules

Comandos de kobana kadu schedules. Toda opção global (Opções globais) vale aqui.

ComandoHTTPDescrição
schedules listGET /v1/schedulesLista agendamentos
schedules createPOST /v1/schedulesAgenda uma Task num ambiente
schedules getGET /v1/schedules/{id}Detalha o agendamento
schedules updatePATCH /v1/schedules/{id}Altera, pausa ou retoma agendamento
schedules deleteDELETE /v1/schedules/{id}Cancela agendamento (soft delete)

schedules list​

Lista agendamentos

kobana kadu schedules list [OPÇÕES]

GET /v1/schedules

Parâmetros de consulta

NomeTipoObrigatórioDescrição
cursorstringnão
limitnumbernão
sort_bystringnãoCampo em snake_case: created_at (padrão), updated_at ou um campo filtrável.
sort_orderstringnãoPadrão: desc. Valores: asc, desc.

Respostas

HTTPDescrição
200OK
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

schedules create​

Agenda uma Task num ambiente

kobana kadu schedules create [OPÇÕES]

POST /v1/schedules

Um agendamento por Task e ambiente. Agendamento não empilha: o disparo é pulado se a Task já tem execução ativa ou na fila.

Corpo da requisição

NomeTipoObrigatórioDescrição
task_idstring (uuid)sim
environment_idstring (uuid)sim
cronstringsim
timezonestringnão
pausedbooleannão

Outros campos e objetos aninhados: kobana schema kadu.schedules.create.

Respostas

HTTPDescrição
201created
409CONFLICT — a Task já tem agendamento no ambiente (details.schedule_id) / IDEMPOTENCY_KEY_REUSED
422INVALID_CRON / VALIDATION_ERROR — Task ou ambiente fora da organização
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

schedules get​

Detalha o agendamento

kobana kadu schedules get [ID] [OPÇÕES]

GET /v1/schedules/{id}

Argumentos do caminho: id

Respostas

HTTPDescrição
200OK
404not found
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

schedules update​

Altera, pausa ou retoma agendamento

kobana kadu schedules update [ID] [OPÇÕES]

PATCH /v1/schedules/{id}

paused: true mantém o cron e faz o dispatcher pular o agendamento.

Argumentos do caminho: id

Corpo da requisição

NomeTipoObrigatórioDescrição
cronstringnão
timezonestringnão
pausedbooleannão

Outros campos e objetos aninhados: kobana schema kadu.schedules.update.

Respostas

HTTPDescrição
200OK
404NOT_FOUND
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (ou CONFLICT da rota)
422INVALID_CRON
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

schedules delete​

Cancela agendamento (soft delete)

kobana kadu schedules delete [ID] [OPÇÕES]

DELETE /v1/schedules/{id}

Um novo POST para a mesma Task e ambiente reativa o agendamento.

Argumentos do caminho: id

Respostas

HTTPDescrição
200OK
404NOT_FOUND
409REPO_MANAGED — declarado no schedules do frontmatter da skill: remova-o de lá
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).