DevOpsGuru / Client / add_notification_channel

add_notification_channel#

DevOpsGuru.Client.add_notification_channel(**kwargs)#

Adds a notification channel to DevOps Guru. A notification channel is used to notify you about important DevOps Guru events, such as when an insight is generated.

If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics.

If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.

See also: AWS API Documentation

Request Syntax

response = client.add_notification_channel(
    Config={
        'Sns': {
            'TopicArn': 'string'
        },
        'Filters': {
            'Severities': [
                'LOW'|'MEDIUM'|'HIGH',
            ],
            'MessageTypes': [
                'NEW_INSIGHT'|'CLOSED_INSIGHT'|'NEW_ASSOCIATION'|'SEVERITY_UPGRADED'|'NEW_RECOMMENDATION',
            ]
        }
    }
)
Parameters:

Config (dict) –

[REQUIRED]

A NotificationChannelConfig object that specifies what type of notification channel to add. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).

  • Sns (dict) – [REQUIRED]

    Information about a notification channel configured in DevOps Guru to send notifications when insights are created.

    If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics.

    If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.

    • TopicArn (string) –

      The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.

  • Filters (dict) –

    The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide filter configurations, the default configurations are to receive notifications for all message types of High or Medium severity.

    • Severities (list) –

      The severity levels that you want to receive notifications for. For example, you can choose to receive notifications only for insights with HIGH and MEDIUM severity levels. For more information, see Understanding insight severities.

      • (string) –

    • MessageTypes (list) –

      The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created.

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Id': 'string'
}

Response Structure

  • (dict) –

    • Id (string) –

      The ID of the added notification channel.

Exceptions