All Products
Search
Document Center

Auto Scaling:DescribeNotificationConfigurations

更新時間:Dec 23, 2024

Queries notification settings. You can call the DescribeNotificationConfiguration operation to query notification settings of scaling events or resource changes, including the notification types and methods.

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

DescribeNotificationConfigurations

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

ScalingGroupId

String

Yes

asg-bp1igpak5ft1flyp****

The ID of the scaling group.

RegionId

String

No

cn-beijing

The region ID of the scaling group.

Response parameters

Parameter

Type

Example

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The request ID.

NotificationConfigurationModels

Array of NotificationConfigurationModel

The notification settings.

NotificationConfigurationModel

NotificationArn

String

acs:mns:cn-beijing:161456884340****:topic/modifyLifecycleHo****

The Alibaba Cloud Resource Name (ARN) of the notification recipient. The value is in one of the following formats:

  • If the notification recipient is CloudMonitor, the return value is in the acs:ess:{region-id}:{account-id}:cloudmonitor format.

  • If the notification recipient is a Simple Message Queue (SMQ, formerly MNS) queue, the return value is in the acs:mns:{region-id}:{account-id}:queue/{queuename} format.

  • If the notification recipient is an SMQ topic, the return value is in the acs:mns:{region-id}:{account-id}:topic/{topicname} format.

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

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

  • account-id: the ID of the Alibaba Cloud account.

  • queuename: the name of the SMQ queue.

  • topicname: the name of the SMQ topic.

ScalingGroupId

String

asg-bp1igpak5ft1flyp****

The ID of the scaling group.

NotificationTypes

Array of String

AUTOSCALING:SCALE_IN_SUCCESS

The types of notifications.

TimeZone

String

UTC+8

The time zone of notifications.

The value is displayed in UTC. For example, a value of UTC+8 indicates that the time is 8 hours ahead of Coordinated Universal Time, and a value of UTC-7 indicates that the time is 7 hours behind Coordinated Universal Time.

Examples

Sample requests

http(s)://ess.aliyuncs.com/?Action=DescribeNotificationConfigurations
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&RegionId=cn-beijing
&<Common request parameters>

Sample success responses

XML format

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

<DescribeNotificationConfigurationsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NotificationConfigurationModels>
        <NotificationArn>acs:mns:cn-beijing:161456884340****:topic/modifyLifecycleHo****</NotificationArn>
        <ScalingGroupId>asg-bp1igpak5ft1flyp****</ScalingGroupId>
        <NotificationTypes>AUTOSCALING:SCALE_IN_SUCCESS</NotificationTypes>
    </NotificationConfigurationModels>
</DescribeNotificationConfigurationsResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NotificationConfigurationModels" : [ {
    "NotificationArn" : "acs:mns:cn-beijing:161456884340****:topic/modifyLifecycleHo****",
    "ScalingGroupId" : "asg-bp1igpak5ft1flyp****",
    "NotificationTypes" : [ "AUTOSCALING:SCALE_IN_SUCCESS" ]
  } ]
}

Error codes

For a list of error codes, see Service error codes.

HTTP status code

Error code

Description

Description

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

The specified scaling group does not exist within the Alibaba Cloud account.