Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Linode Provider
  4. API Docs
  5. getMonitorAlertChannels
Viewing docs for Linode v6.6.0
published on Tuesday, Sep 15, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

linode.getMonitorAlertChannels

linode logo linode logo
Viewing docs for Linode v6.6.0
published on Tuesday, Sep 15, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

    Use this data source to query Linode Monitor Alert notification channels. For more information, see the Linode APIv4 docs. (Note: v4beta only.)

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";

const all = linode.getMonitorAlertChannels({});

    import pulumi
import pulumi_linode as linode

all = linode.get_monitor_alert_channels()

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v6/go/linode"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := linode.GetMonitorAlertChannels(ctx, &linode.GetMonitorAlertChannelsArgs{}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;

return await Deployment.RunAsync(() => 
{
    var all = Linode.GetMonitorAlertChannels.Invoke();

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetMonitorAlertChannelsArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var all = LinodeFunctions.getMonitorAlertChannels(GetMonitorAlertChannelsArgs.builder()
            .build());

    }
}

    variables:
  all:
    fn::invoke:
      function: linode:getMonitorAlertChannels
      arguments: {}

    pulumi {
  required_providers {
    linode = {
      source = "pulumi/linode"
    }
  }
}

data "linode_getmonitoralertchannels" "all" {
}

    Filter Example

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";

const system = linode.getMonitorAlertChannels({
    filters: [{
        name: "type",
        values: ["system"],
    }],
});

    import pulumi
import pulumi_linode as linode

system = linode.get_monitor_alert_channels(filters=[{
    "name": "type",
    "values": ["system"],
}])

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v6/go/linode"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := linode.GetMonitorAlertChannels(ctx, &linode.GetMonitorAlertChannelsArgs{
			Filters: []linode.GetMonitorAlertChannelsFilter{
				{
					Name: "type",
					Values: []string{
						"system",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;

return await Deployment.RunAsync(() => 
{
    var system = Linode.GetMonitorAlertChannels.Invoke(new()
    {
        Filters = new[]
        {
            new Linode.Inputs.GetMonitorAlertChannelsFilterInputArgs
            {
                Name = "type",
                Values = new[]
                {
                    "system",
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetMonitorAlertChannelsArgs;
import com.pulumi.linode.inputs.GetMonitorAlertChannelsFilterArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var system = LinodeFunctions.getMonitorAlertChannels(GetMonitorAlertChannelsArgs.builder()
            .filters(GetMonitorAlertChannelsFilterArgs.builder()
                .name("type")
                .values("system")
                .build())
            .build());

    }
}

    variables:
  system:
    fn::invoke:
      function: linode:getMonitorAlertChannels
      arguments:
        filters:
          - name: type
            values:
              - system

    pulumi {
  required_providers {
    linode = {
      source = "pulumi/linode"
    }
  }
}

data "linode_getmonitoralertchannels" "system" {
  filters {
    name   = "type"
    values = ["system"]
  }
}

    Filterable Fields

    The following top-level fields can be used with the filter block:

    • id
    • label
    • type
    • channelType

    Using getMonitorAlertChannels

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getMonitorAlertChannels(args: GetMonitorAlertChannelsArgs, opts?: InvokeOptions): Promise<GetMonitorAlertChannelsResult>
function getMonitorAlertChannelsOutput(args: GetMonitorAlertChannelsOutputArgs, opts?: InvokeOutputOptions): Output<GetMonitorAlertChannelsResult>
    def get_monitor_alert_channels(filters: Optional[Sequence[GetMonitorAlertChannelsFilter]] = None,
                               opts: Optional[InvokeOptions] = None) -> GetMonitorAlertChannelsResult
def get_monitor_alert_channels_output(filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetMonitorAlertChannelsFilterArgs]]]] = None,
                               opts: Optional[InvokeOutputOptions] = None) -> Output[GetMonitorAlertChannelsResult]
    func GetMonitorAlertChannels(ctx *Context, args *GetMonitorAlertChannelsArgs, opts ...InvokeOption) (*GetMonitorAlertChannelsResult, error)
func GetMonitorAlertChannelsOutput(ctx *Context, args *GetMonitorAlertChannelsOutputArgs, opts ...InvokeOption) GetMonitorAlertChannelsResultOutput

    > Note: This function is named GetMonitorAlertChannels in the Go SDK.

    public static class GetMonitorAlertChannels 
{
    public static Task<GetMonitorAlertChannelsResult> InvokeAsync(GetMonitorAlertChannelsArgs args, InvokeOptions? opts = null)
    public static Output<GetMonitorAlertChannelsResult> Invoke(GetMonitorAlertChannelsInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetMonitorAlertChannelsResult> Invoke(GetMonitorAlertChannelsInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetMonitorAlertChannelsResult> getMonitorAlertChannels(GetMonitorAlertChannelsArgs args, InvokeOptions options)
public static Output<GetMonitorAlertChannelsResult> getMonitorAlertChannels(GetMonitorAlertChannelsArgs args, InvokeOptions options)
public static Output<GetMonitorAlertChannelsResult> getMonitorAlertChannels(GetMonitorAlertChannelsArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: linode:index/getMonitorAlertChannels:getMonitorAlertChannels
  arguments:
    # arguments dictionary
    data "linode_get_monitor_alert_channels" "name" {
    # arguments
}

    The following arguments are supported:

    getMonitorAlertChannels Result

    The following output properties are available:

    Id string
    The unique ID of the channel.
    MonitorAlertChannels List<GetMonitorAlertChannelsMonitorAlertChannel>
    (Nested Attribute List) Monitor alert channels matching the query.
    Filters List<GetMonitorAlertChannelsFilter>
    Id string
    The unique ID of the channel.
    MonitorAlertChannels []GetMonitorAlertChannelsMonitorAlertChannel
    (Nested Attribute List) Monitor alert channels matching the query.
    Filters []GetMonitorAlertChannelsFilter
    id string
    The unique ID of the channel.
    monitor_alert_channels list(object)
    (Nested Attribute List) Monitor alert channels matching the query.
    filters list(object)
    id String
    The unique ID of the channel.
    monitorAlertChannels List<GetMonitorAlertChannelsMonitorAlertChannel>
    (Nested Attribute List) Monitor alert channels matching the query.
    filters List<GetMonitorAlertChannelsFilter>
    id string
    The unique ID of the channel.
    monitorAlertChannels GetMonitorAlertChannelsMonitorAlertChannel[]
    (Nested Attribute List) Monitor alert channels matching the query.
    filters GetMonitorAlertChannelsFilter[]
    id str
    The unique ID of the channel.
    monitor_alert_channels Sequence[GetMonitorAlertChannelsMonitorAlertChannel]
    (Nested Attribute List) Monitor alert channels matching the query.
    filters Sequence[GetMonitorAlertChannelsFilter]
    id String
    The unique ID of the channel.
    monitorAlertChannels List<Property Map>
    (Nested Attribute List) Monitor alert channels matching the query.
    filters List<Property Map>

    Supporting Types

    GetMonitorAlertChannelsFilter

    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values List<string>
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values []string
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values list(string)
    A list of values for the filter to allow. These values should all be in string form.
    match_by string
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)
    name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values string[]
    A list of values for the filter to allow. These values should all be in string form.
    matchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name str
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values Sequence[str]
    A list of values for the filter to allow. These values should all be in string form.
    match_by str
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)

    GetMonitorAlertChannelsMonitorAlertChannel

    Alerts GetMonitorAlertChannelsMonitorAlertChannelAlerts
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    ChannelType string
    The notification transport type (currently email).
    Created string
    When the channel was created.
    CreatedBy string
    The user who created the channel, or system.
    Details GetMonitorAlertChannelsMonitorAlertChannelDetails
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    Id int
    The unique ID of the channel.
    Label string
    The display label for the channel.
    Type string
    The alert type associated with the channel.
    Updated string
    When the channel was last updated.
    UpdatedBy string
    The user who last updated the channel, or system.
    Alerts GetMonitorAlertChannelsMonitorAlertChannelAlerts
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    ChannelType string
    The notification transport type (currently email).
    Created string
    When the channel was created.
    CreatedBy string
    The user who created the channel, or system.
    Details GetMonitorAlertChannelsMonitorAlertChannelDetails
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    Id int
    The unique ID of the channel.
    Label string
    The display label for the channel.
    Type string
    The alert type associated with the channel.
    Updated string
    When the channel was last updated.
    UpdatedBy string
    The user who last updated the channel, or system.
    alerts object
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    channel_type string
    The notification transport type (currently email).
    created string
    When the channel was created.
    created_by string
    The user who created the channel, or system.
    details object
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    id number
    The unique ID of the channel.
    label string
    The display label for the channel.
    type string
    The alert type associated with the channel.
    updated string
    When the channel was last updated.
    updated_by string
    The user who last updated the channel, or system.
    alerts GetMonitorAlertChannelsMonitorAlertChannelAlerts
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    channelType String
    The notification transport type (currently email).
    created String
    When the channel was created.
    createdBy String
    The user who created the channel, or system.
    details GetMonitorAlertChannelsMonitorAlertChannelDetails
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    id Integer
    The unique ID of the channel.
    label String
    The display label for the channel.
    type String
    The alert type associated with the channel.
    updated String
    When the channel was last updated.
    updatedBy String
    The user who last updated the channel, or system.
    alerts GetMonitorAlertChannelsMonitorAlertChannelAlerts
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    channelType string
    The notification transport type (currently email).
    created string
    When the channel was created.
    createdBy string
    The user who created the channel, or system.
    details GetMonitorAlertChannelsMonitorAlertChannelDetails
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    id number
    The unique ID of the channel.
    label string
    The display label for the channel.
    type string
    The alert type associated with the channel.
    updated string
    When the channel was last updated.
    updatedBy string
    The user who last updated the channel, or system.
    alerts GetMonitorAlertChannelsMonitorAlertChannelAlerts
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    channel_type str
    The notification transport type (currently email).
    created str
    When the channel was created.
    created_by str
    The user who created the channel, or system.
    details GetMonitorAlertChannelsMonitorAlertChannelDetails
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    id int
    The unique ID of the channel.
    label str
    The display label for the channel.
    type str
    The alert type associated with the channel.
    updated str
    When the channel was last updated.
    updated_by str
    The user who last updated the channel, or system.
    alerts Property Map
    (Nested Attribute) Alert linkage metadata for this channel. Referenced directly (e.g. alerts.alert_count).
    channelType String
    The notification transport type (currently email).
    created String
    When the channel was created.
    createdBy String
    The user who created the channel, or system.
    details Property Map
    (Nested Attribute) Channel configuration details. Referenced directly (e.g. details.email).
    id Number
    The unique ID of the channel.
    label String
    The display label for the channel.
    type String
    The alert type associated with the channel.
    updated String
    When the channel was last updated.
    updatedBy String
    The user who last updated the channel, or system.

    GetMonitorAlertChannelsMonitorAlertChannelAlerts

    AlertCount int
    The number of associated alerts.
    Type string
    The alert type associated with the channel.
    Url string
    The API URL for associated alerts.
    AlertCount int
    The number of associated alerts.
    Type string
    The alert type associated with the channel.
    Url string
    The API URL for associated alerts.
    alert_count number
    The number of associated alerts.
    type string
    The alert type associated with the channel.
    url string
    The API URL for associated alerts.
    alertCount Integer
    The number of associated alerts.
    type String
    The alert type associated with the channel.
    url String
    The API URL for associated alerts.
    alertCount number
    The number of associated alerts.
    type string
    The alert type associated with the channel.
    url string
    The API URL for associated alerts.
    alert_count int
    The number of associated alerts.
    type str
    The alert type associated with the channel.
    url str
    The API URL for associated alerts.
    alertCount Number
    The number of associated alerts.
    type String
    The alert type associated with the channel.
    url String
    The API URL for associated alerts.

    GetMonitorAlertChannelsMonitorAlertChannelDetails

    Email GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    Email GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    email object
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    email GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    email GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    email GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).
    email Property Map
    (Nested Attribute) Email-specific configuration details. Referenced directly (e.g. email.recipient_type).

    GetMonitorAlertChannelsMonitorAlertChannelDetailsEmail

    RecipientType string
    Recipient selection mode (for example readWriteUsers or user).
    Usernames List<string>
    Usernames that receive notifications.
    RecipientType string
    Recipient selection mode (for example readWriteUsers or user).
    Usernames []string
    Usernames that receive notifications.
    recipient_type string
    Recipient selection mode (for example readWriteUsers or user).
    usernames list(string)
    Usernames that receive notifications.
    recipientType String
    Recipient selection mode (for example readWriteUsers or user).
    usernames List<String>
    Usernames that receive notifications.
    recipientType string
    Recipient selection mode (for example readWriteUsers or user).
    usernames string[]
    Usernames that receive notifications.
    recipient_type str
    Recipient selection mode (for example readWriteUsers or user).
    usernames Sequence[str]
    Usernames that receive notifications.
    recipientType String
    Recipient selection mode (for example readWriteUsers or user).
    usernames List<String>
    Usernames that receive notifications.

    Package Details

    Repository
    Linode pulumi/pulumi-linode
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the linode Terraform Provider.
    linode logo linode logo
    Viewing docs for Linode v6.6.0
    published on Tuesday, Sep 15, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-linode

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial