ListNotificationHistories - 获取通知发送的历史记录列表

获取通知发送的历史记录列表。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
cmn:ListNotificationHistorieslist
  • 全部资源
    *

请求参数

名称类型必填描述示例值
NextTokenstring

标记当前开始读取的位置,置空表示从头开始。

1
MaxResultsinteger

本次读取的最大数据记录数量。

10
MonitorItemIdstring

监控项 ID。

m-22ut5sn54o35wsz6
DeviceIdstring

设备 ID。

device-jrjb476ub06
Typestring

数据类型。

  • SINGLE:单设备。
  • APP:应用。
  • AGGREGATE:聚合监控。
  • PORT_COLLECTION:端口集。
  • DEDICATED_LINE:专线。
  • EVENT:事件。
  • CUSTOM:自定义。
SINGLE
DedicatedLineIdstring

专线 ID。

d-52gmqniln3u53n32
AggregateDataIdstring

聚合数据 ID。

a-52gmqniln3u53n32
InstanceIdstring

实例 ID。

cmn-cn-tl3267yvz03
PortCollectionIdstring

端口集 ID。

p-y12angok0gf881n1
AppIdstring

应用 ID。

app-gh6b3a8yxtkb86yy
AlarmStatusstring

监控状态。

  • NORMAL:正常。
  • WARNING:警告。
  • CRITICAL:严重。
WARNING
Startlong

查询开始时间戳。

1667797440
Endlong

查询结束时间戳。

1659930240
NotificationModestring

发送方式。

  • DING_GROUP:钉钉通知。
  • MOBILE_GROUP:手机通知。
  • EMAIL_GROUP:邮箱通知。
DING_GROUP
NotificationGroupIdstring

通知组 ID。

n-yqqqknft7kzemgwe
Statusstring

发送状态。

SUCCESS
Messagestring

发送内容。

Alarm
PhysicalSpaceIdstring

物理空间 ID。

space-h47sn4e6d59n5ooh
EventItemIdstring

事件 ID。

e-mkl2gnr3am3amlzz

返回参数

名称类型描述示例值
object

Schema of Response

TotalCountinteger

TotalCount 本次请求条件下的数据总量,此参数为可选参数,默认可不返回。

100
RequestIdstring

请求 ID。

AC8F05E6-AFBB-4AAE-B75E-A6539A9BAAA8
NextTokenstring

表示当前调用返回读取到的位置,空代表数据已经读取完毕。

10
MaxResultsinteger

MaxResults 本次请求所返回的最大记录条数。

10
NotificationHistoriesarray<object>

数据列表。

object

通知历史。

Timestring

发送时间。

2021-01-01 00:01:00
NotificationModestring

发送方式。

DING_GROUP
Statusstring

发送状态。

  • SUCCESS:成功。
  • FAILURE:失败。
SUCCESS
Outputstring

输出内容。

OK
Messagestring

发送内容。

alarm content
DeviceIdstring

设备 ID。

device-jrjb476ub06
MonitorItemIdstring

监控项 ID。

m-22ut5sn54o35wsz6
NotificationGroupIdstring

通知组 ID。

n-22ut5sn54o35wsz6
NotificationGroupNamestring

通知组名称。

Notification Group
DedicatedLineIdstring

专线 ID。

d-52gmqniln3u53n32
AggregateDataIdstring

聚合数据 ID。

a-52gmqniln3u53n32
PortCollectionIdstring

端口集 ID。

p-52gmqniln3u53n32
AppIdstring

应用 ID。

a-52gmqniln3u53n32
AlarmStatusstring

监控状态。

  • NORMAL:正常。
  • WARNING:警告。
  • CRITICAL:严重。
WARNING

示例

正常返回示例

JSON格式

{
  "TotalCount": 100,
  "RequestId": "AC8F05E6-AFBB-4AAE-B75E-A6539A9BAAA8",
  "NextToken": "10",
  "MaxResults": 10,
  "NotificationHistories": [
    {
      "Time": "2021-01-01 00:01:00",
      "NotificationMode": "DING_GROUP",
      "Status": "SUCCESS",
      "Output": "OK",
      "Message": "alarm content",
      "DeviceId": "device-jrjb476ub06",
      "MonitorItemId": "m-22ut5sn54o35wsz6",
      "NotificationGroupId": "n-22ut5sn54o35wsz6",
      "NotificationGroupName": "Notification Group",
      "DedicatedLineId": "d-52gmqniln3u53n32",
      "AggregateDataId": "a-52gmqniln3u53n32",
      "PortCollectionId": "p-52gmqniln3u53n32",
      "AppId": "a-52gmqniln3u53n32",
      "AlarmStatus": "WARNING"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameter%sThe specified parameter %s is invalid.参数无效,请检查参数
400Missing%sYou must specify the parameter %s.必填参数没有填。请检查调用时是否填写了此参数,并重试请求。
400SignatureDoesNotMatch签名不通过-
403NoPermission没有权限-
404Invalid%s.NotFoundThe specified resource %s does not exist.找不到对应资源
404ServiceNotFound后端服务未找到-
500InternalError服务器内部错误-
503ServiceUnavailable服务不可用-

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