全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询系统事件详情

最近更新时间:2025-07-15 15:14:23

调用 DescribeSystemEventAttributes 接口查询系统事件详情。

1.接口描述

请求方式:GET

请求域名:monitor.api.ksyun.com

VPC内域名:monitor.internal.api.ksyun.com

接口调用频率限制为:3600次/分钟。

区域参数影响范围

接口仅返回指定区域(机房)内资源触发的事件列表会根据以下参数自动筛选对应区域的数据:

- 公共参数中的 Region 字段

- 请求URL中的 ${region} 变量


2.接口调试

荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。


3. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称

必选

类型

描述

Action

String

公共参数,本接口取值:DescribeSystemEventAttributes

Version

String

公共参数,本接口取值:2025-01-01

StartTime

Long

开始时间。

Tips: 请注意时间格式为Unix时间戳(毫秒),从1970年1月1日开始所经过的毫秒数。

示例值:1752508800000

EndTime

Long

结束时间。

Tips: 请注意时间格式为Unix时间戳(毫秒),从1970年1月1日开始所经过的毫秒数。

示例值:1752552000000

Namespace

String

表示一类云产品,指定命名空间。

示例值:KEC

EventType

String

事件类型。

说明:
关于事件类型的取值,可参考:云产品事件列表

示例值:GPUAbnormal

EventName

String

事件名称。

说明:
关于事件类型的取值,可参考:云产品事件列表

Tips: 支持同时查询多个事件,多个事件之间用逗号分隔,最多可查询10个事件。

示例值:XidError,SXidError

Level

String

事件级别。

有效值:

  • Critical:严重

  • Warn(Warning):警告

  • Info:信息

示例值:Critical

Status

String

事件状态。

说明:
关于事件类型的取值,可参考:云产品事件列表

示例值:Fault

SearchKeywords

String

搜索事件内容包含的关键字。

取值:

  • 如果您待搜索事件的内容中包括 a 和 b,可以搜索a and b。

  • 如果您待搜索事件的内容中包括 a 或 b,可以搜索a or b。

PageIndex

Integer

页码。

取值范围:1~10000。

示例值:10

PageSize

Integer

每页显示记录条数。

取值范围:1~100。

示例值:1


4.输出参数

名称

类型

说明

RequestID

String

请求的ID。

示例值:7106664e-bce9-4871-b5df-9cf6e25ce142

SystemEvents

Array of SystemEvent

事件内容详情集合。

TotalCount

Integer

事件总数。


5. 示例

示例1:查询GPU裸金属事件详情

输入示例

${region} 可替换相应区域,详见:Region 参考

${公共参数} 可替换相应区域,详见:公共参数

curl -X GET 'https://monitor.${region}.api.ksyun.com?Action=DescribeSystemEventAttributes&Version=2021-01-01&StartTime=1751353200000&Namespace=EPCGPU' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H ${公共参数}
输出示例

支持XML和JSON

JSON格式

{
  "RequestID": "7106664e-bce9-4871-b5df-9cf6e25ce142",
  "SystemEvents": [
    {
      "Time": 1752128651772,
      "Namespace": "EPCGPU",
      "NamespaceID": 43,
      "EventType": "GPUFault",
      "EventName": "GpuCheckHealthError",
      "EventLevel": "Critical",
      "EventStatus": "",
      "Tags": [
        "groupid=XXXX-XXXX-XXXX-XXXX-XXXXXXX",
        "host=kscepc--XXXX-XXXX-XXXX-XXXX-XXXXXXX001",
        "reason=LnkWidthMisMatch",
        "type=dmesg_log"
      ],
      "Content": " LnkWidthMisMatch, lnksta_width: x16 x16 x16 x16 x1 x1 x1 x1 x1 x1 x16 x16 x16 x16 ",
      "InstanceName": "qa-gpu-001",
      "InstanceID": "XXXX-XXXX-XXXX-XXXX-XXXXXXX001",
      "Region": "cn-beijing-6"
    },
    {
      "Time": 1752124991800,
      "Namespace": "EPCGPU",
      "NamespaceID": 43,
      "EventType": "GPUFault",
      "EventName": "GpuCheckHealthError",
      "EventLevel": "Critical",
      "EventStatus": "",
      "Tags": [
        "groupid=XXXX-XXXX-XXXX-XXXX-XXXXXXX",
        "host=kscepc--XXXX-XXXX-XXXX-XXXX-XXXXXXX002",
        "reason=LnkWidthMisMatch",
        "type=dmesg_log"
      ],
      "Content": " LnkWidthMisMatch, lnksta_width: x16 x16 x16 x16 x1 x1 x1 x1 x1 x1 x16 x16 x16 x16 ",
      "InstanceName": "qa-gpu-002",
      "InstanceID": "XXXX-XXXX-XXXX-XXXX-XXXXXXX002",
      "Region": "cn-beijing-6"
    }
  ],
  "TotalCount": 2
}

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈