diff --git a/plugins/modules/alternate_content_source_info.py b/plugins/modules/alternate_content_source_info.py new file mode 100644 index 0000000000..fb01a61d32 --- /dev/null +++ b/plugins/modules/alternate_content_source_info.py @@ -0,0 +1,80 @@ +#!/usr/bin/python +# -*- coding: utf-8 -*- +# (c) 2022 William Bradford Clark +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . + +from __future__ import absolute_import, division, print_function +__metaclass__ = type + + +DOCUMENTATION = ''' +--- +module: alternate_content_source_info +version_added: 3.8.0 +short_description: Fetch information about Alternate Content Sources +description: + - Fetch information about Alternate Content Sources +author: "William Bradford Clark (@wbclark)" +options: + name: + description: + - Name of the Alternate Content Source + required: false + type: str +extends_documentation_fragment: + - theforeman.foreman.foreman + - theforeman.foreman.foreman.katelloinfomodule + - theforeman.foreman.foreman.infomodule +''' + +EXAMPLES = ''' +- name: "Find Alternate Content Source by name." + theforeman.foreman.alternate_content_source_info: + username: "admin" + password: "changeme" + server_url: "https://foreman.example.com" + organization: "Default Organization" + name: "Baby's First ACS" +''' + +RETURN = ''' +alternate_content_source: + description: Details about the found Alternate Content Source. + returned: success and I(name) was passed + type: dict +alternate_content_sources: + description: List of all found Alternate Content Sources and their details. + returned: success and I(search) was passed + type: list + elements: dict +''' + + +from ansible_collections.theforeman.foreman.plugins.module_utils.foreman_helper import KatelloInfoAnsibleModule + + +class KatelloAlternateContentSourceInfo(KatelloInfoAnsibleModule): + pass + + +def main(): + module = KatelloAlternateContentSourceInfo() + + with module.api_connection(): + module.run() + + +if __name__ == '__main__': + main()