Fixes #36545 - Correcting apidoc for reclaim_space endpoint of smart-…

[sayan3296]

What are the changes introduced in this pull request?

Modification of APIDOC to include the right reclaim_space endpoint for external smart-proxies

Considerations taken when implementing this change?

When we invoke the "Reclaim Space" action from WebUI for any external smart-proxies, that triggers the right API call as expected.

But navigating to the API doc, we can see reclaim_space endpoint is not mentioned correctly and results in failure if used as mentioned.

We should document the correct endpoint in the apidoc , which is the source of information for all the admins\end-users

What are the testing steps for this pull request?

1. Build a setup with an external smart-proxy included
2. Sync some repos in main Katello server with Immediate download policy
3. Change the download policy of external smart-proxy to Immediate and sync the external smart-proxy
4. Change the download policy back to On_Demand for the external smart-proxy
5. Check the apidoc for Capsule Content --> Reclaim Space and notice POST /katello/api/capsules/:id/reclaim_space is mentioned.
6. Use the API to trigger the "ReclaimSpace" task and it should immediately show some failure as mentioned in BZ 2218179
7. Apply the fix from PR and restart the katello instance
8. Repeat step 5 and notice the corrected endpoint POST /katello/api/capsules/:id/content/reclaim_space
9. Repeat step 6 and that should successfully trigger the expected task

[theforeman-bot]

Issues: #36545

[sjha4]

The API desc now matches the actual route of reclaim_space.
UI is not impacted as we use the correct the endpoint path there:

return BastionResource('katello/api/capsules/:id/content/:action', {id: '@id'}, {
          syncStatus: {method: 'GET', isArray: false, params: {action: 'sync'}},
          sync: {method: 'post', isArray: false, params: {action: 'sync'}},
          cancelSync: {method: 'delete', isArray: false, params: {action: 'sync'}},
          reclaimSpace: {method: 'post', isArray: false, params: {action: 'reclaim_space'}}
        });

APJ 👍🏼