#!/usr/bin/python # Copyright (c) 2016 Hewlett-Packard Enterprise Corporation # # This module 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 software 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 software. If not, see . try: import shade HAS_SHADE = True except ImportError: HAS_SHADE = False DOCUMENTATION = ''' --- module: os_project_facts short_description: Retrieve facts about one or more OpenStack projects extends_documentation_fragment: openstack version_added: "2.1" author: "Ricardo Carrillo Cruz (@rcarrillocruz)" description: - Retrieve facts about a one or more OpenStack projects requirements: - "python >= 2.6" - "shade" options: name: description: - Name or ID of the project required: true domain: description: - Name or ID of the domain containing the project if the cloud supports domains required: false default: None filters: description: - A dictionary of meta data to use for further filtering. Elements of this dictionary may be additional dictionaries. required: false default: None ''' EXAMPLES = ''' # Gather facts about previously created projects - os_project_facts: cloud: awesomecloud - debug: var=openstack_projects # Gather facts about a previously created project by name - os_project_facts: cloud: awesomecloud name: demoproject - debug: var=openstack_projects # Gather facts about a previously created project in a specific domain - os_project_facts cloud: awesomecloud name: demoproject domain: admindomain - debug: var=openstack_projects # Gather facts about a previously created project in a specific domain with filter - os_project_facts cloud: awesomecloud name: demoproject domain: admindomain filters: enabled: False - debug: var=openstack_projects ''' RETURN = ''' openstack_projects: description: has all the OpenStack facts about projects returned: always, but can be null type: complex contains: id: description: Unique UUID. returned: success type: string name: description: Name given to the project. returned: success type: string description: description: Description of the project returned: success type: string enabled: description: Flag to indicate if the project is enabled returned: success type: bool domain_id: description: Domain ID containing the project (keystone v3 clouds only) returned: success type: bool ''' def main(): argument_spec = openstack_full_argument_spec( name=dict(required=False, default=None), domain=dict(required=False, default=None), filters=dict(required=False, type='dict', default=None), ) module = AnsibleModule(argument_spec) if not HAS_SHADE: module.fail_json(msg='shade is required for this module') try: name = module.params['name'] domain = module.params['domain'] filters = module.params['filters'] opcloud = shade.operator_cloud(**module.params) if domain: try: # We assume admin is passing domain id dom = opcloud.get_domain(domain)['id'] domain = dom except: # If we fail, maybe admin is passing a domain name. # Note that domains have unique names, just like id. dom = opcloud.search_domains(filters={'name': domain}) if dom: domain = dom[0]['id'] else: module.fail_json(msg='Domain name or ID does not exist') if not filters: filters = {} filters['domain_id'] = domain projects = opcloud.search_projects(name, filters) module.exit_json(changed=False, ansible_facts=dict( openstack_projects=projects)) except shade.OpenStackCloudException as e: module.fail_json(msg=str(e)) from ansible.module_utils.basic import * from ansible.module_utils.openstack import * if __name__ == '__main__': main()