CreateNotificationConfiguration - 创建弹性伸缩事件及资源变化通知 - 弹性伸缩

接口说明

您可以设置由云监控系统事件、轻量消息队列（原 MNS）队列或轻量消息队列（原 MNS）主题接收消息通知。当伸缩组发生指定类型的伸缩事件或者资源变化时，弹性伸缩会通知云监控或轻量消息队列（原 MNS）。
同一个伸缩组内的不同事件通知不可重复使用同一个接收端。

例如，不同的事件通知不能同时使用同一个云监控、同一个 MNS 主题或者同一个 MNS 队列。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ess:CreateNotificationConfiguration

create

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

无

请求参数

名称	类型	必填	描述	示例值
ScalingGroupId	string	是	伸缩组的 ID。	asg-bp1igpak5ft1flyp****
NotificationArn	string	是	通知对象标识符，设置本参数时支持以下通知方式：云监控，参数取值格式：`acs:ess:{region-id}:{account-id}:cloudmonitor`。 MNS 队列，参数取值格式：`acs:mns:{region-id}:{account-id}:queue/{queuename}`。 MNS 主题，参数取值格式：`acs:mns:{region-id}:{account-id}:topic/{topicname}`。参数格式中的变量含义如下： `region-id`：伸缩组所在的地域的 ID。 `account-id`：阿里云账号 ID。 `queuename`：MNS 队列的名称。 `topicname`：MNS 主题的名称。	acs:mns:cn-beijing:161456884340**:queue/modifyLifecycleHo**
NotificationTypes	array	是	一类或者多类弹性伸缩事件及资源变化通知。多个取值使用重复列表的形式。您可以调用 API DescribeNotificationTypes 接口查询参数取值。
	string	否	一类或者多类弹性伸缩事件及资源变化通知。多个取值使用重复列表的形式。您可以调用 API DescribeNotificationTypes 接口查询参数取值。	AUTOSCALING:SCALE_OUT_SUCCESS
RegionId	string	否	伸缩组所属的地域 ID。	cn-beijing
TimeZone	string	否	消息通知的时区。时区相对于协调世界时的偏移量：如 UTC+8（东八区）、UTC-7（西七区）等。	UTC+8
MessageEncoding	string	否	消息通知内容的编码方式。取值范围： PlainText：不编码，采用明文传输。 Base64：Base64 编码。默认值：Base64。说明仅支持 MNS 通知对象设置该参数。	PlainText

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。