TPT-4218: Update test and docs for ACLP alert channels (#767)

* doc and test

* fix doc

* update doc sample

* update doc example

Author: yec-akamai

docs/modules/monitor_alert_channel_list.md

@@ -47,35 +47,28 @@ WARNING! This module makes use of beta endpoints and requires the C(api_version)
         ```json
         [
             {
-              "alerts": [
-                {
-                  "id": 10000,
-                  "label": "High Memory Usage Plan Dedicated",
-                  "type": "alerts-definitions",
-                  "url": "/monitor/alerts-definitions/10000"
+                "id": 123,
+                "label": "alert notification channel",
+                "type": "user",
+                "channel_type": "email",
+                "details": {
+                    "email": {
+                        "usernames": [
+                            "admin-user1",
+                            "admin-user2"
+                        ],
+                        "recipient_type": "user"
+                    }
                 },
-                {
-                  "id": 10001,
-                  "label": "High Memory Usage Plan Shared",
-                  "type": "alerts-definitions",
-                  "url": "/monitor/alerts-definitions/10001"
-                }
-              ],
-              "channel_type": "email",
-              "content": {
-                "email": {
-                  "email_addresses": [
-                    "Users-with-read-write-access-to-resources"
-                  ]
-                }
-              },
-              "created": "2025-03-20T01:41:09",
-              "created_by": "system",
-              "id": 10000,
-              "label": "Read-Write Channel",
-              "type": "system",
-              "updated": "2025-03-20T01:41:09",
-              "updated_by": "system"
+                "alerts": {
+                    "url": "/monitor/alert-channels/123/alerts",
+                    "type": "alerts-definitions",
+                    "alert_count": 0
+                },
+                "created": "2024-01-01T00:00:00",
+                "updated": "2024-01-01T00:00:00",
+                "created_by": "tester",
+                "updated_by": "tester"
             }
         ]
         

plugins/module_utils/doc_fragments/alert_channels_list.py

@@ -7,35 +7,28 @@
 
 result_alert_channels_samples = ['''[
     {
-      "alerts": [
-        {
-          "id": 10000,
-          "label": "High Memory Usage Plan Dedicated",
-          "type": "alerts-definitions",
-          "url": "/monitor/alerts-definitions/10000"
+        "id": 123,
+        "label": "alert notification channel",
+        "type": "user",
+        "channel_type": "email",
+        "details": {
+            "email": {
+                "usernames": [
+                    "admin-user1",
+                    "admin-user2"
+                ],
+                "recipient_type": "user"
+            }
         },
-        {
-          "id": 10001,
-          "label": "High Memory Usage Plan Shared",
-          "type": "alerts-definitions",
-          "url": "/monitor/alerts-definitions/10001"
-        }
-      ],
-      "channel_type": "email",
-      "content": {
-        "email": {
-          "email_addresses": [
-            "Users-with-read-write-access-to-resources"
-          ]
-        }
-      },
-      "created": "2025-03-20T01:41:09",
-      "created_by": "system",
-      "id": 10000,
-      "label": "Read-Write Channel",
-      "type": "system",
-      "updated": "2025-03-20T01:41:09",
-      "updated_by": "system"
+        "alerts": {
+            "url": "/monitor/alert-channels/123/alerts",
+            "type": "alerts-definitions",
+            "alert_count": 0
+        },
+        "created": "2024-01-01T00:00:00",
+        "updated": "2024-01-01T00:00:00",
+        "created_by": "tester",
+        "updated_by": "tester"
     }
 ]
 ''']

tests/integration/targets/monitor_services_alert_channel_list/tasks/main.yaml

@@ -0,0 +1,30 @@
+- name: monitor_services_alert_channel_list
+  block:
+    - name: List available alert channels
+      linode.cloud.monitor_alert_channel_list:
+      register: alert_channel_list
+
+    - name: Assert monitor_alert_channel_list response
+      assert:
+        that:
+          - alert_channel_list.alert_channels | length > 0
+
+    - name: List system alert channels
+      linode.cloud.monitor_alert_channel_list:
+        filters:
+          - name: label
+            values: ["Read-Write Channel"]
+      register: alert_channel_list_filter
+
+    - name: Assert alert_channel_list_filter response
+      assert:
+        that:
+          - alert_channel_list_filter.alert_channels | length > 0
+          - alert_channel_list_filter.alert_channels.0.label == 'Read-Write Channel'
+
+  environment:
+    LINODE_UA_PREFIX: '{{ ua_prefix }}'
+    LINODE_API_TOKEN: '{{ api_token }}'
+    LINODE_API_URL: '{{ api_url }}'
+    LINODE_API_VERSION: '{{ api_version }}'
+    LINODE_CA: '{{ ca_file or "" }}'