topic Jobs API 2.1 OpenAPI specification seems broken. in Data Engineering

Jobs API 2.1 OpenAPI specification seems broken.

j_al — Wed, 15 Mar 2023 21:24:11 GMT

Jobs API 2.1 OpenAPI specification seems broken.

The swagger file seems to be invalid.

https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml

Re: Jobs API 2.1 OpenAPI specification seems broken.

j_al — Thu, 16 Mar 2023 17:04:10 GMT

You can try to open above file in swagger editor to view the errors.

@Debayan Mukherjee

Re: Jobs API 2.1 OpenAPI specification seems broken.

Anonymous — Sat, 18 Mar 2023 06:21:10 GMT

Hi @Julius Almeida

Hope all is well! Just wanted to check in if you were able to resolve your issue and would you be happy to share the solution or mark an answer as best? Else please let us know if you need more help.

We'd love to hear from you.

Thanks!

Re: Jobs API 2.1 OpenAPI specification seems broken.

JeffShutt_ — Wed, 03 May 2023 22:02:59 GMT

@Debayan Mukherjee , are you suggesting to revert the openapi version specified in https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml from 3.1.0 to 3.0.3?

Re: Jobs API 2.1 OpenAPI specification seems broken.

JeffShutt_ — Fri, 05 May 2023 16:11:41 GMT

It's unclear to me what you are asking, so let me spell out what I am seeing so we are on the same page.

If you go to https://editor.swagger.io/ and input this document, https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml, it tells you "Unable to render this definition"

If you go to https://editor-next.swagger.io/ and input the same document, it does seem to open there albeit with a few warnings.

If you go to https://apitools.dev/swagger-parser/online/ and input the same document, it does validate successfully as far as I can tell.

I am guessing this means that the old swagger editor doesn't support OpenAPI 3.1.0?

Re: Jobs API 2.1 OpenAPI specification seems broken.

JeffShutt_ — Wed, 17 May 2023 14:24:06 GMT

@Debayan Mukherjee , now it appears that https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml has been taken down and is replaced by the new API page. As a user of this API, are we not able to access this Open API spec for code generation anymore?

Re: Jobs API 2.1 OpenAPI specification seems broken.

Debayan — Thu, 16 Mar 2023 06:04:06 GMT

Hi, What do you mean by broken? Was there an issue running the API? If yes, any screenshot for reference?

please tag @Debayan with your next response which will notify me, Thank you!

Re: Jobs API 2.1 OpenAPI specification seems broken.

Debayan — Mon, 20 Mar 2023 16:21:31 GMT

Hi, Could you please try with openapi: 3.0.3 and let us know whats the outcome?

Re: Jobs API 2.1 OpenAPI specification seems broken.

Debayan — Fri, 05 May 2023 05:46:32 GMT

Hi @Jeff Shutt , lets try to revert to 3.0.3 in a dev environment and try again?

Re: Jobs API 2.1 OpenAPI specification seems broken.

Debayan — Tue, 30 May 2023 06:47:40 GMT

Sorry for the delay, we can check internally on OpenAPI and confirm.

Also, https://docs.databricks.com/workflows/jobs/jobs-api-updates.html is the update.

Re: Jobs API 2.1 OpenAPI specification seems broken.

tupshin_ct — Fri, 26 Jul 2024 14:20:02 GMT

Any update on a replacement for the old openapi spec that was taken down?