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

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"),