DescribeNotificationConfigurations - Auto Scaling - Alibaba Cloud Documentation Center

Queries notification settings. You can call the DescribeNotificationConfiguration operation to query notification settings of scaling events or resource changes, including the notification types and methods.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeNotificationConfigurations	The operation that you want to perform. Set the value to DescribeNotificationConfigurations.
ScalingGroupId	String	Yes	asg-bp1igpak5ft1flyp****	The ID of the scaling group.
RegionId	String	No	cn-beijing	The region ID of the scaling group.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	The request ID.
NotificationConfigurationModels	Array of NotificationConfigurationModel		The notification settings.
NotificationConfigurationModel
NotificationArn	String	acs:mns:cn-beijing:161456884340**:topic/modifyLifecycleHo**	The Alibaba Cloud Resource Name (ARN) of the notification recipient. The value is in one of the following formats: If the notification recipient is CloudMonitor, the return value is in the acs:ess:{region-id}:{account-id}:cloudmonitor format. If the notification recipient is a Simple Message Queue (SMQ, formerly MNS) queue, the return value is in the acs:mns:{region-id}:{account-id}:queue/{queuename} format. If the notification recipient is an SMQ topic, the return value is in the acs:mns:{region-id}:{account-id}:topic/{topicname} format. The variables in the preceding value formats have the following meanings: region-id: the region ID of the scaling group. account-id: the ID of the Alibaba Cloud account. queuename: the name of the SMQ queue. topicname: the name of the SMQ topic.
ScalingGroupId	String	asg-bp1igpak5ft1flyp****	The ID of the scaling group.
NotificationTypes	Array of String	AUTOSCALING:SCALE_IN_SUCCESS	The types of notifications.
TimeZone	String	UTC+8	The time zone of notifications. The value is displayed in UTC. For example, a value of UTC+8 indicates that the time is 8 hours ahead of Coordinated Universal Time, and a value of UTC-7 indicates that the time is 7 hours behind Coordinated Universal Time.

Examples

Sample requests

http(s)://ess.aliyuncs.com/?Action=DescribeNotificationConfigurations
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&RegionId=cn-beijing
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeNotificationConfigurationsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NotificationConfigurationModels>
        <NotificationArn>acs:mns:cn-beijing:161456884340****:topic/modifyLifecycleHo****</NotificationArn>
        <ScalingGroupId>asg-bp1igpak5ft1flyp****</ScalingGroupId>
        <NotificationTypes>AUTOSCALING:SCALE_IN_SUCCESS</NotificationTypes>
    </NotificationConfigurationModels>
</DescribeNotificationConfigurationsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NotificationConfigurationModels" : [ {
    "NotificationArn" : "acs:mns:cn-beijing:161456884340****:topic/modifyLifecycleHo****",
    "ScalingGroupId" : "asg-bp1igpak5ft1flyp****",
    "NotificationTypes" : [ "AUTOSCALING:SCALE_IN_SUCCESS" ]
  } ]
}

Error codes

For a list of error codes, see Service error codes.

HTTP status code	Error code	Description	Description
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	The specified scaling group does not exist within the Alibaba Cloud account.