Docs

Auto Scaling

NotificationConfiguration

DescribeNotificationConfigurations - Queries event notification configurations

Query the event notification of one or multiple scaling groups.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string Sample value: DescribeNotificationConfigurations

The action that you want to perform. Value: DescribeNotificationConfigurations.

Version string Sample value: 2020-01-01

The version of the API. Value: 2020-01-01.

ScalingGroupIds.N string[] Optional Sample value: scg-ybmssdnnhn5pkgyd****

The ID of the scaling group. You can call DescribeScalingGroups to query the scaling group ID.

Parameter - N: Specifies the serial number of the scaling group. Valid value: 1-10.

Separate multiple scaling group IDs with ampersands (&).

Response parameters

Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.

NotificationConfigurations object[] Sample value: --

The information of the event notification that meets the condition.

ScalingGroupId string Sample value: scg-ybmssdnnhn5p****

The ID of the scaling group.

NotificationType string Sample value: cloudmonitor

The event notification type.

EventTypes string[] Sample value: ScaleOutStart

The event type.

CreatedAt string Sample value: 2024-04-25T11:19:24Z

The creation time of the event notification.

UpdatedAt string Sample value: 2024-04-25T11:19:24Z

The update time of the event notification.

Sample request

GET /?Action=DescribeNotificationConfigurations&Version=2020-01-01 HTTP/1.1​
Host: auto-scaling.cn-beijing.volcengineapi.com​
X-Date: 20240507T094512Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240507/cn-beijing/auto_scaling/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​

Sample response

{​
  "ResponseMetadata": {​
    "RequestId": "2024050717451722220005105139B563",​
    "Version": "2020-01-01",​
    "Service": "auto_scaling",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "NotificationConfigurations": [​
      {​
        "ScalingGroupId": "scg-ybmssdnnhn5p****",​
        "NotificationType": "cloudmonitor",​
        "EventTypes": [​
          "ScaleOutStart"​
        ],​
        "CreatedAt": "2024-04-25T11:19:24Z",​
        "UpdatedAt": "2024-04-25T11:19:24Z"​
      },​
    ]​
  }​
}​

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error codes	Error message	Description
400	MissingParameter.ScalingGroupId	The required parameter ScalingGroupId is not supplied.	The scaling group ID cannot be empty.
400	LimitExceeded.ScalingGroupIds	You've reached the limit on the number of ScalingGroupIds.	The number of scaling group IDs reaches the upper limit.
500	InternalError	An internal error has occurred.	An internal error occurred. Please try again. If multiple attempts fail, submit a ticket.

Last updated: 2026.06.24 17:08:55