Maximum runs listed is 26, but documentation says 1000

[vegarsti]

The help text claims that the maximum number of runs listed with runs list with the --limit flag is 1000,

$ databricks runs list -h
...
  --limit INTEGER      The limit determines the number of runs listed. Limit
                       must be between 0 and 1000. Set to 20 runs by default.

however, no more than 26 is allowed:

$ databricks runs list --limit 27
Error: b'{"error_code":"INVALID_PARAMETER_VALUE","message":"Invalid limit 27 - it has to be no more than 26."}'

[nordp]

Hi @vegarsti!

Thanks for raising this issue. The documented maximum limit parameter in /jobs/runs/list is different in Jobs API 2.0 (1000) and Jobs API 2.1 (25).

I've notified the Jobs team to make the error message reflect the public documentation, and I'll gladly help get your PR merged once it makes the distinction in max limit based on API version.

[vegarsti]

Oh, I see! Thank you!