| Server IP : 85.214.239.14 / Your IP : 216.73.216.27 Web Server : Apache/2.4.65 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Mon Sep 30 15:36:27 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 8.2.29 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /lib/python3/dist-packages/ansible_collections/theforeman/foreman/plugins/modules/ |
Upload File : |
#!/usr/bin/python
# -*- coding: utf-8 -*-
# (c) 2016, Eric D Helms <ericdhelms@gmail.com>
# (c) 2017, Matthias M Dellweg <dellweg@atix.de> (ATIX AG)
#
# 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 <http://www.gnu.org/licenses/>.
from __future__ import absolute_import, division, print_function
__metaclass__ = type
DOCUMENTATION = '''
---
module: organization
version_added: 1.0.0
short_description: Manage Organizations
description:
- Manage Organizations
author:
- "Eric D Helms (@ehelms)"
- "Matthias M Dellweg (@mdellweg) ATIX AG"
options:
name:
description:
- Name of the Organization
required: true
type: str
description:
description:
- Description of the Organization
required: false
type: str
label:
description:
- Label of the Organization
type: str
ignore_types:
description:
- List of resources types that will be automatically associated
type: list
elements: str
required: false
aliases:
- select_all_types
version_added: 3.8.0
extends_documentation_fragment:
- theforeman.foreman.foreman
- theforeman.foreman.foreman.entity_state
- theforeman.foreman.foreman.nested_parameters
'''
EXAMPLES = '''
- name: "Create CI Organization"
theforeman.foreman.organization:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: "My Cool New Organization"
state: present
'''
RETURN = '''
entity:
description: Final state of the affected entities grouped by their type.
returned: success
type: dict
contains:
organizations:
description: List of organizations.
type: list
elements: dict
'''
from ansible_collections.theforeman.foreman.plugins.module_utils.foreman_helper import ForemanEntityAnsibleModule, NestedParametersMixin
class ForemanOrganizationModule(NestedParametersMixin, ForemanEntityAnsibleModule):
pass
def main():
module = ForemanOrganizationModule(
foreman_spec=dict(
name=dict(required=True),
description=dict(),
label=dict(),
ignore_types=dict(type='list', elements='str', required=False, aliases=['select_all_types']),
select_all_types=dict(type='list', invisible=True, flat_name='ignore_types'),
),
)
with module.api_connection():
entity = module.lookup_entity('entity')
# workround the fact that the API expects `ignore_types` when modifying the entity
# but uses `select_all_types` when showing one
if entity and 'select_all_types' in entity:
entity['ignore_types'] = entity.pop('select_all_types')
module.run()
if __name__ == '__main__':
main()