1. What is the nature and description of the request?

Enhance redhat.satellite Ansible Module to Support Advanced Host Collection Management.

Specifically, customer would like to add capabilities similar to those available in the foreman module, such as:

Direct Host Management:
Add or remove hosts directly to/from Host Collections.
Specify hosts by name or ID without requiring manual API calls or additional logic.
Host Collection Renaming:
Enable renaming of existing Host Collections while retaining their properties.
Batch Operations:
Support batch operations for managing multiple hosts or collections simultaneously.
These features would align the module more closely with the needs of users working in environments where Host Collections are central to Satellite-based automation workflows.

2. Why does the customer need this? (List the business requirements here)

The lack of advanced Host Collection management capabilities in the current redhat.satellite module often requires users to rely on additional tools, such as direct API calls using the uri module, or to use the foreman module. While these approaches are functional, they lack the seamless integration and support provided by Red Hat.

Enhancing the redhat.satellite module with these features would:

• Increase Efficiency:
• Reduce the complexity of playbooks for Host Collection management.
• Eliminate the need for custom API calls for routine operations.
• Improve User Experience:
• Provide a more intuitive and streamlined interface for managing Host Collections in Ansible.
• Ensure Full Red Hat Support:
• Enable users to manage Satellite-hosted environments entirely within the Red Hat-supported ecosystem.

3. How would you like to achieve this? (List the functional requirements here)

Proposed Solution:
Enhance the redhat.satellite module with the following capabilities:

New Parameters:

Add a hosts parameter to directly manage hosts within a Host Collection.
Introduce a rename parameter to update the name of a Host Collection.
State Management Enhancements:

Allow batch operations (e.g., adding multiple hosts at once).
Enable conditional updates, such as replacing or appending hosts.
Documentation Updates:

Provide detailed examples and use cases for the new features.

References:
Current foreman module capabilities: Foreman Ansible Collection Documentation  (list hosts is possible here, parameter exists inside the module)
https://docs.ansible.com/ansible/latest/collections/theforeman/foreman/host_collection_module.html

Current redhat.satellite module documentation: Red Hat Satellite Ansible Collection (hosts list not possible here, it doesn't exist)
https://redhatsatellite.github.io/satellite-ansible-collection/develop/plugins/host_collection_module.html

The finest manipulation of host collections is possible only with foreman module not supported module like redhat.satellite.
In addition it is simple to compare with Uri manulations and most performing.
The SCA arriving, a need to follow hosts, to help at the reporting. The problem of host collections is that is it dynamically and when we unregister or just re-register the host will lost its Host Collection if it is a customize Host Collection manually (the memory is like lost each time there is new attachement of hosts on the satellite, but the re-attachment can be mandatory for subs or just to synchronize content of the AK).