云服务器
云服务器
文档指南
请输入
- 文档首页
云服务器云服务器ECSAPI参考监控DescribeSystemEvents - 查询系统事件列表
复制全文
下载 pdfDescribeSystemEvents - 查询系统事件列表
文档反馈
问问助手调用 DescribeSystemEvents 接口，查询实例的系统事件信息。
使用说明
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：DescribeSystemEvents
要执行的操作，取值：DescribeSystemEvents。
Version string 必选 示例值：2020-04-01
API的版本，取值：2020-04-01。
Category string 可选 示例值：ResourceEvent
系统事件类别。取值：
- ResourceEvent：资源事件
- TaskEvent：任务事件
CreatedAtEnd string 可选 示例值：2021-06-29T18:11:46+08:00
以CreatedAtEnd为终点，筛选创建时间在其之前的事件。默认值为现在，格式为RFC3339。
CreatedAtStart string 可选 示例值：2021-06-28T18:29:38+08:00
以CreatedAtStart为起点，筛选创建时间在其之后的事件。默认值为CreatedAtEnd前24小时（参考请求参数CreatedAtEnd），格式为RFC3339。
EventIds.N string[] 可选 示例值：EventIds.1=e-3ti9101aju3vj0******&EventIds.2=e-r4911sfaa9ts******
- 参数 - N：表示事件的序号。
- 多个事件ID之间用&分隔。
MaxResults integer 可选 示例值：20
分页查询时设置的每页行数：
- 最大值：100
- 最小值：0
- 默认值：20
NextToken string 可选 示例值：--
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。
ResourceIds.N string[] 可选 示例值：ResourceIds.1=i-3ti9101aju3vj0******&ResourceIds.2=i-tws01a56ydh0******
- 参数 - N：表示资源的序号。
- 多个资源ID之间用&分隔。
说明
当前支持的资源类型为ECS实例。
Status.N string[] 可选 示例值： Status.1=Executing&Status.2=Inquiring
系统事件的状态，最多支持10个。
- 参数 - N：表示事件类型的序号。
- 多个事件类型之间用&分隔。
- 取值：
- UnknownStatus：未知状态
- Executing：执行中
- Succeeded：执行成功
- Failed：执行失败
- Inquiring：待响应
- Scheduled：计划执行
- Rejected：用户拒绝执行
- Canceled：已取消
- Pending：已暂停
- Recovered：已恢复
Types.N string[] 可选 示例值：Types.1=SystemFailure_Reboot&Types.2=DiskError_Redeploy
系统事件的类型，最多支持100个。
- 参数 - N：表示事件类型的序号。
- 多个事件类型之间用&分隔。
- 取值：
- SystemFailure_Stop：因系统故障实例停止。
- SystemFailure_Reboot：因系统故障实例重启。
- DiskError_Redeploy：因硬盘异常实例重新部署。
- GpuError_Redeploy：GPU异常，导致实例重新部署。
- SystemMaintenance_Redeploy：因系统维护实例重新部署。
- SystemMaintenance_StopAndRepair：实例停止，系统维修。
- SystemFailure_Redeploy：因系统故障实例重新部署。
- SystemFailure_Repair：系统故障，进行维修。
- CreateInstance：创建实例。
- RunInstance：启动实例。
- StopInstance：停止实例。
- DeleteInstance：删除实例。
- SpotInstanceInterruption_Delete：抢占型实例中断，实例释放。
- AccountUnbalanced_Stop：账户欠费，实例停止。
- AccountUnbalanced_Delete：账户欠费，实例释放。
- InstanceChargeType_Change：实例计费类型改变。
- InstanceConfiguration_Change：实例配置变更。
- FileSystemReadOnly_Change：文件系统变为只读状态。
- RebootInstance：实例重启。
- InstanceFailure：因操作系统错误实例异常。
- ApplicationFailure：应用异常。
- DeploymentSet_Modify：修改实例部署集。
- ServerMigrationTask：服务器迁移任务。
- ServerMigration_FirstSync：服务器迁移，全量数据同步。
- ServerMigration_AdditionalSync：服务器迁移，增量数据同步。
- GpuRiskDetected：GPU运行存在风险。
- ElasticScheduledInstance_Create：弹性预约单创建。
- ElasticScheduledInstance_Cancel：弹性预约单取消。
- ElasticScheduledInstance_Deliver：弹性预约单交付。
- ElasticScheduledInstance_AutoRelease：弹性预约实例自动释放。
- ElasticScheduledInstance_Invalid：弹性预约单失效。
- InfrastructureUpgrade_Redeploy：因基础设施升级实例重新部署。
- DiskErrorDetected：硬盘异常。
- DiskError_ReplaceDisk：因硬盘异常更换硬盘。
- InstanceOOM：实例内存OOM。
- MemoryRiskDetected：内存运行存在风险。
- InstanceFileSystemFailure_StopAndRepair：因文件系统异常实例停机修复。
- InstanceDiskStalled：因云盘性能受损实例异常。
- SystemMaintenance_ReserveAndRepair：因系统维护实例停机维修。
返回参数
NextToken string 示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RC******
本次调用返回的查询凭证值，返回为空表示该页为末页。
SystemEvents object[] 示例值：--
实例系统事件信息。
Category string 示例值：ResourceEvent
事件类别。
CreatedAt string 示例值：2022-08-29T18:11:46+08:00
系统事件创建时间。
ExtraInfo object 示例值：{"VolumeId": "vol-3tiegs1y963vj***","Serial": "ysw2flxa****"}
系统事件的扩展信息。
Id string 示例值：e-3tiegs1y963vj0******
系统事件ID。
ImpactLevel string 示例值：Info-信息
系统事件的影响等级。取值：
- Critical-严重
- Warning-警告
- Info-信息
OperatedEndAt string 示例值：2022-08-30T15:11:46+08:00
运维时间窗口结束时间。
OperatedStartAt string 示例值：2022-09-10T18:11:46+08:00
运维时间窗口的起始时间。
ResourceId string 示例值：i-3tiegs1y963vj0******
资源ID。
Status string 示例值：Execting
系统事件的状态。
Type string 示例值：SystemFailure_Stop
系统事件的类型。
UpdatedAt string 示例值：2022-08-30T18:11:46+08:00
系统事件更新时间。
请求示例
GET /?Action=DescribeSystemEvents&Version=2020-04-01&EventIds.1=e-3ti9101aju3vj0****** HTTP/1.1
Host: ecs.cn-beijing.volcengineapi.com
Region: cn-beijing
ServiceName: ecs
返回示例
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "DescribeSystemEvents",
"Version": "2020-04-01",
"Service": "ecs",
"Region": "cn-beijing"
},
"Result": {
"SystemEvents": [
{
"Id": "e-3ti9101aju3vj0******",
"Category": "ResourceEvent",
"CreatedAt": "2022-06-15T16:34:34+08:00",
"UpdatedAt": "2022-06-15T16:34:49+08:00",
"ResourceId": "i-3ti9101aju3vj0******",
"Type": "DiskError_Redeploy",
"Status": "Succeeded",
"OperatedStartAt": "2022-08-30T15:11:46+08:00",
"OperatedEndAt": "2022-09-10T18:11:46+08:00",
"ExtraInfo": {
"Serial": "ysw2flxa****",
"VolumeId": "vol-3tiegs1y963vj0******"
}
}
],
"NextToken": ""
}
}
错误码
最近更新时间：2025.11.12 11:27:12
这个页面对您有帮助吗？
有用
有用
无用
无用