pipeline-manager: api: documentation, comments and refactor

[snkas]

The testing part of this PR is postponed to a later PR, instead the general documentation, comment and refactor improvements are done for service, connector and program.

Overview:

• Update service API comments and documentation
• Update connector API comments and documentation
• Update program API comments and documentation
• Add update_connector_by_name and use it in its PATCH endpoint
• Add update_program_by_name and use it in its PATCH endpoint
• Regenerate OpenAPI JSON and Python bindings

EDIT: below the original text:

The primary goal is to have a basic API test that does a mix of GET, PUT, PATCH, POST and DELETE among the endpoints all the object types share. This is both to check for consistency in terms of response codes as well as behavior across the object types. It supplements the other API tests already in integration_test

There will be a separate PR for pipelines after this one. This PR encompasses service, connector and program.

Overview:

• Update service API comments and annotation
• Update connector API comments and annotation
• Add update_connector_by_name and use it in its PATCH endpoint
• Update program API comments and annotation
• Add update_program_by_name and use it in its PATCH endpoint
• Regenerate OpenAPI JSON and Python bindings
• Basic API test

Is this a user-visible change (yes/no): no