Share via


az grafana notification-channel

Note

This reference is part of the amg extension for the Azure CLI (version 2.61.0 or higher). The extension will automatically install the first time you run an az grafana notification-channel command. Learn more about extensions.

This command group has been deprecated and will be removed in a future release.

Commands to manage notification channels of an instance.

As part of Grafana legacy alerting, this command group only works with Grafana 10 and below.

Commands

Name Description Type Status
az grafana notification-channel create

Create a notification channel.

Extension Deprecated
az grafana notification-channel delete

Delete a notification channel.

Extension Deprecated
az grafana notification-channel list

List all notification channels of an instance.

Extension Deprecated
az grafana notification-channel show

Get the details of a notification channel.

Extension Deprecated
az grafana notification-channel test

Test a notification channel.

Extension Deprecated
az grafana notification-channel update

Update a notification channel.

Extension Deprecated

az grafana notification-channel create

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

Create a notification channel.

az grafana notification-channel create --definition
                                       --name
                                       [--api-key --token]
                                       [--resource-group]

Examples

create a notification channel for Teams

az grafana notification-channel create -n MyGrafana --definition '{
  "name": "Teams",
  "settings": {
    "uploadImage": true,
    "url": "https://webhook.office.com/IncomingWebhook/"
   },
  "type": "teams"
}'

Required Parameters

--definition

Json string with notification channel definition, or a path to a file with such content.

--name -n

Name of the Azure Managed Grafana.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az grafana notification-channel delete

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

Delete a notification channel.

az grafana notification-channel delete --name
                                       --notification-channel
                                       [--api-key --token]
                                       [--resource-group]

Required Parameters

--name -n

Name of the Azure Managed Grafana.

--notification-channel

Id, uid which can identify a data source. CLI will search in the order of id, and uid, till finds a match.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az grafana notification-channel list

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

List all notification channels of an instance.

az grafana notification-channel list --name
                                     [--api-key --token]
                                     [--resource-group]
                                     [--short]

Required Parameters

--name -n

Name of the Azure Managed Grafana.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--short

List notification channels in short format.

Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az grafana notification-channel show

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

Get the details of a notification channel.

az grafana notification-channel show --name
                                     --notification-channel
                                     [--api-key --token]
                                     [--resource-group]

Required Parameters

--name -n

Name of the Azure Managed Grafana.

--notification-channel

Id, uid which can identify a data source. CLI will search in the order of id, and uid, till finds a match.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az grafana notification-channel test

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

Test a notification channel.

az grafana notification-channel test --name
                                     --notification-channel
                                     [--api-key --token]
                                     [--resource-group]

Required Parameters

--name -n

Name of the Azure Managed Grafana.

--notification-channel

Id, uid which can identify a data source. CLI will search in the order of id, and uid, till finds a match.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az grafana notification-channel update

Deprecated

This command is implicitly deprecated because command group 'grafana notification-channel' is deprecated and will be removed in a future release.

Update a notification channel.

az grafana notification-channel update --definition
                                       --name
                                       --notification-channel
                                       [--api-key --token]
                                       [--resource-group]

Required Parameters

--definition

Json string with notification channel definition, or a path to a file with such content.

--name -n

Name of the Azure Managed Grafana.

--notification-channel

Id, uid which can identify a data source. CLI will search in the order of id, and uid, till finds a match.

Optional Parameters

--api-key --token -t

Api key or service account token, a randomly generated string used to interact with Grafana endpoint; if missing, CLI will use current logged-in user's credentials.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.