Add location to modules which support this parameter

- Add `location` parameter to `address` and `device` module
- Add changelog fragment
- Extend documentation accordingly
- Regenerate documentation

Author: cmeissner

changelogs/fragments/add location_id.yaml

@@ -0,0 +1,2 @@
+enhancements:
+- Add location to `address` and `device` module

docs/plugins/address_module.rst

@@ -392,6 +392,40 @@ Parameters
       - :ansible-option-choices-entry:`true`
 
 
+      .. raw:: html
+
+        </div>
+
+  * - .. raw:: html
+
+        <div class="ansible-option-cell">
+        <div class="ansibleOptionAnchor" id="parameter-location"></div>
+
+      .. _ansible_collections.codeaffen.phpipam.address_module__parameter-location:
+
+      .. rst-class:: ansible-option-title
+
+      **location**
+
+      .. raw:: html
+
+        <a class="ansibleOptionLink" href="#parameter-location" title="Permalink to this option"></a>
+
+      .. ansible-option-type-line::
+
+        :ansible-option-type:`string`
+
+      .. raw:: html
+
+        </div>
+
+    - .. raw:: html
+
+        <div class="ansible-option-cell">
+
+      Address location
+
+
       .. raw:: html
 
         </div>

docs/plugins/device_module.rst

@@ -226,6 +226,40 @@ Parameters
       IP address of the given device
 
 
+      .. raw:: html
+
+        </div>
+
+  * - .. raw:: html
+
+        <div class="ansible-option-cell">
+        <div class="ansibleOptionAnchor" id="parameter-location"></div>
+
+      .. _ansible_collections.codeaffen.phpipam.device_module__parameter-location:
+
+      .. rst-class:: ansible-option-title
+
+      **location**
+
+      .. raw:: html
+
+        <a class="ansibleOptionLink" href="#parameter-location" title="Permalink to this option"></a>
+
+      .. ansible-option-type-line::
+
+        :ansible-option-type:`string`
+
+      .. raw:: html
+
+        </div>
+
+    - .. raw:: html
+
+        <div class="ansible-option-cell">
+
+      Device location
+
+
       .. raw:: html
 
         </div>

plugins/modules/address.py

@@ -97,6 +97,10 @@
         description: Exclude this address from status update scans
         type: bool
         required: false
+    location:
+        description: Address location
+        type: str
+        required: false
 extends_documentation_fragment:
     - codeaffen.phpipam.phpipam
     - codeaffen.phpipam.phpipam.entity_state
@@ -151,6 +155,7 @@ def main():
             port=dict(type='str'),
             note=dict(type='str'),
             exclude_ping=dict(type='bool'),
+            location=dict(type='entity', controller='tools/locations'),
         )
     )
 

plugins/modules/device.py

@@ -118,6 +118,10 @@
         description: CTX engine id when using SNMPv3
         type: str
         required: false
+    location:
+        description: Device location
+        type: str
+        required: false
 extends_documentation_fragment:
     - codeaffen.phpipam.phpipam
     - codeaffen.phpipam.phpipam.entity_state
@@ -175,6 +179,7 @@ def main():
             snmp_v3_priv_pass=dict(type='str', no_log=True, phpipam_name='snmp_v3_priv_pass'),
             snmp_v3_ctx_name=dict(type='str', phpipam_name='snmp_v3_ctx_name'),
             snmp_v3_ctx_engine_id=dict(type='str', phpipam_name='snmp_v3_ctx_engine_id'),
+            location=dict(type='entity', controller='tools/locations'),
         ),
         required_together=['rack', 'starting_rack', 'rack_units'],
     )