You can call this operation to create notifications for scaling activities and resource changes.

Description

You can configure Cloud Monitor system events, Message Notification Service (MNS) queues, or MNS topics to receive notifications. When a scaling activity or a resource change of the specified type occurs in a scaling group, Auto Scaling notifies Cloud Monitor or MNS.

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 CreateNotificationConfiguration

The operation that you want to perform. Set the value to CreateNotificationConfiguration.

NotificationArn String Yes acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****

The Alibaba Cloud Resource Name (ARN) of the notified party. The following list describes the formats of this parameter:

  • When the notified party is Cloud Monitor, the parameter format is acs:ess:{region-id}:{account-id}:cloudmonitor.
  • When the notified party is an MNS queue, the parameter format is acs:mns:{region-id}:{account-id}:queue/{queuename}.
  • When the notified party is an MNS topic, the parameter format is acs:mns:{region-id}:{account-id}:topic/{topicname}.

The variables in the preceding parameter formats have the following meanings:

  • region-id: the region ID of the scaling group
  • account-id: the ID of Alibaba Cloud account
  • queuename: the name of the MNS queue
  • topicname: the name of the MNS topic
NotificationType.N RepeatList Yes AUTOSCALING:SCALE_OUT_SUCCESS

The type of notification N for scaling activities or resource changes. Valid values of N: 1 to 8. Specify multiple values in the repeated list form.

You can call the DescribeNotificationTypes operation to query the value of this parameter.

ScalingGroupId String Yes asg-bp1igpak5ft1flyp****

The ID of the scaling group.

Response parameters

Parameter Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request.

Examples

Sample requests

https://ess.aliyuncs.com/?Action=CreateNotificationConfiguration
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&NotificationType.1=AUTOSCALING:SCALE_OUT_SUCCESS
&NotificationType.2=AUTOSCALING:SCALE_IN_SUCCESS
&NotificationType.3=AUTOSCALING:SCALE_OUT_ERROR
&NotificationType.4=AUTOSCALING:SCALE_IN_ERROR
&NotificationType.5=AUTOSCALING:SCALE_REJECT
&<Common request parameters>

Sample success responses

XML format

<CreateNotificationConfigurationResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</CreateNotificationConfigurationResponse>

JSON format

{
    "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

For a list of error codes, visit the API Error Center.

HTTP status code

Error code

Error message

Description

400

InvalidNotificationArn

The specified parameter notificationArn is invalid.

The error message returned because the specified NotificationArn parameter is invalid.

400

InvalidNotificationTypes

The specified NotificationType is invalid.

The error message returned because the specified NotificationType.N parameter is invalid.

400

NotificationConfigurationExist

The specified notificationConfiguration already exist for the scalingGroup.

The error message returned because the specified event notification is already configured for the current scaling group.

400

NotificationConfigurationQuotaExceed.ForScalingGroup

NotificationConfiguration num exceed for the specified scalingGroup.

The error message returned because the maximum number of notifications allowed for the scaling group has been reached.

400

QueueNotExist

The specified queue queuename does not exist.

The error message returned because the specified MNS queue does not exist.

400

TopicNotExist

The specified topic topicname does not exist.

The error message returned because the specified MNS topic does not exist.

400

UnsupportedNotificationType.CurrentRegion

The NotificationType is not supported in the special region which scalingGroup belongs to.

The error message returned because the notification type is not supported in the region to which the scaling group belongs.

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

The error message returned because the specified scaling group does not exist.