All Products
Search
Document Center

Auto Scaling:DescribeNotificationConfigurations

最終更新日:Sep 24, 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 notified party. The following list describes the value formats of this parameter:

  • If the notified party is CloudMonitor, the value format is acs:ess:{region-id}:{account-id}:cloudmonitor.

  • If the notified party is a Message Service (MNS) queue, the value format is acs:mns:{region-id}:{account-id}:queue/{queuename}.

  • If the notified party is an MNS topic, the value format is acs:mns:{region-id}:{account-id}:topic/{topicname}.

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 MNS queue.

  • topicname: the name of the MNS topic.

ScalingGroupId

String

asg-bp1igpak5ft1flyp****

The ID of the scaling group.

NotificationTypes

Array of String

AUTOSCALING:SCALE_IN_SUCCESS

The types of notifications for scaling events or resource changes.

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

Error message

Description

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

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