创建消息通知配置 - CreateNotificationSetting
功能介绍
创建消息通知配置。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| AccessAnalyzer:notificationSetting:create | Write | notificationSetting * | - | - | - |
URI
POST /v5/notification-settings
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| analyzer_id | 是 | String | 分析器的唯一标识符。 |
| mc_switch | 是 | Boolean | 是否开启消息中心通知开关。 |
| smn_topic_urns | 是 | Array of strings | 消息通知配置的SMN主题URN列表。 |
响应参数
状态码：201
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 消息通知配置的唯一标识符。 |
| urn | String | 消息通知配置的唯一资源标识符。 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误信息。 |
| request_id | String | 请求 ID。 |
| encoded_authorization_message | String | 鉴权信息。 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误信息。 |
| request_id | String | 请求 ID。 |
| encoded_authorization_message | String | 鉴权信息。 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误信息。 |
| request_id | String | 请求 ID。 |
| encoded_authorization_message | String | 鉴权信息。 |
请求示例
创建消息通知配置。
POST https://{hostname}/v5/notification-settings
{
"analyzer_id" : "3de500b3f6c74b0a8ef170656f8a6376",
"mc_switch" : true,
"smn_topic_urns" : [ "urn:smn:cn-north-7:******:test1" ]
} 响应示例
状态码：201
Created
{
"id" : "1c8b66cc466943ad9f6238a19f6f6679"
} 状态码
| 状态码 | 描述 |
|---|---|
| 201 | Created |
| 400 | Bad request |
| 403 | Forbidden |
| 404 | NotFound |
错误码
请参见错误码。
