CreateNotificationConfiguration
事件通知支持在發(fā)生指定類型的事件后，自動發(fā)送消息到云監(jiān)控、MNS主題和MNS隊列，可以幫助您及時掌握伸縮組的動態(tài)，進(jìn)一步實現(xiàn)自動化管理。如果當(dāng)前事件通知的類型不再滿足業(yè)務(wù)需求，您可以調(diào)用API ModifyNotificationConfiguration修改彈性伸縮事件及資源變化通知，您無需重新創(chuàng)建新的事件通知，但不支持修改事件通知的通知方式。
接口說明
- 您可以設(shè)置由云監(jiān)控系統(tǒng)事件、消息服務(wù)MNS隊列或消息服務(wù)MNS主題接收消息通知。當(dāng)伸縮組發(fā)生指定類型的伸縮事件或者資源變化時，彈性伸縮會通知云監(jiān)控或消息服務(wù)。
-
同一個伸縮組內(nèi)的不同事件通知不可重復(fù)使用同一個接收端。
例如，不同的事件通知不能同時使用同一個云監(jiān)控、同一個MNS主題或者同一個MNS隊列。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | CreateNotificationConfiguration | 系統(tǒng)規(guī)定參數(shù)。取值：CreateNotificationConfiguration。 |
| ScalingGroupId | String | 是 | asg-bp1igpak5ft1flyp**** | 伸縮組的ID。 |
| NotificationArn | String | 是 | acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo**** | 通知對象標(biāo)識符，設(shè)置本參數(shù)時支持以下通知方式：
參數(shù)格式中的變量含義如下：
|
| NotificationType.N | String | 否 | AUTOSCALING:SCALE_OUT_SUCCESS | 一類或者多類彈性伸縮事件及資源變化通知。N的取值范圍：1~8，多個取值使用重復(fù)列表的形式。 您可以調(diào)用接口DescribeNotificationTypes查詢參數(shù)取值。 |
| RegionId | String | 否 | cn-beijing | 伸縮組所屬的地域ID。 |
| TimeZone | String | 否 | UTC+8 | 消息通知的時區(qū)。 時區(qū)相對于協(xié)調(diào)世界時的偏移量： 如 UTC+8（東八區(qū)）、UTC-7（西七區(qū)）等。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請求ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=CreateNotificationConfiguration
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&NotificationType=["AUTOSCALING:SCALE_OUT_SUCCESS"]
&RegionId=cn-beijing
&公共請求參數(shù)正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNotificationConfigurationResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateNotificationConfigurationResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 |
InvalidNotificationArn |
The specified parameter notificationArn is invalid. |
指定的NotificationArn不合法。 |
400 |
InvalidNotificationTypes |
The specified notification type is invalid. |
指定的NotificationType.N不合法。 |
400 |
NotificationConfigurationExist |
The specified notification configuration already exist for the scalingGroup. |
指定的事件通知已經(jīng)存在于當(dāng)前伸縮組中。 |
400 |
NotificationConfigurationQuotaExceed.ForScalingGroup |
NotificationConfiguration num exceed for the specified scalingGroup. |
當(dāng)前伸縮組配置的通知功能超出允許的上限值。 |
400 |
QueueNotExist |
The specified queue queuename does not exist. |
指定的MNS隊列不存在。 |
400 |
TopicNotExist |
The specified topic topicname does not exist. |
指定的MNS主題不存在。 |
400 |
UnsupportedNotificationType.CurrentRegion |
The NotificationType is not supported in the special region which scaling group belongs to. |
當(dāng)前地域不支持該通知方式。 |
400 |
InvalidParameter.TimeZone |
The specified parameter TimeZone is not valid. |
指定的參數(shù)TimeZone不合法。 |
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
指定的伸縮組不存在。 |