fixup! fixup! fixup! fixup! fixup! fixup! Allow managing dashboards i…

…n subfolders

changelogs/fragments/411-dashboard-subfolders.yml

@@ -0,0 +1,4 @@
+
+---
+minor_changes:
+  - Allow creating dashboards in subfolders for `grafana_dashboard`

plugins/modules/grafana_dashboard.py

@@ -400,6 +400,11 @@ def grafana_create_dashboard(module, data):
 
     # test if the folder exists
     folder_exists = False
+    if data["parent_uid"] and grafana_version < 11:
+        module.fail_json(
+            failed=True, msg="Subfolder API is available starting Grafana v11"
+        )
+
     if grafana_version >= 5:
         folder_exists, folder_id = grafana_folder_exists(
             module, data["url"], data["folder"], data["parent_uid"], headers

roles/grafana/README.md

@@ -87,6 +87,7 @@ Configure Grafana organizations, dashboards, folders, datasources, teams and use
 | org_id | no |
 | org_name | no |
 | overwrite | no |
+| parent_uid | no |
 | path | no |
 | slug | no |
 | state | no |

tests/integration/targets/grafana_dashboard/tasks/dashboard-folder-destination.yml

@@ -96,3 +96,8 @@
         that:
           - diff_result4.failed == false
           - diff_result4.changed == true
+  rescue:
+    - name: Skip if we are running an older version of Grafana
+      ansible.builtin.assert:
+        that:
+          - sub_folder.msg | default ('') == 'Subfolder API is available'