Skip to content

monitor_alert_channel_list.md

Latest commit

 

History

History
82 lines (65 loc) · 3.9 KB

monitor_alert_channel_list.md

File metadata and controls

82 lines (65 loc) · 3.9 KB

monitor_alert_channel_list

List and filter on Alert Channels.

WARNING! This module makes use of beta endpoints and requires the C(api_version) field be explicitly set to C(v4beta).

Minimum Required Fields

Field Type Required Description
api_token str Required The Linode account personal access token. It is necessary to run the module.
It can be exposed by the environment variable LINODE_API_TOKEN instead.
See details in Usage.

Examples

- name: List all of available alert channels to the account
  linode.cloud.monitor_alert_channel_list:
    api_version: v4beta

Parameters

Field Type Required Description
order str Optional The order to list Alert Channels in. (Choices: desc, asc; Default: asc)
order_by str Optional The attribute to order Alert Channels by.
filters (sub-options) list Optional A list of filters to apply to the resulting Alert Channels.
count int Optional The number of Alert Channels to return. If undefined, all results will be returned.

filters

Field Type Required Description
name str Required The name of the field to filter on. Valid filterable fields can be found here.
values list Required A list of values to allow for this field. Fields will pass this filter if at least one of these values matches.

Return Values

  • alert_channels - The returned Alert Channels.

    • Sample Response: 
      [
    {
      "id": 10000,
      "label": "Read-Write Channel",
      "channel_type": "email",
      "type": "system",
      "content": {
        "email": {
          "email_addresses": [
            "Users-with-read-write-access-to-resources"
          ]
        }
      },
      "details": {
        "email": {
          "usernames": [],
          "recipient_type": "read_write_users"
        }
      },
      "alerts": {
        "url": "/monitor/alert-channels/10000/alerts",
        "type": "alerts-definitions",
        "alert_count": 8
      },
      "created": "2025-03-20T01:41:09",
      "updated": "2025-03-20T01:41:09",
      "created_by": "system",
      "updated_by": "system"
    }
  ]
    • See the Linode API response documentation for a list of returned fields