feat: Add status option to netbox_cluster module (#1283)

The `netbox_cluster` module now supports the `status` option, allowing users to specify the status of the cluster. This enhancement provides more flexibility in managing clusters within NetBox.

Fixes #1275

Author: richbibby

changelogs/fragments/1275-feature-netbox_cluster-adds-status-field.yml

@@ -0,0 +1,2 @@
+minor_changes:
+      - Add `status` to `netbox_cluster` (https://github.com/netbox-community/ansible_modules/issues/1275)

plugins/modules/netbox_cluster.py

@@ -35,6 +35,12 @@
           - The name of the cluster
         required: true
         type: str
+      status:
+        description:
+          - Status of the cluster
+        required: false
+        type: raw
+        version_added: "3.20.0"
       cluster_type:
         description:
           - type of the cluster
@@ -114,7 +120,7 @@
             - Schnozzberry
         state: present
 
-    - name: Update the group and site of an existing cluster
+    - name: Update the group, site and status of an existing cluster
       netbox.netbox.netbox_cluster:
         netbox_url: http://netbox.local
         netbox_token: thisIsMyToken
@@ -123,6 +129,7 @@
           cluster_type: qemu
           cluster_group: GROUP
           site: SITE
+          status: planned
         state: present
 """
 
@@ -160,6 +167,7 @@ def main():
                 required=True,
                 options=dict(
                     name=dict(required=True, type="str"),
+                    status=dict(required=False, type="raw"),
                     cluster_type=dict(required=False, type="raw"),
                     cluster_group=dict(required=False, type="raw"),
                     site=dict(required=False, type="raw"),