View a markdown version of this page

Use DescribeNotificationConfigurations with a CLI - AWS SDK Code Examples

There are more AWS SDK examples available in the AWS Doc SDK Examples GitHub repo.

Use DescribeNotificationConfigurations with a CLI

The following code examples show how to use DescribeNotificationConfigurations.

CLI
AWS CLI

Example 1: To describe the notification configurations of a specified group

The following describe-notification-configurations example describes the notification configurations for the specified Auto Scaling group.

aws autoscaling describe-notification-configurations \ --auto-scaling-group-names my-asg

Output:

{ "NotificationConfigurations": [ { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" }, { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" } ] }

For more information, see Getting Amazon SNS notifications when your Auto Scaling group scales in the Amazon EC2 Auto Scaling User Guide.

Example 2: To describe a specified number of notification configurations

The following describe-notification-configurations example uses the --max-items option to return a specific number of notification configurations.

aws autoscaling describe-notification-configurations \ --auto-scaling-group-names my-auto-scaling-group \ --max-items 1

Output:

{ "NotificationConfigurations": [ { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic-2" }, { "AutoScalingGroupName": "my-asg", "NotificationType": "autoscaling:TEST_NOTIFICATION", "TopicARN": "arn:aws:sns:us-west-2:123456789012:my-sns-topic" } ] }

If the output includes a NextToken field, there are more notification configurations. To get the additional notification configurations, use the value of this field with the starting-token parameter in a subsequent call as follows.

aws autoscaling describe-notification-configurations \ --auto-scaling-group-names my-asg \ --starting-token Z3M3LMPEXAMPLE

For more information, see Getting Amazon SNS notifications when your Auto Scaling group scales in the Amazon EC2 Auto Scaling User Guide.

PowerShell
Tools for PowerShell V4

Example 1: This example describes the notification actions associated with the specified Auto Scaling group.

Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list

Output:

AutoScalingGroupName : my-asg NotificationType : auto-scaling:EC2_INSTANCE_LAUNCH TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic AutoScalingGroupName : my-asg NotificationType : auto-scaling:EC2_INSTANCE_TERMINATE TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic

Example 2: This example describes the notification actions associated with all your Auto Scaling groups.

Get-ASNotificationConfiguration
Tools for PowerShell V5

Example 1: This example describes the notification actions associated with the specified Auto Scaling group.

Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list

Output:

AutoScalingGroupName : my-asg NotificationType : auto-scaling:EC2_INSTANCE_LAUNCH TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic AutoScalingGroupName : my-asg NotificationType : auto-scaling:EC2_INSTANCE_TERMINATE TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic

Example 2: This example describes the notification actions associated with all your Auto Scaling groups.

Get-ASNotificationConfiguration