All Products
Search
Document Center

Auto Scaling:ModifyNotificationConfiguration

Last Updated:Oct 26, 2026

Modifies an Auto Scaling event and resource change notification.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:ModifyNotificationConfiguration

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None None

Request parameters

Parameter

Type

Required

Description

Example

ScalingGroupId

string

Yes

The ID of the scaling group.

asg-bp1igpak5ft1flyp****

NotificationArn

string

Yes

The identifier of the notification recipient. When you set this parameter, 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 parameter formats have the following meanings:

  • region-id: the ID of the region where the scaling group resides.

  • account-id: the Alibaba Cloud account ID.

  • queuename: the name of the MNS queue.

  • topicname: the name of the MNS topic.

acs:ess:cn-beijing:161456884340****:cloudmonitor

NotificationType

array

Yes

The types of Auto Scaling events and resource change notifications. Valid values of N: 1 to 8.

AUTOSCALING:SCALE_OUT_SUCCESS

string

No

The types of Auto Scaling events and resource change notifications. Valid values of N: 1 to 8.

  • AUTOSCALING:SCALE_OUT_SUCCESS: The scale-out activity succeeded.

  • AUTOSCALING:SCALE_IN_SUCCESS: The scale-in activity succeeded.

  • AUTOSCALING:SCALE_OUT_ERROR: The scale-out activity failed.

  • AUTOSCALING:SCALE_IN_ERROR: The scale-in activity failed.

  • AUTOSCALING:SCALE_REJECT: The scaling activity was rejected to execute.

  • AUTOSCALING:SCALE_OUT_START: The scale-out activity started.

  • AUTOSCALING:SCALE_IN_START: The scale-in activity started.

  • AUTOSCALING:SCHEDULE_TASK_EXPIRING: The scheduled node is about to expire.

  • SCALING_GROUP_DIAGNOSE: Scaling group diagnosis.

  • AUTOSCALING:SCALE_OUT_WARN: The scale-out activity partially succeeded.

  • AUTOSCALG:SCALE_IN_WARN: The scale-down activity partially succeeded.

AUTOSCALING:SCALE_OUT_SUCCESS

RegionId

string

No

The region ID of the scaling group.

cn-beijing

TimeZone

string

No

The time zone for message notifications. Specify the time zone offset from Coordinated Universal Time (UTC), such as UTC+8 and UTC-7.

UTC+8

MessageEncoding

string

No

The encoding method for the message notification content. Valid values:

  • PlainText: No encoding is used. The content is transmitted in plaintext.

  • Base64: Base64 encoding.

Default value: Base64.

Note

This parameter is supported only for MNS notification recipients.

PlainText

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.