更新时间:2025-09-18 GMT+08:00

创建订阅事件

功能介绍

添加订阅的事件。

调用方法

请参见如何调用API。

URI

POST /v2/{project_id}/event-subs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释:

事件订阅名称。

取值范围:

不涉及。

source_type

否

String

参数解释:

事件源类型。

取值范围:

支持cluster,backup,disaster-recovery。

source_id

否

String

参数解释:

事件源ID。

取值范围:

不涉及。

category

否

String

参数解释:

事件类别。

取值范围:

支持management、monitor、security、system alarm。

severity

否

String

参数解释:

事件级别。

取值范围:

支持normal、warning。

tag

否

String

参数解释:

事件标签。

取值范围:

不涉及。

enable

否

Integer

参数解释:

是否开启订阅。

取值范围:

1为开启,0为关闭。

notification_target

是

String

参数解释:

消息通知地址。

取值范围:

不涉及。

notification_target_name

是

String

参数解释:

消息主题名称。

取值范围:

不涉及。

notification_target_type

是

String

参数解释:

消息通知类型只支持SMN。

取值范围:

不涉及。

time_zone

否

String

参数解释:

时区。

取值范围:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

订阅ID。

取值范围:

不涉及。

name

String

参数解释:

订阅名称。

取值范围:

不涉及。

source_type

String

参数解释:

事件源类型。

取值范围:

不涉及。

source_id

String

参数解释:

事件源ID。

取值范围:

不涉及。

category

String

参数解释:

事件类别。

取值范围:

不涉及。

severity

String

参数解释:

事件级别。

取值范围:

不涉及。

tag

String

参数解释:

事件标签。

取值范围:

不涉及。

enable

Integer

参数解释:

是否开启订阅。

取值范围:

1为开启,0为关闭。

project_id

String

参数解释:

项目ID。

取值范围:

不涉及。

name_space

String

参数解释:

所属服务。

取值范围:

不涉及。

notification_target

String

参数解释:

消息通知主题地址。

取值范围:

不涉及。

notification_target_name

String

参数解释:

消息通知主题名称。

取值范围:

不涉及。

notification_target_type

String

参数解释:

消息通知类型。

取值范围:

不涉及。

language

String

参数解释:

语言。

取值范围:

不涉及。

time_zone

String

参数解释:

时区。

取值范围:

不涉及。

请求示例

开启名为zrf-test-66的正常和警告事件订阅,并选择地址为“urn:smn:cn-north-7:4cf650fd46704908aa071b4df2453e1e:dws-test-nodelete”的SMN消息主题“dws-test-nodelete”。

https://{Endpoint}/v2/4cf650fd46704908aa071b4df2453e1e/event-subs

{
  "severity" : "normal,warning",
  "source_id" : "",
  "source_type" : "",
  "tag" : "",
  "category" : "",
  "enable" : 1,
  "name" : "zrf-test-66",
  "notification_target" : "urn:smn:cn-north-7:4cf650fd46704908aa071b4df2453e1e:dws-test-nodelete",
  "notification_target_name" : "dws-test-nodelete",
  "notification_target_type" : "SMN",
  "time_zone" : "GMT+08:00"
}

响应示例

状态码:200

添加事件订阅成功。

{
  "id" : "41eb162b-cd3b-4c66-88d0-0c2c17fdfc2b",
  "name" : "zrf-test-66",
  "category" : "",
  "severity" : "normal,warning",
  "tag" : "",
  "enable" : 1,
  "language" : "zh-cn",
  "source_type" : "",
  "source_id" : "",
  "project_id" : "4cf650fd46704908aa071b4df2453e1e",
  "name_space" : "DWS",
  "notification_target" : "urn:smn:cn-north-7:4cf650fd46704908aa071b4df2453e1e:dws-test-nodelete",
  "notification_target_name" : "dws-test-nodelete",
  "notification_target_type" : "SMN",
  "time_zone" : "GMT+08:00"
}

状态码

状态码

描述

200

添加事件订阅成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。