CreateNotificationConfiguration
创建弹性伸缩事件及资源变化通知（CreateNotificationConfiguration）。
您可以设置由云监控系统事件、消息服务 MNS 队列或 MNS 主题接收消息通知。当伸缩组发生指定类型的伸缩事件或者资源变化时，弹性伸缩会发送消息通知云监控或 MNS。目前，有部分阿里云地域暂未部署 MNS 队列 和 MNS 主题服务，具体详情，请访问 MNS 管理控制台或者参阅 MNS 常见问题。
调试
前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| NotificationArn | String | 是 | acs:ess:cn-hangzhou:123456:cloudmonitor |
通知对象标识符。格式为
|
| NotificationType.N | RepeatList | 是 | AUTOSCALING:SCALE_OUT_SUCCESS |
一类或者多类弹性伸缩事件及资源变化通知。N 的取值范围为 1~8，多个取值使用重复列表的形式。 您可以通过接口 查询参数取值。 |
| ScalingGroupId | String | 是 | AG6CQdPU8OKdwLjgZcJ**** |
伸缩组 ID。 |
| Action | String | 否 | CreateNotificationConfiguration |
系统规定参数。取值：CreateNotificationConfiguration。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。无论调用接口成功与否，我们都会返回请求 ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=CreateNotificationConfiguration
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ****
&NotificationArn=acs:ess:cn-hangzhou:123456:cloudmonitor
&NotificationType.1=AUTOSCALING:SCALE_OUT_SUCCESS
&NotificationType.2=AUTOSCALING:SCALE_IN_SUCCESS
&NotificationType.3=AUTOSCALING:SCALE_OUT_ERROR
&NotificationType.4=AUTOSCALING:SCALE_IN_ERROR
&NotificationType.5=AUTOSCALING:SCALE_REJECT
&<公共请求参数>
正常返回示例
XML 格式
<CreateNotificationConfigurationResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</CreateNotificationConfigurationResponse>
JSON 格式
{
"requestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}错误码
HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
|
400 |
InvalidNotificationArn |
The specified parameter notificationArn is invalid. |
指定的 NotificationArn 不合法。 |
|
400 |
InvalidNotificationTypes |
The specified notificationType is invalid. |
指定的 NotificationType.N不合法。 |
|
400 |
NotificationConfigurationExist |
The specified notificationConfiguration already exist for the scalingGroup. |
指定的事件通知已经存在于当前伸缩组中。 |
|
400 |
NotificationConfigurationQuotaExceed.ForScalingGroup |
NotificationConfiguration num exceed for the specified scalingGroup. |
当前伸缩组配置的通知功能超出允许的上限值。 |
|
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 scalingGroup belongs to. |
当前地域不支持该通知方式。 |
|
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
指定的伸缩组不存在。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4545.html
微信扫一扫
相关推荐
-
DescribeScalingInstances
查询伸缩组内ECS实例列表，并列出ECS实例的属性。 描述 您可以通过指定伸缩组ID查询该伸缩组内的ECS实例列表，查询时可以指定伸缩配置ID、健康状态、生命周期状态、创建类型进行过滤。 请求参数 名称 类型 是否必选 描述 Action String 是 操作接口名，系统规定参…
-
CreateScheduledTask
调用CreateScheduledTask接口创建一个定时任务。 接口说明 一个账号下最多创建20个定时任务。 由于伸缩组正在发生伸缩活动或者伸缩组停用等原因，导致定时任务触发执行伸缩规则失败后，在LaunchExpirationTime内，定时任务会自动重试触发，否则放弃本次定…
-
创建生命周期挂钩
本文主要介绍生命周期挂钩的定义和创建。 在 中，您已经成功实现弹性扩张或收缩 ECS 资源。但是，这些 ECS 资源只进行了简单的初始配置，面对复杂的业务情况，您可能希望在启用这些 ECS 资源前进行自定义操作，这时就需要使用生命周期挂钩。 什么是生命周期挂钩 如果您为伸缩组创建…
-
伸缩活动的流程
本文主要介绍弹性伸缩的伸缩活动流程。 伸缩活动的生命周期为判断伸缩组的健康状态和边界条件步骤与启动 cooldown 步骤之间的所有活动。 伸缩组自动伸缩 自动扩展 判断伸缩组的健康状态和边界条件。 分配 ActivityId 和执行伸缩活动。 创建 ECS 实例。 修改 Tot…
-
修改伸缩组
本文主要介绍修改伸缩组的步骤。 创建伸缩组后，如果当前伸缩组属性不再满足需求，您可以直接修改一项或者多项属性，无需重新创建。 说明 如果修改 伸缩最大实例数和 伸缩最小实例数，导致伸缩组内的ECS实例数超过上限或低于下限，弹性伸缩会自动加入或移出ECS实例，保证ECS实例数量满足…
-
EnableScalingGroup
本文介绍启用伸缩组API操作。 描述 启用一个指定的伸缩组。 启用伸缩组成功以后（active 状态），会先把接口中指定的 ECS 实例加入伸缩组。 接口中指定的 ECS 实例成功加入伸缩组后，如果当前 ECS 实例数量仍小于 MinSize，则弹性伸缩服务会自动创建差额的按量付…
