ModifyNotificationConfiguration - Auto Scaling

Modifies a notification for Auto Scaling events and resource changes.

Test

You can call this operation in OpenAPI Explorer. OpenAPI Explorer automatically calculates the signature and generates sample SDK code.

Request parameters

Parameter	Type	Required	Example value	Description
Action	String	Yes	ModifyNotificationConfiguration	A required parameter. Set the value to ModifyNotificationConfiguration.
ScalingGroupId	String	Yes	asg-bp1igpak5ft1flyp****	The ID of the scaling group.
NotificationArn	String	Yes	acs:ess:cn-beijing:161456884340****:cloudmonitor	The Alibaba Cloud Resource Name (ARN) of the notification recipient. The following notification methods are supported: CloudMonitor: `acs:ess:{region-id}:{account-id}:cloudmonitor`. MNS queue: `acs:mns:{region-id}:{account-id}:queue/{queuename}`. MNS topic: `acs:mns:{region-id}:{account-id}:topic/{topicname}`. The variables in the preceding formats have the following meanings: region-id: the ID of the region where the scaling group is located. account-id: the Alibaba Cloud account ID. queuename: the name of the MNS queue. topicname: the name of the MNS topic.
NotificationType.N	String	No	AUTOSCALING:SCALE_OUT_SUCCESS	One or more types of Auto Scaling event and resource change notifications. The value of N ranges from 1 to 8. Valid values: AUTOSCALING:SCALE_OUT_SUCCESS: a successful scale-out event. AUTOSCALING:SCALE_IN_SUCCESS: a successful scale-in event. AUTOSCALING:SCALE_OUT_ERROR: a failed scale-out event. AUTOSCALING:SCALE_IN_ERROR: a failed scale-in event. AUTOSCALING:SCALE_REJECT: a rejected scaling activity. AUTOSCALING:SCALE_OUT_START: a scale-out event has started. AUTOSCALING:SCALE_IN_START: a scale-in event has started. AUTOSCALING:SCHEDULE_TASK_EXPIRING: a notification that a scheduled task is about to expire. SCALING_GROUP_DIAGNOSE: a scaling group diagnosis. AUTOSCALING:SCALE_OUT_WARN: a partially successful scale-out event. AUTOSCALG:SCALE_IN_WARN: a partially successful scale-in event.
RegionId	String	No	cn-beijing	The ID of the region where the scaling group is located.
TimeZone	String	No	UTC+8	The time zone for message notifications. The value is the offset from Coordinated Universal Time (UTC). Examples: UTC+8 and UTC-7.
MessageEncoding	String	No	PlainText	The encoding method of the message content. Valid values: PlainText: The message is not encoded and is transmitted in plaintext. Base64: The message is Base64-encoded. Default value: Base64. Note This parameter is supported only for MNS notifications.

Response parameters

Parameter	Type	Example value	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	The ID of the request.

Examples

Request example

http(s)://ess.aliyuncs.com/?Action=ModifyNotificationConfiguration
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&NotificationArn=acs:ess:cn-beijing:161456884340****:cloudmonitor
&NotificationType=["AUTOSCALING:SCALE_OUT_SUCCESS"]
&RegionId=cn-beijing
&CommonRequestParameters

Response examples

XML format

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

<ModifyNotificationConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNotificationConfigurationResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Error codes

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

HTTP status code	Error code	Error message	Description
400	InvalidNotificationTypes	The specified NotificationType is invalid.	The specified NotificationType.N is invalid.
400	NotificationConfigurationNotExist	The specified notification configuration not exist for the scaling group.	The specified notification configuration does not exist for the scaling group.
400	InvalidParameter.TimeZone	The specified parameter TimeZone is not valid.	The specified TimeZone parameter is invalid.
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	The specified scaling group does not exist.