[YUNIKORN-2655] Cleanup REST API documentation

[ryankert01]

What is this PR for?

The REST API documentation is not up to date with the current behaviour as it does not show any 400 or 404 errors returned by a number of API calls.

The error response only shows a 500 code with the same message for each call.

We should move to a simple list for each call showing the applicable errors like this:

### Error responses

**Code** : `400 Bad Request` (URL query is invalid, missing partition name)

**Code** : `404 Not Found` (Partition not found)

**Code** : `500 Internal Server Error` 

Remove the error examples as they do not add any detail required

What type of PR is it?

• - Bug Fix
• - Improvement
• - Feature
• - Documentation
• - Hot Fix
• - Refactoring

Todos

• - Task

What is the Jira issue?

https://issues.apache.org/jira/browse/YUNIKORN-2655

How should this be tested?

Screenshots (if appropriate)

Questions:

• - The licenses files need update.
• - There is breaking changes for older versions.
• - It needs documentation.

[chenyulin0719]

@ryankert01 Thanks for the careful check. I found a mistake and also have a question.

[chenyulin0719]

+1 LGTM

[chia7712]

LGTM