獲取通知發送的歷史記錄列表。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
cmn:ListNotificationHistories | list |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
NextToken | string | 否 | 標記當前開始讀取的位置,置空表示從頭開始。 | 1 |
MaxResults | integer | 是 | 本次讀取的最大數據記錄數量。 | 10 |
MonitorItemId | string | 否 | 監控項 ID。 | m-22ut5sn54o35wsz6 |
DeviceId | string | 否 | 設備 ID。 | device-jrjb476ub06 |
Type | string | 是 | 數據類型。
| SINGLE |
DedicatedLineId | string | 否 | 專線 ID。 | d-52gmqniln3u53n32 |
AggregateDataId | string | 否 | 聚合數據 ID。 | a-52gmqniln3u53n32 |
InstanceId | string | 是 | 實例 ID。 | cmn-cn-tl3267yvz03 |
PortCollectionId | string | 否 | 端口集 ID。 | p-y12angok0gf881n1 |
AppId | string | 否 | 應用 ID。 | app-gh6b3a8yxtkb86yy |
AlarmStatus | string | 否 | 監控狀態。
| WARNING |
Start | long | 否 | 查詢開始時間戳。 | 1667797440 |
End | long | 否 | 查詢結束時間戳。 | 1659930240 |
NotificationMode | string | 否 | 發送方式。
| DING_GROUP |
NotificationGroupId | string | 否 | 通知組 ID。 | n-yqqqknft7kzemgwe |
Status | string | 否 | 發送狀態。 | SUCCESS |
Message | string | 否 | 發送內容。 | Alarm |
PhysicalSpaceId | string | 否 | 物理空間 ID。 | space-h47sn4e6d59n5ooh |
EventItemId | string | 否 | 事件 ID。 | e-mkl2gnr3am3amlzz |
返回參數
示例
正常返回示例
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 | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidParameter%s | The specified parameter %s is invalid. | 參數無效,請檢查參數 |
400 | Missing%s | You must specify the parameter %s. | 必填參數沒有填。請檢查調用時是否填寫了此參數,并重試請求。 |
400 | SignatureDoesNotMatch | 簽名不通過 | - |
403 | NoPermission | 沒有權限 | - |
404 | Invalid%s.NotFound | The specified resource %s does not exist. | 找不到對應資源 |
404 | ServiceNotFound | 后端服務未找到 | - |
500 | InternalError | 服務器內部錯誤 | - |
503 | ServiceUnavailable | 服務不可用 | - |
訪問錯誤中心查看更多錯誤碼。