Rundeck API URL strawmen.md

• Jobs ** List jobs

• [[https://gist.github.com/785084][Query rundeck jobs list for a project, optionally save the xml file]]
  • Existing URL: "/menu/workflows.xml?projFilter={project}"
• Hypothetical alternatives:
  • Jobs-oriented:
    • /jobs.xml?project={project}
    • /jobs/list.xml?project={project}
  • Project-oriented:
    • /projects/jobs.xml?project={project}
    • /projects/{project}/jobs.xml ** Run a job
• [[https://gist.github.com/783971][How to run a job using curl]]
  • Existing URL: "/scheduledExecution/runJobByName.xml?id={jobId}"
• Hypothetical alternatives:
  • Jobs-oriented:
    • /jobs/{jobId}/run.xml
    • /jobs/run.xml?id={jobId}
  • Job-oriented:
    • /job/run.xml?id={jobId}
    • /job/{jobId}/run
    • /job/run/{jobId}.xml ** Queue list
• [[https://gist.github.com/785055][Script to query queue using curl]]
  • Existing URL: "/menu/queueList.xml?id={jobId}"
• Hypothetical alternatives:
  • Jobs-oriented:
    • /jobs/running.xml?id={jobId}
    • /jobs/{jobId}/running.xml?id={jobid}
  • Queue-oriented:
    • /queue.xml
    • /queue/running.xml

• Ad hoc commands (run and forget) ** Run a command

• [[https://gist.github.com/790341][Dispatch execution using curl]]
  • Existing URL: "POST /scheduledExecution/uploadAndExecute.xml" +Hypothetical alternatives:
  • Jobs-oriented
    • POST /jobs/uploadAndExecute.xml
  • Ad hoc oriented
    • POST /dispatch.xml
    • POST /run.xml