禁止令允许您中止报警通知设定时间段 。单抑制可应用到数告警例举,本周定时维护期间使用单抑制所有报警通知 下周使用预期停机创建抑制时,请具体说明下列内容:
- 时标启动抑制(自UTC Unixe使用0表示
- 时标结束抑制(指自UTC Unixe使用0表示
- 至少有下列之一:通知计划列表(ID指定)、实体列表(ID指定)、检查列表(United States指定)entityID:checkID链表提醒entityID:alarmID)
属性化
| 名称 | 描述性 | 验证 |
|---|---|---|
| 报警器 | 列表提醒标识enFooBar:alAbc123)判定通知抑制 | 可选性 数组[String非空字符串] 数组或对象0至512 |
| 检验 | 列表检验IDenFooBAR:chAbc123)判定通知抑制 | 可选性 数组[String非空字符串] 数组或对象0至512 |
| 结束时间 | unix时间戳以毫秒结束指定0使用当前时间 | 可选性 整数 |
| 实体 | 实体标识表确定通知抑制 | 可选性 数组[String非空字符串] 数组或对象数介于0至512 |
| 标签标签 | 友美标签抑制 | 可选性 1至255字符间字符串长 |
| notification_plans | 通知计划标识列表判定通知抑制 | 可选性 数组[String非空字符串] 数组或对象0至512 |
| 开始时间 | unix时间戳以毫秒开始抑制指定0使用当前时间 | 可选性 整数 |
使用后续抑制API操作创建、查看、更新和管理抑制模板
创建抑制
POST/Serpress
创建新抑制
指定用有效参数集抑制特征抑制属性表格内
不同列表(通知_规划、实体、检查和报警)表示可定义抑制的不同层次创建抑制时, 仔细考虑您想使用哪些范围以避免意外压缩提醒
注解
创建抑制时,起始时间只能定为0或未来时间有一些回旋空间记录它接收处理请求所花时间, 意指如果起始时间在过去小于60秒时, 即被视为现在而非引起验证错误如果要立即开始抑制,请设置起始时间为0
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 201 | 好 | 地址头包含新创建抑制链路 |
| 400 | 坏请求 | 系统请求中接收无效值 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
示例:使用通知计划nfooBar
{{
"notification_plans": ["npfooBar"],
Checks:[en123:ch123]
起始时间: 137849233027
结束时间: 137849233027
}
示例:禁止通知实体en123所有通知计划
{{
实体:
Checks:[en123:ch123]
起始时间: 137849233027
结束时间: 137849233027
}
示例:禁止所有通知计划仅查实体en123
{{
Checks:[en123:ch123]
起始时间: 137849233027
结束时间: 137849233027
}
示例:禁止所有通知实体enMonkey和通知检查Ch123
{{
实体:
Checks:[en123:ch123]
起始时间: 137849233027
结束时间: 137849233027
}
示例:禁止通知计划npTechnology
{{
"notification_plans": ["npTechnical"],
起始时间: 137849233027
结束时间: 137849233027
}
实例:禁止通知计划npTechnology
{{
"notification_plans": ["npTechnical"],
ARMS:['en123:al123','enMonkey:alBaz'
起始时间: 137849233027
结束时间: 137849233027
}
操作不返回响应体
列表抑制
获取/提高
列表抑制使用/supressions?id=supressionOneId & id=supressionTwoId过滤结果只包括关于指定抑制的信息
操作可分解信息见粘贴集合.
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 二百 | 好 | 请求完成 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
示例列表禁止:JSON响应
{{
值:
{{
id:spaAA
"notification_plans": ['npfooBar'],
实体:
Checks:
ARMs:
起始时间: 137849233027
结束时间: 137849233027
}
万事通
元数据
计数数数:1
限值: 50
标志号:Null
ext_marce:Null
exthref无效
}
}
获取ID抑制
GET /suppressions/{suppressionId}
运算返回抑制抑制Id.
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 二百 | 好 | 请求完成 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
示例获取抑制ID:JSON响应
{{
id:spaAA
"notification_plans": ['npfooBar'],
实体:
Checks:
ARMs:
起始时间: 137849233027
结束时间: 137849233027
}
更新抑制
PUT /suppressions/{suppressionId}
更新抑制由抑制Id.
可完全局部更新抑制提交请求时只包含属性值省略参数上值不更新注意更新列表完全替换前一列表参考抑制属性表格内
注解
更新抑制时记住下列要点:
- 开始时间前,您可修改禁止区时间流逝后 抑制启动后 端点时间才能更新
- 结束时间只能定为0或未来时间和启动时间一样,60秒备抵用于计算接收处理请求所需时间表示如果端点前小于60秒,则视之为现在而非引起验证错误如果您想立即结束抑制,端点时间定为0
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 204 | 无内容 | 服务器满足请求不返回响应体 |
| 400 | 坏请求 | 系统请求中接收无效值 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
实例更新抑制:JSON请求
{{
实体:
结束时间: 1378495433027
}
操作不返回响应体
删除抑制
DELETE /suppressions/{suppressionId}
从您的账号删除抑制
注解
可随时删除抑制值,即使它活动时活动抑制删除后立即结束
下表显示此操作可能的响应码 :
| 响应代码 | 名称 | 描述性 |
|---|---|---|
| 204 | 无内容 | 服务器满足请求不返回响应体 |
| 401 | 未授权 | 系统接收用户请求未经认证 |
| 403 | 禁止 | 系统收到用户无权请求 |
| 404 | 未找到 | URL、实体或帐户请求系统中找不到 |
| 500 | 内部服务器错误 | 遇上意外条件 |
| 503 | 服务无可用 | 系统经历重负载或系统其他故障 |
下表显示请求页眉参数
| 名称 | 类型 | 描述性 |
|---|---|---|
| X-AUT-Token | 字符串(必备) | 有效验证令牌并存行政访问细节见获取证书 |
注解
操作不接受请求体
操作不返回响应体