Modifies the configurations of an event notification.

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 ModifyNotificationConfiguration

The operation that you want to perform. 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 notified party. The following list describes the value formats of this parameter:

  • If the notified party is CloudMonitor, the value format of this parameter is acs:ess:{region-id}:{account-id}:cloudmonitor.
  • If the notified party is a Message Service (MNS) queue, the value format of this parameter is acs:mns:{region-id}:{account-id}:queue/{queuename}.
  • If the notified party is an MNS topic, the value format of this parameter is 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 resides.
  • account-id: the ID of the Alibaba Cloud account.
  • queuename: the name of the MNS queue.
  • topicname: the name of the MNS topic.
RegionId String No cn-beijing

The ID of the region where the scaling group resides.

NotificationType.N String 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.

Response parameters

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

The ID of the request.

Examples

Sample requests

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
&<Common request parameters>

Sample success responses

XML format

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

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

JSON format

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

{
  "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

InvalidNotificationTypes

The specified NotificationType is invalid.

The error message returned because the value that you specified for the NotificationType.N parameter is invalid.

400

NotificationConfigurationNotExist

The specified notification configuration not exist for the scaling group.

The error message returned because the specified notification type for scaling activities and resource changes does not exist in the scaling group.

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

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