Add maintenance info to the response of fetching a service instance

[gberche-orange]

Also provides rationale for platform to poll the "fetching a service instance" endpoint

What is the problem this PR solves?

closes #714

Checklist:

• [x] The swagger.yaml doc has been updated with any required changes
• [x] The openapi.yaml doc has been updated with any required changes