Server IP : 85.214.239.14 / Your IP : 3.147.57.217 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | 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) 2019 Bernhard Hopfenmüller (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: bookmark version_added: 1.0.0 short_description: Manage Bookmarks description: - "Manage Bookmark Entities" author: - "Bernhard Hopfenmueller (@Fobhep) ATIX AG" - "Christoffer Reijer (@ephracis) Basalt AB" options: name: description: - Name of the bookmark required: true type: str controller: description: - Controller for the bookmark required: true type: str public: description: - Make bookmark available for all users required: false default: true type: bool query: description: - Query of the bookmark type: str extends_documentation_fragment: - theforeman.foreman.foreman - theforeman.foreman.foreman.entity_state_with_defaults ''' EXAMPLES = ''' - name: "Create a Bookmark" theforeman.foreman.bookmark: username: "admin" password: "changeme" server_url: "https://foreman.example.com" name: "recent" controller: "job_invocations" query: "started_at > '24 hours ago'" state: present_with_defaults - name: "Update a Bookmark" theforeman.foreman.bookmark: username: "admin" password: "changeme" server_url: "https://foreman.example.com" name: "recent" controller: "job_invocations" query: "started_at > '12 hours ago'" state: present - name: "Delete a Bookmark" theforeman.foreman.bookmark: username: "admin" password: "changeme" server_url: "https://foreman.example.com" name: "recent" controller: "job_invocations" state: absent ''' RETURN = ''' entity: description: Final state of the affected entities grouped by their type. returned: success type: dict contains: bookmarks: description: List of bookmarks. type: list elements: dict contains: id: description: Database id of the bookmark. type: int name: description: Name of the bookmark. type: str controller: description: Controller, the query is performed on. type: str query: description: Query to be performed on the controller. type: str public: description: Publicity of the bookmark. type: bool owner_type: description: Class of the owner entity. type: str owner_id: description: Database id of the owner entity. type: int ''' from ansible_collections.theforeman.foreman.plugins.module_utils.foreman_helper import ForemanEntityAnsibleModule class ForemanBookmarkModule(ForemanEntityAnsibleModule): pass def main(): module = ForemanBookmarkModule( foreman_spec=dict( name=dict(required=True), controller=dict(required=True), public=dict(default='true', type='bool'), query=dict(), ), argument_spec=dict( state=dict(default='present', choices=['present_with_defaults', 'present', 'absent']), ), required_if=( ['state', 'present', ['query']], ['state', 'present_with_defaults', ['query']], ), ) with module.api_connection(): module.set_entity('entity', module.find_resource( 'bookmarks', search='name="{0}",controller="{1}"'.format(module.foreman_params['name'], module.foreman_params['controller']), failsafe=True, )) module.run() if __name__ == '__main__': main()