add back url parameter (#92)

* add back url parameter
* add docs for url parameter
* only define overriden parameters for doc
* fix copyright year

Author: rndmh3ro

plugins/doc_fragments/common_options.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (c) 2021 T-Systems Multimedia Solutions GmbH
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+#
+# 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 <http://www.gnu.org/licenses/>.
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+
+class ModuleDocFragment(object):
+    # Documentation for common options that are always the same
+    DOCUMENTATION = r"""
+    options:
+      url:
+        required: true
+     """

plugins/modules/icinga_command.py

@@ -37,6 +37,7 @@
 version_added: '1.0.0'
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 options:
   state:
     description:
@@ -189,6 +190,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         imports=dict(type="list", elements="str", required=False, default=[]),
         disabled=dict(

plugins/modules/icinga_command_template.py

@@ -36,6 +36,7 @@
 author: Lars Krahl (@mmslkr)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.1.0'
 options:
   state:
@@ -188,6 +189,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         imports=dict(type="list", elements="str", required=False, default=[]),
         disabled=dict(

plugins/modules/icinga_endpoint.py

@@ -36,6 +36,7 @@
 author: Aaron Bulmahn (@arbu)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.5.0'
 options:
   state:
@@ -107,6 +108,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         host=dict(required=False),
         port=dict(required=False, type="int"),

plugins/modules/icinga_host.py

@@ -36,6 +36,7 @@
 author: Sebastian Gumprich (@rndmh3ro)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.0.0'
 options:
   state:
@@ -190,6 +191,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         display_name=dict(required=False),
         groups=dict(type="list", elements="str", default=[], required=False),

plugins/modules/icinga_host_template.py

@@ -36,6 +36,7 @@
 author: Michaela Mattes (@michaelamattes)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.2.0'
 options:
   state:
@@ -185,6 +186,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         display_name=dict(required=False),
         groups=dict(type="list", elements="str", default=[], required=False),

plugins/modules/icinga_hostgroup.py

@@ -36,6 +36,7 @@
 author: Sebastian Gumprich (@rndmh3ro)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.0.0'
 options:
   state:
@@ -96,6 +97,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         display_name=dict(required=False),
         assign_filter=dict(required=False),

plugins/modules/icinga_notification.py

@@ -36,6 +36,7 @@
 author: Sebastian Gumprich (@rndmh3ro)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.0.0'
 options:
   state:
@@ -152,6 +153,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         imports=dict(type="list", elements="str", required=False),
         apply_to=dict(required=True, choices=["service", "host"]),

plugins/modules/icinga_notification_template.py

@@ -36,6 +36,7 @@
 author: Sebastian Gumprich (@rndmh3ro)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: "1.9.0"
 options:
   state:
@@ -125,6 +126,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         notification_interval=dict(required=False),
         states=dict(type="list", elements="str", required=False),

plugins/modules/icinga_service.py

@@ -36,6 +36,7 @@
 author: Sebastian Gumprich (@rndmh3ro)
 extends_documentation_fragment:
   - ansible.builtin.url
+  - t_systems_mms.icinga_director.common_options
 version_added: '1.0.0'
 options:
   state:
@@ -286,6 +287,7 @@ def main():
     # add our own arguments
     argument_spec.update(
         state=dict(default="present", choices=["absent", "present"]),
+        url=dict(required=True),
         object_name=dict(required=True, aliases=["name"]),
         disabled=dict(type="bool", default=False, choices=[True, False]),
         check_command=dict(required=False),